1git-forest(1)                       hxtools                      git-forest(1)
2
3
4

Name

6       git-forest — display the commit history forest
7

Syntax

9       git-forest      [-a]     [--no-rebase]     [--style=number]     [--sha]
10       [--svdepth=depth] [rev-list-options] [refspec...]
11

Description

13       git-forest is a  command-line  zero-lookahead  git  repository  history
14       visualizer with Unicode output with a bit of gitk resemblance.
15
16   Why another program?
17       The  tree  visualization  of  gitk  is very useful, but there were (git
18       1.5.4 timeframe) no decent visualizers that can run in a  console  win‐
19       dow, without the need to have X around (which gitk depends on). tig has
20       numerous limitations, it  cannot  display  octopus  merges  or  octopus
21       branching.  As  of  git  1.5.6, there are still no other Unicode-output
22       programs known to me.
23
24   A bit of internals
25       git-forest originally was a zero-lookahead  visualizer,  i.e.  branches
26       were  accomodated  when they have first been seen. Since mid-June 2008,
27       git-forest has a lookahead tunable that controls  how  long  an  inter-
28       merge vine (a branch in the graphical sense) can be.
29

Options

31       -a     Display author for each commit.
32
33       --no-rebase
34              Do not show the rebase pseudo-refs.
35
36       --style=1
37              Use single-line visuals (default).
38
39       --style=2
40              Use double-line visuals.
41
42       --style=10
43              Use  specific  rounded  Unicode  visuals for edges; glyphs might
44              only be available with X11 terminals and appropriate fonts.
45
46       --style=15
47              Use single bold-line visuals. Not readily usable with  VGA  con‐
48              sole fonts without special unimaps.
49
50       --sha  Display (abbreviated) SHAs for each commit.
51
52       --svdepth=depth
53              This  option  controls  the maximum length of merge subvines. It
54              defaults to 2.
55
56       All other options and arguments are passed down  to  git-log.  Commonly
57       useful options are --all and --topo-order.
58

Examples

60       git-forest --all | less -RS
61       git-forest origin/master | less -RS
62
63       This  tool  does  not  try to minimize the empty space between branches
64       like gitk does. Take it as a feature.
65

See also

67       hxtools(7)
68
69
70
71hxtools                           2008-07-06                     git-forest(1)
Impressum