نام (NAME)

diff3 - مقایسه سهطرفه فایلها به صورت خط به خط

خلاصه دستور (SYNOPSIS)

diff3 [گزینه]... MYFILE OLDFILE YOURFILE

توضیحات (DESCRIPTION)

مقایسه سه‌طرفه سه فایل به صورت خط به خط.

آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.

گزینهها (OPTIONS)

-A, --show-all: نمایش تمام تغییرات، و قرار دادن تضادها (تعارض‌ها) در میان براکت‌ها.
-e, --ed: خروجی دادن یک اسکریپت ed برای اعمال تغییرات از OLDFILE به YOURFILE روی MYFILE.
-E, --show-overlap: مشابه -e، اما تضادها را در میان براکت‌ها قرار می‌دهد.
-3, --easy-only: مشابه -e، اما تنها تغییرات غیرهمپوشان (بدون تضاد) را اعمال می‌کند.
-x, --overlap-only: مشابه -e، اما تنها تغییرات همپوشان (دارای تضاد) را اعمال می‌کند.
-X: مشابه -x، اما تضادها را در میان براکت‌ها قرار می‌دهد.
-i: افزودن دستورات 'w' و 'q' به انتهای اسکریپت‌های ed (جهت ذخیره و خروج).
-m, --merge: تولید مستقیم فایل ادغام‌شده نهایی؛ در صورت تعیین نشدن گزینه‌های دیگر، ادغام مطابق با -A انجام می‌شود.
-a, --text: رفتار با تمامی فایل‌ها به عنوان فایل متنی.
--strip-trailing-cr: حذف نویسه‌های بازگشت به ابتدای سطر (CR انتهای سطرها در سبک DOS/ویندوز) در ورودی.
-T, --initial-tab: تراز کردن تب‌ها با افزودن یک کاراکتر تب به ابتدای هر سطر.
--diff-program=PROGRAM: استفاده از PROGRAM (برنامه سفارشی) برای مقایسه فایل‌ها.
-L, --label=LABEL: استفاده از LABEL (برچسب سفارشی) به جای نام فایل (می‌تواند تا سه بار تکرار شود).
--help: نمایش این راهنما و خروج.
-v, --version: نمایش اطلاعات نسخه و خروج.

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

گزینه‌های -e، -E، -x و -X (و گزینه‌های طولانی معادل آن‌ها) باعث می‌شوند به جای قالب پیش‌فرض، یک اسکریپت ed در خروجی تولید شود.

در نهایت، گزینه -m (--merge) باعث می‌شود که diff3 عملیات ادغام را به صورت داخلی انجام داده و فایل ادغام‌شده نهایی را در خروجی تولید کند. برای ورودی‌های نامتعارف، این روش بسیار پایدارتر و مطمئن‌تر از به‌کارگیری ed است.

اگر به جای هر یک از فایل‌ها '-' قرار داده شود، ورودی استاندارد (stdin) خوانده می‌شود.

وضعیت خروج در صورت موفقیت ۰، در صورت وجود تضاد (تعارض) ۱، و در صورت بروز خطا ۲ است.

نویسنده (AUTHOR)

نوشته شده توسط Randy Smith.

گزارش باگها (REPORTING BUGS)

گزارش باگ‌ها به: bug-diffutils@gnu.org
صفحه خانگی GNU diffutils: https://www.gnu.org/software/diffutils
راهنمای عمومی استفاده از نرم‌افزارهای گنو: https://www.gnu.org/gethelp

حق نشر (COPYRIGHT)

حق نشر © 2025 بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc.)
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر https://gnu.org/licenses/gpl.html.
این یک نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید. هیچ‌گونه ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.

همچنین ببینید (SEE ALSO)

cmp(1), diff(1), sdiff(1)

مستندات کامل برای diff3 به عنوان یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های info و diff3 به درستی روی سیستم شما نصب شده باشند، دستور

: info diff3

باید دسترسی شما به راهنمای کامل را فراهم کند.