/[CvsGraph]/cvsgraph/cvsgraph.conf.5
ViewVC logotype

Annotate of /cvsgraph/cvsgraph.conf.5

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


Revision 1.11 - (hide annotations)
Sat Jul 20 00:48:17 2002 UTC (15 years, 4 months ago) by bertho
Branch: MAIN
Changes since 1.10: +1 -1 lines
Hopefully fixed configure problems
Prepared new release 1.3.0
1 bertho 1.11 .TH "cvsgraph.conf" "5" "1.3.0" "B. Stultiens" "CVS/RCS Utilties"
2 bertho 1.1 .SH "NAME"
3     cvsgraph.conf \- CVS/RCS repository grapher configuration
4     .SH "OVERVIEW"
5     The configuration file is a context free grammar where
6     empty lines and whitespace are ignored. Comments start
7     with '#' and everything until end of line is ignored.
8     .br
9     A configuration parameter is written as:
10     .br
11     <keyword> = <argument> ;
12     .br
13     .LP
14     Keywords are defined in \fBPARAMETERS\fR. The argument
15     can be either numerical or string typed.
16    
17     .LP
18     Numbers may be entered as octal, decimal or hex as in 0117,
19 bertho 1.7 79 and 0x4f respectively. Floating point numbers contain a
20     single '.', but must start with a digit. Integer numbers are
21     automagically converted to floats if required.
22 bertho 1.1
23     .LP
24     Strings are C\-style strings, enclosed in double quotes
25     in which characters may be escaped with '\\' and written
26     in octal and hex escapes. Note that '\\' must be escaped
27 bertho 1.6 if it is to be entered as a character. Escapes recognized
28     are '\\[abfnrtv]', '\\[xX][0-9a-fA-F]{2}' and '\\[012][0-7]{0,2}'.
29 bertho 1.1 .br
30     Some strings are expanded with printf like conversions
31     which start with '%'. Not all are applicable at all times,
32     in which case they will expand to nothing.
33 bertho 1.3 .br
34     Note that expansions of paths are available with and without
35     trailing '/'. The distinction is required for path construction
36     to ensure that empty expansions will not redirect the path to
37     root and no double '/' in a path is generated.
38 bertho 1.1 .TP
39     %c
40 bertho 1.3 cvsroot including a trailing '/' if non\-empty
41     .TP
42     %C
43     cvsroot without trailing '/', regardless of how it was entered
44     on the commandline
45 bertho 1.1 .TP
46     %m
47 bertho 1.3 cvsmodule including trailing '/' if non\-empty
48     .TP
49     %M
50     cvsmodule without trailing '/', regardless of how it was entered
51     on the commandline
52 bertho 1.1 .TP
53     %f
54 bertho 1.3 filename without path (\fIbasename <name>\fR functionality)
55 bertho 1.1 .TP
56     %F
57 bertho 1.3 filename without path and with ",v" stripped (\fIbasename <name> ,v\fR
58     functionality)
59 bertho 1.1 .TP
60     %p
61 bertho 1.3 path part of filename. This includes a trailing '/' if the
62     path is non\-empty
63 bertho 1.1 .TP
64     %r
65     number of revisions
66     .TP
67     %b
68     number of branches
69     .TP
70     %%
71 bertho 1.6 literal '%'
72 bertho 1.1 .TP
73     %R
74     the revision number (e.g. '1.2.4.4')
75     .TP
76     %P
77     previous revision number
78     .TP
79     %B
80     the branch number (e.g. '1.2.4')
81     .TP
82     %d
83     date of revision
84     .TP
85     %a
86     author of revision
87     .TP
88     %s
89     state of revision
90     .TP
91 bertho 1.9 %l
92     The logentry of the revision. You need to enable \fBparse_logs\fR for this to
93     work. You may append an optional truncate length by writing '[num]' (with num
94     the maximum length) directly after %l. If no trunction is specified, then all
95     will be expanded. Specifying a negative truncation length means that newlines
96     should be replaced by spaces. If truncation occurs, then "..." will be
97     appended. The expansion is scanned for possible html-entities and are replaced
98     by &#...; equivalents.
99     .br
100     For example: "%l[25]" will expand up to 25 characters of the log.
101     .TP
102     %L
103     Same as %l, but no html-entity translations are performed.
104     .TP
105 bertho 1.1 %t
106     current tag of branch or revision
107     .TP
108     %0..%9
109     command\-line argument \-0 .. \-9
110    
111     .LP
112 bertho 1.6 Fonts are numbered 0..4 (as defined in libgd) where
113 bertho 1.1 0 = tiny, 1 = small, 2 = medium (bold), 3 = large and
114     4 = giant.
115    
116     .LP
117     Colors are a strings, similar to html\-type colors in the form
118     "#rrggbb" with parts written in hex, where rr = red (00..ff),
119     gg = green (00\-ff) and bb = blue (00\-ff).
120    
121     .LP
122 bertho 1.8 Booleans have three possible arguments: true, false and not. `Not' means
123     inverse of what it was (logical negation) and is represented by the value -1.
124     For the configuration file that means that the default value is negated.
125     However, the not possibility is a very handy tool for commandline overrides
126     generated from (CGI-)scripts.
127    
128     .LP
129 bertho 1.1 There are several reserved words besides of the keywords.
130     These additional reserved words expand to numerical values:
131     .br
132     Booleans:
133     .br
134     false = 0
135     .br
136     true = 1
137     .br
138 bertho 1.8 not = -1
139     .br
140 bertho 1.1 Alignment specifiers:
141     .br
142     left = 0
143     .br
144     center = 1
145     .br
146     right = 2
147     .br
148     Image specifiers:
149     .br
150     gif = 0
151     .br
152     png = 1
153     .br
154     jpeg = 2
155     .br
156     Font specifiers:
157     .br
158     tiny = 0
159     .br
160     small = 1
161     .br
162     medium = 2
163     .br
164     large = 3
165     .br
166     giant = 4
167     .br
168    
169     .SH "PARAMETERS"
170     .TP
171     \fBcvsroot\fR \fIstring\fR
172     The absolute base directory where the CSV/RCS repository can be found.
173     A '/' will be appended to the string if it is not empty and does not
174     contain a trailing '/'.
175     .br
176     Default is an empty string.
177    
178     .TP
179     \fBcvsmodule\fR \fIstring\fR
180     The modulename of the CVS/RCS repository. This is converted into a
181     subdirectory name with a trailing '/'.
182     .br
183     Default is an empty string.
184    
185     .TP
186     \fBcolor_bg\fR \fIcolor\fR
187     The background color of the image.
188     .br
189     Default is white ("#ffffff").
190    
191     .TP
192 bertho 1.7 \fBtransparent_bg\fR \fIboolean\fR
193     The background color of the image is to be the transparent color. This is
194     only usefull for PNG images. Be sure to set \fBcolor_bg\fR to something
195     reasonable to make sure that the image is viewable with programs that do not
196     support transparency.
197     .br
198     Default is false.
199    
200     .TP
201 bertho 1.1 \fBdate_format\fR \fIstring\fR
202     The \fBstrftime(3)\fR format string for date and time representation in
203     the '%d' expansion.
204     .br
205     Default is "%d\-%b\-%Y %H:%M:%S".
206    
207     .TP
208 bertho 1.5 \fBbox_shadow\fR \fIboolean\fR
209 bertho 1.1 A boolean whether or not to draw a shadow for the boxes of
210     revisions and branches.
211     .br
212     Default is false.
213    
214     .TP
215 bertho 1.5 \fBupside_down\fR \fIboolean\fR
216     Draw the entire tree upside down if set. I.e. highest revisions are
217 bertho 1.6 at the top of the image. See also cvsgraph(1) option '\fB-u\fR'.
218 bertho 1.5 .br
219     Default is false.
220    
221     .TP
222 bertho 1.10 \fBleft_right\fR \fIboolean\fR
223     Draw the entire tree from left to right instead of top down if set.
224     I.e. highest revisions are at the right of the image. You can also
225     draw the tree right to left when \fBupside_down\fR is set too.
226     .br
227     Default is false.
228    
229     .TP
230 bertho 1.5 \fBstrip_untagged\fR \fIboolean\fR
231 bertho 1.6 Ommit all revisions that do not have tags and are not a branchpoint. This
232     reduces the image-size, but can be confusing when looking for a specific
233     revision. See also cvsgraph(1) option '\fB-s\fR'.
234     .br
235     Default is false.
236    
237     .TP
238     \fBstrip_first_rev\fR \fIboolean\fR
239     Also ommit the first revision in a branch if it does not have tags and is not a
240     branchpoint. This has only effect if \fBstrip_untagged\fR is set. See also
241     cvsgraph(1) option '\fB-S\fR'.
242     .br
243     Default is false.
244    
245     .TP
246 bertho 1.7 \fBauto_stretch\fR \fIboolean\fR
247 bertho 1.6 Try to stretch the inter\-revision spacing to move the trunks more to the left,
248     effectively reducing the image's size. See also cvsgraph(1) option '\fB-k\fR'.
249 bertho 1.5 .br
250     Default is false.
251    
252     .TP
253 bertho 1.7 \fBuse_ttf\fR \fIboolean\fR
254     Enable truetype rendering of strings using the FreeType interface of libgd.
255     Note that ttf rendering is significantly slower than libgd's bitmap fonts.
256     .br
257     Default is false.
258    
259     .TP
260     \fBanti_alias\fR \fIboolean\fR
261     Enable antialias rendering of truetype fonts. This has only effect if
262     \fBuse_ttf\fR is set. Enabling anti_alias gives very nice results.
263     However, that is at the expense of 8-bit vs. 4-bit colormap images,
264     which can be a major drawback because the size of 8-bit images is 3..4
265     times that of 4-bit images (with compressed PNG as output).
266     .br
267     Default is true.
268 bertho 1.8
269     .TP
270     \fBthick_lines\fR \fInumber\fR
271     Set the thickness of connector lines between boxes. Normally, lines
272     are drawn one pixel wide, but can look somewhat thin. Setting the thickness
273     to anything over 5 would be plain ugly (but hey, who is to debate tast:-).
274     Values less than 1 and over 11 are clipped.
275     .br
276     Default is 1.
277 bertho 1.9
278     .TP
279     \fBparse_logs\fR \fIboolean\fR
280     Enable the parsing of the \fIentire\fR ,v file to read the log-entries between
281     revisions. This is necessary for the %l expansion to work, but slows down
282     parsing by a very large factor. You've been warned.
283     .br
284     Default is false.
285 bertho 1.7
286     .TP
287     \fBbranch_ttfont\fR \fIstring\fR
288     .TP
289     \fBbranch_tag_ttfont\fR \fIstring\fR
290     .TP
291     \fBrev_ttfont\fR \fIstring\fR
292     .TP
293     \fBrev_text_ttfont\fR \fIstring\fR
294     .TP
295     \fBtag_ttfont\fR \fIstring\fR
296     .TP
297     \fBtitle_ttfont\fR \fIstring\fR
298     Set the truetype font face or filename for the individual elements. Gd's bitmap
299     fonts are used as a fallback if the font cannot be found or contains errors.
300     .br
301     Default none.
302    
303     .TP
304     \fBbranch_ttsize\fR \fIfloat\fR
305     .TP
306     \fBbranch_tag_ttsize\fR \fIfloat\fR
307     .TP
308     \fBrev_ttsize\fR \fIfloat\fR
309     .TP
310     \fBrev_text_ttsize\fR \fIfloat\fR
311     .TP
312     \fBtag_ttsize\fR \fIfloat\fR
313     .TP
314     \fBtitle_ttsize\fR \fIfloat\fR
315     Set the truetype font size for the individual elements. See also *_ttfont.
316     .br
317     Default 0.0.
318    
319     .TP
320 bertho 1.1 \fBtag_font\fR \fInumber\fR
321     The font used to draw tags in the revision boxes.
322     .br
323     Default is tiny.
324    
325     .TP
326     \fBtag_color\fR \fIcolor\fR
327     The color used to draw tags in the revision boxes.
328     .br
329     Default is black ("#000000").
330    
331     .TP
332     \fBrev_font\fR \fInumber\fR
333     .br
334     Default is tiny.
335    
336     .TP
337     \fBrev_color\fR \fIcolor\fR
338     The color of revision boxes, including the revision number.
339     .br
340     Default is black ("#000000").
341    
342     .TP
343     \fBrev_bgcolor\fR \fIcolor\fR
344     Revision box background color. This is the interior fill of the
345     box.
346     .br
347     Default is white ("#ffffff").
348    
349     .TP
350 bertho 1.7 \fBrev_separator\fR \fInumber\fR
351     Space between tags in revision boxes.
352 bertho 1.1 .br
353     Default is 0.
354    
355     .TP
356     \fBrev_minline\fR \fInumber\fR
357     The minimum vertical distance between revision boxes.
358     .br
359     Default is 0.
360    
361     .TP
362     \fBrev_maxline\fR \fInumber\fR
363     The maximum vertical distance between revision boxes.
364 bertho 1.7 This has only effect if \fBauto_stretch\fR is set to true (or option '\fB-k\fR'
365 bertho 1.6 is specified).
366 bertho 1.1 .br
367 bertho 1.6 Default is 5 times \fBrev_minline\fR.
368 bertho 1.1
369     .TP
370     \fBrev_lspace\fR \fInumber\fR
371     .TP
372     \fBrev_rspace\fR \fInumber\fR
373     .TP
374     \fBrev_tspace\fR \fInumber\fR
375     .TP
376     \fBrev_bspace\fR \fInumber\fR
377 bertho 1.6 Interior spacing in revision boxes of left, right, top and bottom
378 bertho 1.1 respectively. Note that the left right spacing is not used separately
379     because text is center aligned.
380     .br
381     Default is 0.
382    
383     .TP
384     \fBrev_text\fR \fIstring\fR
385     The additional text in a revision box under the revision number.
386     .br
387     Default is "%d".
388    
389     .TP
390     \fBrev_text_font\fR \fInumber\fR
391     The font of the additional text in a revision box under the revision number.
392     .br
393     Default is tiny.
394    
395     .TP
396     \fBrev_text_color\fR \fIcolor\fR
397     The font color of the additional text in a revision box under the revision number.
398     .br
399     Default is black ("#000000").
400    
401     .TP
402     \fBbranch_font\fR \fInumber\fR
403 bertho 1.7 The font of the number in a branch box.
404     .br
405     Default is tiny.
406    
407     .TP
408     \fBbranch_tag_font\fR \fInumber\fR
409     The font of the tags in a branch box.
410 bertho 1.1 .br
411     Default is tiny.
412    
413     .TP
414     \fBbranch_color\fR \fIcolor\fR
415 bertho 1.7 All branch element's color excluding tags.
416     .br
417     Default is black ("#000000").
418    
419     .TP
420     \fBbranch_tag_color\fR \fIcolor\fR
421     All branch tags' color.
422 bertho 1.1 .br
423     Default is black ("#000000").
424    
425     .TP
426     \fBbranch_lspace\fR \fInumber\fR
427     .TP
428     \fBbranch_rspace\fR \fInumber\fR
429     .TP
430     \fBbranch_tspace\fR \fInumber\fR
431     .TP
432     \fBbranch_bspace\fR \fInumber\fR
433     Interior spacing of branch boxes.
434     .br
435     Default is 0.
436    
437     .TP
438     \fBbranch_margin\fR \fInumber\fR
439     Exterior spacing of branches. Each branch will be spaced
440     with a minimum of this value.
441     .br
442     Default is 0.
443    
444     .TP
445     \fBbranch_connect\fR \fInumber\fR
446     Length of the vertical connector from a revision to the branch box.
447     .br
448     Default is 0.
449 bertho 1.5
450     .TP
451 bertho 1.6 \fBbranch_dupbox\fR \fIboolean\fR
452     Add an extra branch box at the end of the trunk. Useful for upside down drawn
453     trees.
454 bertho 1.5 .br
455     Default is false.
456 bertho 1.1
457     .TP
458     \fBtitle\fR \fIstring\fR
459     The title of the image.
460     .br
461     Default is empty string.
462    
463     .TP
464     \fBtitle_x\fR \fInumber\fR
465     .TP
466     \fBtitle_y\fR \fInumber\fR
467     Postion of title.
468     .br
469     Default is 0.
470    
471     .TP
472     \fBtitle_font\fR \fInumber\fR
473     The font of the title.
474     .br
475     Default is tiny.
476    
477     .TP
478     \fBtitle_align\fR \fInumber\fR
479     Horizontal alignment of the title.
480     .br
481     Default is left.
482    
483     .TP
484     \fBtitle_color\fR \fIcolor\fR
485     The color of the title.
486     .br
487     Default is black ("#000000").
488    
489     .TP
490     \fBmargin_top\fR \fInumber\fR
491     .TP
492     \fBmargin_bottom\fR \fInumber\fR
493     .TP
494     \fBmargin_left\fR \fInumber\fR
495     .TP
496     \fBmargin_right\fR \fInumber\fR
497     Margins of the image. Note: the title position is not affected by
498     the margin.
499     .br
500     Default is 0.
501    
502     .TP
503     \fBimage_type\fR \fInumber\fR
504     Image types are available if they can be found in
505     the gd library. Newer versions of gd do not have
506     gif anymore. CvsGraph will automatically generate
507     png images instead.
508     .br
509     Default is dependent on availability and is prioritized in the order
510     png, gif and jpeg.
511    
512     .TP
513     \fBimage_quality\fR \fInumber\fR
514     The quality of a jpeg image (1..100)
515     .br
516     Default is 100.
517    
518     .TP
519     \fBmap_name\fR \fIstring\fR
520     The name= attribute in <map name="mapname">...</map> in the
521     generated HTML map.
522     .br
523     Default is "CvsGraphImageMap".
524    
525     .TP
526     \fBmap_branch_href\fR \fIstring\fR
527     .TP
528     \fBmap_rev_href\fR \fIstring\fR
529     .TP
530     \fBmap_diff_href\fR \fIstring\fR
531     These are the href= attributes in the <area>
532     tags of html.
533     .br
534 bertho 1.6 Default are:
535 bertho 1.1 .br
536     branch: "href=\\"unset: conf.map_branch_href\\""
537     .br
538     revision: "href=\\"unset: conf.map_rev_href\\""
539     .br
540     diff: "href=\\"unset: conf.map_diff_href\\""
541    
542     .TP
543     \fBmap_branch_alt\fR \fIstring\fR
544     .TP
545     \fBmap_rev_alt\fR \fIstring\fR
546     .TP
547     \fBmap_diff_alt\fR \fIstring\fR
548     These are the alt= attributes in the <area>
549     tags of html.
550     .br
551 bertho 1.6 Default are "alt=\\"%B\\"", "alt=\\"%R\\"" and
552     "alt=\\"%P &lt;\-&gt; %R\\"" respectively.
553 bertho 1.1
554     .SH "AUTHOR"
555     \fBCvsGraph\fR is written and maintained by B. Stultiens.
556     .br
557     Send comments and bugreports to \fIcvsgraph@akhphd.au.dk\fR and
558 bertho 1.3 visit the homepage at:
559     .br
560     \fIhttp://www.akhphd.au.dk/~bertho/cvsgraph\fR.
561 bertho 1.1 .SH "SEE ALSO"
562     .BR cvsgraph(1)

  ViewVC Help
Powered by ViewVC 1.1.0 with CvsGraph 1.7.0