.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 .\" .\" Standard preamble: .\" ======================================================================== .de Sh \" Subsection heading .br .if t .Sp .ne 5 .PP \fB\\$1\fR .PP .. .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 .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. | will give a .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' .\" expand to `' in nroff, nothing in troff, for use with C<>. .tr \(*W-|\(bv\*(Tr .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .\" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .hy 0 .if n .na .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "TEXDIFF 1" .TH TEXDIFF 1 "2009-09-24" "perl v5.8.8" "User Contributed Perl Documentation" .SH "نام (NAME)" \&\fBtexdiff\fR \- مقایسه دو سند (La)TeX جهت ایجاد یک نسخه ادغام‌شده حاوی تغییرات، مشابه قابلیت پیگیری تغییرات در برخی واژه‌پردازها .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" texdiff [\-\-nofloats|\-n] old.tex new.tex [diff.tex] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" دو فایل نخست با یکدیگر مقایسه می‌شوند و یک فایل TeX جدید در خروجی تولید می‌شود. هنگامی که فایل خروجی توسط (La)TeX پردازش شود، تغییرات جدید را با رنگ آبی و متن‌های قدیمی را با رنگ قرمز به‌همراه یک خط روی متن (strike-through) مشخص می‌کند. علاوه بر این، بخش‌های تغییریافته در حاشیهٔ صفحه با خطوط خاکستری توسط بستهٔ \f(CW\*(C`changebar\*(C'\fR در LaTeX علامت‌گذاری می‌شوند (البته تنها پس از اجرای \f(CW\*(C`dvips\*(C'\fR؛ در \&\f(CW\*(C`xdvi\*(C'\fR این خطوط به اندازهٔ یک اینچ بیش از حد به سمت چپ قرار می‌گیرند تا فاصلهٔ یک اینچی اعمال‌شده توسط راه‌اندازهای چاپگر TeX را جبران کنند). .PP برنامهٔ \&\f(CW\*(C`texdiff\*(C'\fR برای درج این نشانه‌ها از دستور \f(CW\*(C`wdiff\*(C'\fR استفاده می‌کند و در نتیجه به آن وابسته است. اگر ماکروهای LaTeX درون بخش‌های خط‌خورده یا زیرخط‌دار قرار گیرند، اجرای latex به احتمال زیاد با خطا مواجه خواهد شد. ریشهٔ بیشتر مشکلات در این است که \f(CW\*(C`wdiff\*(C'\fR جفت‌آکولادها را از یکدیگر جدا می‌کند. بنابراین \&\f(CW\*(C`texdiff\*(C'\fR یک اسکریپت perl است که \f(CW\*(C`wdiff\*(C'\fR را به‌صورت درونی فراخوانی کرده و خروجی \f(CW\*(C`wdiff\*(C'\fR را با جفت کردن دوبارهٔ آکولادها و رسیدگی به برخی ماکروهای پرکاربرد LaTeX اصلاح می‌کند. .PP برای کارکرد texdiff، کد LaTeX زیر باید در دیباچهٔ (preamble) سند LaTeX قرار داده شود: .PP .Vb 3 \& \eusepackage{xcolor} \eusepackage{ulem} \eusepackage{changebar} \& \enewcommand\eTLSins[1]{\ecbstart{}\etextcolor{ins}{\euline{#1}}\ecbend{}} \& \enewcommand\eTLSdel[1]{\ecbdelete{}\etextcolor{del}{\esout{#1}}} .Ve .PP رنگ‌های ویرایشی \f(CW\*(C`ins\*(C'\fR و \f(CW\*(C`del\*(C'\fR را با نام‌های رنگ موجود در \f(CW\*(C`xcolor\*(C'\fR تعریف کنید: \ecolorlet{ins}{blue} \ecolorlet{del}{red} .PP یا از ابتدا: \edefinecolor{ins}{rgb}{0, 0.5, 0} .PP برخلاف اسکریپت‌های اولیه، این ماکروها به‌طور خودکار در \ebegin{document} درج \s-1نمی‌شوند\s0 (بخش \fBقدردانی‌ها (ACKNOWLEDGMENTS)\fR در زیر را ببینید)؛ زیرا این روش روی فایل‌های یک سند چندفایلی (فایل‌هایی که با \einclude یا \einput فراخوانی می‌شوند) کار نخواهد کرد. علاوه بر این، در صورت درج دستی ماکروها، می‌توانید آن‌ها را مطابق با نیاز خود سفارشی کنید؛ برای نمونه، رنگ متن یا موقعیت نوار تغییرات (changebars) را تغییر دهید. برای آگاهی از نحوهٔ انجام این کار، نگاهی به مستندات بسته‌های ulem و changebar بیندازید! .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP "\fB\-\-nofloats\fR, \fB\-n\fR" 4 .IX Item "--nofloats, -n" در صورت تعیین، از محتویات محیط‌های figure صرف‌نظر می‌کند، اما موارد درج‌شده و حذف‌شده در دستورهای caption را نمایش می‌دهد. این کار برای جلوگیری از به‌هم‌ریختگی‌های پیچیده در محیط‌های subfloat یا محیط‌های figure پیچیده انجام می‌شود. .IP "\fB\-\-debug\fR, \fB\-d\fR" 4 .IX Item "--debug, -d" اشکال‌زدایی را فعال می‌کند. فایل‌های موقتی که شامل آکولادهای شماره‌گذاری‌شده هستند نگه‌داشته می‌شوند و یک فایل تفاوت خام با نام فایل خروجی به‌همراه پسوند '\-wdiff.tex' نوشته می‌شود. علاوه بر این، چندین پیام عیب‌یابیِ عبارات باقاعده چاپ می‌شود. \fBهشدار: خروجی بسیار زیادی تولید می‌کند.\fR .SH "نویسندگان (AUTHORS)" .IX Header "AUTHORS" Mark Doll gmx.net>, Cengiz Gunay users.sf.net>. .SH "قدردانی‌ها (ACKNOWLEDGMENTS)" .IX Header "ACKNOWLEDGMENTS" .IP "\fB*\fR" 4 .IX Item "*" نسخهٔ 0.4، توسط \s-1CG\s0، در 2009/09/15. افزودن استفاده از GetOpt برای دریافت یک پارامتر اختیاری جهت نادیده گرفتن محتویات شناورها (مانند figure یا table). افزودن یک حالت اشکال‌زدایی اختیاری. تعبیهٔ مستندات \s-1POD\s0. رفع مشکل مربوط به درج‌ها و حذف‌هایی که در میان دستورهای بخش‌بندی (sectioning) ظاهر شده و باعث اختلال در LaTeX می‌شدند. .IP "\fB*\fR" 4 .IX Item "*" نسخهٔ 0.3، ویرایش شده توسط Cengiz Gunay ، در 2009/06/30. افزودن برخی از دستورهای Latex که باید مستثنی شوند و اصلاح نحوهٔ مدیریت نویسه‌های '\e%'. .IP "\fB*\fR" 4 .IX Item "*" نسخهٔ 0.2، پیاده‌سازی perl از TeXdiff توسط Mark Doll ، در 2006/08/09. این نسخه از اسکریپت‌های اولیهٔ bash و perl نوشته‌شده توسط Robert Maron مشتق شده است که در http://www.robmar.net/TexDiff موجود هستند. این نسخه از texdiff در http://mark.doll.name/texdiff در دسترس است. .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .IX Header "COPYRIGHT AND LICENSE" Copyleft 2006\-2009, Mark Doll and Cengiz Gunay .PP این کتابخانه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت همان شرایط خود Perl بازتوزیع کرده یا تغییر دهید.