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

Diff of /cvsgraph/cvsgraph.conf

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

revision 1.1.1.1, Tue Feb 20 12:07:03 2001 UTC revision 1.35, Wed May 21 13:33:35 2008 UTC
# Line 1  Line 1 
1  # CvsGraph configuration  # CvsGraph configuration
2  #  #
3  # - Empty lines are ignored.  # - Empty lines and whitespace are ignored.
4    #
5  # - Comments start with '#' and everything until  # - Comments start with '#' and everything until
6  #   end of line is ignored.  #   end of line is ignored.
7    #
8  # - Strings are C-style strings in which characters  # - Strings are C-style strings in which characters
9  #   may be escaped with '\' and written in octal  #   may be escaped with '\' and written in octal
10  #   and hex escapes. Note that '\' must be escaped  #   and hex escapes. Note that '\' must be escaped
11  #   if it is to be entered as a character.  #   if it is to be entered as a character.
12    #
13    # - Some strings are expanded with printf like
14    #   conversions which start with '%'. Not all
15    #   are applicable at all times, in which case they
16    #   will expand to nothing.
17    #       %c = cvsroot (with trailing '/')
18    #       %C = cvsroot (*without* trailing '/')
19    #       %m = module (with trailing '/')
20    #       %M = module (*without* trailing '/')
21    #       %f = filename without path
22    #       %F = filename without path and with ",v" stripped
23    #       %p = path part of filename (with trailing '/')
24    #       %r = number of revisions
25    #       %b = number of branches
26    #       %% = '%'
27    #       %R = the revision number (e.g. '1.2.4.4')
28    #       %P = previous revision number
29    #       %B = the branch number (e.g. '1.2.4')
30    #       %d = date of revision
31    #       %a = author of revision
32    #       %s = state of revision
33    #       %t = current tag of branch or revision
34    #       %0..%9 = command-line argument -0 .. -9
35    #       %l = HTMLized log entry of the revision
36    #               NOTE: %l is obsolete. See %(%) and cvsgraph.conf(5) for
37    #               more details.
38    #       %L = log entry of revision
39    #               The log entry expansion takes an optional argument to
40    #               specify maximum length of the expansion like %L[25].
41    #       %(...%) = HTMLize the string within the parenthesis.
42    #
43  # - Numbers may be entered as octal, decimal or  # - Numbers may be entered as octal, decimal or
44  #   hex as in 0127, 792 and 0x4f respectively.  #   hex as in 0117, 79 and 0x4f respectively.
45    #
46  # - Fonts are numbered 0..4 (defined as in libgd)  # - Fonts are numbered 0..4 (defined as in libgd)
47  #       0 = Tiny  #       0 = tiny
48  #       1 = Small  #       1 = small
49  #       2 = Medium bold  #       2 = medium (bold)
50  #       3 = Large  #       3 = large
51  #       4 = Giant  #       4 = giant
52  #  #
53  # - Colors are a string like html-type colors in  # - Colors are a string like HTML type colors in
54  #   the form "#rrggbb" with parts written in hex  #   the form "#rrggbb" with parts written in hex
55  #       rr = red (00..ff)  #       rr = red (00..ff)
56  #       gg = green (00-ff)  #       gg = green (00-ff)
57  #       bb = blue (00-ff)  #       bb = blue (00-ff)
58  #  #
59    #   Colors and some strings can also be defined as conditional
60  # cmd_rlog <string>  #   expressions so that revision/branch conditions can be repesented
61  #       The *absolute* path of the rlog command  #   visually:
62  cmd_rlog        = "/usr/bin/rlog";  #     color/string = [ "key" op "content" truecase falsecase ];
63    #   Operator 'op' can be one of:
64    #       * =~    contained in regex
65    #       * =*    contained in regex, case insensitive
66    #       * !~    not contained in regex
67    #       * !*    not contained in regex, case insensitive
68    #       * <     less than string, timestamp or rev/branch number
69    #       * <=    less or equal than string, timestamp or rev/branch number
70    #       * >     greater than string, timestamp or rev/branch number
71    #       * >=    greater or equal than string, timestamp or rev/branch number
72    #       * ==    equal than string, timestamp or rev/branch number
73    #       * !=    not equal than string, timestamp or rev/branch number
74    #   The 'content' is one of:
75    #       * POSIX 1003.2 extended regular expression
76    #       * timestamp in UTC format: YYYY[.MM[.DD[.hh[.mm[.ss]]]]]
77    #       * revision or branch number
78    #   The 'key' can be one of:
79    #       * state         State of the revision
80    #       * author        The auther of a revision
81    #       * tag           both revision- and branch-tags
82    #       * date          date of the revision
83    #       * rev           numeric revision- or branch-number
84    #   Both 'truecase' and 'falsecase' can be either a (color-)string,
85    #   as described above, or a new conditional expression.
86    #   Examples:
87    #       rev_bgcolor = [ "state" =~ "dead" "#e08080" "#f0f0f0" ];
88    #       branch_color= [ "rev" < "2.1.2" "#000000" [ "tag" =~ "XyZ.*" "#123456" "#654321" ] ];
89    #       rev_idtext  = [ "state" == "dead" "Dead %R" "%R" ]
90    #   Note that not all colors can be changed on the fly. For example,
91    #   branch_color cannot be be changed based on revision identification
92    #   (i.e. author, date or state). The color_bg is always unique and
93    #   fixed (all expressions will evaluate to the false case).
94    #   Also, only string rev_text and rev_idtext can be conditional expressions
95    #   as other do not make much sense to be dynamic.
96    #
97    # - There are several reserved words besides of the
98    #   feature-keywords. These additional reserved words
99    #   expand to numerical values:
100    #       * false  = 0
101    #       * true   = 1
102    #       * not    = -1
103    #       * left   = 0
104    #       * center = 1
105    #       * right  = 2
106    #       * gif    = 0
107    #       * png    = 1
108    #       * jpeg   = 2
109    #       * tiny   = 0
110    #       * small  = 1
111    #       * medium = 2
112    #       * large  = 3
113    #       * giant  = 4
114    #
115    # - Booleans have three possible arguments: true, false
116    #   and not. `Not' means inverse of what it was (logical
117    #   negation) and is represented by the value -1.
118    #   For the configuration file that means that the default
119    #   value is negated.
120    #
121    
122  # cvsroot <string>  # cvsroot <string>
123  #       The *absolute* base directory where the  #       The *absolute* base directory where the
124  #       CSV/RCS repository can be found  #       CVS/RCS repository can be found
125  # cvsmodule <string>  # cvsmodule <string>
126  #  #
127  cvsroot         = "/home/bertho/tmp/cvstest";  cvsroot         = "/var/cvs";
128  cvsmodule       = "ttt";  cvsmodule       = "";
129    
130    # color_bg <color>
131    #       The background color of the image
132    # transparent_bg <boolean>
133    #       Make color_bg the transparent color (only useful with PNG)
134  color_bg        = "#ffffff";  color_bg        = "#ffffff";
135    transparent_bg  = false;
136    
137    # date_format <string>
138    #       The strftime(3) format string for date and time
139    date_format     = "%d-%b-%Y %H:%M:%S";
140    
141    # box_shadow <boolean>
142    #       Add a shadow around the boxes
143    # upside_down <boolean>
144    #       Reverse the order of the revisions
145    # left_right <boolean>
146    #       Draw the image left to right instead of top down,
147    #       or right to left is upside_down is set simultaneously.
148    # strip_untagged <boolean>
149    #       Remove all untagged revisions except the first, last and tagged ones
150    # strip_first_rev <boolean>
151    #       Also remove the first revision if untagged
152    # auto_stretch <boolean>
153    #       Try to reformat the tree to minimize image size
154    # use_ttf <boolean>
155    #       Use TrueType fonts for text
156    # anti_alias <boolean>
157    #       Enable pretty TrueType anti-alias drawing
158    # thick_lines <number>
159    #       Draw all connector lines thicker (range: 1..11)
160    box_shadow      = true;
161    upside_down     = false;
162    left_right      = false;
163    strip_untagged  = false;
164    strip_first_rev = false;
165    #auto_stretch   = true;         # not yet stable.
166    use_ttf         = false;
167    anti_alias      = true;
168    thick_lines     = 1;
169    
170    # msg_color <color>
171    #       Sets the error/warning message color
172    # msg_font <number>
173    # msg_ttfont <string>
174    # msg_ttsize <float>
175    #       Sets the error/warning message font
176    msg_color       = "#800000";
177    msg_font        = medium;
178    msg_ttfont      = "/usr/share/fonts/bitstream-vera/VeraIt.ttf";
179    msg_ttsize      = 11.0;
180    
181    # parse_logs <boolean>
182    #       Enable the parsing of the *entire* ,v file to read the
183    #       log-entries between revisions. This is necessary for
184    #       the %L expansion to work, but slows down parsing by
185    #       a very large factor. You're warned.
186    parse_logs      = false;
187    
188  tag_font        = 2;  # tag_font <number>
189  tag_color       = "#008000";  #       The font of the tag text
190    # tag_color <color>
191    #       The color of the tag text
192    # tag_ignore <string>
193    #       A extended regular expression to exclude certain tags from view.
194    #       See regex(7) for details on the format.
195    #       Note 1: tags matched in merge_from/merge_to are always displayed unless
196    #               tag_ignore_merge is set to true.
197    #       Note 2: normal string rules apply and special characters must be
198    #               escaped.
199    # tag_ignore_merge <boolean>
200    #       If set to true, allows tag_ignore to also hide merge_from and merge_to
201    #       tags.
202    # tag_nocase <boolean>
203    #       Ignore the case in tag_ignore expressions
204    # tag_negate <boolean>
205    #       Negate the matching criteria of tag_ignore. When true, only matching
206    #       tags will be shown.
207    #       Note: tags matched with merge_from/merge_to will still be displayed.
208    tag_font        = medium;
209    tag_ttfont      = "/usr/share/fonts/bitstream-vera/VeraIt.ttf";
210    tag_ttsize      = 11.0;
211    tag_color       = "#007000";
212    #tag_ignore     = "(test|alpha)_release";
213    #tag_ignore_merge = false;
214    #tag_nocase     = false;
215    #tag_negate     = false;
216    
217  rev_font        = 4;  # rev_font <number>
218  rev_color       = "#000000";  # rev_ttfont <string>
219    # rev_ttsize <float>
220    #       Sets the font of the revision ID text
221    # rev_hidenumber <boolean>
222    #       If set to true no revision numbers will be printed in the graph.
223    # rev_idtext <cond.string>
224    #       The revision ID text
225    # rev_text_font <number>
226    # rev_text_ttfont <string>
227    # rev_text_ttsize <float>
228    #       Sets the font of the descriptive text
229    # rev_text_color <color>
230    #       Sets the color of the descriptive text
231    # rev_text <cond.string>
232    #       The descriptive text of a revision
233    # rev_color <color>
234    #       The color of the revision box and revision ID text.
235    # rev_bgcolor <color>
236    #       The background color of the revision box
237    # rev_{min,max}line
238    #       Autostretch limits
239    # rev_[ltrb]space
240    #       The interior spacing of the revision box text
241    # rev_separator <number>
242    #       Space between tags in a revision box
243    # rev_maxtags <number>
244    #       Sets the maximum number of tags i a revision box
245    #
246    #rev_hidenumber = false;
247    rev_font        = giant;
248    rev_ttfont      = "/usr/share/fonts/bitstream-vera/Vera.ttf";
249    rev_ttsize      = 12.0;
250    rev_idtext      = [ "state" == "dead" "(Dead %R)" "%R" ];
251    #rev_color      = "#000000";
252    rev_color       = [ "rev" =~ "1\\.1\\.1\\..*" "#ff4040" "#000000" ];
253    #rev_bgcolor    = "#f0f0f0";
254    rev_bgcolor = [ "state" =~ "dead" "#e0c0c0" [ "tag" =~ "BugFix" "#e0e0ff" [ "date" <= "2001.02.15.20.00.00" "#ffe0ff" "#f0f0f0" ] ] ];
255  rev_separator   = 1;  rev_separator   = 1;
256  rev_minline     = 15;  rev_minline     = 15;
257  rev_maxline     = 30;  rev_maxline     = 75;
258  rev_lspace      = 5;  rev_lspace      = 5;
259  rev_rspace      = 5;  rev_rspace      = 5;
260  rev_tspace      = 3;  rev_tspace      = 3;
261  rev_bspace      = 3;  rev_bspace      = 3;
262    #rev_text       = "%d"; # or "%d\n%a, %s" for author and state too
263    rev_text        = [ "state" == "dead" "Died %d\nMaybe alive in other branch" "%d" ];
264    rev_text_font   = tiny;
265    rev_text_ttfont = "/usr/share/fonts/bitstream-vera/VeraSe.ttf";
266    rev_text_ttsize = 9.0;
267    rev_text_color  = "#500020";
268    rev_maxtags     = 25;
269    
270    # merge_color <color>
271    #       The color of the line connecting merges
272    #       See note2 below.
273    # merge_front <boolean>
274    #       If true, draw the merge-lines on top if the image
275    # merge_nocase <boolean>
276    #       Ignore case in regular expressions
277    # merge_from <string>
278    #       A regex describing a tag that is used as the merge source
279    #       See note2 below.
280    # merge_to <string>
281    #       A regex describing a tag that is the target of the merge
282    #       See note2 below.
283    # merge_findall <boolean>
284    #       Try to match all merge_to targets possible. This can result in
285    #       multiple lines originating from one tag.
286    # merge_arrows <boolean>
287    #       Use arrows to point to the merge destination. Default is true.
288    # merge_cvsnt <boolean>
289    #       Use CVSNT's mergepoint registration for merges
290    # merge_cvsnt_color <color>
291    #       The color of the line connecting merges from/to registered
292    #       mergepoints.
293    # merge_on_tag <boolean>
294    #       Display merge lines on tags in left_right case
295    # arrow_width <number>
296    # arrow_length <number>
297    #       Specify the size of the arrows. Default is 3 wide and 12 long.
298    #
299    # NOTE:
300    # - The merge_from is an extended regular expression as described in
301    #   regex(7) and POSIX 1003.2 (see also Single Unix Specification at
302    #   http://www.opengroup.com).
303    # - The merge_to is an extended regular expression with a twist. All
304    #   subexpressions from the merge_from are expanded into merge_to
305    #   using %[1-9] (in contrast to \[1-9] for backreferences). Care is
306    #   taken to escape the constructed expression.
307    # - A '$' at the end of the merge_to expression can be important to
308    #   prevent 'near match' references. Normally, you want the destination
309    #   to be a good representation of the source. However, this depends
310    #   on how well you defined the tags in the first place.
311    #
312    # Example:
313    #       merge_from = "^f_(.*)";
314    #       merge_to = "^t_%1$";
315    #       tags: f_foo, f_bar, f_foobar, t_foo, t_bar
316    #       result:
317    #               f_foo   -> "^t_foo$"    -> t_foo
318    #               f_bar   -> "^t_bar$"    -> t_bar
319    #               f_foobar-> "^t_foobar$" -> <no match>
320    #
321    # NOTE 2:
322    # It is now possible to use multiple regex combination to find merges
323    # which cannot be expressed in one regex.
324    # The triplet merge_{from,to,color} can be used multiple times to
325    # define disjoined tag-definitions.
326    # Example config:
327    #       merge_color = "#ff0000";
328    #       merge_from = "(.*)";
329    #       merge_to = "^pm-%1-to-(.*)";
330    #       merge_color = "#00ff00";
331    #       merge_from = "^closed-(.*)";
332    #       merge_to = "^merged-%1-toMain";
333    #
334    # This will match "rel-1-2-1" to "pm-rel-1-2-1-to-branch-1-2-2" with
335    # bright red and match "closed-branch-1-2-2" to "merged-branch-1-2-2-toMain"
336    # with bright green.
337    # There is no limit on how many times you may repeat the triplet.
338    #
339    merge_color     = "#a000a0";
340    merge_front     = false;
341    merge_nocase    = false;
342    merge_from      = "^f_(.*)";
343    merge_to        = "^t_%1$";
344    merge_findall   = false;
345    
346    #merge_arrows   = true;
347    #arrow_width    = 3;
348    #arrow_length   = 12;
349    
350  branch_font     = 2;  merge_cvsnt     = true;
351    merge_cvsnt_color = "#606000";
352    
353    #merge_on_tag   = true;
354    
355    # branch_font <number>
356    #       The font of the number and tags
357    # branch_color <color>
358    #       All branch element's color
359    # branch_[lrtb]space <number>
360    #       Interior spacing (margin)
361    # branch_margin <number>
362    #       Exterior spacing
363    # branch_connect <number>
364    #       Length of the vertical connector
365    # branch_dupbox <boolean>
366    #       Add the branch-tag also at the bottom/top of the trunk
367    # branch_fold <boolean>
368    #       Fold empty branches in one box to save space
369    # branch_foldall <boolean>
370    #       Put all empty branches in one box, even if they
371    #       were interspaced with branches with revisions.
372    # branch_resort <boolean>
373    #       Resort the branches by the number of revisions to save space
374    # branch_subtree <string>
375    #       Only show the branch denoted or all branches that sprout
376    #       from the denoted revision. The argument may be a symbolic
377    #       tag. This option you would normally want to set from the
378    #       command line with the -O option.
379    branch_font     = medium;
380    branch_ttfont   = "/usr/share/fonts/bitstream-vera/VeraBd.ttf";
381    branch_ttsize   = 18.0;
382    branch_tag_color= "#000080";
383    branch_tag_font = medium;
384    branch_tag_ttfont = "/usr/share/fonts/bitstream-vera/VeraBI.ttf";
385    branch_tag_ttsize = 14.0;
386  branch_color    = "#0000c0";  branch_color    = "#0000c0";
387  branch_bgcolor  = "#ffffff";  branch_bgcolor  = "#ffffc0";
388  branch_lspace   = 5;  branch_lspace   = 5;
389  branch_rspace   = 5;  branch_rspace   = 5;
390  branch_tspace   = 3;  branch_tspace   = 3;
391  branch_bspace   = 3;  branch_bspace   = 3;
392    branch_margin   = 15;
393    branch_connect  = 8;
394    branch_dupbox   = false;
395    branch_fold     = true;
396    branch_foldall  = false;
397    branch_resort   = false;
398    #branch_subtree = "1.2.4";
399    
400  # title <string>  # title <string>
401  #       %c = cvsroot  #       The title string is expanded (see above for details)
 #       %m = module  
 #       %f = filename  
 #       %r = number of revisions  
 #       %b = number of branches  
 #       %% = '%'  
