/[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 - (hide annotations)
Sun Aug 15 16:58:22 2004 UTC (13 years, 3 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 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.16 # %l = htmlized logentry of the revision
36 bertho 1.19 # NOTE: %l is obsolete. See %(%) and cvsgraph.conf(5) for
37     # more details.
38 bertho 1.16 # %L = logentry of revision
39 bertho 1.19 # 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 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     # - 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 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     # CSV/RCS repository can be found
87     # 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     # Make color_bg the transparent color (only usefull 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     # or right to left is upside_down is set simulatiously.
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     # 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 bertho 1.24 # 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 bertho 1.4 tag_font = medium;
166 bertho 1.14 tag_ttfont = "/dos/windows/fonts/ariali.ttf";
167     tag_ttsize = 11.0;
168 bertho 1.6 tag_color = "#007000";
169 bertho 1.23 #tag_ignore = "(test|alpha)_release";
170     #tag_nocase = false;
171 bertho 1.24 #tag_negate = false;
172 bertho 1.1
173 bertho 1.4 rev_font = giant;
174 bertho 1.14 rev_ttfont = "/dos/windows/fonts/arial.ttf";
175     rev_ttsize = 12.0;
176 bertho 1.1 rev_color = "#000000";
177 bertho 1.6 rev_bgcolor = "#f0f0f0";
178 bertho 1.1 rev_separator = 1;
179     rev_minline = 15;
180 bertho 1.14 rev_maxline = 75;
181 bertho 1.1 rev_lspace = 5;
182     rev_rspace = 5;
183     rev_tspace = 3;
184     rev_bspace = 3;
185 bertho 1.14 rev_text = "%d"; # or "%d\n%a, %s" for author and state too
186 bertho 1.6 rev_text_font = tiny;
187 bertho 1.14 rev_text_ttfont = "/dos/windows/fonts/times.ttf";
188     rev_text_ttsize = 9.0;
189 bertho 1.6 rev_text_color = "#500020";
190 bertho 1.18 rev_maxtags = 25;
191 bertho 1.1
192 bertho 1.19 # 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 bertho 1.22 # 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 bertho 1.19 #
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 bertho 1.22
236     #merge_arrows = true;
237     #arrow_width = 3;
238     #arrow_length = 12;
239    
240 bertho 1.19
241 bertho 1.4 # 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 bertho 1.12 # branch_dupbox <boolean>
252 bertho 1.11 # Add the branch-tag also at the bottom/top of the trunk
253 bertho 1.20 # branch_fold <boolean>
254     # Fold empty branches in one box to save space
255 bertho 1.21 # branch_foldall <boolean>
256     # Put all empty branches in one box, even if they
257     # were interspaced with branches with revisions.
258 bertho 1.25 # 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 bertho 1.4 branch_font = medium;
264 bertho 1.14 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 bertho 1.1 branch_color = "#0000c0";
271 bertho 1.6 branch_bgcolor = "#ffffc0";
272 bertho 1.1 branch_lspace = 5;
273     branch_rspace = 5;
274     branch_tspace = 3;
275     branch_bspace = 3;
276 bertho 1.4 branch_margin = 15;
277     branch_connect = 8;
278 bertho 1.12 branch_dupbox = false;
279 bertho 1.20 branch_fold = true;
280 bertho 1.21 branch_foldall = false;
281 bertho 1.25 #branch_subtree = "1.2.4";
282 bertho 1.1
283     # title <string>
284 bertho 1.5 # The title string is expanded (see above for details)
285 bertho 1.1 # 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 bertho 1.4 # title_color <color>
294 bertho 1.6 title = "%c%m%f\nRevisions: %r, Branches: %b";
295 bertho 1.1 title_x = 10;
296     title_y = 5;
297 bertho 1.6 title_font = small;
298 bertho 1.14 title_ttfont = "/dos/windows/fonts/times.ttf";
299     title_ttsize = 10.0;
300 bertho 1.4 title_align = left;
301 bertho 1.1 title_color = "#800000";
302    
303     # Margins of the image
304     # Note: the title is outside the margin
305 bertho 1.6 margin_top = 35;
306 bertho 1.1 margin_bottom = 10;
307     margin_left = 10;
308     margin_right = 10;
309    
310 bertho 1.2 # 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 bertho 1.6 image_type = png;
322 bertho 1.2 image_quality = 75;
323    
324 bertho 1.3 # HTML ImageMap generation
325 bertho 1.5 # map_name <string>
326 bertho 1.7 # The name= attribute in <map name="mapname">...</map>
327 bertho 1.5 # map_branch_href <string>
328     # map_branch_alt <string>
329     # map_rev_href <string>
330     # map_rev_alt <string>
331 bertho 1.6 # map_diff_href <string>
332     # map_diff_alt <string>
333 bertho 1.25 # map_merge_href <string>
334     # map_merge_alt <string>
335 bertho 1.5 # These are the href= and alt= attributes in the <area>
336     # tags of html. The strings are expanded (see above).
337 bertho 1.3 map_name = "MyMapName";
338 bertho 1.19 map_branch_href = "href=\"%9cvsweb_graph.cgi/%m%p?only_with_tag=%(%t%)%8\"";
339     map_branch_alt = "alt=\"%0 %(%t%) (%B)\"";
340 bertho 1.10 map_rev_href = "href=\"%9cvsweb_graph.cgi/%m%p%F?rev=%R&content-type=text/x-cvsweb-markup%8\"";
341 bertho 1.19 map_rev_alt = "alt=\"%1 %(%t%) (%R)\"";
342 bertho 1.10 map_diff_href = "href=\"%9cvsweb_graph.cgi/%m%p%F.diff?r1=%P&r2=%R%8\"";
343 bertho 1.8 map_diff_alt = "alt=\"%2 %P &lt;-&gt; %R\"";
344 bertho 1.25 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 bertho 1.3

  ViewVC Help
Powered by ViewVC 1.1.0 with CvsGraph 1.7.0