Monotone-viz
============

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

Monotone-viz is licensed under the GPL (General Public License),
either version 2, or (at your option) any later version.


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


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

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


RUNNING
=======
usage: monotone-viz [options] [db [branch]]
options:
  -noaa don't use an anti-aliased canvas
  --version print version number and exit

If db and branch are not specified on the command line and
monotone-viz is run from a monotone-controlled directory, it will
automatically use the database and branch specified in the MT/options
file.


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@gmail.com>
http://oandrieu.nerim.net/monotone-viz/