Below is the file 'README' from this revision. You can also download the file.


Git-viz
=======

This is a small GNOME application to visualize git ancestry graphs.


REQUIREMENTS
============
- dot from the graphviz package
  http://www.research.att.com/sw/tools/graphviz/
- GTK+ 2.4, libgnomecanvas

To compile from sources, you'll also need:
- ocaml compiler (>= 3.07)
- LablGTK 2.4.0 or lablgtk-20041119 or lablgtk-20050218
- libcrypto, from the openssl toolkit


COMPILING
=========
- compile/install ocaml and LablGTK
- if you've pulled this from the monotone repository,
  run `aclocal -I . && autoconf' to generate configure
- run ./configure, with the following options if needed :
    --with-lablgtk-dir
- make
- install the binary git-viz somewhere

see INSTALL for an in-depth description of this procedure.


RUNNING
=======
usage: git-viz [options] [git-controlled directory]
options:
  -noaa don't use an anti-aliased canvas


STYLE FILE
==========
Appearance can be controlled via a style file, named
`.mononote-viz.style', in the home directory.

grammar:
  "font" <font_name>
  "cert" cert_name <regexp> "[" ( attribute "=" <string> ";" )+ "]"
  "autocolor"     <none|key|author|branch>
  "layout"        <LR|TB>
  comments are delimited by "(*" and "*)"

When displaying a node, if the node has a cert named 'cert_name' whose
value matches 'regexp', then the specified attributes are used when
displaying the node.

example:
  font "Monospace 10"
  cert author "graydon@.*" [ color = "lightyellow"; ]

the supported attributes are:
 color         : background color for the node (a color name or a triplet "#rrggbb")
 outline_color : color of the node outline
 width_pixels  : width of the outline
 text_color    : color of the node's label


--
Olivier Andrieu <oandrieu@nerim.net>
http://oandrieu.nerim.net/monotone-viz/