'\" t
.\"     Title: git-merge-file
.\"    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 Manual
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GIT\-MERGE\-FILE" "1" "2026\-06\-29" "Git 2\&.55\&.0" "Git Manual"
.\" -----------------------------------------------------------------
.\" * 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-merge-file \- اجرای یک ادغام سه‌طرفه روی فایل‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit merge\-file\fR [\-L <current\-name> [\-L <base\-name> [\-L <other\-name>]]]
        [\-\-ours|\-\-theirs|\-\-union] [\-p|\-\-stdout] [\-q|\-\-quiet] [\-\-marker\-size=<n>]
        [\-\-[no\-]diff3] [\-\-object\-id] <current> <base> <other>
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
با داشتن سه فایل \fI<current>\fR، \fI<base>\fR و \fI<other>\fR، دستور \fIgit merge\-file\fR تمام تغییراتی را که از \fI<base>\fR به \fI<other>\fR منتهی شده‌اند، در \fI<current>\fR اعمال می‌کند\&. نتیجه به طور معمول در \fI<current>\fR ذخیره می‌شود\&. دستور \fIgit merge\-file\fR برای ترکیب تغییرات جداگانه روی یک نسخه اصلی مفید است\&. فرض کنید \fI<base>\fR نسخه اصلی است و هر دو فایل \fI<current>\fR و \fI<other>\fR تغییراتی روی \fI<base>\fR هستند؛ در این حالت \fIgit merge\-file\fR هر دو دسته تغییرات را با یکدیگر ترکیب می‌کند\&.
.sp
اگر هر دو فایل \fI<current>\fR و \fI<other>\fR در بخش مشترکی از خطوط دارای تغییر باشند، یک تداخل (conflict) رخ می‌دهد\&. در صورت یافتن تداخل، \fIgit merge\-file\fR معمولاً یک هشدار چاپ می‌کند و تداخل را میان خطوطی شامل نشانگرهای <<<<<<< و >>>>>>> محصور می‌نماید\&. یک تداخل معمولی شبیه به این خواهد بود:
.sp
.if n \{\
.RS 4
.\}
.nf
<<<<<<< A
lines in file A
=======
lines in file B
>>>>>>> B
.fi
.if n \{\
.RE
.\}
.sp
در صورت وجود تداخل، کاربر باید نتیجه را ویرایش کرده و یکی از گزینه‌ها را حذف کند\&. با این حال، زمانی که گزینهٔ \fB\-\-ours\fR، \fB\-\-theirs\fR یا \fB\-\-union\fR فعال باشد، این تداخل‌ها به ترتیب به نفع خطوط \fI<current>\fR، خطوط \fI<other>\fR یا خطوط هر دو فایل حل می‌شوند\&. طول نشانگرهای تداخل را می‌توان با گزینهٔ \fB\-\-marker\-size\fR مشخص کرد\&.
.sp
اگر \fB\-\-object\-id\fR مشخص شود، دقیقاً همان رفتار رخ می‌دهد، با این تفاوت که به جای مشخص کردن مواردی که باید به عنوان فایل ادغام شوند، آنها به عنوان فهرستی از شناسه‌های شیء (object IDs) که به blobها اشاره دارند مشخص می‌شوند\&.
.sp
مقدار خروج (exit value) این برنامه در صورت بروز خطا منفی است، و در غیر این صورت برابر با تعداد تداخل‌ها خواهد بود (اگر تعداد تداخل‌ها بیشتر از این مقدار باشد، به ۱۲۷ محدود می‌شود)\&. اگر ادغام بدون تداخل انجام شود، مقدار خروج ۰ است\&.
.sp
دستور \fIgit merge\-file\fR طوری طراحی شده است که یک همتای کمینه از \fImerge\fR در RCS باشد؛ یعنی تمام قابلیت‌های \fImerge\fR در RCS را که توسط \fBgit\fR(1) مورد نیاز است پیاده‌سازی می‌کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-\-object\-id
.RS 4
محتویاتی که باید ادغام شوند را به جای فایل، به عنوان blob در مخزن فعلی مشخص می‌کند\&. در این حالت، عملیات باید درون یک مخزن معتبر انجام شود\&.
.sp
اگر گزینهٔ
\fB\-p\fR
مشخص شده باشد، فایل ادغام‌شده (از جمله تداخل‌ها، در صورت وجود) مانند حالت عادی به خروجی استاندارد ارسال می‌شود؛ در غیر این صورت، فایل ادغام‌شده در مخزن اشیاء (object store) نوشته شده و شناسه شیء (object ID) مربوط به blob آن در خروجی استاندارد نوشته می‌شود\&.
.RE
.PP
\-L <label>
.RS 4
این گزینه می‌تواند تا سه بار مشخص شود، و برچسب‌هایی را تعیین می‌کند که باید به جای نام فایل‌های متناظر در گزارش‌های تداخل استفاده شوند\&. یعنی دستور
\fBgit\fR
\fBmerge\-file\fR
\fB\-L\fR
\fBx\fR
\fB\-L\fR
\fBy\fR
\fB\-L\fR
\fBz\fR
\fBa\fR
\fBb\fR
\fBc\fR
خروجی‌ای تولید می‌کند که به نظر می‌رسد به جای فایل‌های a، b و c از فایل‌های x، y و z آمده است\&.
.RE
.PP
\-p
.RS 4
ارسال نتایج به خروجی استاندارد به جای بازنویسی روی
\fI<current>\fR\&.
.RE
.PP
\-q
.RS 4
حالت بی‌صدا؛ هشداری در مورد تداخل‌ها نمایش داده نمی‌شود\&.
.RE
.PP
\-\-diff3
.RS 4
نمایش تداخل‌ها به سبک «diff3»\&.
.RE
.PP
\-\-zdiff3
.RS 4
نمایش تداخل‌ها به سبک «zdiff3»\&.
.sp
مقدار پیش‌فرض گزینه‌های
\fB\-\-diff3\fR
و
\fB\-\-zdiff3\fR
از متغیر پیکربندی
\fBmerge\&.conflictStyle\fR
گرفته می‌شود (نگاه کنید به
\fBgit-config\fR(1))\&.
.RE
.PP
\-\-ours, \-\-theirs, \-\-union
.RS 4
به جای باقی گذاشتن تداخل‌ها در فایل، تداخل‌ها را به نفع خطوط طرف ما (یا طرف آنها یا هر دو) حل می‌کند\&.
.RE
.PP
\-\-diff\-algorithm={patience|minimal|histogram|myers}
.RS 4
استفاده از یک الگوریتم diff متفاوت هنگام ادغام\&. مقدار پیش‌فرض فعلی «myers» است، اما انتخاب الگوریتم‌های جدیدتر مانند «histogram» می‌تواند به جلوگیری از ادغام‌های نادرست که به دلیل خطوط منطبق کم‌اهمیت (مانند آکوالادهای توابع مجزا) رخ می‌دهند کمک کند\&. همچنین نگاه کنید به
\fBgit-diff\fR(1)
\fB\-\-diff\-algorithm\fR\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBgit\fR \fBmerge\-file\fR \fBREADME\&.my\fR \fBREADME\fR \fBREADME\&.upstream\fR
.RS 4
تغییرات README\&.my و README\&.upstream از زمان README را با هم ترکیب کرده، تلاش می‌کند آنها را ادغام کند و نتیجه را در README\&.my می‌نویسد\&.
.RE
.PP
\fBgit\fR \fBmerge\-file\fR \fB\-L\fR \fBa\fR \fB\-L\fR \fBb\fR \fB\-L\fR \fBc\fR \fBtmp/a123\fR \fBtmp/b234\fR \fBtmp/c345\fR
.RS 4
فایل‌های tmp/a123 و tmp/c345 را با نسخه پایه tmp/b234 ادغام می‌کند، اما به جای
\fBtmp/a123\fR
و
\fBtmp/c345\fR\&،
از برچسب‌های
\fBa\fR
و
\fBc\fR
استفاده می‌نماید\&.
.RE
.PP
\fBgit\fR \fBmerge\-file\fR \fB\-p\fR \fB\-\-object\-id\fR \fBabc1234\fR \fBdef567\fR \fB890abcd\fR
.RS 4
تغییرات blobهای abc1234 و 890abcd را از زمان def567 با هم ترکیب کرده، تلاش می‌کند آنها را ادغام کند و نتیجه را در خروجی استاندارد می‌نویسد\&.
.RE
.SH "گیت (GIT)"
.sp
بخشی از مجموعهٔ \fBgit\fR(1)