.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "MAKEGLOSSARIES 1"
.TH MAKEGLOSSARIES 1 2025-11-09 "perl v5.40.3" "makeglossaries Perl Script"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
makeglossaries \- فراخوانی makeindex/xindy برای اسناد LaTeX با استفاده از بسته glossaries
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBmakeglossaries\fR [\fB\-o\fR \fIfile\fR] [\fB\-q\fR] [\fB\-Q\fR] [\fB\-k\fR] [\fB\-n\fR]
[\fB\-s\fR \fIfile\fR] [\fB\-t\fR \fIfile\fR] [\fB\-L\fR \fIlanguage\fR] [\fB\-c\fR] [\fB\-g\fR] [\fB\-l\fR]
[\fB\-p\fR \fInum\fR] [\fB\-r\fR] [\fB\-d\fR \fIaux dir\fR] [\fB\-m\fR \fIfile\fR] [\fB\-x\fR \fIfile\fR]
[\fB\-e\fR] [\fB\-\-version\fR] [\fB\-\-help\fR] \fIfilename\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور \&\fBmakeglossaries\fR برای استفاده همراه با اسناد LaTeX طراحی شده است که از بسته glossaries استفاده می‌کنند.
.PP
آرگومان اجباری \fIfilename\fR باید نام فایل aux باشد. پسوند \fB.aux\fR می‌تواند حذف شود، اما بهتر است در مواردی که نام فایل شامل نقطه‌های اضافی است برای جلوگیری از ابهام ذکر شود.
.PP
همچنین، در صورتی که فقط یک واژه‌نامه (glossary) باید پردازش شود (برای نمونه، هنگام کار روی پیش‌نویس سند)، \fIfilename\fR می‌تواند نام یک فایل واژه‌نامه خاص باشد. در این حالت، همچنان انتظار می‌رود فایل aux وجود داشته باشد و از نام پایه (basename) مربوط به \&\fIfilename\fR استنتاج می‌شود.
.PP
دستور \&\fBmakeglossaries\fR فایل کمکی (auxiliary) را می‌خواند تا مشخص کند که آیا \&\fBmakeindex\fR باید فراخوانی شود یا \fBxindy\fR. تمامی اطلاعات موردنیاز برای ارسال به برنامه نمایه‌سازی مربوطه نیز باید در فایل کمکی موجود باشد، اما می‌توان آن‌ها را با آرگومان‌های گزینه‌های \&\fBmakeglossaries\fR لغو (override) کرد.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-e\fR 4
.IX Item "-e"
تلاشی برای ترمیم چندباره encaps یا شماره صفحه‌های نامعتبر انجام ندهد (فقط \fBmakeindex\fR).
.IP \fB\-c\fR 4
.IX Item "-c"
فشرده‌سازی فاصله‌های خالی میانی (فقط \fBmakeindex\fR).
.IP "\fB\-d\fR \fIaux dir\fR" 4
.IX Item "-d aux dir"
دایرکتوری محل قرارگیری فایل‌های .aux، .glo و غیره را مشخص می‌کند.
پیش‌فرض، دایرکتوری والد فایل پایه \fIfilename\fR است.
.IP \fB\-g\fR 4
.IX Item "-g"
به‌کارگیری ترتیب واژگان آلمانی (فقط \fBmakeindex\fR).
.IP \fB\-k\fR 4
.IX Item "-k"
تلاشی برای انشعاب (forking) با تغییر مسیر لوله‌ای انجام ندهد. (اثر
\-q را کاهش می‌دهد)
.IP \fB\-l\fR 4
.IX Item "-l"
ترتیب حرف به حرف (Letter ordering).
.IP "\fB\-L\fR \fIlanguage\fR" 4
.IX Item "-L language"
این گزینه تنها زمانی اثر دارد که \fBxindy\fR فراخوانی شود. زبان را تنظیم می‌کند.
برای جزئیات بیشتر به مستندات \fBxindy\fR مراجعه کنید.
.IP "\fB\-m\fR \fIfile\fR" 4
.IX Item "-m file"
مسیر کامل به \fIfile\fR را برای \fBmakeindex\fR مشخص می‌کند، در صورتی که 
\fBmakeindex\fR در متغیر path سیستم‌عامل موجود نباشد.
.IP \fB\-n\fR 4
.IX Item "-n"
دستورهایی را که معمولاً اجرا می‌شوند چاپ می‌کند اما آن‌ها را اجرا نمی‌کند.
.IP "\fB\-o\fR \fIfile\fR" 4
.IX Item "-o file"
از \fIfile\fR به عنوان فایل خروجی استفاده می‌کند. (تنها برای اسنادی 
مناسب است که شامل یک واژه‌نامه هستند، در غیر این صورت هر واژه‌نامه
بازنویسی خواهد شد.)
.IP "\fB\-p\fR \fInum\fR" 4
.IX Item "-p num"
شماره صفحه آغازین را روی \fInum\fR تنظیم می‌کند (فقط \fBmakeindex\fR).
.IP \fB\-q\fR 4
.IX Item "-q"
حالت بی‌صدا. پیام‌های ارسالی به خروجی استاندارد را کاهش می‌دهد.
.IP \fB\-Q\fR 4
.IX Item "-Q"
هشدار مربوط به ناتوانی در ایجاد انشعاب (fork) را خاموش می‌کند.
.IP \fB\-r\fR 4
.IX Item "-r"
.PD 0
.IP "\fB\-s\fR \fIfile\fR" 4
.IX Item "-s file"
.PD
استفاده از \fIfile\fR به عنوان فایل شیوه‌نامه (style file). توجه داشته باشید
اگر از این گزینه استفاده می‌کنید، باید بدانید که آیا \fBmakeindex\fR یا \fBxindy\fR
فراخوانی خواهد شد، چرا که آن‌ها فایل‌های شیوه‌نامه متفاوتی دارند.
.IP "\fB\-t\fR \fIfile\fR" 4
.IX Item "-t file"
استفاده از \fIfile\fR به عنوان فایل رونوشت (transcript file).
.Sp
تشکیل ضمنی محدوده صفحات را غیرفعال می‌کند (فقط \fBmakeindex\fR).
.IP "\fB\-x\fR \fIfile\fR" 4
.IX Item "-x file"
مسیر کامل به \fIfile\fR را برای \fBxindy\fR مشخص می‌کند، در صورتی که 
\fBxindy\fR در متغیر path سیستم‌عامل موجود نباشد.
.IP \fB\-\-version\fR 4
.IX Item "--version"
شماره نسخه را چاپ کرده و خارج می‌شود.
.IP \fB\-\-help\fR 4
.IX Item "--help"
پیام راهنما را چاپ کرده و خارج می‌شود.
.SH "پیش‌نیازها (REQUIRES)"
.IX Header "REQUIRES"
ابزارهای Perl، Getopt::Std و makeindex یا xindy (بسته به گزینه‌های بسته
glossaries).
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این یک نرم‌افزار آزاد است که تحت «مجوز عمومی پروژه لایتک» (LaTeX Project Public License) 
توزیع می‌شود. هیچ ضمانتی وجود ندارد (NO WARRANTY).
برای جزئیات به <http://www.latex\-project.org/lppl.txt> مراجعه کنید.
.SH "نویسنده (AUTHOR)"
.IX Header "AUTHOR"
Nicola L. C. Talbot,
<http://www.dickimaw\-books.com>
.SH "مطالعه پیشنهادی (RECOMMENDED READING)"
.IX Header "RECOMMENDED READING"
راهنمای بسته glossaries:
.PP
.Vb 1
\&        texdoc glossaries
.Ve