/[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.33 - (show annotations)
Sun Dec 18 01:57:57 2005 UTC (11 years, 10 months ago) by bertho
Branch: MAIN
CVS Tags: REL_1_6_1, REL_1_6_0
Branch point for: svn-integration, automake-dev1
Changes since 1.32: +49 -16 lines
- Added dynamic colors and strings for more flexibility in visual
  representations of the tree.
- Added keyword rev_idtext to define the revision ID in a revision
  box. Normally this would show the revision number, but can now be
  changed dynamically.
- Fix dashed lines when stripped revisions have mergepoints attatched
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 # arrow_width <number>
294 # arrow_length <number>
295 # Specify the size of the arrows. Default is 3 wide and 12 long.
296 #
297 # NOTE:
298 # - The merge_from is an extended regular expression as described in
299 # regex(7) and POSIX 1003.2 (see also Single Unix Specification at
300 # http://www.opengroup.com).
301 # - The merge_to is an extended regular expression with a twist. All
302 # subexpressions from the merge_from are expanded into merge_to
303 # using %[1-9] (in contrast to \[1-9] for backreferences). Care is
304 # taken to escape the constructed expression.
305 # - A '$' at the end of the merge_to expression can be important to
306 # prevent 'near match' references. Normally, you want the destination
307 # to be a good representation of the source. However, this depends
308 # on how well you defined the tags in the first place.
309 #
310 # Example:
311 # merge_from = "^f_(.*)";
312 # merge_to = "^t_%1$";
313 # tags: f_foo, f_bar, f_foobar, t_foo, t_bar
314 # result:
315 # f_foo -> "^t_foo$" -> t_foo
316 # f_bar -> "^t_bar$" -> t_bar
317 # f_foobar-> "^t_foobar$" -> <no match>
318 #
319 # NOTE 2:
320 # It is now possible to use multiple regex combination to find merges
321 # which cannot be expressed in one regex.
322 # The triplet merge_{from,to,color} can be used multiple times to
323 # define disjoined tag-definitions.
324 # Example config:
325 # merge_color = "#ff0000";
326 # merge_from = "(.*)";
327 # merge_to = "^pm-%1-to-(.*)";
328 # merge_color = "#00ff00";
329 # merge_from = "^closed-(.*)";
330 # merge_to = "^merged-%1-toMain";
331 #
332 # This will match "rel-1-2-1" to "pm-rel-1-2-1-to-branch-1-2-2" with
333 # bright red and match "closed-branch-1-2-2" to "merged-branch-1-2-2-toMain"
334 # with bright green.
335 # There is no limit on how many times you may repeat the triplet.
336 #
337 merge_color = "#a000a0";
338 merge_front = false;
339 merge_nocase = false;
340 merge_from = "^f_(.*)";
341 merge_to = "^t_%1$";
342 merge_findall = false;
343
344 #merge_arrows = true;
345 #arrow_width = 3;
346 #arrow_length = 12;
347
348 merge_cvsnt = true;
349 merge_cvsnt_color = "#606000";
350
351 # branch_font <number>
352 # The font of the number and tags
353 # branch_color <color>
354 # All branch element's color
355 # branch_[lrtb]space <number>
356 # Interior spacing (margin)
357 # branch_margin <number>
358 # Exterior spacing
359 # branch_connect <number>
360 # Length of the vertical connector
361 # branch_dupbox <boolean>
362 # Add the branch-tag also at the bottom/top of the trunk
363 # branch_fold <boolean>
364 # Fold empty branches in one box to save space
365 # branch_foldall <boolean>
366 # Put all empty branches in one box, even if they
367 # were interspaced with branches with revisions.
368 # branch_resort <boolean>
369 # Resort the branches by the number of revisions to save space
370 # branch_subtree <string>
371 # Only show the branch denoted or all branches that sprout
372 # from the denoted revision. The argument may be a symbolic
373 # tag. This option you would normally want to set from the
374 # command line with the -O option.
375 branch_font = medium;
376 branch_ttfont = "/dos/windows/fonts/arialbd.ttf";
377 branch_ttsize = 18.0;
378 branch_tag_color= "#000080";
379 branch_tag_font = medium;
380 branch_tag_ttfont = "/dos/windows/fonts/arialbi.ttf";
381 branch_tag_ttsize = 14.0;
382 branch_color = "#0000c0";
383 branch_bgcolor = "#ffffc0";
384 branch_lspace = 5;
385 branch_rspace = 5;
386 branch_tspace = 3;
387 branch_bspace = 3;
388 branch_margin = 15;
389 branch_connect = 8;
390 branch_dupbox = false;
391 branch_fold = true;
392 branch_foldall = false;
393 branch_resort = false;
394 #branch_subtree = "1.2.4";
395
396 # title <string>
397 # The title string is expanded (see above for details)
398 # title_[xy] <number>
399 # Position of title
400 # title_font <number>
401 # The font
402 # title_align <number>
403 # 0 = left
404 # 1 = center
405 # 2 = right
406 # title_color <color>
407 title = "%c%m%f\nRevisions: %r, Branches: %b";
408 title_x = 10;
409 title_y = 5;
410 title_font = small;
411 title_ttfont = "/dos/windows/fonts/times.ttf";
412 title_ttsize = 10.0;
413 title_align = left;
414 title_color = "#800000";
415
416 # Margins of the image
417 # Note: the title is outside the margin
418 margin_top = 35;
419 margin_bottom = 10;
420 margin_left = 10;
421 margin_right = 10;
422
423 # Image format(s)
424 # image_type <number|{gif,jpeg,png}>
425 # gif (0) = Create gif image
426 # png (1) = Create png image
427 # jpeg (2) = Create jpeg image
428 # Image types are available if they can be found in
429 # the gd library. Newer versions of gd do not have
430 # gif anymore. CvsGraph will automatically generate
431 # png images instead.
432 # image_quality <number>
433 # The quality of a jpeg image (1..100)
434 # image_compress <number>
435 # Set the compression of a PNG image (gd version >= 2.0.12).
436 # Values range from -1 to 9 where:
437 # - -1 default compression (usually 3)
438 # - 0 no compression
439 # - 1 lowest level compression
440 # - ... ...
441 # - 9 highest level of compression
442 # image_interlace <boolean>
443 # Write interlaces PNG/JPEG images for progressive loading.
444 image_type = png;
445 image_quality = 75;
446 image_compress = 3;
447 image_interlace = true;
448
449 # HTML image map generation
450 # map_name <string>
451 # The name= attribute in <map name="mapname">...</map>
452 # map_branch_href <string>
453 # map_branch_alt <string>
454 # map_rev_href <string>
455 # map_rev_alt <string>
456 # map_diff_href <string>
457 # map_diff_alt <string>
458 # map_merge_href <string>
459 # map_merge_alt <string>
460 # These are the href= and alt= attributes in the <area>
461 # tags of HTML. The strings are expanded (see above).
462 map_name = "MyMapName";
463 map_branch_href = "href=\"%9cvsweb_graph.cgi/%m%p?only_with_tag=%(%t%)%8\"";
464 map_branch_alt = "alt=\"%0 %(%t%) (%B)\"";
465 map_rev_href = "href=\"%9cvsweb_graph.cgi/%m%p%F?rev=%R&amp;content-type=text/x-cvsweb-markup%8\"";
466 map_rev_alt = "alt=\"%1 %(%t%) (%R)\"";
467 map_diff_href = "href=\"%9cvsweb_graph.cgi/%m%p%F.diff?r1=%P&amp;r2=%R%8\"";
468 map_diff_alt = "alt=\"%2 %P &lt;-&gt; %R\"";
469 map_merge_href = "href=\"%9cvsweb_graph.cgi/%m%p%F.diff?r1=%P&amp;r2=%R%8\"";
470 map_merge_alt = "alt=\"%2 %P &lt;-&gt; %R\"";
471

  ViewVC Help
Powered by ViewVC 1.1.0 with CvsGraph 1.7.0