українська мова ▾ 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], повідомлення коміту якого — «Add 'git show-branch'». Гілка «fixes» додає один коміт "Introduce "reset type" flag to "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]