'\" t
.\"     Title: git-show-branch
.\"    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\-SHOW\-BRANCH" "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-show-branch \- نمایش شاخه‌ها و کامیت‌های آن‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit show\-branch\fR [\-a | \-\-all] [\-r | \-\-remotes] [\-\-topo\-order | \-\-date\-order]
                [\-\-current] [\-\-color[=<when>] | \-\-no\-color] [\-\-sparse]
                [\-\-more=<n> | \-\-list | \-\-independent | \-\-merge\-base]
                [\-\-no\-name | \-\-sha1\-name] [\-\-topics]
                [(<rev> | <glob>)\&...]
\fIgit show\-branch\fR (\-g | \-\-reflog)[=<n>[,<base>]] [\-\-list] [<ref>]
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
گراف پیشینه کامیت‌ها (commit ancestry graph) را با شروع از کامیت‌های نام‌برده با <rev>ها یا <glob>ها (یا تمام ارجاع‌های زیر refs/heads و/یا refs/tags) به صورت شبه‌بصری نمایش می‌دهد\&.
.sp
این دستور نمی‌تواند همزمان بیش از ۲۶ شاخه و کامیت را نمایش دهد\&.
.sp
در صورتی که هیچ <rev> یا <glob> در خط فرمان مشخص نشده باشد، از مقادیر چندگانه پیکربندی \fBshowbranch\&.default\fR استفاده می‌کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
<rev>
.RS 4
یک عبارت دلخواه SHA\-1 بسط‌یافته (نگاه کنید به
\fBgitrevisions\fR(7))
که معمولاً نام سرشاخه یا تگ است\&.
.RE
.PP
<glob>
.RS 4
یک الگوی glob که با نام شاخه‌ها یا تگ‌های زیر refs/ مطابقت دارد\&. برای نمونه، اگر شاخه‌های موضوعی زیادی زیر refs/heads/topic دارید، دادن
\fBtopic/*\fR
تمام آن‌ها را نمایش خواهد داد\&.
.RE
.PP
\-r, \-\-remotes
.RS 4
نمایش شاخه‌های ردیابی دوردست (remote\-tracking branches)\&.
.RE
.PP
\-a, \-\-all
.RS 4
نمایش همزمان شاخه‌های ردیابی دوردست و شاخه‌های محلی\&.
.RE
.PP
\-\-current
.RS 4
با این گزینه، در صورتی که شاخه جاری در خط فرمان داده نشده باشد، دستور آن را در فهرست revهای نمایشی می‌گنجاند\&.
.RE
.PP
\-\-topo\-order
.RS 4
به‌طور پیش‌فرض، شاخه‌ها و کامیت‌های آن‌ها به ترتیب معکوس زمانی نمایش داده می‌شوند\&. این گزینه باعث می‌شود که آن‌ها به ترتیب توپولوژیکی ظاهر شوند (یعنی کامیت‌های فرزند قبل از والدین خود نمایش داده شوند)\&.
.RE
.PP
\-\-date\-order
.RS 4
این گزینه مشابه
\fB\-\-topo\-order\fR
است از این حیث که هیچ والدی قبل از تمام فرزندانش نمی‌آید، اما در سایر موارد کامیت‌ها بر اساس تاریخ کامیت مرتب می‌شوند\&.
.RE
.PP
\-\-sparse
.RS 4
به‌طور پیش‌فرض، خروجی کامیت‌های ادغامی (merges) را که تنها از یک سرشاخه نمایشی قابل دستیابی هستند نادیده می‌گیرد\&. این گزینه آن‌ها را قابل مشاهده می‌کند\&.
.RE
.PP
\-\-more=<n>
.RS 4
معمولاً دستور با نمایش کامیتی که جد مشترک تمام شاخه‌ها است خروجی را متوقف می‌کند\&. این فلگ به دستور می‌گوید که <n> کامیت مشترک دیگر فراتر از آن را نیز نمایش دهد\&. هنگامی که <n> منفی باشد، تنها <ref>های داده‌شده را بدون نمایش درخت پیشینه کامیت‌ها نمایش می‌دهد\&.
.RE
.PP
\-\-list
.RS 4
مترادف برای
\fB\-\-more=\-1\fR
است\&.
.RE
.PP
\-\-merge\-base
.RS 4
به جای نمایش فهرست کامیت‌ها، پایه‌های ادغام (merge bases) ممکن را برای کامیت‌های مشخص‌شده تعیین می‌کند\&. تمام پایه‌های ادغام در تمام کامیت‌های مشخص‌شده وجود خواهند داشت\&. این رفتار با نحوه مدیریت سه یا چند کامیت در
\fBgit-merge-base\fR(1)
متفاوت است\&.
.RE
.PP
\-\-independent
.RS 4
در میان <ref>های داده‌شده، تنها مواردی را نمایش می‌دهد که از هیچ <ref> دیگری قابل دسترسی نباشند\&.
.RE
.PP
\-\-no\-name
.RS 4
رشته‌های نام‌گذاری را برای هر کامیت نمایش ندهد\&.
.RE
.PP
\-\-sha1\-name
.RS 4
به جای نام‌گذاری کامیت‌ها با استفاده از مسیر دستیابی به آن‌ها از سرشاخه‌ها (مانند "master~2" به معنای پدربزرگ "master")، آن‌ها را با پیشوند منحصربه‌فرد نام‌های شیءشان نام‌گذاری کند\&.
.RE
.PP
\-\-topics
.RS 4
تنها کامیت‌هایی را نمایش می‌دهد که روی اولین شاخه مشخص‌شده نیستند\&. این کار با پنهان کردن هر کامیتی که از قبل در خط اصلی توسعه قرار دارد، به ردیابی شاخه‌های موضوعی کمک می‌کند\&. با اجرای "git show\-branch \-\-topics master topic1 topic2"، تجدیدنظرهایی که با "git rev\-list ^master topic1 topic2" مشخص می‌شوند نمایش داده خواهند شد\&.
.RE
.PP
\-g, \-\-reflog[=<n>[,<base>]] [<ref>]
.RS 4
تعداد <n> ورودی اخیر ref\-log را برای ref مشخص‌شده نمایش می‌دهد\&. اگر <base> مشخص شده باشد، <n> ورودی به عقب از آن ورودی نمایش داده می‌شود\&. پارامتر <base> می‌تواند به عنوان شمارش یا تاریخ مشخص شود\&. هنگامی که پارامتر صریح <ref> داده نشود، پیش‌فرض آن شاخه جاری است (یا
\fBHEAD\fR
در صورتی که جدا (detached) شده باشد)\&.
.RE
.PP
\-\-color[=<when>]
.RS 4
رنگ‌آمیزی علامت وضعیت (یکی از این موارد:
\fB*\fR
!
\fB+\fR
\fB\-\fR)
برای هر کامیت متناسب با شاخه‌ای که در آن قرار دارد\&. مقدار باید یکی از always (پیش‌فرض)، never، یا auto باشد\&.
.RE
.PP
\-\-no\-color
.RS 4
خاموش کردن خروجی رنگی، حتی زمانی که فایل پیکربندی پیش‌فرض را روی خروجی رنگی قرار داده باشد\&. معادل
\fB\-\-color=never\fR
است\&.
.RE
.sp
توجه داشته باشید که گزینه‌های \-\-more، \-\-list، \-\-independent، و \-\-merge\-base مانعة‌الجمع هستند\&.
.SH "خروجی (OUTPUT)"
.sp
به ازای N عدد <ref>، اولین N خط شامل توضیح یک‌خطی از پیام کامیت آن‌ها خواهد بود\&. سرشاخه‌ای که توسط $GIT_DIR/HEAD به آن اشاره می‌شود با یک نویسه ستاره \fB*\fR به عنوان پیشوند مشخص می‌شود، در حالی که سایر سرشاخه‌ها با یک نویسه ! مشخص می‌شوند\&.
.sp
به دنبال این N خط، یک لاگ یک‌خطی برای هر کامیت با N نویسه تورفتگی نمایش داده می‌شود\&. اگر یک کامیت روی شاخه I\-اُم باشد، کاراکتر تورفتگی I\-اُم علامت \fB+\fR را نشان می‌دهد؛ در غیر این صورت یک فاصله خالی نشان داده می‌شود\&. کامیت‌های ادغام (merge commits) با یک علامت \fB\-\fR مشخص می‌شوند\&. هر کامیت یک نام کوتاه را نمایش می‌دهد که می‌توان از آن به عنوان یک SHA\-1 بسط‌یافته برای نام‌گذاری آن کامیت استفاده کرد\&.
.sp
مثال زیر سه شاخه "master"، "fixes"، و "mhf" را نشان می‌دهد:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git show\-branch master fixes mhf
* [master] Add \*(Aqgit show\-branch\*(Aq\&.
 ! [fixes] Introduce "reset type" flag to "git reset"
  ! [mhf] Allow "+remote:local" refspec to cause \-\-force when fetching\&.
\-\-\-
  + [mhf] Allow "+remote:local" refspec to cause \-\-force when fetching\&.
  + [mhf~1] Use git\-octopus when pulling more than one head\&.
 +  [fixes] Introduce "reset type" flag to "git reset"
  + [mhf~2] "git fetch \-\-force"\&.
  + [mhf~3] Use \&.git/remote/origin, not \&.git/branches/origin\&.
  + [mhf~4] Make "git pull" and "git fetch" default to origin
  + [mhf~5] Infamous \*(Aqoctopus merge\*(Aq
  + [mhf~6] Retire git\-parse\-remote\&.
  + [mhf~7] Multi\-head fetch\&.
  + [mhf~8] Start adding the $GIT_DIR/remotes/ support\&.
*++ [master] Add \*(Aqgit show\-branch\*(Aq\&.
.fi
.if n \{\
.RE
.\}
.sp
.sp
این سه شاخه همگی از یک کامیت مشترک [master] منشعب شده‌اند که پیام کامیت آن "Add \*(Aqgit show\-branch\*(Aq" است\&. شاخه "fixes" یک کامیت با عنوان "Introduce "reset type" flag to "git reset"" اضافه می‌کند\&. شاخه "mhf" کامیت‌های متعدد دیگری اضافه می‌کند\&. شاخه جاری "master" است\&.
.SH "مثال‌ها (EXAMPLES)"
.sp
اگر شاخه‌های اصلی خود را مستقیماً زیر \fBrefs/heads\fR نگه می‌دارید و شاخه‌های موضوعی را در زیردایرکتوری‌های آن قرار می‌دهید، قرار دادن موارد زیر در فایل پیکربندی می‌تواند مفید باشد:
.sp
.if n \{\
.RS 4
.\}
.nf
[showbranch]
        default = \-\-topo\-order
        default = heads/*
.fi
.if n \{\
.RE
.\}
.sp
.sp
با این کار، دستور \fBgit\fR \fBshow\-branch\fR بدون پارامترهای اضافی تنها شاخه‌های اصلی را نمایش می‌دهد\&. علاوه بر این، اگر تصادفاً روی شاخه موضوعی خود باشید، آن شاخه نیز نمایش داده می‌شود\&.
.sp
.if n \{\
.RS 4
.\}
.nf
$ git show\-branch \-\-reflog="10,1 hour ago" \-\-list master
.fi
.if n \{\
.RE
.\}
.sp
.sp
تعداد ۱۰ ورودی reflog را از سرشاخه به عقب تا ۱ ساعت پیش نمایش می‌دهد\&. بدون گزینه \fB\-\-list\fR، خروجی همچنین نشان می‌دهد که این سرشاخه‌ها چگونه از نظر توپولوژیکی به یکدیگر مرتبط هستند\&.
.SH "پیکربندی (CONFIGURATION)"
.sp
تمامی موارد زیر این خط در این بخش، به‌صورت گزینشی از مستندات \fBgit-config\fR(1) گنجانده شده‌اند\&. محتوا همان چیزی است که در آنجا یافت می‌شود:
.PP
showBranch\&.default
.RS 4
مجموعه پیش‌فرض شاخه‌ها برای
\fBgit-show-branch\fR(1)\&. به
\fBgit-show-branch\fR(1)
مراجعه کنید\&.
.RE
.SH "GIT"
.sp
بخشی از مجموعه \fBgit\fR(1)