'\" t
.\"     Title: interdiff
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 23 June 2009
.\"    Manual: Man pages
.\"    Source: patchutils
.\"  Language: English
.\"
.TH "INTERDIFF" "1" "23 June 2009" "patchutils" "Man pages"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
interdiff \- نمایش تفاوت‌های میان دو فایل وصله (diff)
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBinterdiff\fR\ 'u
\fBinterdiff\fR [[\-p\ \fIn\fR] | [\-\-strip\-match=\fIn\fR]] [[\-U\ \fIn\fR] | [\-\-unified=\fIn\fR]] [[\-d\ \fIPAT\fR] | [\-\-drop\-context=\fIPAT\fR]] [[\-q] | [\-\-quiet]] [[\-z] | [\-\-decompress]] [[\-b] | [\-\-ignore\-space\-change]] [[\-B] | [\-\-ignore\-blank\-lines]] [[\-i] | [\-\-ignore\-case]] [[\-w] | [\-\-ignore\-all\-space]] [\-\-color=\fIWHEN\fR] [[\-\-interpolate] | [\-\-combine] | [\-\-flip]] [\-\-no\-revert\-omitted] \fIdiff1\fR \fIdiff2\fR
.HP \w'\fBinterdiff\fR\ 'u
\fBinterdiff\fR {[\-\-help] | [\-\-version]}
.SH "توضیحات (DESCRIPTION)"
.PP
\fBinterdiff\fR
یک diff با قالب یکپارچه (unified format) ایجاد می‌کند که بیانگر تفاوت میان دو diff است\&. هر دو diff باید نسبت به فایل‌های یکسانی باشند\&. برای کسب بهترین نتیجه، diffها باید دست‌کم سه خط زمینه (context) داشته باشند\&.
.PP
برای معکوس کردن یک وصله، از
/dev/null
برای
\fIdiff2\fR\&
استفاده کنید\&.
.PP
برای کاهش مقدار زمینه (context) در یک وصله، استفاده کنید از:
.sp
.if n \{\
.RS 4
.\}
.nf
interdiff \-U1 /dev/null patchfile
.fi
.if n \{\
.RE
.\}
.PP
از آنجا که
\fBinterdiff\fR
این مزیت را ندارد که بتواند فایل‌هایی که قرار است تغییر یابند را بررسی کند، نیازمندی‌های سخت‌گیرانه‌تری نسبت به
\fBpatch\fR(1)
روی قالب ورودی دارد\&. خروجی GNU diff حتی با افزونه‌ها نیز مناسب خواهد بود، اما اگر قصد دارید از وصله‌ای استفاده کنید که به صورت دستی ویرایش شده است، شاید بهتر باشد ابتدا آفست‌ها و شمارش‌ها را با استفاده از
\fBrecountdiff\fR(1)
اصلاح و مرتب نمایید\&.
.PP
با این حال، توجه داشته باشید که هر دو وصله باید نسبت به نسخه‌های یکسانی از همان مجموعه فایل‌های اصلی باشند\&.
.PP
فایل‌های diff می‌توانند در قالب زمینه‌ای (context format) باشند\&. با این حال، خروجی در قالب یکپارچه (unified format) خواهد بود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-h\fR
.RS 4
نادیده گرفته می‌شود؛ جهت سازگاری با نگارش‌های قدیمی‌تر interdiff\&. این گزینه به‌زودی حذف خواهد شد\&.
.RE
.PP
\fB\-p\fR\fIn\fR, \fB\-\-strip\-match=\fR\fB\fIn\fR\fR
.RS 4
هنگام مقایسه نام فایل‌ها،
\fIn\fR
مؤلفه ابتدایی مسیر را از هر دو وصله نادیده می‌گیرد\&. (این مشابه گزینه
\fB\-p\fR
در GNU
\fBpatch\fR(1)\& است\&.) اگر این گزینه مشخص نشود،
\fBinterdiff\fR
به‌طور خودکار تعداد بهینه مؤلفه‌های مسیر را برای حذف، با یافتن کوچک‌ترین مقداری که در آن حداقل یک فایل بین دو وصله مطابقت داشته باشد تعیین می‌کند\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
خروجی ساکت‌تر\&. خطوط توضیحی دلیل تغییرات (rationale) را در ابتدای هر وصله منتشر نمی‌کند\&.
.RE
.PP
\fB\-U\fR\fIn\fR, \fB\-\-unified=\fR\fB\fIn\fR\fR
.RS 4
تلاش برای نمایش
\fIn\fR
خط از زمینه (نیازمند حداقل
\fIn\fR
خط زمینه در هر دو فایل ورودی است)\&. (این مشابه گزینه
\fB\-U\fR
در GNU
\fBdiff\fR(1)\& است\&.)
.RE
.PP
\fB\-d\fR\fIPATTERN\fR, \fB\-\-drop\-context=\fR\fB\fIPATTERN\fR\fR
.RS 4
هیچ زمینه‌ای (context) را برای فایل‌هایی که با الگوی جانشین (wildcard) شل
\fIPATTERN\fR
تطابق دارند نمایش نمی‌دهد\&. این گزینه می‌تواند چندین بار مشخص شود\&.
.sp
توجه داشته باشید که تفسیر الگوی جانشین شل، کاراکترهای اسلش یا نقطه را کاراکتر خاص محسوب نمی‌کند (به بیان دیگر، هیچ فلگی به
\fBfnmatch\fR
داده نمی‌شود)\&. این امر باعث می‌شود الگوهایی از نوع
\(lq*/basename\(rq
بتوانند بدون محدود کردن تعداد بخش‌های مسیر به کار روند\&.
.RE
.PP
\fB\-i\fR, \fB\-\-ignore\-case\fR
.RS 4
حروف کوچک و بزرگ را یکسان در نظر می‌گیرد\&.
.RE
.PP
\fB\-w\fR, \fB\-\-ignore\-all\-space\fR
.RS 4
تغییرات فاصله‌های خالی (whitespace) را در وصله‌ها نادیده می‌گیرد\&. همچنین باعث می‌شود هنگام بازسازی فایل‌ها، اعمال وصله فاصله‌های خالی را نادیده بگیرد\&.
.RE
.PP
\fB\-b\fR, \fB\-\-ignore\-space\-change\fR
.RS 4
تغییرات در مقدار فاصله‌های خالی را نادیده می‌گیرد\&.
.RE
.PP
\fB\-B\fR, \fB\-\-ignore\-blank\-lines\fR
.RS 4
تغییراتی که خطوط آن‌ها کاملاً خالی است را نادیده می‌گیرد\&.
.RE
.PP
\fB\-\-color=\fR\fB\fIWHEN\fR\fR
.RS 4
رنگی کردن خروجی؛
\fIWHEN\fR
می‌تواند \*(Aqnever\*(Aq، \*(Aqalways\*(Aq یا \*(Aqauto\*(Aq باشد (پیش‌فرض: auto، برای غیرفعال‌سازی از \*(Aqnever\*(Aq استفاده کنید)
.RE
.PP
\fB\-z\fR, \fB\-\-decompress\fR
.RS 4
استخراج و باز کردن فایل‌های فشرده با پسوندهای \&.gz و \&.bz2\&.
.RE
.PP
\fB\-\-interpolate\fR
.RS 4
اجرا به صورت
\(lqinterdiff\(rq\&. این حالت پیش‌فرض است\&.
.RE
.PP
\fB\-\-combine\fR
.RS 4
اجرا به صورت
\(lqcombinediff\(rq\&. برای اطلاعات بیشتر پیرامون نحوه تغییر رفتار در این حالت، به
\fBcombinediff\fR(1)
مراجعه کنید\&.
.RE
.PP
\fB\-\-no\-revert\-omitted\fR
.RS 4
(تنها برای حالت درونیابی) هنگامی که فایلی توسط وصله نخست تغییر کرده باشد اما توسط وصله دوم نه، آن تغییر را بازگردانی (revert) نمی‌کند\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
نمایش یک پیام کوتاه نحوه استفاده و خروج\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش شماره نگارش interdiff\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
استفاده پایه:
.sp
.if n \{\
.RS 4
.\}
.nf
interdiff \-z 3\&.2pre1\&.patch\&.gz 3\&.2pre2\&.patch\&.gz
.fi
.if n \{\
.RE
.\}
.PP
معکوس کردن یک وصله:
.sp
.if n \{\
.RS 4
.\}
.nf
interdiff patch /dev/null
.fi
.if n \{\
.RE
.\}
.PP
معکوس کردن بخشی از یک وصله (و نادیده گرفتن مابقی آن):
.sp
.if n \{\
.RS 4
.\}
.nf
filterdiff \-i file\&.c patchfile | \e
  interdiff /dev/stdin /dev/null
.fi
.if n \{\
.RE
.\}
.SH "اشکالات (BUGS)"
.PP
در حال حاضر هیچ باگ شناخته‌شده‌ای در interdiff وجود ندارد؛ اما نکاتی وجود دارد\&. اگر باگی یافتید، لطفاً آن را (به همراه یک مورد آزمایشی کمینه) به Tim Waugh
<twaugh@redhat\&.com>\&
گزارش دهید\&.
.PP
مجموعه‌ای از وصله‌ها وجود دارند که در آن‌ها اطلاعات کافی برای تولید یک interdiff مناسب وجود ندارد\&. در این حالت، راهبرد اتخاذشده بازگردانی وصله اصلی و اعمال وصله جدید است\&. متأسفانه این به این معناست که برگشت‌پذیر بودن interdiffها تضمین‌شده نیست\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBcombinediff\fR(1)
.SH "نویسندگان (AUTHORS)"
.PP
\fBTim Waugh\fR <\&twaugh@redhat.com\&>
.RS 4
نگه‌دارنده بسته
.RE
.PP
\fBMichael K\&. Johnson\fR <\&johnsonm@redhat\&.com\&>
.RS 4
مشارکت‌کننده اولیه صفحه راهنما
.RE