.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "TEXDOC" "1" "February 2025" "Texdoc 4.1.1" "Texdoc manual"
.SH "نام (NAME)"
texdoc \- یافتن و مشاهده مستندات در TeX Live
.SH "خلاصه دستور (SYNOPSIS)"
\fBtexdoc\fR [OPTION]\|\.\|\.\|\. NAME\|\.\|\.\|\.
.br
\fBtexdoc\fR [OPTION]\|\.\|\.\|\. ACTION
.SH "توضیحات (DESCRIPTION)"
تلاش برای یافتن مستندات مناسب TeX برای \fINAME\fR(های) مشخص‌شده\. همچنین می‌توان \fIACTION\fR داده‌شده را اجرا کرد و خارج شد\.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-w\fR, \fB\-\-view\fR
استفاده از حالت مشاهده: باز کردن یک نمایشگر\. \fB(پیش‌فرض)\fR
.TP
\fB\-m\fR, \fB\-\-mixed\fR
استفاده از حالت ترکیبی (مشاهده یا نمایش فهرست)\.
.TP
\fB\-l\fR, \fB\-\-list\fR
استفاده از حالت فهرست: نمایش فهرستی از نتایج\.
.TP
\fB\-s\fR, \fB\-\-showall\fR
استفاده از حالت نمایش همه: نمایش نتایج «نامناسب» در کنار سایر نتایج\.
.TP
\fB\-i\fR, \fB\-\-interact\fR
استفاده از منوهای تعاملی\. \fB(پیش‌فرض)\fR
.TP
\fB\-I\fR, \fB\-\-nointeract\fR
استفاده از فهرست‌های ساده، بدون نیاز به تعامل\.
.TP
\fB\-M\fR, \fB\-\-machine\fR
خروجی ماشین‌خوان برای فهرست‌ها (شامل \-I نیز می‌شود)\.
.TP
\fB\-q\fR, \fB\-\-quiet\fR
نادیده گرفتن هشدارها و اکثر پیام‌های خطا\.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
چاپ اطلاعات تکمیلی (مانند دستور نمایشگر)\.
.TP
\fB\-D\fR, \fB\-\-debug\fR
فعال‌سازی تمام خروجی‌های اشکال‌زدایی (معادل "\-\-debug=all")\.
.TP
\fB\-d\fR LIST, \fB\-\-debug\fR=LIST
فعال‌سازی خروجی‌های اشکال‌زدایی محدود به دسته‌های مشخص‌شده در LIST\.
.br
دسته‌های در دسترس: \fBconfig\fR، \fBfiles\fR، \fBsearch\fR، \fBdocfile\fR، \fBscore\fR، \fBtexdocs\fR، \fBtlpdb\fR، \fBversion\fR، \fBview\fR، و \fBall\fR برای فعال‌سازی تمام آن‌ها\.
.TP
\fB\-c\fR NAME=VALUE
تنظیم مقدار گزینه پیکربندی NAME روی VALUE\.
.SH "عملیات‌ها (ACTIONS)"
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ این پیام راهنما\.
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ شماره نسخه\.
.TP
\fB\-f\fR, \fB\-\-files\fR
چاپ فهرست فایل‌های پیکربندی استفاده‌شده\.
.TP
\fB\-\-just\-view\fR FILE
نمایش FILE داده‌شده با مسیر کامل (بدون جستجو)\.
.TP
\fB\-\-print\-completion\fR SHELL
چاپ تکمیل خودکار شل برای SHELL\.
.SH "محیط (ENVIRONMENT)"
متغیرهای محیطی زیر را می‌توان با علامت دونقطه تفکیک کرد و برای تنظیم نمایشگرها به کار برد:
.TP
\fBBROWSER\fR, \fBBROWSER_texdoc\fR
تنظیم دستور مورد استفاده برای اسناد HTML\.
.TP
\fBDVIVIEWER\fR, \fBDVIVIEWER_texdoc\fR
تنظیم دستور مورد استفاده برای اسناد DVI\.
.TP
\fBMDVIEWER\fR, \fBMDVIEWER_texdoc\fR
تنظیم دستور مورد استفاده برای اسناد Markdown\.
.TP
\fBPAGER\fR, \fBPAGER_texdoc\fR
تنظیم دستور مورد استفاده برای اسناد متنی\.
.TP
\fBPDFVIEWER\fR, \fBPDFVIEWER_texdoc\fR
تنظیم دستور مورد استفاده برای اسناد PDF\.
.TP
\fBPSVIEWER\fR, \fBPSVIEWER_texdoc\fR
تنظیم دستور مورد استفاده برای اسناد PS\.
.P
متغیرهای محیطی زیر نیز استفاده می‌شوند:
.TP
\fBLANG\fR, \fBLC_ALL\fR, \fBLANGUAGE\fR, \fBLANGUAGE_texdoc\fR
تنظیم لوکال که بر نتایج جستجو تأثیر می‌گذارد\.
.TP
\fBTEXDOCS\fR
علاوه بر اسناد موجود در پایگاه‌داده TeX Live، ابزار Texdoc مستندات را در درخت‌های TEXMF مشخص‌شده توسط متغیر kpathsea به نام \fBTEXDOCS\fR نیز جستجو می‌کند\.
.SH "فایل‌ها (FILES)"
\fB<texmf>/texdoc/texdoc\.cnf\fR، خروجی گزینه \fB\-\-files\fR را مشاهده کنید\.
.SH "وضعیت خروج (EXIT STATUS)"
دستور \fBtexdoc\fR با یکی از مقادیر زیر خارج می‌شود:
.TP
0
موفقیت‌آمیز\.
.TP
1
خطای داخلی\.
.TP
2
خطای استفاده نادرست\.
.TP
3
هیچ مستنداتی یافت نشد\.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها به \fItexdoc@tug\.org\fR\.
.br
صفحه خانگی Texdoc: \fIhttp://tug\.org/texdoc\fR
.br
منبع: \fIhttps://github\.com/TeX\-Live/texdoc\fR
.SH "حق نشر (COPYRIGHT)"
حق نشر 2008\-2025 Manuel Pe'gourie'\-Gonnard, Takuto Asakura, the TeX Live Team\.
.br
مجوز: نسخه ۳ یا بالاتر GNU GPL \fIhttp://gnu\.org/licenses/gpl\.html\fR\.
.br
این یک نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید\.
.SH "همچنین ببینید (SEE ALSO)"
مستندات کامل در قالب یک راهنمای PDF نگهداری می‌شود\. دستور
.IP "" 4
.nf
texdoc texdoc
.fi
.IP "" 0
.P
باید به شما دسترسی به راهنمای کامل را ارائه دهد\.