Documentation/git-show-branches-script.txt

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