CvsGraph(1)

NAME
cvsgraph - A CVS/RCS repository grapher

SYNOPSIS
cvsgraph [options] file

DESCRIPTION
CvsGraph generates images and imagemaps from CVS/RCS repository files.

OPTIONS

-c file
    Read alternate config from file.

-d level
    Enable debug mode at level. The amount of information is determined by a bitwise or of the following: 1=config lexer, 2=config parser, 4=rcsfile lexer, 8=rcsfile parser, 16=rcsfile structure. The level argument may be in decimal, octal or hexadecimal format.

-h  A brief description of possible options.

-i  Generate an imagemap instead of an image.

-M name
    Use name as imagemap name (has only effect in combination with -i).

-m mod
    Use mod as cvsmodule.

-o file
    Output to file. Otherwise, output is written to standard output.

-q  Be quiet (i.e. no warnings)

-r path
    Use path as cvsroot.

-V  Print version and exit.

-[0-9] txt
    Use txt for expansion

CONFIGURATION
CvsGraph starts with reading a configuration file. If the -c option is given on the commandline, then it is read. Otherwise, cvsgraph first looks for a configuration file in the current directory using ./cvsgraph.conf and, if not found, tries to open /usr/local/etc/cvsgraph.conf. If still no configuration file is read an error message is issued and cvsgraph terminates. The format of the configuration file is described in cvsgraph.conf(5). Configuration parameters entered on the commandline have always precedent over the configuration file.
The location of a repository file is determined by the configuration parameters cvsroot and cvsmodule and the respective commandline options -r and -m. The cvsroot, cvsmodule and file are concatenated with separating '/' path-separators forming the final location:
<cvsroot>/<cvsmodule>/file
No path-separator is appended if cvsroot and cvsmodule are empty strings. An error message is issued if the resulting path cannot be opend. Note that cvsgraph does not atempt to check any validity any of the path components. This enables a user to open any file on the file-system by setting cvsroot and cvsmodule to empty strings.
For example, cvsgraph -r '' -m '' ../myfile,v would try to open the file ../myfile,v. Note that a variety of possibilities yield the same file and all have their advantages and drawbacks, which are mostly related to the possible use of the parameters in text expansions.

OUTPUT
The output generated by cvsgraph can be either an image (default) or and HTML imagemap (-i option).
Images can have several formats, depending on the capabilities of the gd library on which the drawing is built. The configuration allows for GIF, PNG or JPEG type images. Newer versions of gd do no longer support GIF and PNG will be used instead.
Generation of imagemaps conforms to the HTML standard and maps rectangular regions of the image where revisions and branches are drawn. Additionally, an extra rectangular region is generated between revisions to support diff generation.

FILES

/usr/local/etc/cvsgraph.conf
    Configuration file read for default layout parameters.

AUTHOR
CvsGraph is written and maintained by B. Stultiens.
Send comments and bugreports to cvsgraph@akhphd.au.dk and visit the homepage at:
http://www.akhphd.au.dk/~bertho/cvsgraph.

SEE ALSO
cvsgraph.conf(5)