.\" -*- 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 "LATEXDIFF 1"
.TH LATEXDIFF 1 2025-12-30 "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)"
latexdiff \- تشخیص و نشانه‌گذاری تفاوت‌های بین دو فایل LaTeX
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBlatexdiff\fR [ \fBOPTIONS\fR ] \fIold.tex\fR \fInew.tex\fR > \fIdiff.tex\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
به‌طور خلاصه، \fIlatexdiff\fR یک ابزار کاربردی برای کمک به مدیریت ویرایش‌ها و نسخه‌های اسناد LaTeX است. این ابزار دو فایل معتبر LaTeX، که در اینجا \f(CW\*(C`old.tex\*(C'\fR و \f(CW\*(C`new.tex\*(C'\fR نامیده می‌شوند را با یکدیگر مقایسه می‌کند، تفاوت‌های معنادار میان آن‌ها را می‌یابد (یعنی نادیده گرفتن تعداد فاصله‌ها و موقعیت شکستگی خطوط)، و دستورات ویژه‌ای را برای برجسته‌سازی تفاوت‌ها می‌افزاید. در جایی که برجسته‌سازی بصری ممکن نیست، برای مثال در تغییرات قالب‌بندی، تفاوت‌ها همچنان در کد منبع نشانه‌گذاری می‌شوند. توجه داشته باشید که old.tex و new.tex باید فایل‌های واقعی باشند (نه pipe یا موارد مشابه)، زیرا دو بار باز می‌شوند (مگر اینکه از گزینهٔ \f(CW\*(C`\-\-encoding\*(C'\fR استفاده شود).
.PP
این برنامه با دیباچه (preamble) به شکلی متفاوت از بدنهٔ اصلی سند رفتار می‌کند. تفاوت‌های بین دیباچه‌ها با استفاده از مقایسهٔ خط‌به‌خط (مشابه دستور diff در Unix، اما با نادیده گرفتن فاصله‌ها) مشخص می‌شوند. یک کامنت، «\f(CW\*(C`%DIF\ >\*(C'\fR» به هر خط اضافه‌شده ملحق می‌شود، یعنی خطی که در \f(CW\*(C`new.tex\*(C'\fR وجود دارد اما در \f(CW\*(C`old.tex\*(C'\fR نیست. خطوط حذف‌شده با پیشوند «\f(CW\*(C`%DIF\ <\*(C'\fR» غیرفعال می‌شوند. پیش از بلوک‌های تغییریافته، خطوط کامنتی قرار می‌گیرند که اطلاعاتی دربارهٔ شماره خطوط در فایل‌های اصلی ارائه می‌دهند. در مواردی که تفاوت‌ها ناچیز باشند، فایل حاصل \f(CW\*(C`diff.tex\*(C'\fR مشابه \f(CW\*(C`new.tex\*(C'\fR خواهد بود. در پایان دیباچه، تعاریف دستورات نشانه‌گذاری \fIlatexdiff\fR درج می‌شوند. در مقایسهٔ بدنهٔ اصلی متن، \fIlatexdiff\fR تلاش می‌کند تا دستورالعمل‌های زیر را (به ترتیب اولویت) برآورده سازد:
.IP 1. 3
اگر هر دو فایل \f(CW\*(C`old.tex\*(C'\fR و \f(CW\*(C`new.tex\*(C'\fR کدهای معتبر LaTeX باشند، فایل حاصل \f(CW\*(C`diff.tex\*(C'\fR نیز باید یک LaTeX معتبر باشد. (توجه: اگر چند دستور سادهٔ plain TeX در \f(CW\*(C`old.tex\*(C'\fR یا \f(CW\*(C`new.tex\*(C'\fR به کار رفته باشد، کارکرد درست \f(CW\*(C`diff.tex\*(C'\fR تضمین نمی‌شود، اما معمولاً کار خواهد کرد).
.IP 2. 3
تفاوت‌های معنادار در سطح کلمات جداگانه تعیین می‌شوند. تمامی تفاوت‌های معنادار، از جمله تفاوت‌های میان کامنت‌ها، باید به وضوح در کد منبع حاصل \f(CW\*(C`diff.tex\*(C'\fR نشانه‌گذاری شوند.
.IP 3. 3
اگر بخشی تغییریافته شامل متن یا دستورات تولیدکنندهٔ متن باشد، اجرای \f(CW\*(C`diff.tex\*(C'\fR با LaTeX باید خروجی‌ای تولید کند که در آن بخش‌های اضافه‌شده و حذف‌شده برجسته شده باشند.
.IP 4. 3
در جایی که تفاوت‌های ناچیز وجود دارد، مثلاً در موقعیت شکستگی خطوط، \f(CW\*(C`diff.tex\*(C'\fR باید از قالب‌بندی \f(CW\*(C`new.tex\*(C'\fR پیروی کند.
.PP
برای مقایسه، همان الگوریتمِ \fIdiff\fR استفاده می‌شود اما به جای خطوط، کلمات مقایسه می‌شوند. تلاشی صورت می‌گیرد تا بلوک‌هایی که کاملاً تغییر کرده‌اند شناسایی شوند تا بتوان آن‌ها را به عنوان یک واحد نشانه‌گذاری کرد. کامنت‌ها خط به خط مقایسه می‌شوند اما تعداد فاصله‌ها در کامنت‌ها نادیده گرفته می‌شود. دستورات به همراه تمام آرگومان‌هایشان معمولاً به عنوان یک واحد مقایسه می‌شوند، یعنی هیچ نشانه‌گذاری در آرگومان‌های دستورات درج نمی‌شود. با این حال، برای تعداد مشخصی از دستورات (به عنوان مثال، \f(CW\*(C`\ecaption\*(C'\fR و تمامی دستورات بخش‌بندی) مشخص است که آرگومان آخر متن است. این متن به کلمات تقسیم شده و دقیقاً مانند متن عادی مقایسه می‌شود (برای نمایش و تغییر فهرست دستورات متنی، از گزینه‌ها استفاده کنید، پایین‌تر را ببینید). از آنجا که این الگوریتم دانش عمیقی از LaTeX ندارد، فرض می‌کند هر جفت آکولاد که بلافاصله پس از یک دستور می‌آید (یعنی دنباله‌ای از حروف که با بک‌اسلش شروع می‌شود) آرگومان‌های آن دستور هستند. به عنوان محدودیتی برای شرط ۱ در بالا، بنابراین لازم است تمام آرگومان‌ها با آکولاد احاطه شوند و فاصله‌های اضافی درج نشود. به عنوان مثال بنویسید:
.PP
.Vb 1
\&  \esection{\etextem{This is an emphasized section title}}
.Ve
.PP
و نه
.PP
.Vb 1
\&  \esection {\etextem{This is an emphasized section title}}
.Ve
.PP
یا
.PP
.Vb 1
\&  \esection\etextem{This is an emphasized section title}
.Ve
.PP
اگرچه همهٔ این گونه‌ها برای LaTeX یکسان هستند (اما گزینهٔ \fB\-\-allow\-spaces\fR را ببینید که گونهٔ دوم را مجاز می‌داند).
.PP
برای محیط‌هایی که محتوای آن‌ها با LaTeX استاندارد مطابقت ندارد یا نشانه‌گذاری گرافیکی در آن‌ها منطقی نیست، می‌توان با تنظیم متغیر پیکربندی PICTUREENV که به صورت پیش‌فرض روی محیط‌های \f(CW\*(C`picture\*(C'\fR و \f(CW\*(C`DIFnomarkup\*(C'\fR تنظیم شده است، تمام دستورات نشانه‌گذاری را حذف کرد؛ گزینهٔ \fB\-\-config\fR را ببینید). محیط دوم (\f(CW\*(C`DIFnomarkup\*(C'\fR) می‌تواند برای محافظت از بخش‌هایی از فایل LaTeX استفاده شود که در آن‌ها نشانه‌گذاری به نشانه‌گذاری نامعتبر منجر می‌شود. باید بخش مشکل‌ساز را در هر دو فایل قدیم و جدید با \f(CW\*(C`\ebegin{DIFnomarkup}\*(C'\fR و \f(CW\*(C`\eend{DIFnomarkup}\*(C'\fR احاطه کنید. شما باید این محیط را در دیباچهٔ هر دو سند قدیم و جدید تعریف کنید. ترجیح من این است که آن را به عنوان یک محیط خالی (null-environment) تعریف کنم:
.PP
\&\f(CW\*(C`\enewenvironment{DIFnomarkup}{}{}\*(C'\fR
.PP
اما انتخاب با شماست. هرگونه نشانه‌گذاری در این محیط حذف خواهد شد و عموماً همه‌چیز در داخل محیط، مستقیماً از فایل جدید گرفته می‌شود.
.PP
همچنین مقایسهٔ فایل‌هایی که دیباچه ندارند امکان‌پذیر است. در این حالت، فایل در حالت سند اصلی پردازش می‌شود، اما تعاریف دستورات نشانه‌گذاری درج نمی‌شوند.
.PP
تمامی دستورات نشانه‌گذاریِ درج‌شده توسط \fIlatexdiff\fR با «\f(CW\*(C`\eDIF\*(C'\fR» آغاز می‌شوند. بلوک‌های اضافه‌شده که حاوی کلمات، دستورات یا کامنت‌هایی هستند که در \f(CW\*(C`new.tex\*(C'\fR وجود دارند اما در \f(CW\*(C`old.tex\*(C'\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 علامت‌گذاری می‌گردند. در داخل بلوک‌های اضافه‌شده، تمامی متون به این شکل با \f(CW\*(C`\eDIFadd\*(C'\fR برجسته می‌شوند:
\&\f(CW\*(C`\eDIFadd{Added text block}\*(C'\fR
دستورات برگزیدهٔ «امن» (safe) نیز می‌توانند در این بلوک‌های متنی گنجانده شوند (برای مشاهده و تغییر فهرست دستورات امن از گزینه‌ها استفاده کنید، پایین‌تر را ببینید). تمامی دستورات دیگر و همچنین آکولادهای «{» و «}» هرگز در دامنهٔ \f(CW\*(C`\eDIFadd\*(C'\fR قرار نمی‌گیرند. کامنت‌های اضافه‌شده با قرار دادن پیشوند «\f(CW\*(C`%DIF\ >\ \*(C'\fR» مشخص می‌شوند.
.PP
در داخل بلوک‌های حذف‌شده، متن با \f(CW\*(C`\eDIFdel\*(C'\fR برجسته می‌شود. کامنت‌های حذف‌شده با قرار دادن پیشوند «\f(CW\*(C`%DIF\ <\ \*(C'\fR» مشخص می‌شوند. دستورات غیرامن و آکولادها در داخل بلوک‌های حذف‌شده، با «\f(CW\*(C`%DIFDELCMD\ <\ \*(C'\fR» به صورت کامنت درمی‌آیند..SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.SS "مقدمه (Preamble)"
.IX Subsection "Preamble"
گزینه‌های زیر سبک نشانه‌گذاری بصری را با افزودن تعاریف دستورات مناسب به مقدمه (preamble) مشخص می‌کنند. برای شرح سبک‌های موجود، انتهای این بخش را ببینید.
.IP "\fB\-\-type=markupstyle\fR یا \fB\-t markupstyle\fR" 4
.IX Item "--type=markupstyle or -t markupstyle"
کد مربوط به سبک نشانه‌گذاری انتخاب‌شده را به مقدمه اضافه می‌کند. این گزینه دستورات
\&\f(CW\*(C`\eDIFadd\*(C'\fR و \f(CW\*(C`\eDIFdel\*(C'\fR را تعریف می‌کند.
سبک‌های موجود:
.Sp
\&\f(CW\*(C`UNDERLINE CTRADITIONAL TRADITIONAL CFONT FONTSTRIKE INVISIBLE
CHANGEBAR CCHANGEBAR CULINECHBAR CFONTCHBAR BOLD PDFCOMMENT
LUAUNDERLINE\*(C'\fR
.Sp
[ پیش‌فرض: \f(CW\*(C`UNDERLINE\*(C'\fR ]
.IP "\fB\-\-subtype=markstyle\fR یا \fB\-s markstyle\fR" 4
.IX Item "--subtype=markstyle or -s markstyle"
کد مربوط به سبک انتخاب‌شده برای دستورات علامت‌گذاری پیرامونی (به‌عنوان مثال، برای علامت‌گذاری تغییرات در حاشیه) را به مقدمه اضافه می‌کند. این گزینه دستورات
\&\f(CW\*(C`\eDIFaddbegin\*(C'\fR، \f(CW\*(C`\eDIFaddend\*(C'\fR، \f(CW\*(C`\eDIFdelbegin\*(C'\fR و \f(CW\*(C`\eDIFdelend\*(C'\fR را تعریف می‌کند.
سبک‌های موجود: \f(CW\*(C`SAFE MARGIN COLOR DVIPSCOL  ZLABEL ONLYCHANGEDPAGE (LABEL)*\*(C'\fR
.Sp
[ پیش‌فرض: \f(CW\*(C`SAFE\*(C'\fR ]
* زیرنوع \f(CW\*(C`LABEL\*(C'\fR منسوخ شده است
.IP "\fB\-\-floattype=markstyle\fR یا \fB\-f markstyle\fR" 4
.IX Item "--floattype=markstyle or -f markstyle"
کد مربوط به سبک انتخاب‌شده را به مقدمه اضافه می‌کند تا جایگزین دستورات نشانه‌گذاری و علامت‌گذاری استاندارد درون اشیاء شناور (floats) شود
(به‌عنوان مثال، یادداشت‌های حاشیه‌ای درون شناورها باعث ایجاد خطا می‌شوند، بنابراین نشانه‌گذاری حاشیه‌ای را می‌توان به این صورت غیرفعال کرد). این گزینه تمام
دستورات \&\f(CW\*(C`\eDIF...FL\*(C'\fR را تعریف می‌کند.
سبک‌های موجود: \f(CW\*(C`FLOATSAFE TRADITIONALSAFE IDENTICAL\*(C'\fR
.Sp
[ پیش‌فرض: \f(CW\*(C`FLOATSAFE\*(C'\fR ]
.IP "\fB\-\-encoding=enc\fR یا \fB\-e enc\fR" 4
.IX Item "--encoding=enc or -e enc"
کدگذاری old.tex و new.tex را مشخص می‌کند. کدگذاری‌های متداول عبارت‌اند از:
\&\f(CW\*(C`ascii\*(C'\fR، \f(CW\*(C`utf8\*(C'\fR، \f(CW\*(C`latin1\*(C'\fR، \f(CW\*(C`latin9\*(C'\fR. فهرستی از کدگذاری‌های موجود را می‌توان با اجرای دستور زیر به دست آورد:
.Sp
\&\f(CW\*(C`perl \-MEncode \-e \*(Aqprint join ("\en",Encode\-\*(C'\fRencodings( ":all" )) ;' >
.Sp
اگر از این گزینه استفاده شود، old.tex و new.tex فقط یک‌بار باز می‌شوند.
[کدگذاری پیش‌فرض utf8 است، مگر این‌که در چند خط اول مقدمه فراخوانی \f(CW\*(C`\eusepackage[..]{inputenc}\*(C'\fR وجود داشته باشد که در این صورت کدگذاری انتخاب‌شده توسط این دستور فرض می‌شود. توجه داشته باشید که ASCII (لاتک استاندارد) زیرمجموعه‌ای از utf8 است]
.IP "\fB\-\-preamble=file\fR یا \fB\-p file\fR" 4
.IX Item "--preamble=file or -p file"
به جای تولید مقدمه، فایل را در انتهای مقدمه درج می‌کند. مقدمه باید دستورات زیر را تعریف کند:
\&\f(CW\*(C`\eDIFaddbegin, \eDIFaddend, \eDIFadd{..},
\&\eDIFdelbegin,\eDIFdelend,\eDIFdel{..},\*(C'\fR
و همچنین گونه‌های آن‌ها را برای استفاده درون شناورها:
\&\f(CW\*(C`\eDIFaddbeginFL, \eDIFaddendFL, \eDIFaddFL{..},
\&\eDIFdelbeginFL, \eDIFdelendFL, \eDIFdelFL{..}\*(C'\fR
(در صورت تنظیم این گزینه، گزینه‌های \fB\-t\fR، \fB\-s\fR و \fB\-f\fR نادیده گرفته می‌شوند.)
.IP \fB\-\-packages=pkg1,pkg2,..\fR 4
.IX Item "--packages=pkg1,pkg2,.."
به latexdiff اعلام می‌کند که فایل .tex با بسته‌های بارگذاری‌شده در این فهرست پردازش می‌شود. اگر فایل .tex شامل مقدمه باشد این امر معمولاً لازم نیست، زیرا مقدمه به‌طور خودکار برای یافتن دستورات \f(CW\*(C`\eusepackage\*(C'\fR پویش می‌شود.
استفاده از گزینهٔ \fB\-\-packages\fR پویش خودکار را غیرفعال می‌کند، بنابراین اگر به هر دلیلی نیاز به غیرفعال کردن تجزیهٔ مختص به بسته‌ها باشد، از \fB\-\-packages=none\fR استفاده کنید.
بسته‌های زیر رفتارهای خاصی را فعال می‌کنند:
.RS 4
.ie n .IP """endfloat""" 8
.el .IP \f(CWendfloat\fR 8
.IX Item "endfloat"
اطمینان حاصل می‌کند که \f(CW\*(C`\ebegin{figure}\*(C'\fR و \f(CW\*(C`\eend{figure}\*(C'\fR همیشه به تنهایی در یک خط قرار گیرند.
.ie n .IP """hyperref""" 8
.el .IP \f(CWhyperref\fR 8
.IX Item "hyperref"
نام دستورات \f(CW\*(C`\eDIFadd\*(C'\fR و \f(CW\*(C`\eDIFdel\*(C'\fR را به \f(CW\*(C`\eDIFaddtex\*(C'\fR و \f(CW\*(C`\eDIFdeltex\*(C'\fR تغییر داده و دستورات جدید \f(CW\*(C`\eDIFadd\*(C'\fR و \f(CW\*(C`\eDIFdel\*(C'\fR را تعریف می‌کند، که پوششی برای این دستورات فراهم می‌آورند و از آن‌ها برای متن استفاده می‌کنند اما نه برای دستور تعریف پیوند (جایی که هرگونه نشانه‌گذاری باعث بروز خطا می‌شود).
.ie n .IP """apacite"", ""biblatex""" 8
.el .IP "\f(CWapacite\fR, \f(CWbiblatex\fR" 8
.IX Item "apacite, biblatex"
دستوراتی را که به عنوان دستورات ارجاع شناخته می‌شوند، بازتعریف می‌کند.
.ie n .IP """siunitx""" 8
.el .IP \f(CWsiunitx\fR 8
.IX Item "siunitx"
با \f(CW\*(C`\eSI\*(C'\fR مانند دستورات ارجاع رفتار می‌کند (یعنی در صورتی که سبک نشانه‌گذاری از بستهٔ ulem استفاده کند، آن را با \f(CW\*(C`\embox\*(C'\fR محافظت می‌کند).
.ie n .IP """cleveref""" 8
.el .IP \f(CWcleveref\fR 8
.IX Item "cleveref"
با \f(CW\*(C`\ecref,\eCref\*(C'\fR و غیره مانند دستورات ارجاع رفتار می‌کند (یعنی در صورتی که سبک نشانه‌گذاری از بستهٔ ulem استفاده کند، آن‌ها را با \f(CW\*(C`\embox\*(C'\fR محافظت می‌کند).
.ie n .IP """glossaries""" 8
.el .IP \f(CWglossaries\fR 8
.IX Item "glossaries"
بیشتر دستورات glossaries را به عنوان امن (safe) تعریف می‌کند و در صورت نیاز آن‌ها را با \embox محافظت می‌نماید.
.ie n .IP """mhchem""" 8
.el .IP \f(CWmhchem\fR 8
.IX Item "mhchem"
با \f(CW\*(C`\ece\*(C'\fR به عنوان یک دستور امن رفتار می‌کند، یعنی برجسته خواهد شد (توجه داشته باشید که \f(CW\*(C`\ecee\*(C'\fR در معادلات برجسته نخواهد شد زیرا این امر منجر به خطاهای پردازشی می‌شود).
.ie n .IP """chemformula"" یا ""chemmacros""" 8
.el .IP "\f(CWchemformula\fR یا \f(CWchemmacros\fR" 8
.IX Item "chemformula or chemmacros"
با \f(CW\*(C`\ech\*(C'\fR به عنوان یک دستور امن در خارج از معادلات رفتار می‌کند، یعنی برجسته خواهد شد (توجه داشته باشید که \f(CW\*(C`\ech\*(C'\fR در معادلات برجسته نخواهد شد زیرا منجر به خطاهای پردازشی می‌شود).
.RE
.RS 4
.Sp
[ پیش‌فرض: پویش مقدمه برای یافتن دستورات \f(CW\*(C`\eusepackage\*(C'\fR جهت تعیین بسته‌های بارگذاری‌شده. ]
.RE
.SS "پیکربندی (Configuration)"
.IX Subsection "Configuration"
.IP "\fB\-\-exclude\-safecmd=exclude\-file\fR یا \fB\-A exclude-file\fR یا \fB\-\-exclude\-safecmd=""cmd1,cmd2,...""\fR" 4
.IX Item "--exclude-safecmd=exclude-file or -A exclude-file or --exclude-safecmd=""cmd1,cmd2,..."""
.PD 0
.IP \fB\-\-replace\-safecmd=replace\-file\fR 4
.IX Item "--replace-safecmd=replace-file"
.IP "\fB\-\-append\-safecmd=append\-file\fR یا \fB\-a append-file\fR یا \fB\-\-append\-safecmd=""cmd1,cmd2,...""\fR" 4
.IX Item "--append-safecmd=append-file or -a append-file or --append-safecmd=""cmd1,cmd2,..."""
.PD
حذف، جایگزینی یا افزودن به فهرست عبارت‌های منظم (RegEx) منطبق با دستوراتی که استفاده از آن‌ها در دامنهٔ دستور \f(CW\*(C`\eDIFadd\*(C'\fR یا \f(CW\*(C`\eDIFdel\*(C'\fR امن است. فایل باید در هر خط شامل یک Perl-RegEx باشد (خطوط توضیحات که با # یا % آغاز می‌شوند نادیده گرفته می‌شوند). توجه داشته باشید که عبارت منظم باید با کل نشانک تطبیق یابد، یعنی /^regex$/ به‌طور پیش‌فرض در نظر گرفته می‌شود و «\e» ابتدای دستور در آن گنجانده نمی‌شود.
گزینه‌های \fB\-\-exclude\-safecmd\fR و \fB\-\-append\-safecmd\fR می‌توانند با گزینهٔ \fB\-\-replace\-safecmd\fR ترکیب شوند و می‌توان از آن‌ها به طور مکرر برای افزودن تجمعی به فهرست‌ها استفاده کرد.
\fB\-\-exclude\-safecmd\fR و \fB\-\-append\-safecmd\fR همچنین می‌توانند فهرستی جداشده با کاما را به عنوان ورودی دریافت کنند. اگر برای یکی از عبارت‌های منظم نیاز به کاما باشد، آن را با «\e,» مشخص کنید. در اکثر موارد لازم است فهرست جداشده با کاما با قرار گرفتن درون علامت نقل‌قول از دستکاری پوسته (shell) محافظت شود.
.IP "\fB\-\-exclude\-textcmd=exclude\-file\fR یا \fB\-X exclude-file\fR یا \fB\-\-exclude\-textcmd=""cmd1,cmd2,...""\fR" 4
.IX Item "--exclude-textcmd=exclude-file or -X exclude-file or --exclude-textcmd=""cmd1,cmd2,..."""
.PD 0
.IP \fB\-\-replace\-textcmd=replace\-file\fR 4
.IX Item "--replace-textcmd=replace-file"
.IP "\fB\-\-append\-textcmd=append\-file\fR یا \fB\-x append-file\fR یا \fB\-\-append\-textcmd=""cmd1,cmd2,...""\fR" 4
.IX Item "--append-textcmd=append-file or -x append-file or --append-textcmd=""cmd1,cmd2,..."""
.PD
حذف، جایگزینی یا افزودن به فهرست عبارت‌های منظم منطبق با دستوراتی که آخرین آرگومان آن‌ها متن است. برای جزئیات بیشتر ورودی مربوط به \fB\-\-exclude\-safecmd\fR را دقیقاً در بالا ببینید.
.IP \fB\-\-replace\-context1cmd=replace\-file\fR 4
.IX Item "--replace-context1cmd=replace-file"
.PD 0
.IP "\fB\-\-append\-context1cmd=append\-file\fR یا" 4
.IX Item "--append-context1cmd=append-file or"
.IP "\fB\-\-append\-context1cmd=""cmd1,cmd2,...""\fR" 4
.IX Item "--append-context1cmd=""cmd1,cmd2,..."""
.PD
جایگزینی یا افزودن به فهرست عبارات منظم منطبق با دستوراتی که آخرین آرگومان آن‌ها متن است اما برای کارکرد به بافت خاصی نیاز دارند، به عنوان مثال \f(CW\*(C`\ecaption\*(C'\fR تنها درون شکل (figure) یا جدول کار خواهد کرد. این دستورات مانند دستورات متنی رفتار می‌کنند، مگر زمانی که در یک بخش حذف‌شده ظاهر شوند؛ در این صورت غیرفعال می‌شوند اما آرگومان آن‌ها به صورت متن حذف‌شده نمایش داده می‌شود.
.IP \fB\-\-replace\-context2cmd=replace\-file\fR 4
.IX Item "--replace-context2cmd=replace-file"
.PD 0
.IP "\fB\-\-append\-context2cmd=append\-file\fR یا" 4
.IX Item "--append-context2cmd=append-file or"
.IP "\fB\-\-append\-context2cmd=""cmd1,cmd2,...""\fR" 4
.IX Item "--append-context2cmd=""cmd1,cmd2,..."""
.PD
همانند دستورات متناظر برای context1. تنها تفاوت این است که دستورات context2 در بخش‌های حذف‌شده به‌طور کامل غیرفعال می‌شوند، از جمله آرگومان‌های آن‌ها.
.Sp
دستورات context2 همچنین تنها دستوراتی در مقدمه هستند که آرگومان آن‌ها در حالت کلمه‌به‌کلمه پردازش خواهد شد (که فقط در صورتی کار می‌کند که بیش از یک‌بار در مقدمه ظاهر نشوند). این الگوریتم در حال حاضر نمی‌تواند با دستورات تکراری context2 در مقدمه سازگار شود، مانند آنچه برای نمونه برای آرگومان \f(CW\*(C`\eauthor\*(C'\fR در برخی از سبک‌های ژورنال‌ها رخ می‌دهد (البته در سبک‌های استاندارد رخ نمی‌دهد).
اگر چنین تکراری شناسایی شود، کل مقدمه در حالت خط‌به‌خط پردازش خواهد شد. در چنین حالتی، از گزینهٔ \f(CW\*(C`\-\-replace\-context2cmd\*(C'\fR استفاده کنید تا فقط دستوراتی انتخاب شوند که باید پردازش گردند و در مقدمه مکرراً استفاده نشده‌اند.
.IP "\fB\-\-exclude\-mboxsafecmd=exclude\-file\fR یا \fB\-\-exclude\-mboxsafecmd=""cmd1,cmd2,...""\fR" 4
.IX Item "--exclude-mboxsafecmd=exclude-file or --exclude-mboxsafecmd=""cmd1,cmd2,..."""
.PD 0
.IP "\fB\-\-append\-mboxsafecmd=append\-file\fR یا \fB\-\-append\-mboxsafecmd=""cmd1,cmd2,...""\fR" 4
.IX Item "--append-mboxsafecmd=append-file or --append-mboxsafecmd=""cmd1,cmd2,..."""
.PD
تعریف دستورات امن، که علاوه بر این نیاز دارند تا با کپسوله‌سازی در یک \f(CW\*(C`\embox{..}\*(C'\fR محافظت شوند. این امر گاهی برای دور زدن ناسازگاری‌های بین بسته‌های خارجی و بستهٔ ulem لازم است؛ بسته‌ای که برای برجسته‌سازی در سبک پیش‌فرض UNDERLINE و همچنین CULINECHBAR و CFONTSTRIKE استفاده می‌شود.
.IP "\fB\-\-config var1=val1,var2=val2,...\fR یا \fB\-c var1=val1,..\fR" 4
.IX Item "--config var1=val1,var2=val2,... or -c var1=val1,.."
.PD 0
.IP "\fB\-c configfile\fR" 4
.IX Item "-c configfile"
.PD
تنظیم متغیرهای پیکربندی. این گزینه می‌تواند برای تنظیم متغیرهای مختلف تکرار شود (به عنوان جایگزینی برای فهرست جداشده با کاما).
متغیرهای موجود (برای توضیحات بیشتر به بخش زیر مراجعه کنید):
.Sp
\&\f(CW\*(C`ARRENV\*(C'\fR (RegEx)
.Sp
\&\f(CW\*(C`COUNTERCMD\*(C'\fR (RegEx)
.Sp
\&\f(CW\*(C`CUSTODIFCMD\*(C'\fR (RegEx)
.Sp
\&\f(CW\*(C`FLOATENV\*(C'\fR (RegEx)
.Sp
\&\f(CW\*(C`ITEMCMD\*(C'\fR (RegEx)
.Sp
\&\f(CW\*(C`LISTENV\*(C'\fR  (RegEx)
.Sp
\&\f(CW\*(C`MATHARRENV\*(C'\fR (RegEx)
.Sp
\&\f(CW\*(C`MATHENV\*(C'\fR (RegEx)
.Sp
\&\f(CW\*(C`MATHREPL\*(C'\fR (String)
.Sp
\&\f(CW\*(C`MAXCHANGESLETTER\*(C'\fR (Integer)
.Sp
\&\f(CW\*(C`MINWORDSBLOCK\*(C'\fR (Integer)
.Sp
\&\f(CW\*(C`PICTUREENV\*(C'\fR (RegEx)
.Sp
\&\f(CW\*(C`SCALEDELGRAPHICS\*(C'\fR (Float).IP "\fB\-\-add\-to\-config varenv1=pattern1,varenv2=pattern2,...\fR" 4
.IX Item "--add-to-config varenv1=pattern1,varenv2=pattern2,..."
برای متغیرهای پیکربندی که یک عبارت باقاعده (regular expression) هستند (اساساً آن‌هایی که به ENV، COUNTERCMD و CUSTOMDIFCMD ختم می‌شوند، فهرست بالا را ببینید)، این گزینه روشی جایگزین برای تغییر متغیرهای پیکربندی فراهم می‌کند. به جای تعیین الگوی کامل، با این گزینه می‌توان یک الگوی جایگزین اضافه کرد. \f(CW\*(C`varenv\*(C'\fR باید یکی از متغیرهای فهرست‌شده در بالا باشد که عبارت باقاعده را به عنوان آرگومان می‌پذیرد، و pattern هر عبارت باقاعده‌ای است (که ممکن است نیاز باشد با نقل‌قول در برابر پوسته محافظت شود). با استفاده از نقطه‌ویرگول (;) می‌توان چندین الگو را به طور همزمان اضافه کرد، مانند: \f(CW\*(C`\-\-add\-to\-config "LISTENV=myitemize;myenumerate,COUNTERCMD=endnote"\*(C'\fR
.IP \fB\-\-show\-preamble\fR 4
.IX Item "--show-preamble"
چاپ دستورهای دیباچه (preamble) تولیدشده یا گنجانده‌شده.
.IP \fB\-\-show\-safecmd\fR 4
.IX Item "--show-safecmd"
چاپ فهرست RegEx برای تطابق و استثنا کردن دستورهای امن (safe commands).
.IP \fB\-\-show\-textcmd\fR 4
.IX Item "--show-textcmd"
چاپ فهرست RegEx برای تطابق و استثنا کردن دستورها با آرگومان متنی.
.IP \fB\-\-show\-config\fR 4
.IX Item "--show-config"
نمایش مقدارهای متغیرهای پیکربندی.
.IP \fB\-\-show\-all\fR 4
.IX Item "--show-all"
ترکیب کردن همهٔ دستورهای \-\-show.
.Sp
توجه: برای همهٔ دستورهای \-\-show، رفتار برنامه بسته به اینکه آیا فایل‌های \f(CW\*(C`old.tex\*(C'\fR یا \f(CW\*(C`new.tex\*(C'\fR مشخص شده باشند متفاوت است. اگر مشخص نشده باشند، پیکربندی اولیه نمایش داده می‌شود. اگر مشخص شده باشند، پیکربندی کامل نشان داده می‌شود که شامل برخی افزوده‌های دستورهای داخلی و تغییرات بر اساس بسته‌های موجود در سیستم یا استفاده‌شده در فایل‌های .tex است. در هر دو حالت، هیچ تفاضل‌گیری (differencing) انجام نمی‌شود.
.SS "سایر گزینه‌های پیکربندی (Other configuration options):"
.IX Subsection "Other configuration options:"
.IP \fB\-\-allow\-spaces\fR 4
.IX Item "--allow-spaces"
مجاز دانستن فاصله (space) میان آرگومان‌های درون قلاب یا آکولاد دستورها. توجه داشته باشید که این گزینه ممکن است اثرات جانبی نامطلوبی داشته باشد (محدودهٔ نامرتبط ممکن است با دستورهای پیشین یکی شود)، بنابراین تنها در صورتی باید استفاده شود که حالت پیش‌فرض نتایج نادرستی ایجاد کند. (در حالت پیش‌فرض لازم است آرگومان‌ها مستقیماً و بدون فواصل میانی به دنبال یکدیگر بیایند).
.IP \fB\-\-math\-markup=level\fR 4
.IX Item "--math-markup=level"
تعیین میزان دانه‌بندی (granularity) نشانه‌گذاری در محیط‌های ریاضیاتی نمایش‌یافته:
مقدارهای ممکن برای level عبارتند از (هر دو برچسب عددی و متنی پذیرفته می‌شوند):
.Sp
\&\f(CW\*(C`off\*(C'\fR یا \f(CW0\fR: غیرفعال کردن نشانه‌گذاری برای محیط‌های ریاضی. معادلات حذف‌شده در فایل diff نمایش داده نخواهند شد. این حالت زمانی کاربرد دارد که تمامی حالت‌های دیگر منجر به کد نامعتبر latex شوند.
.Sp
\&\f(CW\*(C`whole\*(C'\fR یا \f(CW1\fR: تفاضل‌گیری در سطح کل معادلات. حتی تغییرات جزئی در معادلات باعث می‌شود کل معادله به عنوان تغییریافته علامت‌گذاری شود. این حالت را می‌توان زمانی استفاده کرد که پردازش در حالت coarse یا fine به کد نامعتبر latex بیانجامد.
.Sp
\&\f(CW\*(C`coarse\*(C'\fR یا \f(CW2\fR: تشخیص تغییرات درون معادلات با دانه‌بندی درشت؛ تغییرات در نوع معادله (مانند displaymath به equation) به عنوان تغییر در کل معادله ظاهر می‌شود. این حالت برای شرایطی توصیه می‌شود که محتوا و ترتیب برخی معادلات همچنان در حال تغییر است. [پیش‌فرض]
.Sp
\&\f(CW\*(C`fine\*(C'\fR یا \f(CW3\fR: تشخیص تغییرات کوچک در معادلات و نشانه‌گذاری با دانه‌بندی ریز. این حالت زمانی مناسب‌تر است که تنها تغییرات جزئی در معادلات مورد انتظار باشد، مانند اصلاح غلط‌های تایپی.
.IP \fB\-\-graphics\-markup=level\fR 4
.IX Item "--graphics-markup=level"
.Vb 1
\& تغییر سبک برجسته‌سازی برای تصاویر و گرافیک‌های جای‌گذاری‌شده با دستورهای C<\eincludegraphics>.
.Ve
.Sp
مقدارهای ممکن برای level:
.Sp
\&\f(CW\*(C`none\*(C'\fR، \f(CW\*(C`off\*(C'\fR یا \f(CW0\fR: بدون برجسته‌سازی برای شکل‌ها
.Sp
\&\f(CW\*(C`new\-only\*(C'\fR یا \f(CW1\fR: احاطه کردن شکل‌های تازه اضافه‌شده یا تغییریافته با یک کادر آبی [پیش‌فرض در صورت بارگذاری بستهٔ graphicx]
.Sp
\&\f(CW\*(C`both\*(C'\fR یا \f(CW2\fR:     برجسته‌سازی شکل‌های جدید با کادر آبی و نمایش شکل‌های حذف‌شده با مقیاس کوچک‌تر و خط‌خورده با یک ضربدر مورب قرمز. برای تنظیم اندازهٔ شکل‌های حذف‌شده از متغیر پیکربندی SCALEDELGRAPHICS استفاده کنید.
.Sp
توجه داشته باشید که تغییر در پارامترهای اختیاری باعث می‌شود شکل برای latexdiff به عنوان تغییریافته شناخته شود و در نتیجه برجسته خواهد شد.
.Sp
در برخی شرایط، در صورت وجود انواع خاصی از تغییرات در جدول‌ها، ممکن است خطای "Misplaced \enoalign" رخ دهد. در این حالت لطفاً از \f(CW\*(C`\-\-graphics\-markup=none\*(C'\fR به عنوان راهکار موقت استفاده کنید.
.IP \fB\-\-no\-del\fR 4
.IX Item "--no-del"
حذف متن پاک‌شده از خروجی diff. این گزینه از نظر اثرگذاری مشابه سبک BOLD است، اما متن حذف‌شده فقط در خروجی نامرئی نمی‌شود، بلکه در فایل متنی diff نیز گنجانده نمی‌شود. این کار می‌تواند مطمئن‌تر از نامرئی کردن صرف آن باشد.
.IP "\fB\-\-disable\-citation\-markup\fR یا \fB\-\-disable\-auto\-mbox\fR" 4
.IX Item "--disable-citation-markup or --disable-auto-mbox"
غیرفعال کردن نشانه‌گذاری ارجاع‌ها (citation) و نشانه‌گذاری سایر دستورهای آسیب‌پذیر در سبک‌هایی که از ulem استفاده می‌کنند (UNDERLINE، FONTSTRIKE، CULINECHBAR)
(این دو گزینه یکسان بوده و صرفاً نام مستعار یکدیگر هستند)
.IP "\fB\-\-enable\-citation\-markup\fR یا \fB\-\-enforce\-auto\-mbox\fR" 4
.IX Item "--enable-citation-markup or --enforce-auto-mbox"
محافظت از دستورهای ارجاع و سایر دستورهای آسیب‌پذیر در بخش‌های تغییریافته با استفاده از دستور \f(CW\*(C`\embox\*(C'\fR، یعنی استفاده از رفتار پیش‌فرض بستهٔ ulem برای سایر بسته‌ها
(این دو گزینه یکسان بوده و صرفاً نام مستعار یکدیگر هستند)
.SS "متفرقه (Miscellaneous)"
.IX Subsection "Miscellaneous"
.IP "\fB\-\-verbose\fR یا \fB\-V\fR" 4
.IX Item "--verbose or -V"
ارسال اطلاعات وضعیت گوناگون به stderr هنگام پردازش.
حالت پیش‌فرض، اجرای بی‌صدا است.
.IP \fB\-\-driver=type\fR 4
.IX Item "--driver=type"
انتخاب درایور برای بستهٔ changebar (تنها برای سبک‌هایی که از changebar استفاده می‌کنند مرتبط است: CCHANGEBAR ،CFONTCHBAR ،CULINECHBAR ،CHANGEBAR). درایورهای ممکن در راهنمای changebar فهرست شده‌اند، مانند pdftex، dvips، dvitops
[پیش‌فرض: pdftex]
.IP \fB\-\-ignore\-warnings\fR 4
.IX Item "--ignore-warnings"
نادیده گرفتن هشدارهای مربوط به ناهمخوانی طول بین رشته‌های ورودی و تجزیه‌شده و نویسه‌های مفقود. این پیام‌های هشدار اغلب مربوط به کدهای غیراستاندارد latex یا ساختارهای ترکیبی با نحو ناشناخته برای \f(CW\*(C`latexdiff\*(C'\fR هستند، اما تفاوت نهایی حاصل در هر صورت اغلب کاملاً کاربردی است، به ویژه اگر کدهای غیراستاندارد latex تنها در بخش‌هایی از متن رخ داده باشند که تغییر نکرده‌اند.
.IP "\fB\-\-label=label\fR یا \fB\-L label\fR" 4
.IX Item "--label=label or -L label"
تنظیم برچسب‌های مورد استفاده برای توصیف فایل‌های قدیمی و جدید. اولین استفاده از این گزینه، برچسب توصیف‌کنندهٔ فایل قدیمی و دومین استفاده، برچسب فایل جدید را تنظیم می‌کند؛ یعنی هر دو برچسب را به این صورت تعیین کنید: \f(CW\*(C`\-L labelold \-L labelnew\*(C'\fR.
[پیش‌فرض: استفاده از نام فایل و تاریخ ویرایش برای برچسب]
.IP \fB\-\-no\-label\fR 4
.IX Item "--no-label"
جلوگیری از درج نام فایل‌های قدیمی و جدید به عنوان یادداشت (کامنت) در فایل خروجی.
.IP \fB\-\-visible\-label\fR 4
.IX Item "--visible-label"
گنجاندن نام فایل‌های قدیمی و جدید (یا برچسب‌های تنظیم‌شده با گزینهٔ \f(CW\*(C`\-\-label\*(C'\fR) به عنوان خروجی قابل رؤیت.
.IP \fB\-\-flatten\fR 4
.IX Item "--flatten"
جایگزین کردن دستورهای \f(CW\*(C`\einput\*(C'\fR و \f(CW\*(C`\einclude\*(C'\fR درون بدنه با محتوای فایل‌های مشخص‌شده در آرگومان آن‌ها. اگر \f(CW\*(C`\eincludeonly\*(C'\fR در دیباچه (preamble) وجود داشته باشد، تنها آن فایل‌ها در سند بسط داده می‌شوند. با این حال، بازگشت (recursion) انجام نمی‌شود؛ یعنی دستورهای \f(CW\*(C`\einput\*(C'\fR و \f(CW\*(C`\einclude\*(C'\fR درون بخش‌های گنجانده‌شده بسط نمی‌یابند. فرض بر این است که فایل‌های گنجانده‌شده به ترتیب در همان دایرکتوری‌های فایل‌های اصلی قدیمی و جدید قرار دارند و امکان سازماندهی فایل‌ها در دایرکتوری‌های قدیمی و جدید را فراهم می‌سازند. گزینهٔ \-\-flatten به صورت بازگشتی اعمال می‌شود، بنابراین فایل‌های واردشده می‌توانند حاوی دستورهای \f(CW\*(C`\einput\*(C'\fR بیشتری باشند. همچنین فایل‌های گنجانده‌شده با بستهٔ import (\f(CW\*(C`\eimport\*(C'\fR و \f(CW\*(C`\esubimport\*(C'\fR) و دستور \f(CW\*(C`\esubfile\*(C'\fR را نیز مدیریت می‌کند.
.Sp
استفاده از این گزینه ممکن است باعث افزایش چشمگیر زمان پردازش برای اسناد بزرگ‌تر شود، و سند تفاوت حاصل دیگر ساختار اسناد ورودی را بازتاب نخواهد داد.
.IP \fB\-\-filter\-script=filterscript\fR 4
.IX Item "--filter-script=filterscript"
عبور دادن فایل‌ها از این اسکریپت پالایه (filterscript - مسیر کامل ترجیح داده می‌شود) پیش از پردازش. اسکریپت پالایه باید ورودی را از STDIN دریافت کرده و خروجی را به STDOUT ارسال کند. هنگامی که با \-\-flatten ترکیب شود، هر فایل به محض فراخوانی از پالایه عبور داده خواهد شد.
.IP \fB\-\-ignore\-filter\-stderr\fR 4
.IX Item "--ignore-filter-stderr"
هنگام اجرا با \-\-filter\-script، ممکن است پیام‌های STDERR از طرف اسکریپت باعث کاهش خوانایی شوند. این پرچم را فعال کنید تا از STDERR اسکریپت پالایه چشم‌پوشی شود.
.IP "\fB\-\-help\fR یا \fB\-h\fR" 4
.IX Item "--help or -h"
نمایش متن راهنما
.IP \fB\-\-version\fR 4
.IX Item "--version"
نمایش شمارهٔ نسخه.SS "گزینه‌های داخلی (Internal options)"
.IX Subsection "Internal options"
این گزینه‌ها عمدتاً برای استفادهٔ خودکار توسط latexdiff-vc هستند. می‌توان آن‌ها را مستقیماً نیز به کار برد، اما رابط برنامه‌نویسی (API) آن‌ها نسبت به سایر گزینه‌ها ناپایدارتر تلقی می‌شود.
.IP \fB\-\-no\-links\fR 4
.IX Item "--no-links"
جلوگیری از ایجاد پیوندهای ارجاعی (hyperreference)، مورد استفاده برای تفاضل‌های کمینه (گزینهٔ \-\-only\-changes در latexdiff-vc).
.SS "سبک‌های از پیش‌تعریف‌شده (Predefined styles)"
.IX Subsection "Predefined styles"
.SS "انواع اصلی (Major types)"
.IX Subsection "Major types"
نوع اصلی، نشانه‌گذاری متن ساده و برخی از دستورهای لاتک برگزیده در خارج از شناورها را با تعریف دستورهای نشانه‌گذاری \f(CW\*(C`\eDIFadd{...}\*(C'\fR و \f(CW\*(C`\eDIFdel{...}\*(C'\fR تعیین می‌کند.
.ie n .IP """UNDERLINE""" 10
.el .IP \f(CWUNDERLINE\fR 10
.IX Item "UNDERLINE"
متن افزوده‌شده با خط موج‌دار زیرخط‌دار و آبی‌رنگ می‌شود، متن حذف‌شده خط‌خورده و قرمز خواهد بود (نیازمند بسته‌های color و ulem). خط زدن روی متن (Overstriking) در معادلات ریاضی نمایشی (displayed math) کار نمی‌کند، به‌گونه‌ای که بخش‌های حذف‌شدهٔ معادله به‌جای خط خوردن، زیرخط‌دار می‌شوند (این یک نقص ذاتی در بستهٔ ulem است).
.ie n .IP """LUAUNDERLINE""" 10
.el .IP \f(CWLUAUNDERLINE\fR 10
.IX Item "LUAUNDERLINE"
متن افزوده‌شده زیرخط‌دار و آبی‌رنگ، و متن حذف‌شده خط‌خورده و قرمز خواهد بود (نیازمند بستهٔ lua-ul به‌همراه LuaLaTeX).
.ie n .IP """CTRADITIONAL""" 10
.el .IP \f(CWCTRADITIONAL\fR 10
.IX Item "CTRADITIONAL"
متن افزوده‌شده آبی‌رنگ و با قلم بدون‌سریف (sans-serif) است، و برای هر بخش از متن حذف‌شده یک پاورقی قرمز ایجاد می‌شود (نیازمند بستهٔ color).
.ie n .IP """TRADITIONAL""" 10
.el .IP \f(CWTRADITIONAL\fR 10
.IX Item "TRADITIONAL"
مانند \f(CW\*(C`CTRADITIONAL\*(C'\fR اما بدون استفاده از رنگ.
.ie n .IP """CFONT""" 10
.el .IP \f(CWCFONT\fR 10
.IX Item "CFONT"
متن افزوده‌شده آبی‌رنگ و با قلم بدون‌سریف بوده، و متن حذف‌شده قرمز و با اندازه‌ای بسیار کوچک است.
.ie n .IP """FONTSTRIKE""" 10
.el .IP \f(CWFONTSTRIKE\fR 10
.IX Item "FONTSTRIKE"
متن افزوده‌شده با قلم بدون‌سریف است، و متن حذف‌شده کوچک و خط‌خورده خواهد بود.
.ie n .IP """CCHANGEBAR""" 10
.el .IP \f(CWCCHANGEBAR\fR 10
.IX Item "CCHANGEBAR"
متن افزوده‌شده آبی‌رنگ، و متن حذف‌شده قرمز است. علاوه بر این، متن تغییریافته با یک خط در حاشیه مشخص می‌شود (نیازمند بسته‌های color و changebar).
.ie n .IP """CFONTCHBAR""" 10
.el .IP \f(CWCFONTCHBAR\fR 10
.IX Item "CFONTCHBAR"
مانند \f(CW\*(C`CFONT\*(C'\fR اما همراه با خطوط حاشیهٔ اضافی (نیازمند بسته‌های color و changebar).
.ie n .IP """CULINECHBAR""" 10
.el .IP \f(CWCULINECHBAR\fR 10
.IX Item "CULINECHBAR"
مانند \f(CW\*(C`UNDERLINE\*(C'\fR اما همراه با خطوط حاشیهٔ اضافی (نیازمند بسته‌های color، ulem و changebar).
.ie n .IP """CHANGEBAR""" 10
.el .IP \f(CWCHANGEBAR\fR 10
.IX Item "CHANGEBAR"
هیچ نشانه‌گذاری روی متن اعمال نمی‌شود، اما حاشیه‌ها با خطوط تغییر نشانه‌گذاری می‌شوند (نیازمند بستهٔ changebar).
.ie n .IP """INVISIBLE""" 10
.el .IP \f(CWINVISIBLE\fR 10
.IX Item "INVISIBLE"
بدون نشانه‌گذاری دیداری (اما دستورهای نشانه‌گذاری عمومی همچنان درج خواهند شد).
.ie n .IP """BOLD""" 10
.el .IP \f(CWBOLD\fR 10
.IX Item "BOLD"
متن افزوده‌شده با قلم پررنگ (bold) مشخص می‌شود، و متن حذف‌شده نمایش داده نمی‌شود (همچنین برای امکانی دیگر جهت پنهان‌سازی متن حذف‌شده، گزینهٔ \-\-no\-del را ببینید).
.ie n .IP """PDFCOMMENT""" 10
.el .IP \f(CWPDFCOMMENT\fR 10
.IX Item "PDFCOMMENT"
از بستهٔ pdfcomment برای زیرخط‌دار کردن متن جدید و مشخص کردن حذفیات با یک یادداشت (comment) در PDF استفاده می‌شود. توجه داشته باشید که این نشانه‌گذاری ممکن است بسته به نمایشگر PDF مورد استفاده، متفاوت دیده شده یا اصلاً نمایش داده نشود. نمایشگری که بهترین پشتیبانی را از نشانه‌گذاری‌های PDF دارد احتمالاً acroread است. این سبک تنها در صورتی توصیه می‌شود که تعداد تفاوت‌ها اندک باشد.
.SS "زیرنوع‌ها (Subtypes)"
.IX Subsection "Subtypes"
زیرنوع دستورهایی را تعریف می‌کند که در آغاز و پایان بلوک‌های افزوده‌شده یا حذف‌شده درج می‌شوند، فارغ از اینکه این بلوک‌ها حاوی متن باشند یا دستور (دستورهای تعریف‌شده: \f(CW\*(C`\eDIFaddbegin, \eDIFaddend, \eDIFdelbegin, \eDIFdelend\*(C'\fR).
.ie n .IP """SAFE""" 10
.el .IP \f(CWSAFE\fR 10
.IX Item "SAFE"
بدون نشانه‌گذاری اضافی (انتخاب توصیه‌شده).
.ie n .IP """MARGIN""" 10
.el .IP \f(CWMARGIN\fR 10
.IX Item "MARGIN"
نشانه‌گذاری آغاز و پایان بلوک‌های تغییریافته با نمادهایی در حاشیهٔ مجاور (با استفاده از دستور استاندارد \f(CW\*(C`\emarginpar\*(C'\fR \- توجه داشته باشید که این دستور گاهی کمی از موقعیت اصلی خود جابه‌جا می‌شود).
.ie n .IP """COLOR""" 10
.el .IP \f(CWCOLOR\fR 10
.IX Item "COLOR"
روشی جایگزین برای نشانه‌گذاری بخش‌های افزوده به رنگ آبی و بخش‌های حذفی به رنگ قرمز (توصیه می‌شود به‌جای این، از انواع اصلی برای اعمال نشانه‌گذاری رنگی استفاده شود، هرچند در برخی موارد رنگ‌آمیزی با dvipscol می‌تواند کامل‌تر باشد، مثلاً برای دستورهای ارجاع).
.ie n .IP """DVIPSCOL""" 10
.el .IP \f(CWDVIPSCOL\fR 10
.IX Item "DVIPSCOL"
روشی جایگزین برای نشانه‌گذاری بخش‌های افزوده به رنگ آبی و بخش‌های حذفی به رنگ قرمز. توجه داشته باشید که \f(CW\*(C`DVIPSCOL\*(C'\fR تنها با مبدل dvips کار می‌کند و مثلاً با pdflatex کار نخواهد کرد (توصیه می‌شود به‌جای این از انواع اصلی برای نشانه‌گذاری رنگی استفاده شود، اگرچه در مواردی رنگ‌آمیزی با dvipscol می‌تواند کامل‌تر باشد).
.ie n .IP """ZLABEL""" 10
.el .IP \f(CWZLABEL\fR 10
.IX Item "ZLABEL"
می‌تواند برای برجسته‌سازی تنها صفحه‌های تغییریافته به کار رود، اما نیازمند پس‌پردازش است. توصیه می‌شود این گزینه را دستی فراخوانی نکنید، بلکه از \f(CW\*(C`latexdiff\-vc\*(C'\fR به همراه گزینهٔ \f(CW\*(C`\-\-only\-changes\*(C'\fR استفاده کنید. در غیر این صورت، از اسکریپت موجود در دیباچهٔ (preamble) فایل‌های diff ساخته‌شده با این سبک استفاده نمایید.
.ie n .IP """ONLYCHANGEDPAGE""" 10
.el .IP \f(CWONLYCHANGEDPAGE\fR 10
.IX Item "ONLYCHANGEDPAGE"
صفحات تغییریافته را بدون نیاز به پس‌پردازش برجسته می‌کند، اما اگر عناصر شناور (شکل‌ها، جدول‌ها) وجود داشته باشند ممکن است عملکرد قابل اعتمادی نداشته باشد.
.ie n .IP """LABEL""" 10
.el .IP \f(CWLABEL\fR 10
.IX Item "LABEL"
مشابه \f(CW\*(C`ZLABEL\*(C'\fR است، اما به بستهٔ zref نیاز ندارد و قابلیت اطمینان آن کمتر است (منسوخ‌شده).
.SS "انواع شناور (Float Types)"
.IX Subsection "Float Types"
برخی از نشانه‌گذاری‌های استفاده‌شده در متن اصلی ممکن است در صورت استفاده در محیط‌های شناور (مانند شکل‌ها یا جدول‌ها) مشکل ایجاد کنند. به همین دلیل نسخه‌های جایگزینی از تمامی دستورهای نشانه‌گذاری در محیط‌های شناور استفاده می‌شود. نوع شناور این دستورهای جایگزین را تعریف می‌کند.
.ie n .IP """FLOATSAFE""" 10
.el .IP \f(CWFLOATSAFE\fR 10
.IX Item "FLOATSAFE"
از همان نشانه‌گذاری متن در بدنهٔ اصلی استفاده می‌کند، اما تمامی دستورهای مشخص‌کنندهٔ آغاز و پایان بلوک‌های تغییریافته را روی دستورهای تهی تنظیم می‌کند. اگر زیرنوع شما \f(CW\*(C`MARGIN\*(C'\fR باشد باید این نوع شناور را انتخاب کنید، زیرا \f(CW\*(C`\emarginpar\*(C'\fR در محیط‌های شناور به‌درستی کار نمی‌کند.
.ie n .IP """TRADITIONALSAFE""" 10
.el .IP \f(CWTRADITIONALSAFE\fR 10
.IX Item "TRADITIONALSAFE"
موارد افزوده را به همان شیوهٔ متن اصلی نشانه‌گذاری می‌کند. محیط‌های حذف‌شده با قلاب‌های شکسته \e[ و \e] مشخص شده و متن حذف‌شده در اندازهٔ scriptscript قرار می‌گیرد. این نوع شناور همیشه باید همراه با انواع نشانه‌گذاری \f(CW\*(C`TRADITIONAL\*(C'\fR و \f(CW\*(C`CTRADITIONAL\*(C'\fR به کار رود، زیرا دستور \efootnote در محیط‌های شناور به‌درستی کار نمی‌کند.
.ie n .IP """IDENTICAL""" 10
.el .IP \f(CWIDENTICAL\fR 10
.IX Item "IDENTICAL"
هیچ تفاوتی میان متن اصلی و محیط‌های شناور قائل نمی‌شود..SS "متغیرهای پیکربندی (Configuration Variables)"
.IX Subsection "Configuration Variables"
.ie n .IP """ARRENV""" 10
.el .IP \f(CWARRENV\fR 10
.IX Item "ARRENV"
اگر تطابقی با \f(CW\*(C`ARRENV\*(C'\fR درون یک محیط ریاضی درون‌خطی در یک بلوک حذف‌شده یا اضافه‌شده یافت شود، آن‌گاه عبارت ریاضی درون‌خطی در میان \f(CW\*(C`\embox{\*(C'\fR...\f(CW\*(C`}\*(C'\fR قرار می‌گیرد. این امر از آنجا ضروری است که خط کشیدن زیر متن (underlining) در محیط‌های آرایه‌ایِ درون‌خطی کار نمی‌کند.
.Sp
[ پیش‌فرض: \f(CW\*(C`ARRENV\*(C'\fR=\f(CW\*(C`(?:array|[pbvBV]matrix)\*(C'\fR\ 
.ie n .IP """COUNTERCMD""" 10
.el .IP \f(CWCOUNTERCMD\fR 10
.IX Item "COUNTERCMD"
اگر دستوری در یک بلوک حذف‌شده که در فهرست textcmd نیز وجود دارد با \f(CW\*(C`COUNTERCMD\*(C'\fR مطابقت داشته باشد، آن‌گاه دستور اضافی \f(CW\*(C`\eaddtocounter{\*(C'\fR\fIcntcmd\fR\f(CW\*(C`}{\-1}\*(C'\fR، که در آن \fIcntcmd\fR دستور منطبق است، به فایل diff الحاق می‌شود تا شماره‌گذاری در فایل diff با شماره‌گذاری در فایل جدید همگام باقی بماند.
.Sp
[ پیش‌فرض: \f(CW\*(C`COUNTERCMD\*(C'\fR=\f(CW\*(C`(?:footnote|part|section|subsection\*(C'\fR ...
.Sp
\&\f(CW\*(C`|subsubsection|paragraph|subparagraph)\*(C'\fR  ]
.ie n .IP """CUSTOMDIFCMD""" 10
.el .IP \f(CWCUSTOMDIFCMD\fR 10
.IX Item "CUSTOMDIFCMD"
این گزینه برای کاربران پیشرفته است و امکان تعریف نسخه‌های ویژه‌ای از دستورها را فراهم می‌آورد که به عنوان دستورهای امن کار نمی‌کنند.
.Sp
دستورهای موجود در \f(CW\*(C`CUSTOMDIFCMD\*(C'\fR که در بلوک‌های اضافه‌شده یا حذف‌شده رخ می‌دهند، یک پیشوند ADD یا DEL دریافت خواهند کرد.
نسخه‌های پیشونددارِ دستور باید در دیباچه تعریف شوند، خواه با قرار دادن آن‌ها
در دیباچه دست‌کم فایل جدید، یا با ایجاد یک فایل دیباچه سفارشی (گزینه \-\-preamble).
برای نمونه، دستور \f(CW\*(C`\eblindtext\*(C'\fR (از بسته blindtext) به خوبی با زیرخط‌کشی سازگار نیست، به گونه‌ای که
برای نوع نشانه‌گذاری استاندارد، تعریف آن به عنوان یک دستور امن رضایت‌بخش نیست. در عوض، می‌توان نسخه‌های سفارشی‌شده
بدون خط‌کشی را در دیباچه تعریف کرد:
.Sp
\&\f(CW\*(C`\enewcommand{\eDELblindtext}{{\ecolor{red}\eblindtext}}\*(C'\fR
.Sp
\&\f(CW\*(C`\enewcommand{\eADDblindtext}{{\ecolor{blue}\eblindtext}}\*(C'\fR
.Sp
و سپس latexdiff باید با گزینه \f(CW\*(C`\-c CUSTOMDIFCMD=blindtext\*(C'\fR فراخوانی شود.
.Sp
[ پیش‌فرض: none ]
.ie n .IP """FLOATENV""" 10
.el .IP \f(CWFLOATENV\fR 10
.IX Item "FLOATENV"
محیط‌هایی که نام آن‌ها با عبارت باقاعده موجود در \f(CW\*(C`FLOATENV\*(C'\fR مطابقت داشته باشد، شناور در نظر گرفته می‌شوند. در این محیط‌ها، دستورهای نشانه‌گذاری \fIlatexdiff\fR با انواع FL آن‌ها جایگزین می‌شوند.
.Sp
[ پیش‌فرض: \f(CW\*(C`(?:figure|table|plate)[\ew\ed*@]*\*(C'\fR\ ]
.ie n .IP """ITEMCMD""" 10
.el .IP \f(CWITEMCMD\fR 10
.IX Item "ITEMCMD"
دستورهایی که نشان‌دهنده سطر آیتم جدید در محیط‌های فهرست هستند.
.Sp
[ پیش‌فرض: \e\f(CW\*(C`item\*(C'\fR ]
.ie n .IP """LISTENV""" 10
.el .IP \f(CWLISTENV\fR 10
.IX Item "LISTENV"
محیط‌هایی که نام آن‌ها با عبارت باقاعده موجود در \f(CW\*(C`LISTENV\*(C'\fR تطابق دارد، محیط‌های فهرست هستند.
.Sp
[ پیش‌فرض: \f(CW\*(C`(?:itemize|enumerate|description)\*(C'\fR\ ]
.ie n .IP """MATHENV"",""MATHREPL""" 10
.el .IP \f(CWMATHENV\fR,\f(CWMATHREPL\fR 10
.IX Item "MATHENV,MATHREPL"
اگر هر دو دستور \ebegin و \eend برای یک محیط ریاضی (نام محیط منطبق با \f(CW\*(C`MATHENV\*(C'\fR یا \e[ و \e]) در همان بلوک حذف‌شده یکسان قرار داشته باشند، به‌جای اینکه کامنت شوند، با دستورهای \ebegin و \eend برای \f(CW\*(C`MATHREPL\*(C'\fR جایگزین می‌شوند.
.Sp
[ پیش‌فرض: \f(CW\*(C`MATHENV\*(C'\fR=\f(CW\*(C`(?:displaymath|equation)\*(C'\fR\ , \f(CW\*(C`MATHREPL\*(C'\fR=\f(CW\*(C`displaymath\*(C'\fR\ ]
.ie n .IP """MAXCHANGESLETTER"" هنگامی که latexdiff جایگزینی یک تک‌کلمه را تشخیص می‌دهد، تلاش می‌کند تا تغییرات را در سطح حرف شناسایی کند. اگر تغییرات زیادی وجود داشته باشد، این احتمال هست که کلمه به طور کامل جایگزین شده باشد، و تغییرات در سطح حرف به جای مفید بودن گیج‌کننده خواهد بود. در این حالت، latexdiff به نمایش جایگزینی در سطح کلمه بازمی‌گردد. رویکردِ تشخیص این دو حالت صرفاً شمارش تعداد افزودن‌ها و حذف‌های متمایز است (نه تعداد حروف تغییریافته!)، و تنها در صورتی که این تعداد کمتر یا مساوی با MAXCHANGESLETTER باشد، نشانه‌گذاری در سطح حرف به کار می‌رود. مقادیر معقول 0، 1 یا 2 هستند. مقدار 0 نشانه‌گذاری در سطح حرف را به طور کامل غیرفعال می‌کند. مقدار 1 تنها یک افزودن یا حذف منفرد را مجاز می‌داند، برای نمونه برای تصحیح یک غلط املایی یا تغییر مفرد/جمع یک فعل، اما نه یک جایگزینی. مقدار 2 یک جایگزینی (یا دو افزودن یا حذف) را مجاز می‌داند\-\-\-این امر گاهی سبب می‌شود کلمات متفاوتی در سطح حرف نشانه‌گذاری شوند، مثلاً they\-> there حرف ""y"" حذف‌شده و ""re"" اضافه‌شده را نمایش می‌دهد، که اغلب نامطلوب است." 10
.el .IP "\f(CWMAXCHANGESLETTER\fR هنگامی که latexdiff جایگزینی یک تک‌کلمه را تشخیص می‌دهد، تلاش می‌کند تا تغییرات را در سطح حرف شناسایی کند. اگر تغییرات زیادی وجود داشته باشد، این احتمال هست که کلمه به طور کامل جایگزین شده باشد، و تغییرات در سطح حرف به جای مفید بودن گیج‌کننده خواهد بود. در این حالت، latexdiff به نمایش جایگزینی در سطح کلمه بازمی‌گردد. رویکردِ تشخیص این دو حالت صرفاً شمارش تعداد افزودن‌ها و حذف‌های متمایز است (نه تعداد حروف تغییریافته!)، و تنها در صورتی که این تعداد کمتر یا مساوی با MAXCHANGESLETTER باشد، نشانه‌گذاری در سطح حرف به کار می‌رود. مقادیر معقول 0، 1 یا 2 هستند. مقدار 0 نشانه‌گذاری در سطح حرف را به طور کامل غیرفعال می‌کند. مقدار 1 تنها یک افزودن یا حذف منفرد را مجاز می‌داند، برای نمونه برای تصحیح یک غلط املایی یا تغییر مفرد/جمع یک فعل، اما نه یک جایگزینی. مقدار 2 یک جایگزینی (یا دو افزودن یا حذف) را مجاز می‌داند\-\-\-این امر گاهی سبب می‌شود کلمات متفاوتی در سطح حرف نشانه‌گذاری شوند، مثلاً they\-> there حرف ""y"" حذف‌شده و ""re"" اضافه‌شده را نمایش می‌دهد، که اغلب نامطلوب است." 10
.IX Item "MAXCHANGESLETTER هنگامی که latexdiff جایگزینی یک تک‌کلمه را تشخیص می‌دهد، تلاش می‌کند تا تغییرات را در سطح حرف شناسایی کند. اگر تغییرات زیادی وجود داشته باشد، این احتمال هست که کلمه به طور کامل جایگزین شده باشد، و تغییرات در سطح حرف به جای مفید بودن گیج‌کننده خواهد بود. در این حالت، latexdiff به نمایش جایگزینی در سطح کلمه بازمی‌گردد. رویکردِ تشخیص این دو حالت صرفاً شمارش تعداد افزودن‌ها و حذف‌های متمایز است (نه تعداد حروف تغییریافته!)، و تنها در صورتی که این تعداد کمتر یا مساوی با MAXCHANGESLETTER باشد، نشانه‌گذاری در سطح حرف به کار می‌رود. مقادیر معقول 0، 1 یا 2 هستند. مقدار 0 نشانه‌گذاری در سطح حرف را به طور کامل غیرفعال می‌کند. مقدار 1 تنها یک افزودن یا حذف منفرد را مجاز می‌داند، برای نمونه برای تصحیح یک غلط املایی یا تغییر مفرد/جمع یک فعل، اما نه یک جایگزینی. مقدار 2 یک جایگزینی (یا دو افزودن یا حذف) را مجاز می‌داند---این امر گاهی سبب می‌شود کلمات متفاوتی در سطح حرف نشانه‌گذاری شوند، مثلاً they-> there حرف ""y"" حذف‌شده و ""re"" اضافه‌شده را نمایش می‌دهد، که اغلب نامطلوب است."
[ پیش‌فرض: 1 ]
.ie n .IP """MINWORDSBLOCK""" 10
.el .IP \f(CWMINWORDSBLOCK\fR 10
.IX Item "MINWORDSBLOCK"
حداقل تعداد توکن‌های لازم برای تشکیل یک بلوک مستقل. این مقدار در الگوریتم تشخیص تغییرات بلوک‌های کامل، با ادغام بخش‌های متنیِ یکسانِ کمتر از \f(CW\*(C`MINWORDSBLOCK\*(C'\fR با بخش‌های اضافه‌شده و کنارگذاشته‌شده قبلی استفاده می‌شود.
.Sp
[ پیش‌فرض: 3 ]
.ie n .IP """PICTUREENV""" 10
.el .IP \f(CWPICTUREENV\fR 10
.IX Item "PICTUREENV"
درون محیط‌هایی که نام آن‌ها با عبارت باقاعده موجود در \f(CW\*(C`PICTUREENV\*(C'\fR مطابقت دارد، تمام نشانه‌گذاری‌های latexdiff حذف می‌شوند (در موارد حاد و نامتعارف ممکن است این امر به نشانه‌گذاری ناسازگار منجر شود اما این وضعیت باید نادر باشد).
.Sp
[ پیش‌فرض: \f(CW\*(C`(?:picture|DIFnomarkup)[\ew\ed*@]*\*(C'\fR\ ]
.ie n .IP """SCALEDELGRAPHICS""" 10
.el .IP \f(CWSCALEDELGRAPHICS\fR 10
.IX Item "SCALEDELGRAPHICS"
اگر \f(CW\*(C`\-\-graphics\-markup=both\*(C'\fR انتخاب شود، \f(CW\*(C`SCALEDELGRAPHICS\*(C'\fR ضریبی است که تصاویر حذف‌شده با آن مقیاس‌بندی می‌شوند (یعنی 0.5 به این معنی است که آن‌ها در نصف اندازه خطی نمایش داده می‌شوند).
.Sp
[ پیش‌فرض: 0.5 ]
.ie n .IP """VERBATIMENV""" 10
.el .IP \f(CWVERBATIMENV\fR 10
.IX Item "VERBATIMENV"
عبارت باقاعده‌ای (RegEx) که محیط‌هایی مانند verbatim را توصیف می‌کند که محتوای آن‌ها باید عیناً در نظر گرفته شود. محتوای این محیط‌ها به هیچ وجه پردازش نخواهد شد: محتوای حذف‌شده کامنت می‌شود، محتوای جدید نشانه‌گذاری نمی‌شود
.Sp
[ پیش‌فرض:  \f(CW\*(C`comment\*(C'\fR\  ]
.ie n .IP """VERBATIMLINEENV""" 10
.el .IP \f(CWVERBATIMLINEENV\fR 10
.IX Item "VERBATIMLINEENV"
عبارت باقاعده‌ای (RegEx) که محیط‌هایی مانند verbatim را توصیف می‌کند که محتوای آن‌ها باید عیناً در نظر گرفته شود. محتوای محیط‌های توصیف‌شده با VERBATIMLINEENV در حالت خطی مقایسه می‌شوند و تغییرات با استفاده از بسته listings نشانه‌گذاری می‌شوند. سبک نشانه‌گذاری بر اساس نوع نشانه‌گذاری اصلی انتخاب‌شده (گزینه \-t)، یا بر پایه تحلیل دیباچه تعیین می‌شود.
توجه داشته باشید که "listings.sty" باید نصب باشد. اگر این فایل یافت نشود، راه‌حل جایگزین (fallback) این است که با محیط‌های VERBATIMLINEENV دقیقاً مانند محیط‌های VERBATIMENV رفتار شود.
.Sp
[ پیش‌فرض:  \f(CW\*(C`(?:verbatim[*]?|lstlisting\*(C'\fR\  ]
.SH "رهنمودها (DIRECTIVES)"
.IX Header "DIRECTIVES"
گاهی اوقات خروجی تولید‌شده توسط \f(CW\*(C`latexdiff\*(C'\fR رضایت‌بخش نیست یا برخی ساختارهای پیچیده حتی منجر به ایجاد فایل tex اختلافی می‌شوند که به خطا می‌انجامد. می‌توان با قرار دادن کامنت‌های ویژه‌ای به نام \fIرهنمودها (directives)\fR در فایل tex، سرنخ‌هایی برای کنترل نشانه‌گذاری به latexdiff ارائه داد. رهنمودها بلوک‌ها را به وسیله رهنمودهای جفت‌شده \f(CW\*(C`BEGIN\*(C'\fR و \f(CW\*(C`END\*(C'\fR مشخص می‌کنند. مهم است که رهنمودها دقیقاً مطابق آنچه در زیر مشخص شده نوشته شوند؛ یعنی تمام حروف باید بزرگ باشند و دقیقاً یک فاصله میان BEGIN/END و نوع بلوک وجود داشته باشد. با این حال، می‌توان پس از رهنمود کامنت‌های دلخواه اضافه کرد. تو در تو کردن یا تداخل بلوک‌ها به درستی تجزیه نمی‌شود و رفتاری تعریف‌نشده ایجاد خواهد کرد. بلوک‌ها می‌توانند در مرزهای حوزه (scope boundaries) امتداد یابند؛ همچنین می‌توان آن‌ها را در آخرین آرگومان دستورهای متنی به کار برد. اگر آن‌ها در آرگومان‌های دستورهای دیگر ظاهر شوند، latexdiff فرض می‌کند که پیش یا پس از آن دستور قرار گرفته‌اند؛ با این وجود، بهتر است از این کار پرهیز شود.
.ie n .IP "بلوک """DIFADD"""" 10
.el .IP "بلوک \f(CWDIFADD\fR" 10
.IX Item "بلوک DIFADD"
.Vb 5
\& ...
\& %BEGIN DIFADD
\& ...
\& %END DIFADD
\& ...
.Ve
.Sp
هر آنچه میان رهنمودهای \f(CW\*(C`%BEGIN DIFADD\*(C'\fR و \f(CW\*(C`%END DIFADD\*(C'\fR محصور شده باشد، به عنوان یک افزودن اتمی (یکپارچه) به متن در نظر گرفته خواهد شد. محتوای درون آن به عنوان متن اضافه‌شده و طبق قواعد عادی برای نشانه‌گذاری، نشانه‌گذاری خواهد شد. یک مورد استفاده از این رهنمود زمانی است که یک بند به طور اساسی تغییر کرده باشد اما برخی از عبارت‌بندی‌های بند اصلی را حفظ کرده باشد. از آنجا که latexdiff ترجیح می‌دهد تفاوت حداقلی بین دو فایل پیدا کند، چنین وضعیتی معمولاً به یک نشانه‌گذاری تکه‌تکه می‌انجامد، با چندین جمله یا بخش‌هایی از جملاتِ اضافه‌شده و حذف‌شده و چند عبارت باقی‌مانده که دست‌نخورده علامت می‌خورند. با استفاده از این رهنمود می‌توان تمام بخشِ تغییریافته را به عنوان جدید مشخص کرد، که سپس به صورت یکپارچه (en bloc) به عنوان جدید نشانه‌گذاری می‌شود، و بخش قدیمی به صورت یک بلوک از مطالب حذف‌شده نشان داده می‌شود، که معمولاً از نشانه‌گذاری تکه‌تکه‌ی پیش‌فرض واضح‌تر است.
رهنمودهای بلوک \&\f(CW\*(C`DIFADD\*(C'\fR باید در بدنه فایل جدید قرار گیرند. این رهنمودها در دیباچه یا در فایل قدیمی نادیده گرفته می‌شوند.
.ie n .IP "بلوک """DIFDEL"""" 10
.el .IP "بلوک \f(CWDIFDEL\fR" 10
.IX Item "بلوک DIFDEL"
.Vb 5
\& ...
\& %BEGIN DIFDEL
\& ...
\& %END DIFDEL
\& ...
.Ve
.Sp
هر آنچه میان رهنمودهای \f(CW\*(C`%BEGIN DIFDEL\*(C'\fR و \f(CW\*(C`%END DIFDEL\*(C'\fR محصور شده باشد، به عنوان متن حذف‌شده اتمی در نظر گرفته خواهد شد. محتوای درون آن به عنوان متن حذف‌شده و طبق قواعد عادی برای نشانه‌گذاری، نشانه‌گذاری خواهد شد.
رهنمودهای بلوک \&\f(CW\*(C`DIFDEL\*(C'\fR باید در بدنه فایل قدیمی قرار گیرند. این رهنمودها در دیباچه یا در فایل جدید نادیده گرفته می‌شوند. مورد استفاده مشابه بلوک‌های \f(CW\*(C`DIFADD\*(C'\fR است، اما سرنخ در فایل قدیمی قرار می‌گیرد. در بیشتر موارد کافی است که یا در فایل قدیمی با یک بلوک \f(CW\*(C`DIFDEL\*(C'\fR \fIیا\fR در فایل جدید با یک بلوک \f(CW\*(C`DIFADD\*(C'\fR سرنخ داده شود و latexdiff بقیه کارها را انجام خواهد داد.
.ie n .IP "بلوک """DIFNOMARKUP"""" 10
.el .IP "بلوک \f(CWDIFNOMARKUP\fR" 10
.IX Item "بلوک DIFNOMARKUP"
.Vb 5
\& ...
\& %BEGIN DIFNOMARKUP
\& ...
\& %END DIFNOMARKUP
\& ...
.Ve
.Sp
متن بین نشانگرها در الگوریتم diff گنجانده خواهد شد اما هیچ نشانه‌گذاری واقعی در این بخش از متن انجام نخواهد شد. این بخش تنها متن جدید را نشان می‌دهد و متن قدیمی را سرکوب (پنهان) می‌کند. اگر متنی که بلافاصله بالای بلوک DIFNOMARKUP قرار دارد اضافه شده باشد، یک
\&\f(CW\*(C`\eDIFaddend\*(C'\fR مستقیماً بالای خط \f(CW\*(C`%BEGIN DIFNOMARKUP\*(C'\fR قرار می‌گیرد و هر دستور باز \f(CW\*(C`\eDIFadd\*(C'\fR خاتمه می‌یابد؛ به طور مشابه برای بلوک‌های حذف‌شده و برای متنی که بلافاصله پس از
\&\f(CW\*(C`%BEGIN DIFNOMARKUP\*(C'\fR اضافه یا حذف شده است نیز چنین است. هدف اصلی این دستور بهبود وضعیت است در صورتی که latexdiff خروجی نامعتبر یا از لحاظ بصری غیرقابل قبولی تولید کرده باشد \- نشانه‌گذاری در بخش مشکل‌دار می‌تواند با احاطه کردن آن با رهنمودهای \f(CW\*(C`DIFNOMARKUP\*(C'\fR و اجرای مجدد latexdiff سرکوب شود، و بدین ترتیب نشانه‌گذاری سایر بخش‌های سند ممکن گردد (اما لطفاً همچنان این موارد نقص در latexdiff را همان‌گونه که در زیر شرح داده شده گزارش کنید تا latexdiff بهبود یابد).
این جفت رهنمود باید در فایل جدید قرار گیرند و در فایل قدیمی (یا در دیباچه هر یک از دو فایل) نادیده گرفته خواهند شد..SH "مشکلات رایج و پرسش‌های متداول (COMMON PROBLEMS AND FAQ)"
.IX Header "COMMON PROBLEMS AND FAQ"
.IP "ارجاعات تغییریافته منجر به ایجاد overfull box می‌شوند" 10
.IX Item "ارجاعات تغییریافته منجر به ایجاد overfull box می‌شوند"
یک ناسازگاری میان بسته‌ی \f(CW\*(C`ulem\*(C'\fR (که \f(CW\*(C`latexdiff\*(C'\fR از آن برای خط کشیدن زیر متن و خط زدن روی آن در سبک UNDERLINE، یعنی سبک پیش‌فرض، استفاده می‌کند) و شیوه‌ی تولید ارجاعات وجود دارد. برای اینکه بتوان ارجاعات را به درستی علامت‌گذاری کرد، آن‌ها درون یک دستور \f(CW\*(C`\embox\*(C'\fR قرار می‌گیرند. از آنجا که mboxها نمی‌توانند در بین خطوط شکسته شوند، این فرآیند مکرراً منجر به overfull box (جعبه‌های لبریز) می‌شود که ممکن است با فراتر رفتن از حاشیه‌ی راست، محتوا را بپوشاند و ناخوانا کند. همین امر برای برخی بسته‌های دیگر (مانند siunitx) نیز رخ می‌دهد. اگر این موضوع مشکل‌ساز است، چند راهکار در اختیار دارید.
.Sp
1. از علامت‌گذاری نوع \f(CW\*(C`CFONT\*(C'\fR (گزینه‌ی \f(CW\*(C`\-t CFONT\*(C'\fR) استفاده کنید: اگر این نشانه‌گذاری انتخاب شود، ارجاعات تغییریافته دیگر با خط موج‌دار (افزوده‌ها) یا خط‌خورده (حذف‌شده‌ها) مشخص نمی‌شوند، اما همچنان با رنگ مناسب برجسته می‌شوند و متن حذف‌شده با قلم متفاوتی نشان داده می‌شود. سبک‌های دیگر که از بسته‌ی \f(CW\*(C`ulem\*(C'\fR استفاده نمی‌کنند نیز کار خواهند کرد.
.Sp
2. گزینه‌ی \f(CW\*(C`\-\-disable\-citation\-markup\*(C'\fR را انتخاب کنید که علامت‌گذاری ارجاعات را خاموش می‌کند: ارجاعات حذف‌شده دیگر نمایش داده نمی‌شوند و ارجاعات افزوده‌شده بدون علامت‌گذاری نشان داده می‌شوند. (این رفتار پیش‌فرض latexdiff در نگارش‌های 0.6 و قدیمی‌تر بود).
برای بسته‌های سفارشی می‌توانید دستوراتی را که نیاز به محافظت توسط \f(CW\*(C`\embox\*(C'\fR دارند با گزینه‌های \f(CW\*(C`\-\-append\-mboxsafecmd\*(C'\fR و \f(CW\*(C`\-\-excludemboxsafecmd\*(C'\fR تعریف کنید
(فهرست دستورات خود را به عنوان درخواست قابلیت در صفحه‌ی github ارسال کنید تا رفتار پیش‌فرض نگارش‌های بعدی تعیین شود، بخش ۶ را ببینید).
.Sp
3. اگر از luatex >= 1.12.0 استفاده می‌کنید، می‌توانید از گزینه‌ی LUAUNDERLINE استفاده کنید که از lua-ul به جای ulem برای خط کشیدن زیر متن استفاده می‌کند و این مشکل را ندارد (قابلیت آزمایشی).
.IP "تغییرات در معادلات پیچیده‌ی ریاضی منجر به بروز خطاهای پردازش latex می‌شود." 10
.IX Item "تغییرات در معادلات پیچیده‌ی ریاضی منجر به بروز خطاهای پردازش latex می‌شود."
گزینه‌ی \f(CW\*(C`\-\-math\-markup=whole\*(C'\fR را امتحان کنید. اگر حتی این هم ناموفق بود، می‌توانید علامت‌گذاری معادلات را با \f(CW\*(C`\-\-math\-markup=off\*(C'\fR خاموش کنید.
.IP "بخش‌های حذف‌شده در معادلات خط‌خورده نمی‌شوند بلکه زیر آن‌ها خط کشیده می‌شود." 10
.IX Item "بخش‌های حذف‌شده در معادلات خط‌خورده نمی‌شوند بلکه زیر آن‌ها خط کشیده می‌شود."
این یک محدودیت از بسته‌ی ulem است که عمل خط زدن روی متن را پیاده‌سازی می‌کند. اگر از بسته‌ی amsmath استفاده کنید، دستور خط زدن به نحوی بازتعریف می‌شود که بخش‌های حذف‌شده با دستور \f(CW\*(C`\etext\*(C'\fR محصور شوند؛ افزودن \f(CW\*(C`\eusepackage{amsmath}\*(C'\fR به دیباچه (preamble) شما این رفتار را فعال خواهد کرد. (اگر amsmath مستقیماً وارد نشده باشد، بلکه توسط بسته‌ی دیگری وارد شود، latexdiff قادر به شناسایی در دسترس بودن آن نخواهد بود؛ در این حالت می‌توانید با گزینه‌ی \f(CW\*(C`\-\-packages=amsmath\*(C'\fR یک سرنخ به latexdiff بدهید).
.IP "چگونه می‌توانم فقط صفحاتی را نمایش دهم که تغییرات در آن‌ها رخ داده است؟" 10
.IX Item "چگونه می‌توانم فقط صفحاتی را نمایش دهم که تغییرات در آن‌ها رخ داده است؟"
از گزینه‌های \f(CW\*(C`\-\-s ZLABEL\*(C'\fR (نیازمند مقداری پس‌پردازش) یا \f(CW\*(C`\-s ONLYCHANGEDPAGE\*(C'\fR استفاده کنید. دستور \f(CW\*(C`latexdiff\-vc \-\-ps|\-\-pdf\*(C'\fR با گزینه‌ی \f(CW\*(C`\-\-only\-changes\*(C'\fR کارهای پس‌پردازش را برای شما مدیریت می‌کند (نیازمند نصب بودن بسته‌ی zref است).
.IP "کدگذاری نویسه‌ها هنگام اجرای latexdiff از powershell به هم می‌ریزد." 10
.IX Item "کدگذاری نویسه‌ها هنگام اجرای latexdiff از powershell به هم می‌ریزد."
این مشکل محدود به \f(CW\*(C`latexdiff\*(C'\fR نیست و به تنظیمات پیش‌فرض \f(CW\*(C`powershell\*(C'\fR در Windows مربوط می‌شود. توصیه می‌شود به جای آن از \f(CW\*(C`cmd\*(C'\fR استفاده کنید.
.SH "باگ‌های شناخته‌شده (KNOWN BUGS)"
.IX Header "KNOWN BUGS"
.ie n .IP "گزینه‌ی ""\-\-allow\-spaces"" کاملاً به‌طور سازگار پیاده‌سازی نشده است. این گزینه قواعدی مبنی بر بی‌اهمیت بودن تعداد و نوع فاصله‌های خالی را نقض می‌کند، زیرا تعداد متفاوت فاصله‌های بین آرگومان‌ها معنادار در نظر گرفته می‌شود." 10
.el .IP "گزینه‌ی \f(CW\-\-allow\-spaces\fR کاملاً به‌طور سازگار پیاده‌سازی نشده است. این گزینه قواعدی مبنی بر بی‌اهمیت بودن تعداد و نوع فاصله‌های خالی را نقض می‌کند، زیرا تعداد متفاوت فاصله‌های بین آرگومان‌ها معنادار در نظر گرفته می‌شود." 10
.IX Item "گزینه‌ی --allow-spaces کاملاً به‌طور سازگار پیاده‌سازی نشده است. این گزینه قواعدی مبنی بر بی‌اهمیت بودن تعداد و نوع فاصله‌های خالی را نقض می‌کند، زیرا تعداد متفاوت فاصله‌های بین آرگومان‌ها معنادار در نظر گرفته می‌شود."
.PP
لطفاً گزارش‌های باگ را با استفاده از سامانه‌ی پیگیری مشکلات در صفحه‌ی مخزن گیت‌هاب \fIhttps://github.com/ftilmann/latexdiff.git\fR ارسال کنید،
یا آن‌ها را به نشانی \fItilmann \-\- AT \-\- gfz\-potsdam.de\fR بفرستید. شماره نگارش \fIlatexdiff\fR را نیز قید کنید
(از توضیحات بالای سورس‌کد یا با استفاده از \fB\-\-version\fR). اگر با فایل‌های latexای مواجه شدید
که بدون خطا بوده و مطابق با ویژگی‌های ذکرشده در بالا هستند،
اما مقایسه‌ی تفاوت آن‌ها همچنان خروجی latex بدون خطا تولید نمی‌کند،
لطفاً آن فایل‌ها را برای من بفرستید، ترجیحاً طوری ویرایش شوند که تا زمانی که مشکل بازتولید می‌شود، فقط حاوی بخش مشکل‌ساز باشند.
اگر فایل شما به فایل‌های کلاس (class) غیر استاندارد وابسته است، باید آن‌ها را نیز ارسال کنید. من به نمونه‌هایی که در کامپایل latex فایل‌های اصلی‌شان مشکل داشته باشم رسیدگی نخواهم کرد.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
latexrevise, latexdiff\-vc
.SH "سازگاری و قابلیت حمل (PORTABILITY)"
.IX Header "PORTABILITY"
\&\fIlatexdiff\fR از دستورات خارجی استفاده نمی‌کند و بنابراین باید روی هر بستری که از Perl 5.6 یا بالاتر پشتیبانی می‌کند اجرا شود. در صورتی که فایل‌هایی با کدگذاری‌هایی غیر از ASCII یا UTF\-8 پردازش شوند، Perl 5.8 یا بالاتر مورد نیاز است.
.PP
نگارش استاندارد \fIlatexdiff\fR نیازمند نصب بسته‌ی پرل \&\f(CW\*(C`Algorithm::Diff\*(C'\fR (موجود در \fIwww.cpan.org\fR \- \&\fIhttp://search.cpan.org/~nedkonz/Algorithm\-Diff\-1.15\fR) است، اما یک نگارش مستقل، \fIlatexdiff-so\fR، که این بسته درون آن گنجانده شده نیز موجود است. \&\fIlatexdiff-fast\fR نیازمند وجود دستور \fIdiff\fR است.
.SH "نویسنده (AUTHOR)"
.IX Header "AUTHOR"
نگارش 1.4.0
حق نشر (C) 2004\-2024 Frederik Tilmann
.PP
این برنامه یک نرم‌افزار آزاد است؛ می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو نگارش ۳ (GNU General Public License Version 3) بازتوزیع کرده یا تغییر دهید.
.PP
مشارکت‌کنندگان در اصلاحات و بخش‌های افزوده: V. Kuhlmann، J. Paisley، N. Becker، T. Doerges، K. Huebner، T. Connors، Sebastian Gouezel و بسیاری دیگر.
با تشکر از افراد فراوانی که گزارش باگ، پیشنهاد قابلیت و بازخوردهای دیگر فرستادند.