/[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 - (show annotations)
Wed May 21 01:41:18 2008 UTC (9 years, 5 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 # CvsGraph configuration
2 #
3 # - Empty lines and whitespace are ignored.
4 #
5 # - Comments start with '#' and everything until
6 # end of line is ignored.
7 #
8 # - 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 #
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
44 # hex as in 0117, 79 and 0x4f respectively.
45 #
46 # - Fonts are numbered 0..4 (defined as in libgd)
47 # 0 = tiny
48 # 1 = small
49 # 2 = medium (bold)
50 # 3 = large
51 # 4 = giant
52 #
53 # - Colors are a string like HTML type colors in
54 # 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 # 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 # 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>
123 # The *absolute* base directory where the
124 # CVS/RCS repository can be found
125 # cvsmodule <string>
126 #
127 cvsroot = "/home/bertho/tmp/cvstest";
128 cvsmodule = "ttt";
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";
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 = "/dos/windows/fonts/ariali.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 <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 # 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 = "/dos/windows/fonts/ariali.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 <number>
218 # 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 = "/dos/windows/fonts/arial.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;
256 rev_minline = 15;
257 rev_maxline = 75;
258 rev_lspace = 5;
259 rev_rspace = 5;
260 rev_tspace = 3;
261 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 = "/dos/windows/fonts/times.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 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 = "/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 branch_color = "#0000c0";
387 branch_bgcolor = "#ffffc0";
388 branch_lspace = 5;
389 branch_rspace = 5;
390 branch_tspace = 3;
391 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>
401 # The title string is expanded (see above for details)
402 # title_[xy] <number>
403 # Position of title
404 # title_font <number>
405 # The font
406 # title_align <number>
407 # 0 = left
408 # 1 = center
409 # 2 = right
410 # title_color <color>
411 title = "%c%m%f\nRevisions: %r, Branches: %b";
412 title_x = 10;
413 title_y = 5;
414 title_font = small;
415 title_ttfont = "/dos/windows/fonts/times.ttf";
416 title_ttsize = 10.0;
417 title_align = left;
418 title_color = "#800000";
419
420 # Margins of the image
421 # Note: the title is outside the margin
422 margin_top = 35;
423 margin_bottom = 10;
424 margin_left = 10;
425 margin_right = 10;
426
427 # 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 # 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

  ViewVC Help
Powered by ViewVC 1.1.0 with CvsGraph 1.7.0