COMBINEDIFF(1) Man pages COMBINEDIFF(1)

combinediff - ایجاد یک وصله یکپارچه تجمیعی از دو وصله افزایشی

combinediff [[-p n] | [--strip-match=n]] [[-U n] | [--unified=n]] [[-d PAT] | [--drop-context=PAT]] [[-q] | [--quiet]] [[-z] | [--decompress]] [[-b] | [--ignore-space-change]] [[-B] | [--ignore-blank-lines]] [[-i] | [--ignore-case]] [[-w] | [--ignore-all-space]] [--color=WHEN] [[--interpolate] | [--combine]] diff1 diff2

combinediff {[--help] | [--version]}

دستور combinediff یک diff یکپارچه ایجاد می‌کند که بیانگر مجموع دو diff است. فایل‌های diff باید به ترتیبی که قرار است اعمال شوند فهرست شوند. برای دستیابی به بهترین نتیجه، diffها باید دست‌کم سه خط زمینه (context) داشته باشند.

از آنجا که combinediff از این مزیت که بتواند فایل‌های نیازمند تغییر را بررسی کند برخوردار نیست، نیازمندی‌های سخت‌گیرانه‌تری برای قالب ورودی نسبت به patch(1) دارد. خروجی GNU diff حتی با وجود افزونه‌ها مناسب خواهد بود، اما اگر قصد دارید از وصله‌ای که به صورت دستی ویرایش شده استفاده کنید، عاقلانه است که ابتدا با استفاده از recountdiff(1) آفست‌ها و شمارنده‌ها را تمیز و مرتب کنید.

با این حال، توجه داشته باشید که دو وصله باید دقیقاً به ترتیب افزایشی باشند. به عبارت دیگر، وصله دوم باید نسبت به وضعیت مجموعه فایل‌های اولیه پس از اعمال وصله اول باشد.

فایل‌های diff می‌توانند در قالب زمینه (context) باشند؛ با این حال، خروجی در قالب یکپارچه (unified) خواهد بود.

-pn, --strip-match=n

هنگام مقایسه نام فایل‌ها، از n جزء اول مسیر در هر دو وصله صرف‌نظر می‌کند. (این مشابه گزینه -p در patch(1) گنو است.) اگر این گزینه مشخص نشود، combinediff با یافتن کوچک‌ترین مقداری که در آن حداقل یک فایل بین دو وصله مطابقت داشته باشد، تعداد بهینه اجزای مسیر برای حذف را به‌طور خودکار تعیین می‌کند.

-q, --quiet

خروجی خلوت‌تر. از نمایش خطوط توضیحی (rationale) در ابتدای هر وصله خودداری می‌کند.

-Un, --unified=n

تلاش برای نمایش n خط زمینه (نیازمند حداقل n خط زمینه در هر دو فایل ورودی است). (این مشابه گزینه -U در diff(1) گنو است.)

-dpattern, --drop-context=PATTERN

برای فایل‌هایی که با الگوی نویسه عمومی (wildcard) پوسته pattern مطابقت دارند، هیچ زمینه‌ای نمایش داده نمی‌شود. این گزینه را می‌توان چندین بار مشخص کرد.

توجه داشته باشید که در تفسیر الگوی نویسه عمومی پوسته، نویسه‌های اسلش یا نقطه خاص در نظر گرفته نمی‌شوند (به عبارت دیگر، هیچ پرچمی به fnmatch داده نمی‌شود). این به این دلیل است که الگوهایی از نوع “*/basename” را بتوان بدون محدود کردن تعداد اجزای مسیر به کار برد.

-i, --ignore-case

حروف بزرگ و کوچک را یکسان در نظر می‌گیرد.

-w, --ignore-all-space

تغییرات فاصله‌های خالی را در وصله‌ها نادیده می‌گیرد. همچنین باعث می‌شود هنگام بازسازی فایل‌ها، اعمال وصله فاصله‌های خالی را نادیده بگیرد.

-b, --ignore-space-change

تغییرات در مقدار فاصله‌های خالی را نادیده می‌گیرد.

-B, --ignore-blank-lines

تغییراتی را که تمام خطوط آن‌ها کاملاً خالی است نادیده می‌گیرد.

--color=WHEN

رنگی‌سازی خروجی؛ WHEN می‌تواند 'never'، 'always' یا 'auto' باشد (پیش‌فرض: auto، برای غیرفعال‌سازی از 'never' استفاده کنید)

-z, --decompress

فایل‌های دارای پسوند .gz و .bz2 را از حالت فشرده خارج می‌کند.

--interpolate

اجرا به عنوان “interdiff”. برای اطلاعات بیشتر درباره نحوه تغییر رفتار در این حالت، interdiff(1) را ببینید.

--combine

اجرا به عنوان “combinediff”. این حالت پیش‌فرض است.

--help

نمایش یک پیام کوتاه درباره نحوه استفاده.

--version

نمایش شماره نسخه combinediff.

گزینه -U کمی نامنظم عمل می‌کند: این گزینه می‌تواند میزان زمینه نمایش داده‌شده را برای فایل‌هایی که در هر دو وصله تغییر یافته‌اند کنترل کند، اما برای فایل‌هایی که تنها در یک وصله ظاهر می‌شوند کار نمی‌کند (که در خروجی با همان میزان زمینه موجود در ورودی نمایش داده می‌شوند).

interdiff(1)

Tim Waugh <twaugh@redhat.com>

نگه‌دارنده بسته
23 Jan 2009 patchutils