نام (NAME)

gphelp - نمایش آنلاین راهنما و مستندات سیستم PARI/GP

خلاصه دستور (SYNOPSIS)

gphelp [-to_pod file] [-raw] [-detex] [-noskip] [-utf8] [-k] [-ch c1] [-cb c2] [-cu c3] [keyword [ @{1,2,3,4,5} ]] [tutorial] [refcard]...

توضیحات (DESCRIPTION)

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

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

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

جستجوی کامل: نشانگرهای @ (FULL SEARCH: @ MARKERS)

الگوی @x (که در آن x شماره یک فصل بین ۱ تا ۵ است) در انتهای keyword جستجو را به‌جای فصل پیش‌فرض ۳، در فصل مربوطه انجام می‌دهد. اگر شماره حذف شود، کل دفترچه راهنما جستجو می‌شود. برای مثال:

گزینه‌ها (OPTIONS)

گزینه‌های خط فرمان زیر در دسترس هستند:

-cb, -color_bold c2

رنگ مورد استفاده برای متن ضخیم (Bold). به -color_help مراجعه کنید.

-ch, -color_help c1

رنگ (بین ۱ تا ۱۶) مورد استفاده برای چاپ عمومی. تنها در حالت detex کاربرد دارد.

-cu, -color_underline c3

رنگ مورد استفاده برای زیرخط (Underline). به -color_help مراجعه کنید.

-detex

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

-noskip

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

-utf8

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

-k

تغییر به حالت apropos. تنها فهرست عناوین بخش‌هایی از دفترچه راهنما که حاوی keyword هستند را در خروجی استاندارد چاپ می‌کند.

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

-raw

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

-to_pod file

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

محیط (ENVIRONMENT)

COLUMNS

تعداد ستون‌های در دسترس در صفحه نمایش (برای حالت detex)

DISPLAY

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

GPDOCDIR

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

GPTEX

GPTMPDIR

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

GPXDVI

فایل‌ها (FILES)

gp

ماشین‌حساب gp

gphelp

اسکریپت gphelp

users.dvi

راهنمای کاربری PARI/GP

tutorial.dvi

آموزش PARI/GP

refcard.dvi

کارت مرجع GP

refcard.ps

کارت مرجع GP، آماده چاپ

اشکالات (BUGS)

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

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

نویسندگان (AUTHORS)

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

همچنین ببینید (SEE ALSO)

gp(1), gzip(1), readline(1), tex(1), xdvi(1).

کپی‌رایت و تکثیر (COPYING)

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

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

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