/[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.21 - (hide annotations)
Tue Jun 14 20:40:14 2005 UTC (12 years, 6 months ago) by bertho
Branch: MAIN
CVS Tags: REL_1_5_2
Changes since 1.20: +1 -1 lines
- Fix merge lines to untagged revisions when strip_untagged is active
- Prepare release 1.5.2
1 bertho 1.21 .TH "CvsGraph" "1" "1.5.2" "B. Stultiens" "CVS/RCS Utilities"
2 bertho 1.1 .SH "NAME"
3     cvsgraph \- A CVS/RCS repository grapher
4     .SH "SYNOPSIS"
5 bertho 1.13 \fBcvsgraph\fR [\fIoptions\fR] [\fIfile\fR]
6 bertho 1.1 .SH "DESCRIPTION"
7 bertho 1.19 \fBCvsGraph\fR generates images and image maps from CVS/RCS repository files.
8 bertho 1.1 .SH "OPTIONS"
9     .TP
10 bertho 1.5 \fB\-b\fR
11 bertho 1.6 Add a branch box at the end of the trunk too. This option negates the
12 bertho 1.7 \fBbranch_dupbox\fR setting from the configuration file.
13 bertho 1.5 .TP
14 bertho 1.1 \fB\-c\fR \fIfile\fR
15     Read alternate config from \fIfile\fR.
16     .TP
17     \fB\-d\fR \fIlevel\fR
18     Enable debug mode at \fIlevel\fR. The amount of information is determined by a
19     bitwise or of the following: 1=config lexer, 2=config parser, 4=rcsfile lexer,
20 bertho 1.6 8=rcsfile parser, 16=rcsfile structure. The \fIlevel\fR argument may be in
21     decimal, octal or hexadecimal format.
22 bertho 1.1 .TP
23     \fB\-h\fR
24     A brief description of possible options.
25     .TP
26     \fB\-i\fR
27 bertho 1.19 Generate an image map instead of an image.
28 bertho 1.1 .TP
29 bertho 1.7 \fB\-I\fR \fIfile\fR
30 bertho 1.19 Also write an image map to \fIfile\fR. This can be useful if you want to
31     generate both image and image map simultaneously. This halves the total time
32 bertho 1.7 spent on accessing the repository file because it is parsed only once.
33     .br
34     However, keeping track of auto-generated files can be a bit of a hack if
35 bertho 1.19 used in HTTP requests (unless you pass both image and HTML file in one
36     HTTP stream).
37 bertho 1.7 .br
38     Note 1: most time is used for the image-drawing routines (actually libgd),
39     so you might want to think twice in CGI apps.
40     .br
41     Note 2: you can still use '\fB-o\fR' to specify an output file for the image.
42 bertho 1.19 And, if you also specify '\fB-i\fR', then you'll get two image maps, for
43 bertho 1.7 whatever purpose that might be.
44     .TP
45     \fB\-k\fR
46     Try to reduce the image size by adjusting inter\-revision spacing and moving
47 bertho 1.8 trunks more left. This options negates the \fBauto_stretch\fR setting from the
48 bertho 1.7 configuration file.
49     .TP
50 bertho 1.1 \fB\-M\fR \fIname\fR
51 bertho 1.19 Use \fIname\fR as image map name (has only effect in combination with
52 bertho 1.15 \&'\fB\-i\fR'). This option overrides \fBmap_name\fR in the configuration file.
53 bertho 1.1 .TP
54     \fB\-m\fR \fImod\fR
55 bertho 1.19 Use \fImod\fR as the CVS module.
56 bertho 1.7 This option overrides \fBcvsmodule\fR in the configuration file.
57     .TP
58     \fB\-O\fR \fIcfg_option=value[;opt=val[...]]\fR
59     Set \fIcfg_option\fR to \fIvalue\fR. Multiple \fB-O\fR are allowed as well
60     as multiple options can be set simultaneously by separating them with ';'.
61     See \fBcvsgraph.conf(5)\fR for a detailed list of options.
62     See also \fBCONFIGURATION\fR below.
63 bertho 1.1 .TP
64     \fB\-o\fR \fIfile\fR
65     Output to \fIfile\fR. Otherwise, output is written to standard output.
66     .TP
67     \fB\-q\fR
68     Be quiet (i.e. no warnings)
69     .TP
70     \fB\-r\fR \fIpath\fR
71 bertho 1.19 Use \fIpath\fR as the CVS root.
72 bertho 1.7 This option overrides \fBcvsroot\fR in the configuration file.
73 bertho 1.5 .TP
74 bertho 1.6 \fB\-s\fR
75     Strip all untagged revisions from the tree. Only the first, last and each
76     tagged revision of each trunk will be shown. This will greatly reduce the size
77     of the generated image if you didn't tag everything (and are not interested in
78 bertho 1.7 all revisions). This option negates the \fBstrip_untagged\fR setting from the
79 bertho 1.6 configuration file.
80     .TP
81 bertho 1.7 \fB\-S\fR
82 bertho 1.19 Also strip the first revision in a branch if untagged and not a branch point.
83 bertho 1.7 This has only effect if \fBstrip_untagged\fR or option '\fB\-s\fR' is set.
84     The '\fB\-S\fR' option negates the \fBstrip_first_rev\fR from the configuration
85     file.
86     .TP
87 bertho 1.5 \fB\-u\fR
88 bertho 1.6 Draw the tree upside down (newest revision at the top). This option negates the
89 bertho 1.7 \fBupside_down\fR setting from the configuration file.
90 bertho 1.1 .TP
91     \fB\-V\fR
92     Print version and exit.
93     .TP
94 bertho 1.12 \fB\-x\fR \fI{3,4,x}\fR
95     Set the HTML level of compliance for image maps. Use \fI3\fR for HTML 3.x,
96     \fI4\fR for HTML 4.x and \fIx\fR for XHTML. Default is HTML 3.x compatibility.
97     .TP
98 bertho 1.1 \fB\-[0\-9]\fR \fItxt\fR
99     Use \fItxt\fR for expansion
100     .SH "CONFIGURATION"
101 bertho 1.7 \fBCvsGraph\fR starts with reading a configuration file. If the '\fB\-c\fR'
102 bertho 1.19 option is given on the command line, then it is read. Otherwise, \fBcvsgraph\fR
103 bertho 1.7 first looks for a configuration file in the current directory using
104     \fI./cvsgraph.conf\fR and, if not found, tries to open
105 bertho 1.19 \fI/usr/local/etc/cvsgraph.conf\fR. Defaults and command line overrides
106 bertho 1.7 will be used if no configuration file can be opened. The format of the
107     configuration file is described in \fBcvsgraph.conf(5)\fR. Configuration
108 bertho 1.19 parameters entered on the command line have always precedence over the
109 bertho 1.7 configuration file. Configuration options are processed in the following
110     order:
111     .br
112     - configuration file
113     .br
114 bertho 1.19 - '\fB-O\fR' command line options
115 bertho 1.7 .br
116 bertho 1.19 - other command line overrides (\fB-bkMmrSsu\fR)
117 bertho 1.7 .br
118 bertho 1.19 If you do not want to process any configuration file, then you can set option
119 bertho 1.7 \'\fB-c /dev/null\fR', which will read an empty configuration file.
120     .PP
121 bertho 1.1 The location of a repository file is determined by the configuration parameters
122 bertho 1.19 \fBcvsroot\fR and \fBcvsmodule\fR and the respective command line options
123 bertho 1.15 \&'\fB\-r\fR' and '\fB\-m\fR'. The \fBcvsroot\fR, \fBcvsmodule\fR and \fIfile\fR
124 bertho 1.7 are concatenated with separating '/' path\-separators forming the final
125     location:
126 bertho 1.1 .br
127     <cvsroot>/<cvsmodule>/\fIfile\fR
128     .br
129 bertho 1.7 No path\-separator is appended if \fBcvsroot\fR and \fBcvsmodule\fR are empty
130 bertho 1.19 strings. An error message is issued if the resulting path cannot be opened.
131     Note that \fBcvsgraph\fR does not attempt to check any validity of the path
132 bertho 1.7 components. This enables a user to open any file on the file\-system by setting
133     \fBcvsroot\fR and \fBcvsmodule\fR to empty strings.
134 bertho 1.1 .br
135     For example, \fIcvsgraph \-r '' \-m '' ../myfile,v\fR would try to open the
136 bertho 1.7 file \fI../myfile,v\fR. Note that a variety of possibilities yield the same
137     file and all have their advantages and drawbacks, which are mostly related to
138     the possible use of the parameters in text expansions.
139 bertho 1.9 .PP
140 bertho 1.19 If no \fIfile\fR is given on the command line, then input is read from standard
141 bertho 1.9 input. This can make expansion strings somewhat strange looking, but they are
142     composed with the information available. If no input file was given, then the
143     input filename for expansion is set to \fB<stdin>\fR.
144    
145 bertho 1.1 .SH "OUTPUT"
146 bertho 1.7 The output generated by \fBcvsgraph\fR can be either an image (default) or and
147 bertho 1.19 HTML image map ('\fB\-i\fR' and '\fB-I\fR' options).
148 bertho 1.1 .br
149 bertho 1.7 Images can have several formats, depending on the capabilities of the gd
150     library on which the drawing is built. The configuration allows for GIF, PNG or
151     JPEG type images. Newer versions of gd do no longer support GIF and PNG will be
152     used instead.
153     .br
154 bertho 1.19 Generation of image maps conforms to the HTML standard and maps rectangular
155 bertho 1.7 regions of the image where revisions and branches are drawn. Additionally, an
156     extra rectangular region is generated between revisions to support diff
157     generation.
158 bertho 1.1 .SH "FILES"
159     .LP
160     .TP
161     \fI/usr/local/etc/cvsgraph.conf\fR
162     Configuration file read for default layout parameters.
163     .SH "AUTHOR"
164     \fBCvsGraph\fR is written and maintained by B. Stultiens.
165     .br
166 bertho 1.19 Send comments and bug reports to \fIcvsgraph@akhphd.au.dk\fR and
167 bertho 1.3 visit the homepage at:
168     .br
169 bertho 1.19 \fIhttp://www.akhphd.au.dk/~bertho/cvsgraph/\fR.
170 bertho 1.1 .SH "SEE ALSO"
171     .BR cvsgraph.conf(5)
172    

  ViewVC Help
Powered by ViewVC 1.1.0 with CvsGraph 1.7.0