'\" t
.\"     Title: git-mergetool
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-06-29
.\"    Manual: راهنمای Git
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GIT\-MERGETOOL" "1" "2026\-06\-29" "Git 2\&.55\&.0" "راهنمای Git"
.\" -----------------------------------------------------------------
.\" * 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)"
git-mergetool \- اجرای ابزارهای حل تعارض برای برطرف کردن تعارضات ادغام
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBgit\fR \fBmergetool\fR [\fB\-\-tool=\fR\fI<tool>\fR] [\fB\-y\fR | \fB\-\-\fR[\fBno\-\fR]\fBprompt\fR] [\fI<file>\fR\&...]
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
از \fBgit\fR \fBmergetool\fR برای اجرای یکی از چند ابزار کمکی ادغام جهت حل تعارضات ادغام استفاده کنید\&. این دستور معمولاً پس از \fBgit\fR \fBmerge\fR اجرا می‌شود\&.
.sp
اگر یک یا چند پارامتر <file> مشخص شده باشد، برنامه ابزار ادغام برای حل اختلافات در هر فایل اجرا خواهد شد (فایل‌های بدون تعارض نادیده گرفته می‌شوند)\&. مشخص کردن یک دایرکتوری، تمامی فایل‌های حل‌نشده در آن مسیر را در بر خواهد گرفت\&. اگر هیچ نام \fI<file>\fR مشخص نشده باشد، \fBgit\fR \fBmergetool\fR برنامه ابزار ادغام را روی هر فایلی که دارای تعارض ادغام است اجرا می‌کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-t\fR \fI<tool>\fR, \fB\-\-tool=\fR\fI<tool>\fR
.RS 4
از برنامه حل ادغام مشخص‌شده توسط
\fI<tool>\fR
استفاده می‌کند\&. مقادیر معتبر شامل
\fBemerge\fR،
\fBgvimdiff\fR،
\fBkdiff3\fR،
\fBmeld\fR،
\fBvimdiff\fR
و
\fBtortoisemerge\fR
هستند\&. دستور
\fBgit\fR
\fBmergetool\fR
\fB\-\-tool\-help\fR
را برای مشاهده فهرست تنظیمات معتبر
\fI<tool>\fR
اجرا کنید\&.
.sp
اگر برنامه حل ادغام مشخص نشده باشد،
\fBgit\fR
\fBmergetool\fR
از متغیر پیکربندی
\fBmerge\&.tool\fR
استفاده خواهد کرد\&. اگر متغیر پیکربندی
\fBmerge\&.tool\fR
تنظیم نشده باشد،
\fBgit\fR
\fBmergetool\fR
یک پیش‌فرض مناسب را انتخاب خواهد کرد\&.
.sp
می‌توانید با تنظیم متغیر پیکربندی
\fBmergetool\&.\fR\fI<tool>\fR\fB\&.path\fR
به‌طور صریح مسیر کامل ابزار را مشخص کنید\&. برای نمونه، می‌توانید مسیر مطلق kdiff3 را با تنظیم
\fBmergetool\&.kdiff3\&.path\fR
پیکربندی کنید\&. در غیر این صورت،
\fBgit\fR
\fBmergetool\fR
فرض می‌کند که ابزار در
\fB$PATH\fR
در دسترس است\&.
.sp
به جای اجرای یکی از برنامه‌های ابزار ادغام شناخته‌شده،
\fBgit\fR
\fBmergetool\fR
می‌تواند با تعیین خط فرمانی که باید فراخوانی شود در متغیر پیکربندی
\fBmergetool\&.\fR\fI<tool>\fR\fB\&.cmd\fR
شخصی‌سازی شود تا یک برنامه جایگزین را اجرا کند\&.
.sp
هنگامی که
\fBgit\fR
\fBmergetool\fR
با این ابزار فراخوانی می‌شود (چه از طریق گزینه
\fB\-t\fR
یا
\fB\-\-tool\fR
و چه از طریق متغیر پیکربندی
\fBmerge\&.tool\fR)،
خط فرمان پیکربندی‌شده فراخوانی می‌شود در حالی که
\fBBASE\fR
روی نام یک فایل موقت حاوی پایه مشترک برای ادغام (در صورت وجود) تنظیم شده است؛
\fBLOCAL\fR
روی نام یک فایل موقت حاوی محتویات فایل روی شاخه جاری تنظیم شده است؛
\fBREMOTE\fR
روی نام یک فایل موقت حاوی محتویات فایلِ در حال ادغام تنظیم شده است، و
\fBMERGED\fR
روی نام فایلی تنظیم شده است که ابزار ادغام باید نتیجه حل تعارض ادغام را در آن بنویسد\&.
.sp
اگر ابزار ادغام سفارشی با کد خروج خود موفقیت حل ادغام را به درستی نشان دهد، متغیر پیکربندی
\fBmergetool\&.\fR\fI<tool>\fR\fB\&.trustExitCode\fR
می‌تواند روی
\fBtrue\fR
تنظیم شود\&. در غیر این صورت،
\fBgit\fR
\fBmergetool\fR
پس از خروج ابزار سفارشی، از کاربر درخواست می‌کند تا موفقیت حل تعارض را مشخص کند\&.
.RE
.PP
\fB\-\-tool\-help\fR
.RS 4
چاپ فهرستی از ابزارهای ادغام که می‌توان همراه با
\fB\-\-tool\fR
استفاده کرد\&.
.RE
.PP
\fB\-y\fR, \fB\-\-no\-prompt\fR
.RS 4
پیش از هر بار فراخوانی برنامه حل ادغام، درخواستی برای تأیید نمایش ندهد\&. اگر برنامه حل ادغام به‌طور صریح با گزینه
\fB\-\-tool\fR
یا با متغیر پیکربندی
\fBmerge\&.tool\fR
مشخص شده باشد، این رفتار پیش‌فرض است\&.
.RE
.PP
\fB\-\-prompt\fR
.RS 4
پیش از هر بار فراخوانی برنامه حل ادغام، درخواستی برای تأیید نمایش دهد تا به کاربر امکان نادیده گرفتن مسیر داده شود\&.
.RE
.PP
\fB\-g\fR, \fB\-\-gui\fR
.RS 4
هنگامی که
\fBgit\-mergetool\fR
با گزینه
\fB\-g\fR
یا
\fB\-\-gui\fR
فراخوانی می‌شود، ابزار ادغام پیش‌فرض از متغیر پیکربندی‌شده
\fBmerge\&.guitool\fR
به جای
\fBmerge\&.tool\fR
خوانده خواهد شد\&. اگر
\fBmerge\&.guitool\fR
تنظیم نشده باشد، به ابزار پیکربندی‌شده تحت
\fBmerge\&.tool\fR
رجوع می‌شود\&. این مورد ممکن است به‌طور خودکار با استفاده از متغیر پیکربندی
\fBmergetool\&.guiDefault\fR
انتخاب شود\&.
.RE
.PP
\fB\-\-no\-gui\fR
.RS 4
این گزینه تنظیمات قبلی
\fB\-g\fR
یا
\fB\-\-gui\fR
یا پیکربندی
\fBmergetool\&.guiDefault\fR
را نادیده گرفته و ابزار ادغام پیش‌فرض را از متغیر پیکربندی‌شده
\fBmerge\&.tool\fR
می‌خواند\&.
.RE
.PP
\fB\-O\fR\fI<orderfile>\fR
.RS 4
پردازش فایل‌ها به ترتیبی که در
\fI<orderfile>\fR
مشخص شده است، که در هر خط آن یک الگوی تطابق شل (glob) قرار دارد\&. این گزینه متغیر پیکربندی
\fBdiff\&.orderFile\fR
را بازنویسی می‌کند (به
\fBgit-config\fR(1)
مراجعه کنید)\&. برای لغو
\fBdiff\&.orderFile\fR،
از
\fB\-O/dev/null\fR
استفاده کنید\&.
.RE
.SH "پیکربندی (CONFIGURATION)"
.sp
همه موارد پایین‌تر از این خط در این بخش به‌طور گزینشی از مستندات \fBgit-config\fR(1) آورده شده‌اند\&. محتوا همان چیزی است که در آنجا یافت می‌شود:
.PP
\fBmergetool\&.\fR\fI<tool>\fR\fB\&.path\fR
.RS 4
مسیر ابزار داده‌شده را بازنویسی می‌کند\&. این مورد در صورتی که ابزار شما در
\fB$PATH\fR
قرار ندارد مفید است\&.
.RE
.PP
\fBmergetool\&.\fR\fI<tool>\fR\fB\&.cmd\fR
.RS 4
دستور فراخوانی ابزار ادغام مشخص‌شده را تعیین می‌کند\&. دستور مشخص‌شده در شل با متغیرهای زیر که در دسترس هستند ارزیابی می‌شود:
\fBBASE\fR
نام یک فایل موقت حاوی پایه مشترک فایل‌های در حال ادغام (در صورت وجود) است؛
\fBLOCAL\fR
نام یک فایل موقت حاوی محتویات فایل روی شاخه جاری است؛
\fBREMOTE\fR
نام یک فایل موقت حاوی محتویات فایل از شاخه در حال ادغام است؛
\fBMERGED\fR
شامل نام فایلی است که ابزار ادغام باید نتایج یک ادغام موفق را در آن بنویسد\&.
.RE
.PP
\fBmergetool\&.\fR\fI<tool>\fR\fB\&.hideResolved\fR
.RS 4
به کاربر امکان می‌دهد مقدار سراسری
\fBmergetool\&.hideResolved\fR
را برای یک ابزار خاص بازنویسی کند\&. برای توضیحات کامل به
\fBmergetool\&.hideResolved\fR
مراجعه کنید\&.
.RE
.PP
\fBmergetool\&.\fR\fI<tool>\fR\fB\&.trustExitCode\fR
.RS 4
برای یک دستور ادغام سفارشی، مشخص می‌کند که آیا می‌توان از کد خروج دستور ادغام برای تعیین موفقیت‌آمیز بودن ادغام استفاده کرد یا خیر\&. اگر این مقدار روی true تنظیم نشده باشد، برچسب زمانی فایل مقصد ادغام بررسی می‌شود و در صورتی که فایل به‌روزرسانی شده باشد، ادغام موفقیت‌آمیز در نظر گرفته می‌شود؛ در غیر این صورت، از کاربر خواسته می‌شود موفقیت ادغام را تأیید کند\&.
.RE
.PP
\fBmergetool\&.meld\&.hasOutput\fR
.RS 4
نسخه‌های قدیمی‌تر
\fBmeld\fR
از گزینه
\fB\-\-output\fR
پشتیبانی نمی‌کنند\&. گیت با بررسی خروجی
\fBmeld\fR
\fB\-\-help\fR
تلاش می‌کند تشخیص دهد که آیا
\fBmeld\fR
از
\fB\-\-output\fR
پشتیبانی می‌کند یا خیر\&. پیکربندی
\fBmergetool\&.meld\&.hasOutput\fR
باعث می‌شود گیت این بررسی‌ها را نادیده بگیرد و به جای آن از مقدار پیکربندی‌شده استفاده کند\&. تنظیم
\fBmergetool\&.meld\&.hasOutput\fR
روی
\fBtrue\fR
به گیت می‌گوید که بدون قید و شرط از گزینه
\fB\-\-output\fR
استفاده کند، و مقدار
\fBfalse\fR
از استفاده از
\fB\-\-output\fR
خودداری می‌کند\&.
.RE
.PP
\fBmergetool\&.meld\&.useAutoMerge\fR
.RS 4
هنگامی که گزینه
\fB\-\-auto\-merge\fR
داده شود، meld تمام بخش‌های بدون تعارض را به‌طور خودکار ادغام می‌کند، بخش‌های دارای تعارض را برجسته می‌سازد و منتظر تصمیم کاربر می‌ماند\&. تنظیم
\fBmergetool\&.meld\&.useAutoMerge\fR
روی
\fBtrue\fR
به گیت می‌گوید که بدون قید و شرط از گزینه
\fB\-\-auto\-merge\fR
همراه با
\fBmeld\fR
استفاده کند\&. تنظیم این مقدار روی
\fBauto\fR
باعث می‌شود گیت بررسی کند که آیا
\fB\-\-auto\-merge\fR
پشتیبانی می‌شود یا خیر و تنها در صورت در دسترس بودن از
\fB\-\-auto\-merge\fR
استفاده کند\&. مقدار
\fBfalse\fR
به‌طور کلی از استفاده از
\fB\-\-auto\-merge\fR
خودداری می‌کند و مقدار پیش‌فرض است\&.
.RE
.PP
\fBmergetool\&.\fR\fI<variant>\fR\fB\&.layout\fR
.RS 4
چیدمان پنجره‌های تقسیم‌شده را برای
\fI<variant>\fR
ابزار vimdiff پیکربندی می‌کند، که می‌تواند هر یک از
\fBvimdiff\fR،
\fBnvimdiff\fR
یا
\fBgvimdiff\fR
باشد\&. هنگام اجرای
\fBgit\fR
\fBmergetool\fR
با
\fB\-\-tool=\fR\fI<variant>\fR
(یا بدون
\fB\-\-tool\fR
اگر
\fBmerge\&.tool\fR
به عنوان
\fI<variant>\fR
پیکربندی شده باشد)، گیت به
\fBmergetool\&.\fR\fI<variant>\fR\fB\&.layout\fR
مراجعه می‌کند تا چیدمان ابزار را تعیین کند\&. اگر پیکربندی ویژه نسخه در دسترس نباشد، تنظیمات
\fBvimdiff\fR
به عنوان جایگزین استفاده می‌شود\&. اگر آن هم در دسترس نباشد، یک چیدمان پیش‌فرض با ۴ پنجره استفاده خواهد شد\&. برای پیکربندی چیدمان، به بخش
\fIBACKEND SPECIFIC HINTS\fR
مراجعه کنید\&.
.RE
.PP
\fBmergetool\&.hideResolved\fR
.RS 4
در طول ادغام، گیت به‌طور خودکار تا حد امکان تعارضات را حل کرده و فایل
\fB$MERGED\fR
را شامل نشانگرهای تعارض در اطراف هر تعارضی که نتوانسته حل کند می‌نویسد؛
\fB$LOCAL\fR
و
\fB$REMOTE\fR
به‌طور معمول نسخه‌های فایل از قبل از حل تعارض گیت هستند\&. این پرچم باعث می‌شود
\fB$LOCAL\fR
و
\fB$REMOTE\fR
بازنویسی شوند به‌گونه‌ای که فقط تعارضات حل‌نشده به ابزار ادغام ارائه گردند\&. می‌تواند برای هر ابزار از طریق متغیر پیکربندی
\fBmergetool\&.\fR\fI<tool>\fR\fB\&.hideResolved\fR
پیکربندی شود\&. مقدار پیش‌فرض
\fBfalse\fR
است\&.
.RE
.PP
\fBmergetool\&.keepBackup\fR
.RS 4
پس از انجام یک ادغام، فایل اصلی دارای نشانگرهای تعارض را می‌توان با پسوند
\fB\&.orig\fR
ذخیره کرد\&. اگر این متغیر روی
\fBfalse\fR
تنظیم شود، این فایل نگهداری نمی‌شود\&. مقدار پیش‌فرض
\fBtrue\fR
است (یعنی فایل‌های پشتیبان نگه‌داشته می‌شوند)\&.
.RE
.PP
\fBmergetool\&.keepTemporaries\fR
.RS 4
هنگام فراخوانی یک ابزار ادغام سفارشی، گیت مجموعه‌ای از فایل‌های موقت را برای ارسال به ابزار استفاده می‌کند\&. اگر ابزار خطایی بازگرداند و این متغیر روی
\fBtrue\fR
تنظیم شده باشد، این فایل‌های موقت حفظ خواهند شد؛ در غیر این صورت، پس از خروج ابزار حذف می‌شوند\&. مقدار پیش‌فرض
\fBfalse\fR
است\&.
.RE
.PP
\fBmergetool\&.writeToTemp\fR
.RS 4
گیت به‌طور پیش‌فرض نسخه‌های موقت
\fBBASE\fR،
\fBLOCAL\fR
و
\fBREMOTE\fR
فایل‌های دارای تعارض را در درخت کاری می‌نویسد\&. هنگامی که این متغیر روی
\fBtrue\fR
تنظیم شود، گیت تلاش خواهد کرد تا از یک دایرکتوری موقت برای این فایل‌ها استفاده کند\&. مقدار پیش‌فرض
\fBfalse\fR
است\&.
.RE
.PP
\fBmergetool\&.prompt\fR
.RS 4
پیش از هر بار فراخوانی برنامه حل ادغام درخواست تأیید نمایش دهد\&.
.RE
.PP
\fBmergetool\&.guiDefault\fR
.RS 4
مقدار
\fBtrue\fR
را تنظیم کنید تا به‌طور پیش‌فرض از
\fBmerge\&.guitool\fR
استفاده شود (معادل مشخص کردن آرگومان
\fB\-\-gui\fR)،
یا
\fBauto\fR
را برای انتخاب
\fBmerge\&.guitool\fR
یا
\fBmerge\&.tool\fR
بسته به وجود مقدار در متغیر محیطی
\fBDISPLAY\fR
تنظیم کنید\&. مقدار پیش‌فرض
\fBfalse\fR
است، که در آن آرگومان
\fB\-\-gui\fR
باید به‌طور صریح ارائه شود تا
\fBmerge\&.guitool\fR
مورد استفاده قرار گیرد\&.
.RE
.SH "فایل‌های موقت (TEMPORARY FILES)"
.sp
دستور \fBgit\fR \fBmergetool\fR هنگام حل تعارض‌های ادغام، فایل‌های پشتیبان \fB*\&.orig\fR ایجاد می‌کند\&. پس از ادغام موفق یک فایل و پایان یافتن نشست \fBgit\fR \fBmergetool\fR آن، حذف این فایل‌ها بی‌خطر است\&.
.sp
تنظیم متغیر پیکربندی \fBmergetool\&.keepBackup\fR روی \fBfalse\fR باعث می‌شود \fBgit\fR \fBmergetool\fR هم‌زمان با ادغام موفق فایل‌ها، فایل‌های پشتیبان را به‌طور خودکار حذف کند\&.
.SH "نکات ویژه موتورهای ادغام (BACKEND SPECIFIC HINTS)"
.SS "vimdiff"
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBتوضیحات\fR
.RS 4
.sp
هنگام مشخص کردن \fB\-\-tool=vimdiff\fR در \fBgit\fR \fBmergetool\fR، گیت ابزار Vim را با چیدمان ۴ پنجره که به روش زیر توزیع شده است باز می‌کند:
.sp
.if n \{\
.RS 4
.\}
.nf
---------------------------------------------
|             |           |              |
|   LOCAL     |   BASE    |   REMOTE     |
|             |           |              |
---------------------------------------------
|                                        |
|                MERGED                  |
|                                        |
---------------------------------------------
.fi
.if n \{\
.RE
.\}
.sp
\fBLOCAL\fR، \fBBASE\fR و \fBREMOTE\fR بافرهای فقط‌خواندنی هستند که محتویات فایل دارای تعارض را در کامیت‌های مشخصی نشان می‌دهند (به‌ترتیب «کامیتی که در حال ادغام در آن هستید»، «کامیت جد مشترک» و «کامیتی که از آن در حال ادغام هستید»)\&.
.sp
\fBMERGED\fR یک بافر قابل‌نوشتن است که در آن باید تعارضات را برطرف کنید (با استفاده از سایر بافرهای فقط‌خواندنی به عنوان مرجع)\&. پس از پایان کار، مانند معمول ذخیره کرده و از Vim خارج شوید (\fB:wq\fR) یا اگر می‌خواهید عملیات را لغو کنید، با استفاده از \fB:cq\fR خارج شوید\&.
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBپیکربندی چیدمان\fR
.RS 4
.sp
می‌توانید چیدمان پنجره‌های مورد استفاده توسط Vim را با تنظیم متغیر پیکربندی \fBmergetool\&.vimdiff\&.layout\fR تغییر دهید که رشته‌ای را می‌پذیرد که در آن جداکننده‌های زیر دارای معنای ویژه‌ای هستند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB+\fR
برای «باز کردن یک برگه جدید» استفاده می‌شود
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB,\fR
برای «ایجاد یک تقسیم عمودی جدید» استفاده می‌شود
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB/\fR
برای «ایجاد یک تقسیم افقی جدید» استفاده می‌شود
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB@\fR
برای مشخص کردن فایلی که حاوی نسخه نهایی پس از حل تعارضات است استفاده می‌شود\&. اگر وجود نداشته باشد، به‌طور پیش‌فرض از
\fBMERGED\fR
استفاده خواهد شد\&.
.RE
.sp
اولویت عملگرها به صورت زیر است (می‌توانید از پرانتز برای تغییر آن استفاده کنید):
.sp
.if n \{\
.RS 4
.\}
.nf
`@` > `+` > `/` > `,`
.fi
.if n \{\
.RE
.\}
.sp
اجازه دهید برای درک نحوه عملکرد، چند مثال را بررسی کنیم:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBlayout\fR
\fB=\fR
"(\fBLOCAL\fR,BASE,REMOTE)\fB/MERGED\fR"
.sp
این دقیقاً همان چیدمان پیش‌فرضی است که قبلاً دیده‌ایم\&.
.sp
توجه داشته باشید که
\fB/\fR
بر
\fB,\fR
تقدم دارد و بنابراین در این مورد پرانتزها لازم نیستند\&. تعریف چیدمان بعدی معادل است:
.sp
.if n \{\
.RS 4
.\}
.nf
layout = "LOCAL,BASE,REMOTE / MERGED"
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBlayout\fR
\fB=\fR
"LOCAL,MERGED,REMOTE"
.sp
اگر بنا به دلایلی علاقه‌ای به بافر
\fBBASE\fR
نداشته باشیم\&.
.sp
.if n \{\
.RS 4
.\}
.nf
---------------------------------------------
|             |           |              |
|             |           |              |
|   LOCAL     |   MERGED  |   REMOTE     |
|             |           |              |
|             |           |              |
---------------------------------------------
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBlayout\fR
\fB=\fR
"MERGED"
.sp
فقط بافر
\fBMERGED\fR
نمایش داده خواهد شد\&. با این حال توجه داشته باشید که تمام بافرهای دیگر همچنان در vim بارگذاری شده‌اند و می‌توانید با دستور «buffers» به آن‌ها دسترسی داشته باشید\&.
.sp
.if n \{\
.RS 4
.\}
.nf
---------------------------------------------
|                                        |
|                                        |
|                 MERGED                 |
|                                        |
|                                        |
---------------------------------------------
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBlayout\fR
\fB=\fR
"@LOCAL,REMOTE"
.sp
هنگامی که
\fBMERGED\fR
در چیدمان وجود ندارد، باید یکی از بافرها را با علامت ات‌ساین (\fB@\fR) «نشانه‌گذاری» کنید\&. آن بافر به بافری تبدیل می‌شود که باید پس از حل تعارضات آن را ویرایش کرده و ذخیره نمایید\&.
.sp
.if n \{\
.RS 4
.\}
.nf
---------------------------------------------
|                   |                    |
|                   |                    |
|                   |                    |
|     LOCAL         |    REMOTE          |
|                   |                    |
|                   |                    |
|                   |                    |
---------------------------------------------
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBlayout\fR
\fB=\fR
"LOCAL,BASE,REMOTE
\fB/\fR
\fBMERGED\fR
\fB+\fR
\fBBASE\fR,LOCAL
\fB+\fR
\fBBASE\fR,REMOTE"
.sp
سه برگه باز خواهد شد: اولین برگه یک نسخه از چیدمان پیش‌فرض است، در حالی که دو برگه دیگر به‌ترتیب فقط تفاوت‌های میان (\fBBASE\fR
و
\fBLOCAL\fR)
و
(\fBBASE\fR
و
\fBREMOTE\fR)
را نشان می‌دهند\&.
.sp
.if n \{\
.RS 4
.\}
.nf
---------------------------------------------
| <TAB #1> |  TAB #2  |  TAB #3  |       |
---------------------------------------------
|             |           |              |
|   LOCAL     |   BASE    |   REMOTE     |
|             |           |              |
---------------------------------------------
|                                        |
|                MERGED                  |
|                                        |
---------------------------------------------
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
---------------------------------------------
|  TAB #1  | <TAB #2> |  TAB #3  |       |
---------------------------------------------
|                   |                    |
|                   |                    |
|                   |                    |
|     BASE          |    LOCAL           |
|                   |                    |
|                   |                    |
|                   |                    |
---------------------------------------------
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
---------------------------------------------
|  TAB #1  |  TAB #2  | <TAB #3> |       |
---------------------------------------------
|                   |                    |
|                   |                    |
|                   |                    |
|     BASE          |    REMOTE          |
|                   |                    |
|                   |                    |
|                   |                    |
---------------------------------------------
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBlayout\fR
\fB=\fR
"LOCAL,BASE,REMOTE
\fB/\fR
\fBMERGED\fR
\fB+\fR
\fBBASE\fR,LOCAL
\fB+\fR
\fBBASE\fR,REMOTE
\fB+\fR
(\fBLOCAL/BASE/REMOTE\fR)\fB,\fRMERGED"
.sp
مشابه مثال قبل، اما یک برگه چهارم با همان اطلاعات برگه اول و با چیدمانی متفاوت اضافه می‌کند\&.
.sp
.if n \{\
.RS 4
.\}
.nf
-------------------------------------------------
|  TAB #1  |  TAB #2  |  TAB #3  | <TAB #4> |
-------------------------------------------------
|       LOCAL         |                     |
|---------------------|                     |
|       BASE          |        MERGED       |
|---------------------|                     |
|       REMOTE        |                     |
-------------------------------------------------
.fi
.if n \{\
.RE
.\}
.sp
توجه داشته باشید که در تعریف برگه نهایی چگونه باید از پرانتز استفاده کنیم تا
\fB,\fR
بر
\fB/\fR
تقدم پیدا کند\&.
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBگونه‌ها (Variants)\fR
.RS 4
.sp
به جای \fB\-\-tool=vimdiff\fR، می‌توانید از یکی از این گونه‌های دیگر نیز استفاده کنید:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-tool=gvimdiff\fR، برای باز کردن gVim به جای Vim\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-tool=nvimdiff\fR، برای باز کردن Neovim به جای Vim\&.
.RE
.sp
هنگام استفاده از این گونه‌ها، برای تعیین یک چیدمان سفارشی باید متغیرهای پیکربندی \fBmergetool\&.gvimdiff\&.layout\fR و \fBmergetool\&.nvimdiff\&.layout\fR را به جای \fBmergetool\&.vimdiff\&.layout\fR تنظیم کنید (اگرچه در صورت تنظیم نشدن متغیر ویژه آن گونه، متغیر دوم به عنوان جایگزین استفاده خواهد شد)\&.
.sp
علاوه بر این، برای سازگاری با نسخه‌های قبلی گیت، می‌توانید \fB1\fR، \fB2\fR یا \fB3\fR را به \fBvimdiff\fR یا هر یک از گونه‌ها اضافه کنید (مثلاً: \fBvimdiff3\fR، \fBnvimdiff1\fR و غیره) تا از یک چیدمان از پیش تعریف‌شده استفاده نمایید\&. به عبارت دیگر، استفاده از \fB\-\-tool=\fR[\fBg\fR|\fBn\fR]\fBvimdiff\fR\fI<x>\fR معادل است با استفاده از \fB\-\-tool=\fR[\fBg\fR|\fBn\fR]\fBvimdiff\fR و تنظیم متغیر پیکربندی \fBmergetool\&.\fR[\fBg\fR|\fBn\fR]\fBvimdiff\&.layout\fR روی\&...
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI<x>\fR\fB=1\fR: "@LOCAL,
\fBREMOTE\fR"
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI<x>\fR\fB=2\fR: "LOCAL,
\fBMERGED\fR,
\fBREMOTE\fR"
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI<x>\fR\fB=3\fR: "MERGED"
.RE
.sp
مثال: استفاده از \fB\-\-tool=gvimdiff2\fR برنامه \fBgvim\fR را با سه ستون (\fBLOCAL\fR، \fBMERGED\fR و \fBREMOTE\fR) باز می‌کند\&.
.RE
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)