2005-08-23 06:16:46 +00:00
|
|
|
git-show-branch(1)
|
|
|
|
==================
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
2006-03-09 16:24:50 +00:00
|
|
|
git-show-branch - Show branches and their commits
|
2005-08-23 06:16:46 +00:00
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
2006-01-11 08:16:42 +00:00
|
|
|
[verse]
|
2006-12-22 13:58:39 +00:00
|
|
|
'git-show-branch' [--all] [--remotes] [--topo-order] [--current]
|
2006-03-06 00:00:48 +00:00
|
|
|
[--more=<n> | --list | --independent | --merge-base]
|
2006-12-18 15:48:33 +00:00
|
|
|
[--no-name | --sha1-name] [--topics] [<rev> | <glob>]...
|
2006-12-26 08:11:50 +00:00
|
|
|
'git-show-branch' --reflog[=<n>] <ref>
|
2005-08-23 06:16:46 +00:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2005-12-04 23:58:50 +00:00
|
|
|
|
|
|
|
Shows the commit ancestry graph starting from the commits named
|
|
|
|
with <rev>s or <globs>s (or all refs under $GIT_DIR/refs/heads
|
|
|
|
and/or $GIT_DIR/refs/tags) semi-visually.
|
|
|
|
|
|
|
|
It cannot show more than 29 branches and commits at a time.
|
|
|
|
|
2006-01-11 08:09:16 +00:00
|
|
|
It uses `showbranch.default` multi-valued configuration items if
|
|
|
|
no <rev> nor <glob> is given on the command line.
|
|
|
|
|
2005-08-23 06:16:46 +00:00
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
-------
|
2005-12-04 23:58:50 +00:00
|
|
|
<rev>::
|
|
|
|
Arbitrary extended SHA1 expression (see `git-rev-parse`)
|
|
|
|
that typically names a branch HEAD or a tag.
|
|
|
|
|
|
|
|
<glob>::
|
|
|
|
A glob pattern that matches branch or tag names under
|
|
|
|
$GIT_DIR/refs. For example, if you have many topic
|
|
|
|
branches under $GIT_DIR/refs/heads/topic, giving
|
|
|
|
`topic/*` would show all of them.
|
2005-08-23 06:16:46 +00:00
|
|
|
|
2006-12-22 13:58:39 +00:00
|
|
|
-r|--remotes::
|
|
|
|
Show the remote-tracking branches.
|
|
|
|
|
|
|
|
-a|--all::
|
|
|
|
Show both remote-tracking branches and local branches.
|
2005-08-23 06:16:46 +00:00
|
|
|
|
2006-01-11 08:16:42 +00:00
|
|
|
--current::
|
|
|
|
With this option, the command includes the current
|
|
|
|
branch to the list of revs to be shown when it is not
|
|
|
|
given on the command line.
|
|
|
|
|
2005-12-08 23:28:05 +00:00
|
|
|
--topo-order::
|
|
|
|
By default, the branches and their commits are shown in
|
|
|
|
reverse chronological order. This option makes them
|
|
|
|
appear in topological order (i.e., descendant commits
|
|
|
|
are shown before their parents).
|
|
|
|
|
2006-07-07 02:21:47 +00:00
|
|
|
--sparse::
|
|
|
|
By default, the output omits merges that are reachable
|
|
|
|
from only one tip being shown. This option makes them
|
|
|
|
visible.
|
|
|
|
|
2005-08-23 06:16:46 +00:00
|
|
|
--more=<n>::
|
|
|
|
Usually the command stops output upon showing the commit
|
|
|
|
that is the common ancestor of all the branches. This
|
2005-08-30 00:21:06 +00:00
|
|
|
flag tells the command to go <n> more common commits
|
2005-09-09 22:40:45 +00:00
|
|
|
beyond that. When <n> is negative, display only the
|
|
|
|
<reference>s given, without showing the commit ancestry
|
|
|
|
tree.
|
|
|
|
|
|
|
|
--list::
|
2006-01-11 08:09:16 +00:00
|
|
|
Synonym to `--more=-1`
|
2005-08-23 06:16:46 +00:00
|
|
|
|
|
|
|
--merge-base::
|
|
|
|
Instead of showing the commit list, just act like the
|
2005-09-08 19:15:52 +00:00
|
|
|
'git-merge-base -a' command, except that it can accept
|
|
|
|
more than two heads.
|
2005-08-23 06:16:46 +00:00
|
|
|
|
2005-09-09 22:40:45 +00:00
|
|
|
--independent::
|
|
|
|
Among the <reference>s given, display only the ones that
|
|
|
|
cannot be reached from any other <reference>.
|
|
|
|
|
2005-10-11 22:22:48 +00:00
|
|
|
--no-name::
|
|
|
|
Do not show naming strings for each commit.
|
|
|
|
|
|
|
|
--sha1-name::
|
|
|
|
Instead of naming the commits using the path to reach
|
|
|
|
them from heads (e.g. "master~2" to mean the grandparent
|
|
|
|
of "master"), name them with the unique prefix of their
|
|
|
|
object names.
|
|
|
|
|
2006-12-18 15:48:33 +00:00
|
|
|
--topics::
|
|
|
|
Shows only commits that are NOT on the first branch given.
|
|
|
|
This helps track topic branches by hiding any commit that
|
|
|
|
is already in the main line of development. When given
|
|
|
|
"git show-branch --topics master topic1 topic2", this
|
|
|
|
will show the revisions given by "git rev-list {caret}master
|
|
|
|
topic1 topic2"
|
|
|
|
|
2006-12-26 08:11:50 +00:00
|
|
|
--reflog[=<n>] <ref>::
|
|
|
|
Shows <n> most recent ref-log entries for the given ref.
|
|
|
|
|
|
|
|
|
2005-09-09 22:40:45 +00:00
|
|
|
Note that --more, --list, --independent and --merge-base options
|
|
|
|
are mutually exclusive.
|
|
|
|
|
2005-08-23 06:16:46 +00:00
|
|
|
|
|
|
|
OUTPUT
|
|
|
|
------
|
|
|
|
Given N <references>, the first N lines are the one-line
|
|
|
|
description from their commit message. The branch head that is
|
2006-01-11 22:02:38 +00:00
|
|
|
pointed at by $GIT_DIR/HEAD is prefixed with an asterisk `*`
|
|
|
|
character while other heads are prefixed with a `!` character.
|
2005-08-23 06:16:46 +00:00
|
|
|
|
|
|
|
Following these N lines, one-line log for each commit is
|
|
|
|
displayed, indented N places. If a commit is on the I-th
|
2006-01-11 22:02:38 +00:00
|
|
|
branch, the I-th indentation character shows a `+` sign;
|
|
|
|
otherwise it shows a space. Merge commits are denoted by
|
|
|
|
a `-` sign. Each commit shows a short name that
|
2005-12-29 09:20:06 +00:00
|
|
|
can be used as an extended SHA1 to name that commit.
|
2005-08-23 06:16:46 +00:00
|
|
|
|
|
|
|
The following example shows three branches, "master", "fixes"
|
|
|
|
and "mhf":
|
|
|
|
|
|
|
|
------------------------------------------------
|
|
|
|
$ git show-branch master fixes mhf
|
2006-01-11 22:02:38 +00:00
|
|
|
* [master] Add 'git show-branch'.
|
2005-08-23 06:16:46 +00:00
|
|
|
! [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 heads.
|
|
|
|
+ [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.
|
2006-01-11 22:02:38 +00:00
|
|
|
*++ [master] Add 'git show-branch'.
|
2005-08-23 06:16:46 +00:00
|
|
|
------------------------------------------------
|
|
|
|
|
|
|
|
These three branches all forked from a common commit, [master],
|
|
|
|
whose commit message is "Add 'git show-branch'. "fixes" branch
|
|
|
|
adds one commit 'Introduce "reset type"'. "mhf" branch has many
|
2006-01-11 22:02:38 +00:00
|
|
|
other commits. The current branch is "master".
|
2005-08-23 06:16:46 +00:00
|
|
|
|
|
|
|
|
2006-01-11 08:09:16 +00:00
|
|
|
EXAMPLE
|
|
|
|
-------
|
|
|
|
|
|
|
|
If you keep your primary branches immediately under
|
|
|
|
`$GIT_DIR/refs/heads`, and topic branches in subdirectories of
|
|
|
|
it, having the following in the configuration file may help:
|
|
|
|
|
|
|
|
------------
|
|
|
|
[showbranch]
|
|
|
|
default = --topo-order
|
|
|
|
default = heads/*
|
|
|
|
|
|
|
|
------------
|
|
|
|
|
2006-03-18 00:25:46 +00:00
|
|
|
With this, `git show-branch` without extra parameters would show
|
2006-01-11 08:16:42 +00:00
|
|
|
only the primary branches. In addition, if you happen to be on
|
|
|
|
your topic branch, it is shown as well.
|
2006-01-11 08:09:16 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2005-08-23 06:16:46 +00:00
|
|
|
Author
|
|
|
|
------
|
|
|
|
Written by Junio C Hamano <junkio@cox.net>
|
|
|
|
|
|
|
|
|
|
|
|
Documentation
|
|
|
|
--------------
|
|
|
|
Documentation by Junio C Hamano.
|
|
|
|
|
|
|
|
|
|
|
|
GIT
|
|
|
|
---
|
2005-09-19 10:10:51 +00:00
|
|
|
Part of the gitlink:git[7] suite
|