'\" t
.\"     Title: git-merge-index
.\"    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: English
.\"
.TH "GIT\-MERGE\-INDEX" "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-index \- اجرای ادغام برای فایل‌های نیازمند ادغام
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit merge\-index\fR [\-o] [\-q] <merge\-program> (\-a | ( [\-\-] <file>\&...) )
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
این دستور <file>(ها) را در نمایه (index) جستجو می‌کند و اگر مدخل‌های ادغام وجود داشته باشد، هش SHA\-1 آن فایل‌ها را به عنوان آرگومان‌های ۱، ۲ و ۳ (اگر فایلی وجود نداشته باشد، آرگومان خالی) و <file> را به عنوان آرگومان ۴ ارسال می‌کند\&. حالت‌های فایل (file modes) برای این سه فایل به عنوان آرگومان‌های ۵، ۶ و ۷ ارسال می‌شوند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-\-
.RS 4
هیچ آرگومان دیگری را به عنوان گزینه تفسیر نکن\&.
.RE
.PP
\-a
.RS 4
اجرای ادغام روی تمامی فایل‌های موجود در نمایه که نیازمند ادغام هستند\&.
.RE
.PP
\-o
.RS 4
به جای توقف در نخستین ادغام ناموفق، همه آن‌ها را یک‌باره انجام بده \- به ادغام ادامه بده حتی اگر ادغام‌های قبلی با خطا مواجه شده باشند، و کد خطا را تنها پس از پایان تمام ادغام‌ها بازگردان\&.
.RE
.PP
\-q
.RS 4
در صورت بروز خطا در برنامه ادغام، هشداری صادر نکن (شکست در برنامه ادغام معمولاً نشان‌دهنده تداخل در طول ادغام است)\&. این گزینه برای دستورات سطح بالا (porcelains) کاربرد دارد که ممکن است بخواهند پیام‌های سفارشی صادر کنند\&.
.RE
.sp
اگر \fIgit merge\-index\fR با چند <file> (یا \-a) فراخوانی شود، آن‌ها را به نوبت پردازش می‌کند و تنها در صورتی متوقف می‌شود که برنامه ادغام یک کد خروج غیر صفر بازگرداند\&.
.sp
معمولاً این دستور به همراه اسکریپتی اجرا می‌شود که تقلید گیت از دستور \fImerge\fR بسته RCS را فراخوانی می‌کند\&.
.sp
یک اسکریپت نمونه به نام \fIgit merge\-one\-file\fR در توزیع گیت گنجانده شده است\&.
.sp
هشدار هشدار هشدار! ترتیب «شیء ادغام» در گیت با ترتیب شیء ادغام در برنامه \fImerge\fR متعلق به RCS متفاوت است\&. در ترتیب فوق، شیء اصلی (original) اول است\&. اما ترتیب آرگومان‌ها در برنامه ادغام ۳طرفه \fImerge\fR، شیء اصلی را در وسط قرار می‌دهد\&. دلیل آن را از من نپرسید\&.
.sp
مثال‌ها:
.sp
.if n \{\
.RS 4
.\}
.nf
torvalds@ppc970:~/merge\-test> git merge\-index cat MM
This is MM from the original tree\&.              # original
This is modified MM in the branch A\&.            # merge1
This is modified MM in the branch B\&.            # merge2
This is modified MM in the branch B\&.            # current contents
.fi
.if n \{\
.RE
.\}
.sp
.sp
یا
.sp
.if n \{\
.RS 4
.\}
.nf
torvalds@ppc970:~/merge\-test> git merge\-index cat AA MM
cat: : No such file or directory
This is added AA in the branch A\&.
This is added AA in the branch B\&.
This is added AA in the branch B\&.
fatal: merge program failed
.fi
.if n \{\
.RE
.\}
.sp
.sp
جایی که مثال دوم نشان می‌دهد چگونه \fIgit merge\-index\fR به محض اینکه چیزی با خطا بازگردد از تلاش برای ادغام بازمی‌ایستد (یعنی \fBcat\fR برای فایل AA خطا برگرداند، زیرا در فایل اصلی وجود نداشت، و در نتیجه \fIgit merge\-index\fR حتی تلاشی برای ادغام MM نکرد)\&.
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)