'\" t
.\"     Title: git-gui
.\"    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\-GUI" "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-gui \- یک رابط کاربری گرافیکی قابل‌حمل برای گیت
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit gui\fR [<command>] [<arguments>]
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
یک رابط گرافیکی کاربر مبتنی بر Tcl/Tk برای گیت\&. \fIgit gui\fR بر امکان‌پذیر ساختن اعمال تغییرات در مخزن توسط کاربران تمرکز دارد، از جمله ایجاد کامیت‌های جدید، اصلاح کامیت‌های پیشین، ساخت شاخه‌ها، انجام ادغام‌های محلی، و واکشی/ارسال به مخازن دوردست\&.
.sp
برخلاف \fIgitk\fR، \fIgit gui\fR بر تولید کامیت و حاشیه‌نویسی تک‌فایل (single file annotation) متمرکز است و تاریخچه پروژه را نمایش نمی‌دهد\&. با این حال، گزینه‌هایی در منو برای آغاز یک نشست \fIgitk\fR از درون \fIgit gui\fR فراهم می‌کند\&.
.sp
\fIgit gui\fR روی تمامی سیستم‌های پرکاربرد یونیکس، Mac OS X، و ویندوز (تحت هر دو محیط Cygwin و MSYS) کار می‌کند\&. تا جای ممکن از رهنمودهای رابط کاربری مختص هر سیستم‌عامل پیروی شده است، که باعث می‌شود \fIgit gui\fR یک رابط نسبتاً بومی (native) برای کاربران به نظر برسد\&.
.SH "دستورات (COMMANDS)"
.PP
blame
.RS 4
یک نمایش‌دهنده blame را روی فایل مشخص‌شده در نسخه داده‌شده (یا در پوشه کاری در صورت عدم تعیین) اجرا می‌کند\&.
.RE
.PP
browser
.RS 4
یک مرورگر درختی را باز می‌کند که تمام فایل‌های موجود در کامیت مشخص‌شده را نمایش می‌دهد\&. فایل‌های انتخاب‌شده از طریق مرورگر در نمایش‌دهنده blame باز می‌شوند\&.
.RE
.PP
citool
.RS 4
ابزار
\fIgit gui\fR
را اجرا کرده و ترتیبی می‌دهد که پیش از خروج و بازگشت به پوسته، دقیقاً یک کامیت انجام شود\&. رابط برنامه تنها به کنش‌های مربوط به کامیت محدود می‌شود که زمان راه‌اندازی برنامه را اندکی کاهش داده و نوار منو را ساده‌تر می‌کند\&.
.RE
.PP
version
.RS 4
نسخه در حال اجرای
\fIgit gui\fR
را نمایش می‌دهد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBgit\fR \fBgui\fR \fBblame\fR \fBMakefile\fR
.RS 4
محتوای فایل
\fIMakefile\fR
را در پوشه کاری کنونی نشان می‌دهد، و حاشیه‌نویسی‌هایی برای پدیدآورنده اصلی هر خط و فردی که خط را به مکان کنونی‌اش انتقال داده ارائه می‌کند\&. فایل کامیت‌نشده حاشیه‌نویسی می‌شود، و تغییرات کامیت‌نشده (در صورت وجود) صراحتاً به
\fINot Yet Committed\fR
نسبت داده می‌شوند\&.
.RE
.PP
\fBgit\fR \fBgui\fR \fBblame\fR \fBv0\&.99\&.8\fR \fBMakefile\fR
.RS 4
محتوای
\fIMakefile\fR
را در بازنگری
\fIv0\&.99\&.8\fR
نمایش می‌دهد و حاشیه‌نویسی‌هایی برای هر خط ارائه می‌کند\&. برخلاف مثال بالا، فایل از پایگاه داده اشیاء خوانده می‌شود و نه از پوشه کاری\&.
.RE
.PP
\fBgit\fR \fBgui\fR \fBblame\fR \fB\-\-line=100\fR \fBMakefile\fR
.RS 4
حاشیه‌نویسی‌ها را طبق توضیحات بالا بارگیری کرده و به صورت خودکار نما را طوری پیمایش می‌کند تا روی خط
\fI100\fR
متمرکز شود\&.
.RE
.PP
\fBgit\fR \fBgui\fR \fBcitool\fR
.RS 4
یک کامیت انجام می‌دهد و پس از پایان به پوسته بازمی‌گردد\&. چنانچه پنجره به هر روشی غیر از انجام کامیت بسته شود، این دستور یک کد خروج غیر صفر برمی‌گرداند\&.
.RE
.PP
\fBgit\fR \fBgui\fR \fBcitool\fR \fB\-\-amend\fR
.RS 4
به صورت خودکار وارد حالت
\fIAmend Last Commit\fR
(اصلاح آخرین کامیت) در رابط کاربری می‌شود\&.
.RE
.PP
\fBgit\fR \fBgui\fR \fBcitool\fR \fB\-\-nocommit\fR
.RS 4
مانند citool معمولی رفتار می‌کند، اما به جای انجام کامیت تنها با کد خروج صفر پایان می‌یابد\&. همچنان بررسی می‌کند که نمایه (index) حاوی ورودی‌های ادغام‌نشده نباشد، بنابراین می‌توانید از آن به عنوان یک نسخه گرافیکی از
\fBgit-mergetool\fR(1)
استفاده کنید\&.
.RE
.PP
\fBgit\fR \fBcitool\fR
.RS 4
مشابه
\fBgit\fR
\fBgui\fR
\fBcitool\fR
(در بالا)\&.
.RE
.PP
\fBgit\fR \fBgui\fR \fBbrowser\fR \fBmaint\fR
.RS 4
یک مرورگر برای ساختار درختی شاخه
\fImaint\fR
نمایش می‌دهد\&. فایل‌های انتخاب‌شده در مرورگر را می‌توان با نمایش‌دهنده داخلی blame مشاهده کرد\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBgitk\fR(1)
.RS 4
مرورگر مخزن گیت\&. شاخه‌ها، تاریخچه کامیت‌ها و تفاوت‌های فایل‌ها را نمایش می‌دهد\&. gitk ابزاری است که توسط کنش‌های Repository Visualize در
\fIgit gui\fR
اجرا می‌شود\&.
.RE
.SH "سایر موارد (OTHER)"
.sp
\fIgit gui\fR در واقع به عنوان یک پروژه مستقل نگهداری می‌شود، اما نسخه‌های پایدار آن به عنوان بخشی از مجموعه گیت جهت آسودگی کاربران نهایی توزیع می‌شوند\&.
.sp
مخزن رسمی پروژه \fIgit gui\fR را می‌توان در نشانی زیر یافت:
.sp
.if n \{\
.RS 4
.\}
.nf
https://github\&.com/j6t/git\-gui
.fi
.if n \{\
.RE
.\}
.SH "GIT"
.sp
بخشی از مجموعه \fBgit\fR(1)