українська мова ▾ Topics ▾ Latest version ▾ git-show-branch last updated in 2.46.0

НАЗВА

git-show-branch - Показати гілки та їхні коміти

СИНОПСИС

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>]

ОПИС

Напіввізуально показує граф походження комітів, починаючи з комітів з іменами <rev> або <glob> (або всіх посилань у розділі refs/heads та/або refs/tags).

Він не може показувати більше 26 гілок та комітів одночасно.

Він використовує багатозначні елементи конфігурації showbranch.default, якщо в командному рядку не вказано <rev> або <glob>.

ОПЦІЇ

<rev>

Довільний розширений вираз SHA-1 (див. gitrevisions[7]), який зазвичай іменує заголовок гілки або тег.

<glob>

Шаблон глобуса, який відповідає іменам гілок або тегів у refs/. Наприклад, якщо у вас є багато тематичних гілок у refs/heads/topic, використання topic/* відобразить їх усі.

-r
--remotes

Показати гілки віддаленого відстеження.

-a
--all

Показати як філії з віддаленим відстеженням, так і локальні філії.

--current

З цією опцією команда включає поточну гілку до списку версій, які будуть відображатися, якщо вона не вказана в командному рядку.

--topo-order

За замовчуванням гілки та їхні коміти відображаються у зворотному хронологічному порядку. Ця опція дозволяє їм відображатися в топологічному порядку (тобто коміти-нащадки відображаються раніше за батьківські).

--date-order

Цей параметр схожий на --topo-order у тому сенсі, що жоден батьківський елемент не йде перед усіма його дочірніми елементами, але в іншому випадку коміти впорядковуються відповідно до дати їхньої коміти.

--sparse

За замовчуванням у виводі не відображаються злиття, до яких можна дістатися лише з однієї відображеної підказки. Ця опція робить їх видимими.

--more=<n>

Зазвичай команда зупиняє вивід після показу коміту, який є спільним предком усіх гілок. Цей прапорець вказує команді перейти до <n> спільних комітів після цього. Коли <n> від’ємне, відображається лише задані <ref>, без показу дерева предків комітів.

--list

Синонім до слова --more=-1

--merge-base

Замість відображення списку комітів, визначте можливі бази злиття для зазначених комітів. Усі бази злиття будуть міститися у всіх зазначених комітах. Це відрізняється від того, як git-merge-base[1] обробляє випадок трьох або більше комітів.

--independent

Серед заданих <ref> відобразити лише ті, до яких неможливо дістатися з жодного іншого <ref>.

--no-name

Не показувати рядки імен для кожного коміту.

--sha1-name

Замість того, щоб іменувати коміти, використовуючи шлях до них з заголовків (наприклад, "master~2" для позначення прабатька "master"), назвіть їх унікальним префіксом імен їхніх об’єктів.

--topics

Показує лише коміти, які НЕ знаходяться в першій вказаній гілці. Це допомагає відстежувати тематичні гілки, приховуючи будь-який коміт, який вже знаходиться в основній лінії розробки. Якщо задано "git show-branch --topics master topic1 topic2", це покаже редакції, задані "git rev-list ^master topic1 topic2"

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

Показує <n> найновіших записів журналу посилань для заданого посилання. Якщо вказано <base>, <n> записів, починаючи з цього запису. <base> можна вказати як кількість або дату. Якщо явний параметр <ref> не вказано, за замовчуванням використовується поточна гілка (або HEAD, якщо вона відокремлена).

--color[=<when>]

Розфарбуйте знак статусу (один із цих: * ! + -) кожного коміту, що відповідає гілці, в якій він знаходиться. Значення має бути always (за замовчуванням), never або auto.

--no-color

Вимкнути кольоровий вивід, навіть якщо у файлі конфігурації задано кольоровий вивід за замовчуванням. Те саме, що й --color=never.

Зверніть увагу, що параметри --more, --list, --independent та --merge-base є взаємовиключними.

ВИХІД

Для N <ref> перші N рядків – це однорядковий опис з повідомлення коміту. Заголовок гілки, на який вказує $GIT_DIR/HEAD, починається зірочкою *, а інші заголовки – зірочкою !.

Після цих N рядків відображається однорядковий журнал для кожного коміту з відступом у N позицій. Якщо коміт знаходиться на I-й гілці, символ відступу I показує знак +; інакше - пробіл. Коміти злиття позначаються знаком -. Кожен коміт показує коротку назву, яку можна використовувати як розширений 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], повідомлення коміту якого — «Додати 'git show-branch'». Гілка «fixes» додає один коміт «Ввести прапорець «reset type» для «git reset»». Гілка «mhf» додає багато інших комітів. Поточна гілка — «master».

ПРИКЛАДИ

Якщо ви зберігаєте свої первинні гілки безпосередньо в refs/heads, а тематичні гілки в їхніх підкаталогах, наявність наступного коду в конфігураційному файлі може допомогти:

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

Таким чином, git show-branch без додаткових параметрів відображатиме лише основні гілки. Крім того, якщо ви перебуваєте на своїй тематичній гілці, вона також буде відображатися.

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

показує 10 записів у reflog, починаючи з підказки станом на 1 годину тому. Без --list, вивід також показує, як ці підказки топологічно пов’язані одна з одною.

КОНФІГУРАЦІЯ

Все, що знаходиться нижче цього рядка в цьому розділі, вибірково включено з документації git-config[1]. Вміст такий самий, як і там:

Warning

Missing uk/config/showbranch.adoc

See original version for this content.

GIT

Частина набору git[1]