/[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.25 - (show annotations)
Sun Aug 15 16:58:22 2004 UTC (13 years, 2 months ago) by bertho
Branch: MAIN
CVS Tags: REL_1_5_0
Changes since 1.24: +21 -0 lines
- Added drawing of partial trees. You now can select a subtree based on a
  revision number, branch number or symbolic tag to show only that part of the
  tree. New config option branch_subtree selects which part is shown. If the
  subtree is empty, then the whole tree is shown.

- Most error and warning messages are now displayed in the graph, instead of
  being written to stderr. This enables you to see an image eventhough errors
  might be present. The old method would generate a corrupt image.
  New configuration options include msg_color and msg_font to control the looks
  of it. Messages are always printed at the bottom of the image.

- Fixed a bug in the folding code where subtrees would not fold correctly.

- Added diff links in the map-generation for detected merges so that you can
  get the differences in merge-operations. The options map_merge_href and
  map_merge_alt must be set accordingly.
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 logentry of the revision
36 # NOTE: %l is obsolete. See %(%) and cvsgraph.conf(5) for
37 # more details.
38 # %L = logentry of revision
39 # The logentry expansion take an optional argument to
40 # specify max length of the expansion like %L[25].
41 # %(...%) = HTMLize the string withing 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 # - 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 # * not = -1
65 # * 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 #
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
84 # cvsroot <string>
85 # The *absolute* base directory where the
86 # CSV/RCS repository can be found
87 # cvsmodule <string>
88 #
89 cvsroot = "/home/bertho/tmp/cvstest";
90 cvsmodule = "ttt";
91
92 # color_bg <color>
93 # The background color of the image
94 # transparent_bg <boolean>
95 # Make color_bg the transparent color (only usefull with PNG)
96 color_bg = "#ffffff";
97 transparent_bg = false;
98
99 # date_format <string>
100 # The strftime(3) format string for date and time
101 date_format = "%d-%b-%Y %H:%M:%S";
102
103 # box_shadow <boolean>
104 # Add a shadow around the boxes
105 # upside_down <boolean>
106 # Reverse the order of the revisions
107 # left_right <boolean>
108 # Draw the image left to right instead of top down,
109 # or right to left is upside_down is set simulatiously.
110 # strip_untagged <boolean>
111 # Remove all untagged revisions except the first, last and tagged ones
112 # strip_first_rev <boolean>
113 # Also remove the first revision if untagged
114 # auto_stretch <boolean>
115 # Try to reformat the tree to minimize image size
116 # 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 box_shadow = true;
123 upside_down = false;
124 left_right = false;
125 strip_untagged = false;
126 strip_first_rev = false;
127 #auto_stretch = true; # not yet stable.
128 use_ttf = false;
129 anti_alias = true;
130 thick_lines = 1;
131
132 # 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 # 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 # the %L expansion to work, but slows down parsing by
147 # a very large factor. You're warned.
148 parse_logs = false;
149
150 # 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 # Note 1: tags matched in merge_from/merge_to are always displayed.
158 # Note 2: normal string rules apply and special characters must be escaped.
159 # tag_nocase <boolean>
160 # Ignore the case is tag_ignore expressions
161 # tag_negate <boolean>
162 # Negate the matching criteria of tag_ignore. When true, only matching tags
163 # will be shown.
164 # Note: tags matched with merge_from/merge_to will still be displayed.
165 tag_font = medium;
166 tag_ttfont = "/dos/windows/fonts/ariali.ttf";
167 tag_ttsize = 11.0;
168 tag_color = "#007000";
169 #tag_ignore = "(test|alpha)_release";
170 #tag_nocase = false;
171 #tag_negate = false;
172
173 rev_font = giant;
174 rev_ttfont = "/dos/windows/fonts/arial.ttf";
175 rev_ttsize = 12.0;
176 rev_color = "#000000";
177 rev_bgcolor = "#f0f0f0";
178 rev_separator = 1;
179 rev_minline = 15;
180 rev_maxline = 75;
181 rev_lspace = 5;
182 rev_rspace = 5;
183 rev_tspace = 3;
184 rev_bspace = 3;
185 rev_text = "%d"; # or "%d\n%a, %s" for author and state too
186 rev_text_font = tiny;
187 rev_text_ttfont = "/dos/windows/fonts/times.ttf";
188 rev_text_ttsize = 9.0;
189 rev_text_color = "#500020";
190 rev_maxtags = 25;
191
192 # merge_color <color>
193 # The color of the line connecting merges
194 # merge_front <boolean>
195 # If true, draw the merge-lines on top if the image
196 # merge_nocase <boolean>
197 # Ignore case in regular expressions
198 # merge_from <string>
199 # A regex describing a tag that is used as the merge source
200 # merge_to <string>
201 # A regex describing a tag that is the target of the merge
202 # merge_arrows <boolean>
203 # Use arrows to point to the merge destination. Default is true.
204 # arrow_width <number>
205 # arrow_length <number>
206 # Specify the size of the arrows. Default is 3 wide and 12 long.
207 #
208 # NOTE:
209 # - The merge_from is an extended regular expression as described in
210 # regex(7) and POSIX 1003.2 (see also Single Unix Specification at
211 # http://www.opengroup.com).
212 # - The merge_to is an extended regular expression with a twist. All
213 # subexpressions from the merge_from are expanded into merge_to
214 # using %[1-9] (in contrast to \[1-9] for backreferences). Care is
215 # taken to escape the constructed expression.
216 # - A '$' at the end of the merge_to expression can be important to
217 # prevent 'near match' references. Normally, you want the destination
218 # to be a good representation of the source. However, this depends
219 # on how well you defined the tags in the first place.
220 #
221 # Example:
222 # merge_from = "^f_(.*)";
223 # merge_to = "^t_%1$";
224 # tags: f_foo, f_bar, f_foobar, t_foo, t_bar
225 # result:
226 # f_foo -> "^t_foo$" -> t_foo
227 # f_bar -> "^t_bar$" -> t_bar
228 # f_foobar-> "^t_foobar$" -> <no match>
229 #
230 merge_color = "#a000a0";
231 merge_front = false;
232 merge_nocase = false;
233 merge_from = "^f_(.*)";
234 merge_to = "^t_%1$";
235
236 #merge_arrows = true;
237 #arrow_width = 3;
238 #arrow_length = 12;
239
240
241 # branch_font <number>
242 # The font of the number and tags
243 # branch_color <color>
244 # All branch element's color
245 # branch_[lrtb]space <number>
246 # Interior spacing (margin)
247 # branch_margin <number>
248 # Exterior spacing
249 # branch_connect <number>
250 # Length of the vertical connector
251 # branch_dupbox <boolean>
252 # Add the branch-tag also at the bottom/top of the trunk
253 # branch_fold <boolean>
254 # Fold empty branches in one box to save space
255 # branch_foldall <boolean>
256 # Put all empty branches in one box, even if they
257 # were interspaced with branches with revisions.
258 # branch_subtree <string>
259 # Only show the branch denoted or all branches that sprout
260 # from the denoted revision. The argument may be a symbolic
261 # tag. This option you would normally want to set from the
262 # commandline with the -O option.
263 branch_font = medium;
264 branch_ttfont = "/dos/windows/fonts/arialbd.ttf";
265 branch_ttsize = 18.0;
266 branch_tag_color= "#000080";
267 branch_tag_font = medium;
268 branch_tag_ttfont = "/dos/windows/fonts/arialbi.ttf";
269 branch_tag_ttsize = 14.0;
270 branch_color = "#0000c0";
271 branch_bgcolor = "#ffffc0";
272 branch_lspace = 5;
273 branch_rspace = 5;
274 branch_tspace = 3;
275 branch_bspace = 3;
276 branch_margin = 15;
277 branch_connect = 8;
278 branch_dupbox = false;
279 branch_fold = true;
280 branch_foldall = false;
281 #branch_subtree = "1.2.4";
282
283 # title <string>
284 # The title string is expanded (see above for details)
285 # title_[xy] <number>
286 # Postion of title
287 # title_font <number>
288 # The font
289 # title_align <number>
290 # 0 = left
291 # 1 = center
292 # 2 = right
293 # title_color <color>
294 title = "%c%m%f\nRevisions: %r, Branches: %b";
295 title_x = 10;
296 title_y = 5;
297 title_font = small;
298 title_ttfont = "/dos/windows/fonts/times.ttf";
299 title_ttsize = 10.0;
300 title_align = left;
301 title_color = "#800000";
302
303 # Margins of the image
304 # Note: the title is outside the margin
305 margin_top = 35;
306 margin_bottom = 10;
307 margin_left = 10;
308 margin_right = 10;
309
310 # Image format(s)
311 # image_type <number|{gif,jpeg,png}>
312 # gif (0) = Create gif image
313 # png (1) = Create png image
314 # jpeg (2) = Create jpeg image
315 # Image types are available if they can be found in
316 # the gd library. Newer versions of gd do not have
317 # gif anymore. CvsGraph will automatically generate
318 # png images instead.
319 # image_quality <number>
320 # The quality of a jpeg image (1..100)
321 image_type = png;
322 image_quality = 75;
323
324 # HTML ImageMap generation
325 # map_name <string>
326 # The name= attribute in <map name="mapname">...</map>
327 # map_branch_href <string>
328 # map_branch_alt <string>
329 # map_rev_href <string>
330 # map_rev_alt <string>
331 # map_diff_href <string>
332 # map_diff_alt <string>
333 # map_merge_href <string>
334 # map_merge_alt <string>
335 # These are the href= and alt= attributes in the <area>
336 # tags of html. The strings are expanded (see above).
337 map_name = "MyMapName";
338 map_branch_href = "href=\"%9cvsweb_graph.cgi/%m%p?only_with_tag=%(%t%)%8\"";
339 map_branch_alt = "alt=\"%0 %(%t%) (%B)\"";
340 map_rev_href = "href=\"%9cvsweb_graph.cgi/%m%p%F?rev=%R&content-type=text/x-cvsweb-markup%8\"";
341 map_rev_alt = "alt=\"%1 %(%t%) (%R)\"";
342 map_diff_href = "href=\"%9cvsweb_graph.cgi/%m%p%F.diff?r1=%P&r2=%R%8\"";
343 map_diff_alt = "alt=\"%2 %P &lt;-&gt; %R\"";
344 map_merge_href = "href=\"%9cvsweb_graph.cgi/%m%p%F.diff?r1=%P&r2=%R%8\"";
345 map_merge_alt = "alt=\"%2 %P &lt;-&gt; %R\"";
346

  ViewVC Help
Powered by ViewVC 1.1.0 with CvsGraph 1.7.0