git-show-branch(1) (original) (raw)

Given N s, the first N lines are the one-line description from their commit message. The branch head that is pointed at by $GIT_DIR/HEAD is prefixed with an asterisk * character while other heads are prefixed with a ! character.

Following these N lines, a one-line log for each commit is displayed, indented N places. If a commit is on the I-th 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 can be used as an extended SHA-1 to name that commit.

The following example shows three branches, "master", "fixes", and "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'.

These three branches all forked from a common commit, [master], whose commit message is "Add 'git show-branch'". The "fixes" branch adds one commit "Introduce "reset type" flag to "git reset"". The "mhf" branch adds many other commits. The current branch is "master".