نام (NAME)

git-show-branch - نمایش شاخه‌ها و کامیت‌های آن‌ها

خلاصه دستور (SYNOPSIS)

git show-branch [-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>)...]
git show-branch (-g | --reflog)[=<n>[,<base>]] [--list] [<ref>]

توضیحات (DESCRIPTION)

گراف پیشینه کامیت‌ها (commit ancestry graph) را با شروع از کامیت‌های نام‌برده با <rev>ها یا <glob>ها (یا تمام ارجاع‌های زیر refs/heads و/یا refs/tags) به صورت شبه‌بصری نمایش می‌دهد.

این دستور نمی‌تواند همزمان بیش از ۲۶ شاخه و کامیت را نمایش دهد.

در صورتی که هیچ <rev> یا <glob> در خط فرمان مشخص نشده باشد، از مقادیر چندگانه پیکربندی showbranch.default استفاده می‌کند.

گزینه‌ها (OPTIONS)

<rev>

<glob>

-r, --remotes

-a, --all

--current

--topo-order

--date-order

--sparse

--more=<n>

--list

--merge-base

--independent

--no-name

--sha1-name

--topics

-g, --reflog[=<n>[,<base>]] [<ref>]

--color[=<when>]

--no-color

توجه داشته باشید که گزینه‌های --more، --list، --independent، و --merge-base مانعة‌الجمع هستند.

خروجی (OUTPUT)

به ازای N عدد <ref>، اولین N خط شامل توضیح یک‌خطی از پیام کامیت آن‌ها خواهد بود. سرشاخه‌ای که توسط $GIT_DIR/HEAD به آن اشاره می‌شود با یک نویسه ستاره * به عنوان پیشوند مشخص می‌شود، در حالی که سایر سرشاخه‌ها با یک نویسه ! مشخص می‌شوند.

به دنبال این N خط، یک لاگ یک‌خطی برای هر کامیت با N نویسه تورفتگی نمایش داده می‌شود. اگر یک کامیت روی شاخه I-اُم باشد، کاراکتر تورفتگی I-اُم علامت + را نشان می‌دهد؛ در غیر این صورت یک فاصله خالی نشان داده می‌شود. کامیت‌های ادغام (merge commits) با یک علامت - مشخص می‌شوند. هر کامیت یک نام کوتاه را نمایش می‌دهد که می‌توان از آن به عنوان یک SHA-1 بسط‌یافته برای نام‌گذاری آن کامیت استفاده کرد.

مثال زیر سه شاخه "master"، "fixes"، و "mhf" را نشان می‌دهد:

$ git show-branch master fixes mhf
* [master] Add 'git show-branch'.
 ! [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 'octopus merge'
  + [mhf~6] Retire git-parse-remote.
  + [mhf~7] Multi-head fetch.
  + [mhf~8] Start adding the $GIT_DIR/remotes/ support.
*++ [master] Add 'git show-branch'.

این سه شاخه همگی از یک کامیت مشترک [master] منشعب شده‌اند که پیام کامیت آن "Add 'git show-branch'" است. شاخه "fixes" یک کامیت با عنوان "Introduce "reset type" flag to "git reset"" اضافه می‌کند. شاخه "mhf" کامیت‌های متعدد دیگری اضافه می‌کند. شاخه جاری "master" است.

مثال‌ها (EXAMPLES)

اگر شاخه‌های اصلی خود را مستقیماً زیر refs/heads نگه می‌دارید و شاخه‌های موضوعی را در زیردایرکتوری‌های آن قرار می‌دهید، قرار دادن موارد زیر در فایل پیکربندی می‌تواند مفید باشد:

[showbranch]
        default = --topo-order
        default = heads/*

با این کار، دستور git show-branch بدون پارامترهای اضافی تنها شاخه‌های اصلی را نمایش می‌دهد. علاوه بر این، اگر تصادفاً روی شاخه موضوعی خود باشید، آن شاخه نیز نمایش داده می‌شود.

$ git show-branch --reflog="10,1 hour ago" --list master

تعداد ۱۰ ورودی reflog را از سرشاخه به عقب تا ۱ ساعت پیش نمایش می‌دهد. بدون گزینه --list، خروجی همچنین نشان می‌دهد که این سرشاخه‌ها چگونه از نظر توپولوژیکی به یکدیگر مرتبط هستند.

پیکربندی (CONFIGURATION)

تمامی موارد زیر این خط در این بخش، به‌صورت گزینشی از مستندات git-config(1) گنجانده شده‌اند. محتوا همان چیزی است که در آنجا یافت می‌شود:

showBranch.default

GIT

بخشی از مجموعه git(1)