Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
git-forest(1)			     hxtools			   git-forest(1)

Name
     git-forest -- display the commit history forest

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

Description
     git-forest is a command-line zero-lookahead git repository history  visual-
     izer with Unicode output with a bit of gitk resemblance.

   Why another program?
     The  tree	visualization  of gitk is very useful, but there were (git 1.5.4
     timeframe) no decent visualizers that can run in a console window,  without
     the need to have X around (which gitk depends on). tig has numerous limita-
     tions,  it  cannot  display  octopus merges or octopus branching. As of git
     1.5.6, there are still no other Unicode-output programs known to me.

Options
     -a     Display author for each commit.

     --no-rebase
	    Do not show the rebase pseudo-refs.

     --style=1
	    Use single-line visuals (default).

     --style=2
	    Use double-line visuals.

     --style=10
	    Use specific rounded Unicode visuals for edges; glyphs might only be
	    available with X11 terminals and appropriate fonts.

     --style=15
	    Use single bold-line visuals. Not readily usable  with  VGA  console
	    fonts without special unimaps.

     --sha  Display (abbreviated) SHAs for each commit.

     --svdepth=distance
	    This  option  controls the maximum look-ahead window. If M0's parent
	    (M1) appears within distance or fewer lines of M0, a "sub-vine" will
	    be drawn in the space between the regular vines.
	    Default: 3

	     $ git-forest --svdepth=3 --topo-order
	     aa M0: Merge G into M
	     aaa
	     a a G0
	     a a G1: Merge N into G
	     a aaa
	     a a a N0
	     a a a N1
	     a a a N2
	     a a a N3
	     aaa a
	     a	 a G2/M1
	     aaaaa
	     a N4/M2

	     $ git-forest --svdepth=5 --topo-order
	     aa M0: Merge G into M
	     aaa
	     a a G0
	     a a G1: Merge N in to G
	     aaax
	     aaa N0
	     aaa N1
	     aaa N2
	     aaa N3
	     aaa
	     a a G2/M1
	     aaa
	     a N4/M2

	     For comparison, this is the date-order representation of this exam-
	     ple, in case you want to reproduce it:
	     $ git-forest --date-order
	     aa M0: Merge G into M
	     aaa
	     a a G0
	     a a G1: Merge N into G
	     aaax
	     aaa
	     a a G2/M1
	     a a N0
	     a a N1
	     a a N2
	     a a N3
	     aaa
	     a N4/M2

     All other options and arguments are passed down to git-log. Commonly useful
     options are --all and --topo-order.

Examples
     git-forest --all | less -RS
     git-forest origin/master | less -RS

     This tool does not try to minimize the empty space  between  branches  like
     gitk does. Take it as a feature.

See also
     hxtools(7)

hxtools 			   2008-07-06			   git-forest(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=git-forest&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help