/[CvsGraph]/cvsgraph/cvsgraph.1
ViewVC logotype

Annotate of /cvsgraph/cvsgraph.1

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph


Revision 1.3 - (hide annotations)
Thu Mar 22 21:42:48 2001 UTC (16 years, 7 months ago) by bertho
Branch: MAIN
CVS Tags: REL_1_1_2
Changes since 1.2: +5 -3 lines
- Dead tags (i.e. a tag without a valid revision or branch) does no
  longer print a message in quiet mode.
- Added expansions for cvsroot and cvsmodule without trailing '/'
- Remove core-files in a 'make clean'.
- Fixed default config file to use entities < and >.
1 bertho 1.1 .TH "CvsGraph" "1" "1.1.1" "B. Stultiens" "CVS/RCS Utilties"
2     .SH "NAME"
3     cvsgraph \- A CVS/RCS repository grapher
4     .SH "SYNOPSIS"
5     \fBcvsgraph\fR [\fIoptions\fR] \fIfile\fR
6     .SH "DESCRIPTION"
7     \fBCvsGraph\fR generates images and imagemaps from CVS/RCS repository files.
8     .SH "OPTIONS"
9     .TP
10     \fB\-c\fR \fIfile\fR
11     Read alternate config from \fIfile\fR.
12     .TP
13     \fB\-d\fR \fIlevel\fR
14     Enable debug mode at \fIlevel\fR. The amount of information is determined by a
15     bitwise or of the following: 1=config lexer, 2=config parser, 4=rcsfile lexer,
16     8=rcsfile parser, 16=rcsfile structure. The \fIlevel\fR argument may be in decimal,
17     octal or hexadecimal format.
18     .TP
19     \fB\-h\fR
20     A brief description of possible options.
21     .TP
22     \fB\-i\fR
23     Generate an imagemap instead of an image.
24     .TP
25     \fB\-M\fR \fIname\fR
26     Use \fIname\fR as imagemap name (has only effect in combination with \fB\-i\fR).
27     .TP
28     \fB\-m\fR \fImod\fR
29     Use \fImod\fR as cvsmodule.
30     .TP
31     \fB\-o\fR \fIfile\fR
32     Output to \fIfile\fR. Otherwise, output is written to standard output.
33     .TP
34     \fB\-q\fR
35     Be quiet (i.e. no warnings)
36     .TP
37     \fB\-r\fR \fIpath\fR
38     Use \fIpath\fR as cvsroot.
39     .TP
40     \fB\-V\fR
41     Print version and exit.
42     .TP
43     \fB\-[0\-9]\fR \fItxt\fR
44     Use \fItxt\fR for expansion
45     .SH "CONFIGURATION"
46     \fBCvsGraph\fR starts with reading a configuration file. If the \fB\-c\fR option
47     is given on the commandline, then it is read. Otherwise, \fBcvsgraph\fR first
48     looks for a configuration file in the current directory using \fI./cvsgraph.conf\fR
49     and, if not found, tries to open \fI/usr/local/etc/cvsgraph.conf\fR.
50     If still no configuration file is read an error message is issued and
51     \fBcvsgraph\fR terminates. The format of the configuration file is
52     described in \fBcvsgraph.conf(5)\fR. Configuration parameters entered on
53     the commandline have always precedent over the configuration file.
54     .br
55     The location of a repository file is determined by the configuration parameters
56     cvsroot and cvsmodule and the respective commandline options \fB\-r\fR and \fB\-m\fR.
57     The cvsroot, cvsmodule and \fIfile\fR are concatenated with separating
58     \'/\' path\-separators forming the final location:
59     .br
60     <cvsroot>/<cvsmodule>/\fIfile\fR
61     .br
62     No path\-separator is appended if cvsroot and cvsmodule are empty strings.
63     An error message is issued if the resulting path cannot be opend.
64     Note that \fBcvsgraph\fR does not atempt to check any validity any of
65     the path components. This enables a user to open any file on the file\-system
66     by setting cvsroot and cvsmodule to empty strings.
67     .br
68     For example, \fIcvsgraph \-r '' \-m '' ../myfile,v\fR would try to open the
69     file \fI../myfile,v\fR. Note that a variety of possibilities yield the same file
70 bertho 1.3 and all have their advantages and drawbacks, which are mostly related to the
71     possible use of the parameters in text expansions.
72 bertho 1.1 .SH "OUTPUT"
73     The output generated by \fBcvsgraph\fR can be either an image
74     (default) or and HTML imagemap (\fB\-i\fR option).
75     .br
76     Images can have several formats, depending on the capabilities
77     of the gd library on which the drawing is built. The configuration
78     allows for GIF, PNG or JPEG type images. Newer versions of gd do no
79     longer support GIF and PNG will be used instead.
80     .br
81     Generation of imagemaps conforms to the HTML standard and maps
82     rectangular regions of the image where revisions and branches are
83     drawn. Additionally, an extra rectangular region is generated between
84     revisions to support diff generation.
85     .SH "FILES"
86     .LP
87     .TP
88     \fI/usr/local/etc/cvsgraph.conf\fR
89     Configuration file read for default layout parameters.
90     .SH "AUTHOR"
91     \fBCvsGraph\fR is written and maintained by B. Stultiens.
92     .br
93     Send comments and bugreports to \fIcvsgraph@akhphd.au.dk\fR and
94 bertho 1.3 visit the homepage at:
95     .br
96     \fIhttp://www.akhphd.au.dk/~bertho/cvsgraph\fR.
97 bertho 1.1 .SH "SEE ALSO"
98     .BR cvsgraph.conf(5)
99    

  ViewVC Help
Powered by ViewVC 1.1.0 with CvsGraph 1.7.0