.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
.\" ========================================================================
.\"
.IX Title "LATEXREVISE 1"
.TH LATEXREVISE 1 2024-11-17 "perl v5.38.2" " "
.\" 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)"
latexrevise \- حذف گزینشی نشانه‌گذاری و متن از خروجی latexdiff
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBlatexrevise\fR [ \fBOPTIONS\fR ] [ \fIdiff.tex\fR ] > \fIrevised.tex\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور \&\fIlatexrevise\fR یک فایل به نام \f(CW\*(C`diff.tex\*(C'\fR (خروجی \fIlatexdiff\fR) را می‌خواند و دستورهای نشانه‌گذاری آن را حذف می‌کند.
اگر نام فایلی مشخص نشود، ورودی از ورودی استاندارد (standard input) خوانده می‌شود. این دستور را می‌توان در حالت‌های \fIACCEPT\fR، \fIDECLINE\fR یا \fISIMPLIFY\fR اجرا کرد، یا برای حذف دستورهای لاتک تعریف‌شده توسط کاربر از ورودی استفاده نمود (گزینه‌های \fB\-c\fR، \fB\-e\fR، \fB\-m\fR و \fB\-n\fR را در زیر ببینید).
در حالت \fIACCEPT\fR، تمام قطعه‌متن‌های الحاق‌شده (یا خطوط preamble) نگه داشته می‌شوند و تمام قطعه‌متن‌های دور ریخته‌شده (یا خطوط preamble) حذف می‌گردند.
در حالت \fIDECLINE\fR، تمام قطعه‌متن‌های دور ریخته‌شده نگه داشته شده و تمام قطعه‌متن‌های الحاق‌شده حذف می‌شوند.
اگر مایلید برخی از تغییرات را حفظ کنید، فایل diff.tex را از قبل ویرایش کرده و نشانه‌هایی (tokens) را که در غیر این صورت حذف می‌شدند، به‌صورت دستی بردارید. توجه داشته باشید که \fIlatexrevise\fR فقط به نشانه‌های \f(CW\*(C`\eDIFaddbegin\*(C'\fR، \&\f(CW\*(C`\eDIFaddend\*(C'\fR، \f(CW\*(C`\eDIFdelbegin\*(C'\fR و \f(CW\*(C`\eDIFdelend\*(C'\fR و انواع متناظر FL آن‌ها توجه می‌کند. تمام دستورهای \f(CW\*(C`\eDIFadd\*(C'\fR و \f(CW\*(C`\eDIFdel\*(C'\fR (نه محتوای آن‌ها) به‌سادگی حذف می‌شوند. همچنین دستورهایی که توسط latexdiff به بخش preamble افزوده شده‌اند نیز حذف می‌گردند.
در حالت \fISIMPLIFY\fR، نشانه‌های \f(CW\*(C`\eDIFaddbegin, \eDIFaddend, \eDIFdelbegin, \eDIFdelend\*(C'\fR و انواع متناظر \f(CW\*(C`FL\*(C'\fR آن‌ها حفظ می‌شوند اما سایر نشانه‌گذاری‌ها (مانند \f(CW\*(C`DIFadd\*(C'\fR و <\eDIFdel>) حذف می‌شوند. خروجی حاصل به‌طور کلی یک کد معتبر لاتک نخواهد بود، اما خواندن و ویرایش آن جهت آماده‌سازی برای اجرای بعدی در حالت \fIACCEPT\fR یا \fIDECLINE\fR آسان‌تر خواهد بود.
در حالت \fISIMPLIFY\fR بخش preamble دست‌نخورده باقی می‌ماند.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-a\fR یا \fB\-\-accept\fR" 4
.IX Item "-a or --accept"
اجرا در حالت \fIACCEPT\fR (حذف تمام بلوک‌های نشانه‌گذاری‌شده با \f(CW\*(C`\eDIFdelbegin\*(C'\fR و \f(CW\*(C`\eDIFdelend\*(C'\fR).
.IP "\fB\-d\fR یا \fB\-\-decline\fR" 4
.IX Item "-d or --decline"
اجرا در حالت \fIDECLINE\fR (حذف تمام بلوک‌های نشانه‌گذاری‌شده با \f(CW\*(C`\eDIFaddbegin\*(C'\fR و \f(CW\*(C`\eDIFaddend\*(C'\fR).
.IP "\fB\-s\fR یا \fB\-\-simplify\fR" 4
.IX Item "-s or --simplify"
اجرا در حالت \fISIMPLIFY\fR (نگه‌داشتن تمام نشانه‌های \f(CW\*(C`\eDIFaddbegin\*(C'\fR، \f(CW\*(C`\eDIFaddend\*(C'\fR، \&\f(CW\*(C`\eDIFdelbegin\*(C'\fR و \f(CW\*(C`\eDIFdelend\*(C'\fR، اما حذف سایر نشانه‌گذاری‌های latexdiff از بدنه).
.PP
توجه داشته باشید که این سه گزینه حالت مانعة‌الجمع هستند. اگر هیچ گزینه حالتی تعیین نشود، \&\fIlatexrevise\fR صرفاً یادداشت‌ها و نشانه‌گذاری‌های کاربر را بر اساس چهار گزینه زیر حذف می‌کند. این قابلیت‌ها در خارج از چارچوب latexdiff نیز می‌توانند بسیار مفید باشند.
.IP "\fB\-c cmd\fR یا \fB\-\-comment=cmd\fR" 4
.IX Item "-c cmd or --comment=cmd"
حذف توالی‌های \f(CW\*(C`\ecmd{...}\*(C'\fR. شناسه \f(CW\*(C`cmd\*(C'\fR قرار است یادداشت‌های صریحی را مشخص کند که باید پیش از انتشار نهایی، از فایل حذف شوند.
.IP "\fB\-e envir\fR یا \fB\-\-comment\-environment=envir\fR" 4
.IX Item "-e envir or --comment-environment=envir"
حذف محیط‌های یادداشت صریح از متن، یعنی حذف بلوک‌های:
.Sp
.Vb 3
\&            \ebegin{envir}
\&            ...
\&            \eend{envir}
.Ve
.Sp
از متن فایل.
.IP "\fB\-m cmd\fR یا \fB\-\-markup=cmd\fR" 4
.IX Item "-m cmd or --markup=cmd"
حذف دستور نشانه‌گذاری \f(CW\*(C`\ecmd\*(C'\fR در عین باقی گذاشتن آرگومان آن؛ یعنی تبدیل \f(CW\*(C`\ecmd{abc}\*(C'\fR به \f(CW\*(C`abc\*(C'\fR.
.IP "\fB\-n envir\fR یا \fB\-\-markup\-environment=envir\fR" 4
.IX Item "-n envir or --markup-environment=envir"
به طور مشابه، حذف دستورهای \f(CW\*(C`\ebegin{envir}\*(C'\fR و \f(CW\*(C`\eend{envir}\*(C'\fR در عین باقی گذاشتن محتوای آن محیط در متن.
.IP "\fB\-r cmd\fR یا \fB\-\-replace=cmd\fR" 4
.IX Item "-r cmd or --replace=cmd"
برای ساختارهای \f(CW\*(C`\e\ecmd{..}{..}\*(C'\fR، دستور را حذف می‌کند، محتوای اولین آرگومان را نگه می‌دارد و آرگومان دوم را پاک می‌کند؛ یعنی تبدیل \&\f(CW\*(C`\ecmd{abc}{def}\*(C'\fR به \f(CW\*(C`abc\*(C'\fR.
.IP "\fB\-V\fR یا \fB\-\-verbose\fR" 4
.IX Item "-V or --verbose"
خروجی پرگو با جزئیات کامل
.IP "\fB\-q\fR یا \fB\-\-no\-warnings\fR" 4
.IX Item "-q or --no-warnings"
هشدار ندادن به کاربران درباره عبارات \f(CW\*(C`\eDIDadd{..}\*(C'\fR یا \f(CW\*(C`\eDIFdel{..}\*(C'\fR که باید تا الان حذف شده باشند.
.SH "گزارش باگ‌ها (BUGS)"
.IX Header "BUGS"
نسخه فعلی یک نسخه بتا است که هنوز به‌طور گسترده آزمایش نشده است. این برنامه به‌صورت فعال نگهداری نشده است، بنابراین ممکن است خروجی نسخه‌های جدیدتر latexdiff را کاملاً درست پردازش نکند.
لطفاً گزارش‌های باگ را با استفاده از سامانه پیگیری اشکالات (issue tracker) در صفحه مخزن گیت‌هاب \fIhttps://github.com/ftilmann/latexdiff.git\fR ارسال کنید یا آن‌ها را به \fItilmann \-\- AT \-\- gfz\-potsdam.de\fR بفرستید. شماره سریال \fIlatexrevise\fR (گزینه \-\-version) را نیز لحاظ نمایید. اگر با خروجی‌ای از latexdiff مواجه شدید که به‌درستی توسط \fIlatexrevise\fR پردازش نمی‌شود، لطفاً فایل مشکل‌دار و همچنین فایل‌های قدیمی و جدیدی را که این فایل بر اساس آن‌ها ساخته شده است ضمیمه کنید؛ ترجیحاً طوری ویرایش شوند که تا جای ممکن فقط شامل بخش دارای اشکال باشند به شرطی که همچنان مشکل را بازتولید کنند.
.PP
توجه داشته باشید که عبارات کامنت‌شدهٔ \f(CW\*(C`\ebegin{document}\*(C'\fR یا \&\f(CW\*(C`\eend{document}\*(C'\fR ممکن است باعث سردرگمی \fIlatexrevise\fR شوند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
latexdiff
.SH "سازگاری (PORTABILITY)"
.IX Header "PORTABILITY"
دستور \&\fIlatexrevise\fR از هیچ دستور خارجی استفاده نمی‌کند و بنابراین باید روی هر پلتفرمی که از PERL نسخه ۵ یا بالاتر پشتیبانی می‌کند اجرا شود.
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
کپی‌رایت (C) 2004 Frederik Tilmann
.PP
این برنامه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) نسخه ۳ بازتوزیع کرده یا تغییر دهید.