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

Annotate of /cvsgraph/cvsgraph.conf

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


Revision 1.34 - (hide annotations)
Wed May 21 01:41:18 2008 UTC (9 years, 6 months ago) by bertho
Branch: MAIN
CVS Tags: REL_1_6_2, source_head_20080521
Changes since 1.33: +4 -0 lines
- Do a better job at drawing the merge lines by selecting the shortest path
  from the revision boxes. An analysis is now done whether the source and
  destinations should be on the left or right side.
- Fix the left_right case for merge lines to display correctly.
- Fix a +/-1 error on the merge lines to account for both rounding errors and
  the shadow of the revision boxes.
- Add configuration option 'merge_on_tag' to force the left_right case to
  display merge lines on the tags instead of on the top/bottom sides. This
  also solves imagemap overlaps where multiple sources or destinations would
  be displayed at the same position.
- Fix the imagemap function to record the correct position of the merges.
1 bertho 1.1 # CvsGraph configuration
2     #
3 bertho 1.4 # - Empty lines and whitespace are ignored.
4     #
5 bertho 1.1 # - Comments start with '#' and everything until
6     # end of line is ignored.
7 bertho 1.4 #
8 bertho 1.1 # - Strings are C-style strings in which characters
9     # may be escaped with '\' and written in octal
10     # and hex escapes. Note that '\' must be escaped
11     # if it is to be entered as a character.
12 bertho 1.4 #
13 bertho 1.5 # - 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 bertho 1.16 # will expand to nothing.
17 bertho 1.6 # %c = cvsroot (with trailing '/')
18 bertho 1.9 # %C = cvsroot (*without* trailing '/')
19 bertho 1.6 # %m = module (with trailing '/')
20 bertho 1.9 # %M = module (*without* trailing '/')
21 bertho 1.5 # %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 bertho 1.6 # %P = previous revision number
29 bertho 1.5 # %B = the branch number (e.g. '1.2.4')
30 bertho 1.6 # %d = date of revision
31     # %a = author of revision
32     # %s = state of revision
33 bertho 1.5 # %t = current tag of branch or revision
34     # %0..%9 = command-line argument -0 .. -9
35 bertho 1.28 # %l = HTMLized log entry of the revision
36 bertho 1.19 # NOTE: %l is obsolete. See %(%) and cvsgraph.conf(5) for
37     # more details.
38 bertho 1.28 # %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 bertho 1.5 #
43 bertho 1.1 # - Numbers may be entered as octal, decimal or
44 bertho 1.4 # hex as in 0117, 79 and 0x4f respectively.
45     #
46 bertho 1.1 # - Fonts are numbered 0..4 (defined as in libgd)
47 bertho 1.4 # 0 = tiny
48     # 1 = small
49     # 2 = medium (bold)
50     # 3 = large
51     # 4 = giant
52 bertho 1.1 #
53 bertho 1.28 # - Colors are a string like HTML type colors in
54 bertho 1.1 # the form "#rrggbb" with parts written in hex
55     # rr = red (00..ff)
56     # gg = green (00-ff)
57     # bb = blue (00-ff)
58     #
59 bertho 1.33 # Colors and some strings can also be defined as conditional
60     # expressions so that revision/branch conditions can be repesented
61     # visually:
62     # color/string = [ "key" op "content" truecase falsecase ];
63 bertho 1.32 # 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 bertho 1.33 # * < 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 bertho 1.32 # The 'content' is one of:
75     # * POSIX 1003.2 extended regular expression
76 bertho 1.33 # * timestamp in UTC format: YYYY[.MM[.DD[.hh[.mm[.ss]]]]]
77 bertho 1.32 # * 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 bertho 1.33 # Both 'truecase' and 'falsecase' can be either a (color-)string,
85 bertho 1.32 # 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 bertho 1.33 # rev_idtext = [ "state" == "dead" "Dead %R" "%R" ]
90 bertho 1.32 # 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 bertho 1.33 # Also, only string rev_text and rev_idtext can be conditional expressions
95     # as other do not make much sense to be dynamic.
96 bertho 1.32 #
97 bertho 1.4 # - 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 bertho 1.15 # * not = -1
103 bertho 1.4 # * 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 bertho 1.15 #
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 bertho 1.1
122     # cvsroot <string>
123     # The *absolute* base directory where the
124 bertho 1.28 # CVS/RCS repository can be found
125 bertho 1.1 # cvsmodule <string>
126     #
127     cvsroot = "/home/bertho/tmp/cvstest";
128     cvsmodule = "ttt";
129    
130 bertho 1.6 # color_bg <color>
131     # The background color of the image
132 bertho 1.14 # transparent_bg <boolean>
133 bertho 1.28 # Make color_bg the transparent color (only useful with PNG)
134 bertho 1.1 color_bg = "#ffffff";
135 bertho 1.14 transparent_bg = false;
136 bertho 1.1
137 bertho 1.6 # date_format <string>
138     # The strftime(3) format string for date and time
139     date_format = "%d-%b-%Y %H:%M:%S";
140    
141 bertho 1.13 # box_shadow <boolean>
142 bertho 1.11 # Add a shadow around the boxes
143     # upside_down <boolean>
144     # Reverse the order of the revisions
145 bertho 1.17 # left_right <boolean>
146     # Draw the image left to right instead of top down,
147 bertho 1.28 # or right to left is upside_down is set simultaneously.
148 bertho 1.13 # strip_untagged <boolean>
149 bertho 1.17 # Remove all untagged revisions except the first, last and tagged ones
150 bertho 1.13 # strip_first_rev <boolean>
151     # Also remove the first revision if untagged
152 bertho 1.14 # auto_stretch <boolean>
153 bertho 1.13 # Try to reformat the tree to minimize image size
154 bertho 1.15 # 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 bertho 1.6 box_shadow = true;
161 bertho 1.11 upside_down = false;
162 bertho 1.17 left_right = false;
163 bertho 1.13 strip_untagged = false;
164     strip_first_rev = false;
165 bertho 1.15 #auto_stretch = true; # not yet stable.
166 bertho 1.14 use_ttf = false;
167     anti_alias = true;
168 bertho 1.15 thick_lines = 1;
169 bertho 1.16
170 bertho 1.25 # 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 = "/dos/windows/fonts/ariali.ttf";
179     msg_ttsize = 11.0;
180    
181 bertho 1.16 # 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 bertho 1.19 # the %L expansion to work, but slows down parsing by
185 bertho 1.16 # a very large factor. You're warned.
186     parse_logs = false;
187 bertho 1.6
188 bertho 1.23 # tag_font <number>
189     # 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 bertho 1.26 # 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 bertho 1.23 # tag_nocase <boolean>
203 bertho 1.31 # Ignore the case in tag_ignore expressions
204 bertho 1.24 # tag_negate <boolean>
205 bertho 1.26 # Negate the matching criteria of tag_ignore. When true, only matching
206     # tags will be shown.
207 bertho 1.24 # Note: tags matched with merge_from/merge_to will still be displayed.
208 bertho 1.4 tag_font = medium;
209 bertho 1.14 tag_ttfont = "/dos/windows/fonts/ariali.ttf";
210     tag_ttsize = 11.0;
211 bertho 1.6 tag_color = "#007000";
212 bertho 1.23 #tag_ignore = "(test|alpha)_release";
213 bertho 1.26 #tag_ignore_merge = false;
214 bertho 1.23 #tag_nocase = false;
215 bertho 1.24 #tag_negate = false;
216 bertho 1.1
217 bertho 1.33 # rev_font <number>
218     # rev_ttfont <string>
219     # rev_ttsize <float>
220     # Sets the font of the revision ID text
221 bertho 1.26 # rev_hidenumber <boolean>
222     # If set to true no revision numbers will be printed in the graph.
223 bertho 1.33 # 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 bertho 1.26 #rev_hidenumber = false;
247 bertho 1.4 rev_font = giant;
248 bertho 1.14 rev_ttfont = "/dos/windows/fonts/arial.ttf";
249     rev_ttsize = 12.0;
250 bertho 1.33 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 bertho 1.1 rev_separator = 1;
256     rev_minline = 15;
257 bertho 1.14 rev_maxline = 75;
258 bertho 1.1 rev_lspace = 5;
259     rev_rspace = 5;
260     rev_tspace = 3;
261     rev_bspace = 3;
262 bertho 1.33 #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 bertho 1.6 rev_text_font = tiny;
265 bertho 1.14 rev_text_ttfont = "/dos/windows/fonts/times.ttf";
266     rev_text_ttsize = 9.0;
267 bertho 1.6 rev_text_color = "#500020";
268 bertho 1.18 rev_maxtags = 25;
269 bertho 1.1
270 bertho 1.19 # merge_color <color>
271     # The color of the line connecting merges
272 bertho 1.32 # See note2 below.
273 bertho 1.19 # 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 bertho 1.32 # See note2 below.
280 bertho 1.19 # merge_to <string>
281     # A regex describing a tag that is the target of the merge
282 bertho 1.32 # See note2 below.
283 bertho 1.26 # merge_findall <boolean>
284     # Try to match all merge_to targets possible. This can result in
285     # multiple lines originating from one tag.
286 bertho 1.22 # merge_arrows <boolean>
287     # Use arrows to point to the merge destination. Default is true.
288 bertho 1.29 # 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 bertho 1.34 # merge_on_tag <boolean>
294     # Display merge lines on tags in left_right case
295 bertho 1.22 # arrow_width <number>
296     # arrow_length <number>
297     # Specify the size of the arrows. Default is 3 wide and 12 long.
298 bertho 1.19 #
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 bertho 1.32 #
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 bertho 1.19 #
339     merge_color = "#a000a0";
340     merge_front = false;
341     merge_nocase = false;
342     merge_from = "^f_(.*)";
343     merge_to = "^t_%1$";
344 bertho 1.26 merge_findall = false;
345 bertho 1.22
346     #merge_arrows = true;
347     #arrow_width = 3;
348     #arrow_length = 12;
349    
350 bertho 1.29 merge_cvsnt = true;
351     merge_cvsnt_color = "#606000";
352 bertho 1.34
353     #merge_on_tag = true;
354 bertho 1.19
355 bertho 1.4 # 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 bertho 1.12 # branch_dupbox <boolean>
366 bertho 1.11 # Add the branch-tag also at the bottom/top of the trunk
367 bertho 1.20 # branch_fold <boolean>
368     # Fold empty branches in one box to save space
369 bertho 1.21 # branch_foldall <boolean>
370     # Put all empty branches in one box, even if they
371 bertho 1.26 # were interspaced with branches with revisions.
372 bertho 1.27 # branch_resort <boolean>
373     # Resort the branches by the number of revisions to save space
374 bertho 1.25 # 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 bertho 1.28 # command line with the -O option.
379 bertho 1.4 branch_font = medium;
380 bertho 1.14 branch_ttfont = "/dos/windows/fonts/arialbd.ttf";
381     branch_ttsize = 18.0;
382     branch_tag_color= "#000080";
383     branch_tag_font = medium;
384     branch_tag_ttfont = "/dos/windows/fonts/arialbi.ttf";
385     branch_tag_ttsize = 14.0;
386 bertho 1.1 branch_color = "#0000c0";
387 bertho 1.6 branch_bgcolor = "#ffffc0";
388 bertho 1.1 branch_lspace = 5;
389     branch_rspace = 5;
390     branch_tspace = 3;
391     branch_bspace = 3;
392 bertho 1.4 branch_margin = 15;
393     branch_connect = 8;
394 bertho 1.12 branch_dupbox = false;
395 bertho 1.20 branch_fold = true;
396 bertho 1.21 branch_foldall = false;
397 bertho 1.27 branch_resort = false;
398 bertho 1.25 #branch_subtree = "1.2.4";
399 bertho 1.1
400     # title <string>
401 bertho 1.5 # The title string is expanded (see above for details)
402 bertho 1.1 # title_[xy] <number>
403 bertho 1.28 # Position of title
404 bertho 1.1 # title_font <number>
405     # The font
406     # title_align <number>
407     # 0 = left
408     # 1 = center
409     # 2 = right
410 bertho 1.4 # title_color <color>
411 bertho 1.6 title = "%c%m%f\nRevisions: %r, Branches: %b";
412 bertho 1.1 title_x = 10;
413     title_y = 5;
414 bertho 1.6 title_font = small;
415 bertho 1.14 title_ttfont = "/dos/windows/fonts/times.ttf";
416     title_ttsize = 10.0;
417 bertho 1.4 title_align = left;
418 bertho 1.1 title_color = "#800000";
419    
420     # Margins of the image
421     # Note: the title is outside the margin
422 bertho 1.6 margin_top = 35;
423 bertho 1.1 margin_bottom = 10;
424     margin_left = 10;
425     margin_right = 10;
426    
427 bertho 1.2 # Image format(s)
428     # 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 bertho 1.30 # 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 bertho 1.6 image_type = png;
449 bertho 1.2 image_quality = 75;
450 bertho 1.30 image_compress = 3;
451     image_interlace = true;
452 bertho 1.2
453 bertho 1.28 # HTML image map generation
454 bertho 1.5 # map_name <string>
455 bertho 1.7 # The name= attribute in <map name="mapname">...</map>
456 bertho 1.5 # map_branch_href <string>
457     # map_branch_alt <string>
458     # map_rev_href <string>
459     # map_rev_alt <string>
460 bertho 1.6 # map_diff_href <string>
461     # map_diff_alt <string>
462 bertho 1.25 # map_merge_href <string>
463     # map_merge_alt <string>
464 bertho 1.5 # These are the href= and alt= attributes in the <area>
465 bertho 1.28 # tags of HTML. The strings are expanded (see above).
466 bertho 1.3 map_name = "MyMapName";
467 bertho 1.19 map_branch_href = "href=\"%9cvsweb_graph.cgi/%m%p?only_with_tag=%(%t%)%8\"";
468     map_branch_alt = "alt=\"%0 %(%t%) (%B)\"";
469 bertho 1.28 map_rev_href = "href=\"%9cvsweb_graph.cgi/%m%p%F?rev=%R&amp;content-type=text/x-cvsweb-markup%8\"";
470 bertho 1.19 map_rev_alt = "alt=\"%1 %(%t%) (%R)\"";
471 bertho 1.28 map_diff_href = "href=\"%9cvsweb_graph.cgi/%m%p%F.diff?r1=%P&amp;r2=%R%8\"";
472 bertho 1.8 map_diff_alt = "alt=\"%2 %P &lt;-&gt; %R\"";
473 bertho 1.28 map_merge_href = "href=\"%9cvsweb_graph.cgi/%m%p%F.diff?r1=%P&amp;r2=%R%8\"";
474 bertho 1.25 map_merge_alt = "alt=\"%2 %P &lt;-&gt; %R\"";
475 bertho 1.3

  ViewVC Help
Powered by ViewVC 1.1.0 with CvsGraph 1.7.0