'\" t
.\"     Title: git-mergetool--lib
.\"    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\-MERGETOOL\-\-LIB" "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-mergetool--lib \- قطعه‌کدهای اسکریپت شل مشترک برای ابزار ادغام گیت
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fITOOL_MODE=(diff|merge) \&. "$(git \-\-exec\-path)/git\-mergetool\-\-lib"\fR
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
این دستوری نیست که کاربر نهایی بخواهد آن را اجرا کند؛ هرگز\&. این مستندات برای افرادی است که اسکریپت‌های پورسلین (Porcelain\-ish) را مطالعه می‌کنند یا در حال نوشتن موارد جدید هستند\&.
.sp
قطعه‌کد اسکریپت \fIgit\-mergetool\-\-lib\fR برای این طراحی شده است که توسط سایر اسکریپت‌های شل (با استفاده از \&.) سورس شود تا توابع کار با ابزارهای ادغام گیت را آماده کند\&.
.sp
پیش از سورس کردن \fIgit\-mergetool\-\-lib\fR، اسکریپت شما باید \fBTOOL_MODE\fR را تنظیم کند تا حالت عملیات را برای توابع فهرست‌شده در زیر تعیین کند\&. مقادیر مجاز \fIdiff\fR و \fImerge\fR هستند\&.
.SH "توابع (FUNCTIONS)"
.PP
get_merge_tool
.RS 4
یک ابزار ادغام را برمی‌گرداند\&. اگر ابزار ادغام حدس‌زده‌شده بازگردانده شود، کد خروجی ۱ است و در غیر این صورت ۰\&.
\fI$GIT_MERGETOOL_GUI\fR
می‌تواند روی
\fItrue\fR
تنظیم شود تا به دنبال ابزار گرافیکی (guitool) مناسب جستجو شود\&.
.RE
.PP
get_merge_tool_cmd
.RS 4
دستور سفارشی را برای یک ابزار ادغام برمی‌گرداند\&.
.RE
.PP
get_merge_tool_path
.RS 4
مسیر سفارشی را برای یک ابزار ادغام برمی‌گرداند\&.
.RE
.PP
initialize_merge_tool
.RS 4
توابع خاص ابزار ادغام را در دامنه اجرایی قرار می‌دهد تا بتوان از آن‌ها استفاده کرد یا آن‌ها را بازنویسی (override) نمود\&.
.RE
.PP
run_merge_tool
.RS 4
با داشتن نام ابزار و یک فلگ true/false برای مشخص کردن اینکه آیا پایه ادغام (merge base) وجود دارد یا خیر، ابزار ادغام را اجرا می‌کند\&.
\fI$MERGED\fR،
\fI$LOCAL\fR،
\fI$REMOTE\fR و
\fI$BASE\fR
باید برای استفاده توسط ابزار ادغام تعریف شده باشند\&.
.RE
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)