.TH GPHELP 1 "12 September 2024"
.SH "نام (NAME)"
gphelp \- نمایش آنلاین راهنما و مستندات سیستم PARI/GP
.SH "خلاصه دستور (SYNOPSIS)"
.BR gphelp
[-to_pod
.IR file ]
[-raw]
[-detex]
[-noskip]
[-utf8]
[-k]
[-ch
.IR c1 ]
[-cb
.IR c2 ]
[-cu
.IR c3 ]
[keyword [ @{1,2,3,4,5} ]]
[tutorial]
[refcard]...

.SH "توضیحات (DESCRIPTION)"
اسکریپت راهنمای آنلاین PARI-GP را فراخوانی می‌کند. به‌طور پیش‌فرض،
.I keyword
به‌عنوان عنوان یک بخش (نام یک تابع GP) در نظر گرفته می‌شود و
.B gphelp
آن را در فصل ۳ راهنمای کاربری PARI جستجو می‌کند. اگر پیدا شود، بخش مربوطه در یک فایل موقت در پوشه /tmp (یا
.BR $GPTMPDIR )
کپی شده،
.B TeX
اجرا می‌شود و سپس بخش مربوطه در پنجره‌ای جداگانه با استفاده از
.B xdvi
(یا
.BR $GPXDVI )
نمایش داده می‌شود.

اگر بیش از یک کلمه کلیدی در یک خط فرمان داده شود، خروجی‌ها به یکدیگر متصل می‌شوند. اگر
.I keyword
ذکر نشود، کل دفترچه راهنمای
.IR users.dvi
باز می‌شود. کلمات کلیدی
.I tutorial
و
.I refcard
به‌ترتیب آموزش GP و کارت مرجع سریع را باز می‌کنند.

پیش‌فرض‌های GP، بخش‌های راهنما (۱ تا ۱۱) و همچنین برخی کلمات کلیدی (مانند readline، bnf، ell، تمام عملگرها...) شناسایی شده و به‌صورت ویژه پردازش می‌شوند تا اطمینان حاصل شود که با عنوان یک بخش مطابقت دارند. برای مثال
.B &&
به
.I "Comparison and boolean operators"
ترجمه می‌شود که حدس زدن آن چندان بدیهی نیست.
اگر
.I keyword
حاوی نویسه‌های حساس (مانند فاصله) است، حتماً آن را درون علامت‌های نقل‌قول قرار دهید. برای مثال، باید عبارت
.RS
gphelp -k "elliptic curves"
.RE
را وارد کنید و نه
.RS
gphelp -k elliptic curves
.RE
که ابتدا به دنبال
"elliptic"
و سپس به دنبال
"curves"
می‌گردد و مثلاً
.B ploth
را در میان بخش‌های مرتبط نمایش می‌دهد.

.SH "جستجوی کامل: نشانگرهای @ (FULL SEARCH: @ MARKERS)"
الگوی
.BR @ x
(که در آن x شماره یک فصل بین ۱ تا ۵ است) در انتهای
.I keyword
جستجو را به‌جای فصل پیش‌فرض ۳، در فصل مربوطه انجام می‌دهد. اگر شماره حذف شود، کل دفترچه راهنما جستجو می‌شود. برای مثال:
.RS
gphelp -k gerepile@4
.RE
به دنبال
.B gerepile
در فصل ۴ راهنمای کاربری می‌گردد.
.RS
gphelp -k gerepile@
.RE
کل دفترچه راهنما را جستجو می‌کند. فرض می‌شود که تمام فصل‌های راهنما (usersch[1-5].tex) در مسیر
.B $GPDOCDIR
.RI ( مقدار پیش‌فرض توسط
Configure تعیین می‌شود) قرار دارند. شما مجاز به فشرده‌سازی آن‌ها با gzip (یا compress) هستید؛ این کار تاثیری بر فرایند جستجو نخواهد گذاشت.

.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان زیر در دسترس هستند:
.TP
.BI -cb,\ -color_bold\  c2
رنگ مورد استفاده برای متن ضخیم (Bold). به
.B -color_help
مراجعه کنید.

.TP
.BI -ch,\ -color_help\  c1
رنگ (بین ۱ تا ۱۶) مورد استفاده برای چاپ عمومی. تنها در حالت
.B detex
کاربرد دارد.

.TP
.BI -cu,\ -color_underline\  c3
رنگ مورد استفاده برای زیرخط (Underline). به
.B -color_help
مراجعه کنید.

.TP
.BI \-detex
استفاده از حالت
.BR detex .
فایل TeX به یک خروجی متنی خوانا در صفحه تبدیل می‌شود که مستقیماً در ترمینال چاپ می‌گردد؛ در این حالت از tex یا xdvi استفاده نمی‌شود.

