'\" t
.\"     Title: combinediff
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 23 Jan 2009
.\"    Manual: Man pages
.\"    Source: patchutils
.\"  Language: English
.\"
.TH "COMBINEDIFF" "1" "23 Jan 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)"
combinediff \- ایجاد یک وصله یکپارچه تجمیعی از دو وصله افزایشی
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBcombinediff\fR\ 'u
\fBcombinediff\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]] \fIdiff1\fR \fIdiff2\fR
.HP \w'\fBcombinediff\fR\ 'u
\fBcombinediff\fR {[\-\-help] | [\-\-version]}
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fBcombinediff\fR یک diff یکپارچه ایجاد می‌کند که بیانگر مجموع دو diff است\&. فایل‌های diff باید به ترتیبی که قرار است اعمال شوند فهرست شوند\&. برای دستیابی به بهترین نتیجه، diffها باید دست‌کم سه خط زمینه (context) داشته باشند\&.
.PP
از آنجا که
\fBcombinediff\fR
از این مزیت که بتواند فایل‌های نیازمند تغییر را بررسی کند برخوردار نیست، نیازمندی‌های سخت‌گیرانه‌تری برای قالب ورودی نسبت به
\fBpatch\fR(1)
دارد\&. خروجی GNU diff حتی با وجود افزونه‌ها مناسب خواهد بود، اما اگر قصد دارید از وصله‌ای که به صورت دستی ویرایش شده استفاده کنید، عاقلانه است که ابتدا با استفاده از
\fBrecountdiff\fR(1)
آفست‌ها و شمارنده‌ها را تمیز و مرتب کنید\&.
.PP
با این حال، توجه داشته باشید که دو وصله باید دقیقاً به ترتیب افزایشی باشند\&. به عبارت دیگر، وصله دوم باید نسبت به وضعیت مجموعه فایل‌های اولیه پس از اعمال وصله اول باشد\&.
.PP
فایل‌های diff می‌توانند در قالب زمینه (context) باشند؛ با این حال، خروجی در قالب یکپارچه (unified) خواهد بود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-p\fR\fIn\fR, \fB\-\-strip\-match=\fR\fB\fIn\fR\fR
.RS 4
هنگام مقایسه نام فایل‌ها، از
\fIn\fR
جزء اول مسیر در هر دو وصله صرف‌نظر می‌کند\&. (این مشابه گزینه
\fB\-p\fR
در
\fBpatch\fR(1)
گنو است\&.) اگر این گزینه مشخص نشود،
\fBcombinediff\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
در
\fBdiff\fR(1)
گنو است\&.)
.RE
.PP
\fB\-d\fR\fIpattern\fR, \fB\-\-drop\-context=\fR\fB\fIPATTERN\fR\fR
.RS 4
برای فایل‌هایی که با الگوی نویسه عمومی (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
تغییرات فاصله‌های خالی را در وصله‌ها نادیده می‌گیرد\&. همچنین باعث می‌شود هنگام بازسازی فایل‌ها، اعمال وصله فاصله‌های خالی را نادیده بگیرد\&.
.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\&. برای اطلاعات بیشتر درباره نحوه تغییر رفتار در این حالت،
\fBinterdiff\fR(1)
را ببینید\&.
.RE
.PP
\fB\-\-combine\fR
.RS 4
اجرا به عنوان
\(lqcombinediff\(rq\&. این حالت پیش‌فرض است\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
نمایش یک پیام کوتاه درباره نحوه استفاده\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش شماره نسخه combinediff\&.
.RE
.SH "گزارش باگ‌ها (BUGS)"
.PP
گزینه
\fB\-U\fR
کمی نامنظم عمل می‌کند: این گزینه می‌تواند میزان زمینه نمایش داده‌شده را برای فایل‌هایی که در هر دو وصله تغییر یافته‌اند کنترل کند، اما برای فایل‌هایی که تنها در یک وصله ظاهر می‌شوند کار نمی‌کند (که در خروجی با همان میزان زمینه موجود در ورودی نمایش داده می‌شوند)\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBinterdiff\fR(1)
.SH "نویسندگان (AUTHORS)"
.PP
\fBTim Waugh\fR <\&twaugh@redhat.com\&>
.RS 4
نگه‌دارنده بسته
.RE