/[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.28 - (hide annotations)
Thu Sep 23 19:45:05 2004 UTC (13 years, 2 months ago) by bertho
Branch: MAIN
Changes since 1.27: +16 -16 lines
Apply the patches by Ville Skyttä (with many thanks)
- spelling fixes
- config fix for & -> &
- wrapper example generics fixes
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.4 # - There are several reserved words besides of the
60     # feature-keywords. These additional reserved words
61     # expand to numerical values:
62     # * false = 0
63     # * true = 1
64 bertho 1.15 # * not = -1
65 bertho 1.4 # * left = 0
66     # * center = 1
67     # * right = 2
68     # * gif = 0
69     # * png = 1
70     # * jpeg = 2
71     # * tiny = 0
72     # * small = 1
73     # * medium = 2
74     # * large = 3
75     # * giant = 4
76 bertho 1.15 #
77     # - Booleans have three possible arguments: true, false
78     # and not. `Not' means inverse of what it was (logical
79     # negation) and is represented by the value -1.
80     # For the configuration file that means that the default
81     # value is negated.
82     #
83 bertho 1.1
84     # cvsroot <string>
85     # The *absolute* base directory where the
86 bertho 1.28 # CVS/RCS repository can be found
87 bertho 1.1 # cvsmodule <string>
88     #
89     cvsroot = "/home/bertho/tmp/cvstest";
90     cvsmodule = "ttt";
91    
92 bertho 1.6 # color_bg <color>
93     # The background color of the image
94 bertho 1.14 # transparent_bg <boolean>
95 bertho 1.28 # Make color_bg the transparent color (only useful with PNG)
96 bertho 1.1 color_bg = "#ffffff";
97 bertho 1.14 transparent_bg = false;
98 bertho 1.1
99 bertho 1.6 # date_format <string>
100     # The strftime(3) format string for date and time
101     date_format = "%d-%b-%Y %H:%M:%S";
102    
103 bertho 1.13 # box_shadow <boolean>
104 bertho 1.11 # Add a shadow around the boxes
105     # upside_down <boolean>
106     # Reverse the order of the revisions
107 bertho 1.17 # left_right <boolean>
108     # Draw the image left to right instead of top down,
109 bertho 1.28 # or right to left is upside_down is set simultaneously.
110 bertho 1.13 # strip_untagged <boolean>
111 bertho 1.17 # Remove all untagged revisions except the first, last and tagged ones
112 bertho 1.13 # strip_first_rev <boolean>
113     # Also remove the first revision if untagged
114 bertho 1.14 # auto_stretch <boolean>
115 bertho 1.13 # Try to reformat the tree to minimize image size
116 bertho 1.15 # use_ttf <boolean>
117     # Use TrueType fonts for text
118     # anti_alias <boolean>
119     # Enable pretty TrueType anti-alias drawing
120     # thick_lines <number>
121     # Draw all connector lines thicker (range: 1..11)
122 bertho 1.6 box_shadow = true;
123 bertho 1.11 upside_down = false;
124 bertho 1.17 left_right = false;
125 bertho 1.13 strip_untagged = false;
126     strip_first_rev = false;
127 bertho 1.15 #auto_stretch = true; # not yet stable.
128 bertho 1.14 use_ttf = false;
129     anti_alias = true;
130 bertho 1.15 thick_lines = 1;
131 bertho 1.16
132 bertho 1.25 # msg_color <color>
133     # Sets the error/warning message color
134     # msg_font <number>
135     # msg_ttfont <string>
136     # msg_ttsize <float>
137     # Sets the error/warning message font
138     msg_color = "#800000";
139     msg_font = medium;
140     msg_ttfont = "/dos/windows/fonts/ariali.ttf";
141     msg_ttsize = 11.0;
142    
143 bertho 1.16 # parse_logs <boolean>
144     # Enable the parsing of the *entire* ,v file to read the
145     # log-entries between revisions. This is necessary for
146 bertho 1.19 # the %L expansion to work, but slows down parsing by
147 bertho 1.16 # a very large factor. You're warned.
148     parse_logs = false;
149 bertho 1.6
150 bertho 1.23 # tag_font <number>
151     # The font of the tag text
152     # tag_color <color>
153     # The color of the tag text
154     # tag_ignore <string>
155     # A extended regular expression to exclude certain tags from view.
156     # See regex(7) for details on the format.
157 bertho 1.26 # Note 1: tags matched in merge_from/merge_to are always displayed unless
158     # tag_ignore_merge is set to true.
159     # Note 2: normal string rules apply and special characters must be
160     # escaped.
161     # tag_ignore_merge <boolean>
162     # If set to true, allows tag_ignore to also hide merge_from and merge_to
163     # tags.
164 bertho 1.23 # tag_nocase <boolean>
165     # Ignore the case is tag_ignore expressions
166 bertho 1.24 # tag_negate <boolean>
167 bertho 1.26 # Negate the matching criteria of tag_ignore. When true, only matching
168     # tags will be shown.
169 bertho 1.24 # Note: tags matched with merge_from/merge_to will still be displayed.
170 bertho 1.4 tag_font = medium;
171 bertho 1.14 tag_ttfont = "/dos/windows/fonts/ariali.ttf";
172     tag_ttsize = 11.0;
173 bertho 1.6 tag_color = "#007000";
174 bertho 1.23 #tag_ignore = "(test|alpha)_release";
175 bertho 1.26 #tag_ignore_merge = false;
176 bertho 1.23 #tag_nocase = false;
177 bertho 1.24 #tag_negate = false;
178 bertho 1.1
179 bertho 1.26 # rev_hidenumber <boolean>
180     # If set to true no revision numbers will be printed in the graph.
181     #rev_hidenumber = false;
182 bertho 1.4 rev_font = giant;
183 bertho 1.14 rev_ttfont = "/dos/windows/fonts/arial.ttf";
184     rev_ttsize = 12.0;
185 bertho 1.1 rev_color = "#000000";
186 bertho 1.6 rev_bgcolor = "#f0f0f0";
187 bertho 1.1 rev_separator = 1;
188     rev_minline = 15;
189 bertho 1.14 rev_maxline = 75;
190 bertho 1.1 rev_lspace = 5;
191     rev_rspace = 5;
192     rev_tspace = 3;
193     rev_bspace = 3;
194 bertho 1.14 rev_text = "%d"; # or "%d\n%a, %s" for author and state too
195 bertho 1.6 rev_text_font = tiny;
196 bertho 1.14 rev_text_ttfont = "/dos/windows/fonts/times.ttf";
197     rev_text_ttsize = 9.0;
198 bertho 1.6 rev_text_color = "#500020";
199 bertho 1.18 rev_maxtags = 25;
200 bertho 1.1
201 bertho 1.19 # merge_color <color>
202     # The color of the line connecting merges
203     # merge_front <boolean>
204     # If true, draw the merge-lines on top if the image
205     # merge_nocase <boolean>
206     # Ignore case in regular expressions
207     # merge_from <string>
208     # A regex describing a tag that is used as the merge source
209     # merge_to <string>
210     # A regex describing a tag that is the target of the merge
211 bertho 1.26 # merge_findall <boolean>
212     # Try to match all merge_to targets possible. This can result in
213     # multiple lines originating from one tag.
214 bertho 1.22 # merge_arrows <boolean>
215     # Use arrows to point to the merge destination. Default is true.
216     # arrow_width <number>
217     # arrow_length <number>
218     # Specify the size of the arrows. Default is 3 wide and 12 long.
219 bertho 1.19 #
220     # NOTE:
221     # - The merge_from is an extended regular expression as described in
222     # regex(7) and POSIX 1003.2 (see also Single Unix Specification at
223     # http://www.opengroup.com).
224     # - The merge_to is an extended regular expression with a twist. All
225     # subexpressions from the merge_from are expanded into merge_to
226     # using %[1-9] (in contrast to \[1-9] for backreferences). Care is
227     # taken to escape the constructed expression.
228     # - A '$' at the end of the merge_to expression can be important to
229     # prevent 'near match' references. Normally, you want the destination
230     # to be a good representation of the source. However, this depends
231     # on how well you defined the tags in the first place.
232     #
233     # Example:
234     # merge_from = "^f_(.*)";
235     # merge_to = "^t_%1$";
236     # tags: f_foo, f_bar, f_foobar, t_foo, t_bar
237     # result:
238     # f_foo -> "^t_foo$" -> t_foo
239     # f_bar -> "^t_bar$" -> t_bar
240     # f_foobar-> "^t_foobar$" -> <no match>
241     #
242     merge_color = "#a000a0";
243     merge_front = false;
244     merge_nocase = false;
245     merge_from = "^f_(.*)";
246     merge_to = "^t_%1$";
247 bertho 1.26 merge_findall = false;
248 bertho 1.22
249     #merge_arrows = true;
250     #arrow_width = 3;
251     #arrow_length = 12;
252    
253 bertho 1.19
254 bertho 1.4 # branch_font <number>
255     # The font of the number and tags
256     # branch_color <color>
257     # All branch element's color
258     # branch_[lrtb]space <number>
259     # Interior spacing (margin)
260     # branch_margin <number>
261     # Exterior spacing
262     # branch_connect <number>
263     # Length of the vertical connector
264 bertho 1.12 # branch_dupbox <boolean>
265 bertho 1.11 # Add the branch-tag also at the bottom/top of the trunk
266 bertho 1.20 # branch_fold <boolean>
267     # Fold empty branches in one box to save space
268 bertho 1.21 # branch_foldall <boolean>
269     # Put all empty branches in one box, even if they
270 bertho 1.26 # were interspaced with branches with revisions.
271 bertho 1.27 # branch_resort <boolean>
272     # Resort the branches by the number of revisions to save space
273 bertho 1.25 # branch_subtree <string>
274     # Only show the branch denoted or all branches that sprout
275     # from the denoted revision. The argument may be a symbolic
276     # tag. This option you would normally want to set from the
277 bertho 1.28 # command line with the -O option.
278 bertho 1.4 branch_font = medium;
279 bertho 1.14 branch_ttfont = "/dos/windows/fonts/arialbd.ttf";
280     branch_ttsize = 18.0;
281     branch_tag_color= "#000080";
282     branch_tag_font = medium;
283     branch_tag_ttfont = "/dos/windows/fonts/arialbi.ttf";
284     branch_tag_ttsize = 14.0;
285 bertho 1.1 branch_color = "#0000c0";
286 bertho 1.6 branch_bgcolor = "#ffffc0";
287 bertho 1.1 branch_lspace = 5;
288     branch_rspace = 5;
289     branch_tspace = 3;
290     branch_bspace = 3;
291 bertho 1.4 branch_margin = 15;
292     branch_connect = 8;
293 bertho 1.12 branch_dupbox = false;
294 bertho 1.20 branch_fold = true;
295 bertho 1.21 branch_foldall = false;
296 bertho 1.27 branch_resort = false;
297 bertho 1.25 #branch_subtree = "1.2.4";
298 bertho 1.1
299     # title <string>
300 bertho 1.5 # The title string is expanded (see above for details)
301 bertho 1.1 # title_[xy] <number>
302 bertho 1.28 # Position of title
303 bertho 1.1 # title_font <number>
304     # The font
305     # title_align <number>
306     # 0 = left
307     # 1 = center
308     # 2 = right
309 bertho 1.4 # title_color <color>
310 bertho 1.6 title = "%c%m%f\nRevisions: %r, Branches: %b";
311 bertho 1.1 title_x = 10;
312     title_y = 5;
313 bertho 1.6 title_font = small;
314 bertho 1.14 title_ttfont = "/dos/windows/fonts/times.ttf";
315     title_ttsize = 10.0;
316 bertho 1.4 title_align = left;
317 bertho 1.1 title_color = "#800000";
318    
319     # Margins of the image
320     # Note: the title is outside the margin
321 bertho 1.6 margin_top = 35;
322 bertho 1.1 margin_bottom = 10;
323     margin_left = 10;
324     margin_right = 10;
325    
326 bertho 1.2 # Image format(s)
327     # image_type <number|{gif,jpeg,png}>
328     # gif (0) = Create gif image
329     # png (1) = Create png image
330     # jpeg (2) = Create jpeg image
331     # Image types are available if they can be found in
332     # the gd library. Newer versions of gd do not have
333     # gif anymore. CvsGraph will automatically generate
334     # png images instead.
335     # image_quality <number>
336     # The quality of a jpeg image (1..100)
337 bertho 1.6 image_type = png;
338 bertho 1.2 image_quality = 75;
339    
340 bertho 1.28 # HTML image map generation
341 bertho 1.5 # map_name <string>
342 bertho 1.7 # The name= attribute in <map name="mapname">...</map>
343 bertho 1.5 # map_branch_href <string>
344     # map_branch_alt <string>
345     # map_rev_href <string>
346     # map_rev_alt <string>
347 bertho 1.6 # map_diff_href <string>
348     # map_diff_alt <string>
349 bertho 1.25 # map_merge_href <string>
350     # map_merge_alt <string>
351 bertho 1.5 # These are the href= and alt= attributes in the <area>
352 bertho 1.28 # tags of HTML. The strings are expanded (see above).
353 bertho 1.3 map_name = "MyMapName";
354 bertho 1.19 map_branch_href = "href=\"%9cvsweb_graph.cgi/%m%p?only_with_tag=%(%t%)%8\"";
355     map_branch_alt = "alt=\"%0 %(%t%) (%B)\"";
356 bertho 1.28 map_rev_href = "href=\"%9cvsweb_graph.cgi/%m%p%F?rev=%R&amp;content-type=text/x-cvsweb-markup%8\"";
357 bertho 1.19 map_rev_alt = "alt=\"%1 %(%t%) (%R)\"";
358 bertho 1.28 map_diff_href = "href=\"%9cvsweb_graph.cgi/%m%p%F.diff?r1=%P&amp;r2=%R%8\"";
359 bertho 1.8 map_diff_alt = "alt=\"%2 %P &lt;-&gt; %R\"";
360 bertho 1.28 map_merge_href = "href=\"%9cvsweb_graph.cgi/%m%p%F.diff?r1=%P&amp;r2=%R%8\"";
361 bertho 1.25 map_merge_alt = "alt=\"%2 %P &lt;-&gt; %R\"";
362 bertho 1.3

  ViewVC Help
Powered by ViewVC 1.1.0 with CvsGraph 1.7.0