.TP
.BI \-noskip
به‌طور پیش‌فرض، هنگامی که بخش جدیدی با نشانگر %GPHELPskip (در همان خط) برچسب‌گذاری شده باشد، متن راهنما ادامه می‌یابد. اگر این گزینه تنظیم شود، نشانگرها نادیده گرفته می‌شوند: به محض شروع بخش جدید، متن راهنما پایان می‌یابد.

.TP
.BI \-utf8
در حالت
.BR detex ،
از رمزگذاری UTF-8 برای نویسه‌ها استفاده می‌شود، مثلاً استفاده از \('e (é) به‌جای 'e.

.TP
.BI \-k
تغییر به حالت
.BR apropos .
تنها فهرست عناوین بخش‌هایی از دفترچه راهنما که حاوی
.I keyword
هستند را در خروجی استاندارد چاپ می‌کند.

سپس می‌توانید عنصری را از فهرست انتخاب کرده و از آن به‌عنوان آرگومان برای
.B gphelp
استفاده کنید (اگر شامل فاصله است، آن را بین نقل‌قول قرار دهید)، که می‌تواند با یک نشانگر
.B @
در انتها همراه باشد (توضیحات بالا را ببینید).

.TP
.BI \-raw
استفاده از قالب داخلی برای خروجی (با استفاده از نشانگرهای @x). تنها برای اشکال‌زدایی کاربرد دارد.

.TP
.BI \-to_pod\  file
تلاش برای تبدیل
.I file
از فرمت TeX به فرمت POD. تنها بر روی زیرمجموعه‌ای از راهنمای کاربری PARI کار خواهد کرد (فصل ۳، کارت مرجع). این باید تنها آرگومان در خط فرمان باشد.

.SH "محیط (ENVIRONMENT)"
.TP
COLUMNS
تعداد ستون‌های در دسترس در صفحه نمایش (برای حالت
.BR detex )

.TP
DISPLAY
محل اجرای نمایش‌دهنده dvi. اگر تنظیم نشده باشد، حالت
.B detex
به‌طور خودکار در نظر گرفته می‌شود.

.TP
GPDOCDIR
پوشه‌ای که فایل‌های راهنمای PARI در آن قرار دارند. مقدار پیش‌فرض در زمان Configure تعیین می‌شود.

.TP
GPTEX
.RS
برنامه حروف‌چینی TeX مورد استفاده
.RE

.TP
GPTMPDIR
پوشه‌ای که فایل‌های موقت در آن نوشته می‌شوند

.TP
GPXDVI
.RS
پیش‌نمایش‌گر dvi مورد استفاده. می‌توانید از این متغیر برای تعیین گزینه‌های xdvi استاندارد استفاده کنید، مثلاً "xdvi -s 7" برای انتخاب ضریب کوچک‌نمایی.
.RE

.SH "فایل‌ها (FILES)"
.TP
.I gp
ماشین‌حساب gp

.TP
.I gphelp
اسکریپت gphelp

.TP
.I users.dvi
راهنمای کاربری PARI/GP

.TP
.I tutorial.dvi
آموزش PARI/GP

.TP
.I refcard.dvi
کارت مرجع GP

.TP
.I refcard.ps
کارت مرجع GP، آماده چاپ

.SH "اشکالات (BUGS)"
الگوریتم جستجو نسبتاً ابتدایی و داده‌های جستجو شده نسبتاً بدون ساختار هستند. بنابراین، جستجو در خارج از فصل ۳ ممکن است نتایج مفیدی به همراه نداشته باشد، مگر در حالت
.B apropos
(برای مثال ممکن است بخش‌ها خیلی زود قطع شوند).

الگوهای جستجوی چندکلمه‌ای به دلیل ساختارهای مختلف TeX در منبع، مستعد خطا و عدم موفقیت هستند.

.SH "نویسندگان (AUTHORS)"
در ابتدا توسط Ilya Zakharevitch برای بسته پرل Math::Pari نوشته شد.
توسط Karim Belabas برای توزیع اصلی PARI بازنویسی و گسترش یافت.

.SH "همچنین ببینید (SEE ALSO)"
.IR gp (1),
.IR gzip (1),
.IR readline (1),
.IR tex (1),
.IR xdvi (1).

.SH "کپی‌رایت و تکثیر (COPYING)"
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «اجازه‌نامه عمومی همگانی گنو» (GNU GPL) که توسط «بنیاد نرم‌افزارهای آزاد» منتشر شده است، بازتوزیع کرده یا تغییر دهید.

این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا تناسب برای یک هدف خاص. برای جزئیات بیشتر به «اجازه‌نامه عمومی همگانی گنو» مراجعه کنید.

شما باید یک نسخه از «اجازه‌نامه عمومی همگانی گنو» را همراه با این برنامه دریافت کرده باشید؛ در غیر این صورت، به بنیاد نرم‌افزارهای آزاد به آدرس زیر بنویسید:
Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.