Documentation / git-show-branches-script.txton commit [PATCH] Reformat git-show-branches-script documentation. (e3fdb7f)
   1git-show-branches-script(1)
   2===========================
   3v0.99.4, Aug 2005
   4
   5NAME
   6----
   7git-show-branches-script - Show branches and their commits.
   8
   9SYNOPSIS
  10--------
  11'git show-branches <reference>...'
  12
  13DESCRIPTION
  14-----------
  15Shows the head commits from the named <reference> (or all refs under
  16$GIT_DIR/refs/heads), and displays concise list of commit logs
  17to show their relationship semi-visually.
  18
  19OPTIONS
  20-------
  21<reference>::
  22        Name of the reference under $GIT_DIR/refs/heads/.
  23
  24
  25OUTPUT
  26------
  27Given N <references>, the first N lines are the one-line
  28description from their commit message.  The branch head that is
  29pointed at by $GIT_DIR/HEAD is prefixed with an asterisk '*'
  30character while other heads are prefixed with a '!' character.
  31
  32Following these N lines, one-line log for each commit is
  33displayed, indented N places.  If a commit is on the I-th
  34branch, the I-th indentation character shows a '+' sign;
  35otherwise it shows a space.
  36
  37The following example shows three branches, "pu", "master" and
  38"rc":
  39
  40------------------------------------------------
  41* [pu] Add cheap local clone '-s' flag to git-clone-script
  42 ! [master] Documentation updates.
  43  ! [rc] Merge master into rc
  44+   Add cheap local clone '-s' flag to git-clone-script
  45+   Alternate object pool mechanism updates.
  46+   Audit rev-parse users.
  47++  Documentation updates.
  48  + Merge master into rc
  49+++ [PATCH] plug memory leak in diff.c::diff_free_filepair()
  50------------------------------------------------
  51
  52These three branches all forked from a common commit, "[PATCH]
  53plug memory leak...", and "rc" has one commit ahead of it.  The
  54"master" branch has one different commit that is also shared by
  55"pu" branch, and "pu" branch has three more commits on top of
  56"master" branch.
  57
  58
  59Author
  60------
  61Written by Junio C Hamano <junkio@cox.net>
  62
  63
  64Documentation
  65--------------
  66Documentation by Junio C Hamano.
  67
  68
  69GIT
  70---
  71Part of the link:git.html[git] suite