FLIPDIFF(1) Man pages FLIPDIFF(1)

flipdiff - جابه‌جا کردن ترتیب دو وصله (پچ) افزایشی

flipdiff [[-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] [--in-place] diff1 diff2

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

دستور flipdiff ترتیب دو فایل وصله (patch) که به ترتیب بعد از یکدیگر اعمال می‌شوند را جابه‌جا و معکوس می‌کند. وصله‌ها باید «تمیز» باشند: خطوط زمینه (context lines) باید مطابقت داشته باشند و هیچ آفست ناهماهنگی نباید وجود داشته باشد.

وصله‌های جابه‌جاشده به stdout ارسال می‌شوند، همراه با یک خط نشانه‌گذار (“=== 8< === cut here === 8< ===”) بین آن‌ها، مگر اینکه گزینه --in-place ارائه شده باشد. در این صورت، خروجی مستقیماً روی فایل‌های ورودی اصلی بازنویسی می‌شود.

-pn, --strip-match=n

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

-q, --quiet

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

-Un, --unified=n

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

-dpattern, --drop-context=PATTERN

عدم نمایش هرگونه زمینه برای فایل‌هایی که با الگوی وایلدکارد شل 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.

--in-place

نوشتن خروجی روی فایل‌های ورودی اصلی.

--help

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

--version

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

این برنامه تنها به صورت بسیار محدود تست شده است و حتی ممکن است کار نکند. استفاده از گزینه --in-place در حال حاضر توصیه نمی‌شود.

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

به همین دلیل، عموماً ایده خوبی است که خروجی را مطالعه و بررسی کنید تا از معقول بودن آن اطمینان حاصل نمایید.

Tim Waugh <twaugh@redhat.com>

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