402  # title_[xy] <number>  # title_[xy] <number>
403  #       Postion of title  #       Position of title
404  # title_font <number>  # title_font <number>
405  #       The font  #       The font
406  # title_align <number>  # title_align <number>
407  #       0 = left  #       0 = left
408  #       1 = center  #       1 = center
409  #       2 = right  #       2 = right
410  title           = "%c/%m/%f\nRevisions: %r, Branches: %b";  # title_color <color>
411    title           = "%c%m%f\nRevisions: %r, Branches: %b";
412  title_x         = 10;  title_x         = 10;
413  title_y         = 5;  title_y         = 5;
414  title_font      = 0;  title_font      = small;
415  title_align     = 0;  title_ttfont    = "/usr/share/fonts/bitstream-vera/VeraSe.ttf";
416    title_ttsize    = 10.0;
417    title_align     = left;
418  title_color     = "#800000";  title_color     = "#800000";
419    
420  # Margins of the image  # Margins of the image
421  # Note: the title is outside the margin  # Note: the title is outside the margin
422  margin_top      = 25;  margin_top      = 35;
423  margin_bottom   = 10;  margin_bottom   = 10;
424  margin_left     = 10;  margin_left     = 10;
425  margin_right    = 10;  margin_right    = 10;
426    
427  #width_rev      = 3;  # Image format(s)
428  #width_tag      = 1;  # image_type <number|{gif,jpeg,png}>
429    #       gif  (0) = Create gif image
430    #       png  (1) = Create png image
431    #       jpeg (2) = Create jpeg image
432    #       Image types are available if they can be found in
433    #       the gd library. Newer versions of gd do not have
434    #       gif anymore. CvsGraph will automatically generate
435    #       png images instead.
436    # image_quality <number>
437    #       The quality of a jpeg image (1..100)
438    # image_compress <number>
439    #       Set the compression of a PNG image (gd version >= 2.0.12).
440    #       Values range from -1 to 9 where:
441    #       - -1    default compression (usually 3)
442    #       -  0    no compression
443    #       -  1    lowest level compression
444    #       - ...   ...
445    #       -  9    highest level of compression
446    # image_interlace <boolean>
447    #       Write interlaces PNG/JPEG images for progressive loading.
448    image_type      = png;
449    image_quality   = 75;
450    image_compress  = 3;
451    image_interlace = true;
452    
453    # HTML image map generation
454    # map_name <string>
455    #       The name= attribute in <map name="mapname">...</map>
456    # map_branch_href <string>
457    # map_branch_alt <string>
458    # map_rev_href <string>
459    # map_rev_alt <string>
460    # map_diff_href <string>
461    # map_diff_alt <string>
462    # map_merge_href <string>
463    # map_merge_alt <string>
464    #       These are the href= and alt= attributes in the <area>
465    #       tags of HTML. The strings are expanded (see above).
466    map_name        = "MyMapName";
467    map_branch_href = "href=\"%9cvsweb_graph.cgi/%m%p?only_with_tag=%(%t%)%8\"";
468    map_branch_alt  = "alt=\"%0 %(%t%) (%B)\"";
469    map_rev_href    = "href=\"%9cvsweb_graph.cgi/%m%p%F?rev=%R&amp;content-type=text/x-cvsweb-markup%8\"";
470    map_rev_alt     = "alt=\"%1 %(%t%) (%R)\"";
471    map_diff_href   = "href=\"%9cvsweb_graph.cgi/%m%p%F.diff?r1=%P&amp;r2=%R%8\"";
472    map_diff_alt    = "alt=\"%2 %P &lt;-&gt; %R\"";
473    map_merge_href  = "href=\"%9cvsweb_graph.cgi/%m%p%F.diff?r1=%P&amp;r2=%R%8\"";
474    map_merge_alt   = "alt=\"%2 %P &lt;-&gt; %R\"";
475    

Legend:
Removed from v.1.1.1.1  
changed lines
  Added in v.1.35

  ViewVC Help
Powered by ViewVC 1.1.0 with CvsGraph 1.7.0