/[CvsGraph]/cvsgraph/cvsgraph.conf
ViewVC logotype

Diff of /cvsgraph/cvsgraph.conf

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph | View Patch Patch

revision 1.1, Tue Feb 20 12:07:03 2001 UTC revision 1.27, Sun Aug 29 12:20:03 2004 UTC
# Line 1  Line 1 
1  # CvsGraph configuration  # CvsGraph configuration
2  #  #
3  # - Empty lines are ignored.  # - Empty lines and whitespace are ignored.
4    #
5  # - Comments start with '#' and everything until  # - Comments start with '#' and everything until
6  #   end of line is ignored.  #   end of line is ignored.
7    #
8  # - Strings are C-style strings in which characters  # - Strings are C-style strings in which characters
9  #   may be escaped with '\' and written in octal  #   may be escaped with '\' and written in octal
10  #   and hex escapes. Note that '\' must be escaped  #   and hex escapes. Note that '\' must be escaped
11  #   if it is to be entered as a character.  #   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  # - Numbers may be entered as octal, decimal or
44  #   hex as in 0127, 792 and 0x4f respectively.  #   hex as in 0117, 79 and 0x4f respectively.
45    #
46  # - Fonts are numbered 0..4 (defined as in libgd)  # - Fonts are numbered 0..4 (defined as in libgd)
47  #       0 = Tiny  #       0 = tiny
48  #       1 = Small  #       1 = small
49  #       2 = Medium bold  #       2 = medium (bold)
50  #       3 = Large  #       3 = large
51  #       4 = Giant  #       4 = giant
52  #  #
53  # - Colors are a string like html-type colors in  # - Colors are a string like html-type colors in
54  #   the form "#rrggbb" with parts written in hex  #   the form "#rrggbb" with parts written in hex
# Line 22  Line 56 
56  #       gg = green (00-ff)  #       gg = green (00-ff)
57  #       bb = blue (00-ff)  #       bb = blue (00-ff)
58  #  #
59    # - There are several reserved words besides of the
60  # cmd_rlog <string>  #   feature-keywords. These additional reserved words
61  #       The *absolute* path of the rlog command  #   expand to numerical values:
62  cmd_rlog        = "/usr/bin/rlog";  #       * 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>  # cvsroot <string>
85  #       The *absolute* base directory where the  #       The *absolute* base directory where the
# Line 35  Line 89 
89  cvsroot         = "/home/bertho/tmp/cvstest";  cvsroot         = "/home/bertho/tmp/cvstest";
90  cvsmodule       = "ttt";  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";  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  tag_font        = 2;  # parse_logs <boolean>
144  tag_color       = "#008000";  #       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  rev_font        = 4;  # 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 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    # tag_nocase <boolean>
165    #       Ignore the case is tag_ignore expressions
166    # tag_negate <boolean>
167    #       Negate the matching criteria of tag_ignore. When true, only matching
168    #       tags will be shown.
169    #       Note: tags matched with merge_from/merge_to will still be displayed.
170    tag_font        = medium;
171    tag_ttfont      = "/dos/windows/fonts/ariali.ttf";
172    tag_ttsize      = 11.0;
173    tag_color       = "#007000";
174    #tag_ignore     = "(test|alpha)_release";
175    #tag_ignore_merge = false;
176    #tag_nocase     = false;
177    #tag_negate     = false;
178    
179    # rev_hidenumber <boolean>
180    #       If set to true no revision numbers will be printed in the graph.
181    #rev_hidenumber = false;
182    rev_font        = giant;
183    rev_ttfont      = "/dos/windows/fonts/arial.ttf";
184    rev_ttsize      = 12.0;
185  rev_color       = "#000000";  rev_color       = "#000000";
186    rev_bgcolor     = "#f0f0f0";
187  rev_separator   = 1;  rev_separator   = 1;
188  rev_minline     = 15;  rev_minline     = 15;
189  rev_maxline     = 30;  rev_maxline     = 75;
190  rev_lspace      = 5;  rev_lspace      = 5;
191  rev_rspace      = 5;  rev_rspace      = 5;
192  rev_tspace      = 3;  rev_tspace      = 3;
193  rev_bspace      = 3;  rev_bspace      = 3;
194    rev_text        = "%d"; # or "%d\n%a, %s" for author and state too
195    rev_text_font   = tiny;
196    rev_text_ttfont = "/dos/windows/fonts/times.ttf";
197    rev_text_ttsize = 9.0;
198    rev_text_color  = "#500020";
199    rev_maxtags     = 25;
200    
201    # 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    # merge_findall <boolean>
212    #       Try to match all merge_to targets possible. This can result in
213    #       multiple lines originating from one tag.
214    # 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    #
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    merge_findall   = false;
248    
249    #merge_arrows   = true;
250    #arrow_width    = 3;
251    #arrow_length   = 12;
252    
253    
254  branch_font     = 2;  # 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    # branch_dupbox <boolean>
265    #       Add the branch-tag also at the bottom/top of the trunk
266    # branch_fold <boolean>
267    #       Fold empty branches in one box to save space
268    # branch_foldall <boolean>
269    #       Put all empty branches in one box, even if they
270    #       were interspaced with branches with revisions.
271    # branch_resort <boolean>
272    #       Resort the branches by the number of revisions to save space
273    # 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    #       commandline with the -O option.
278    branch_font     = medium;
279    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  branch_color    = "#0000c0";  branch_color    = "#0000c0";
286  branch_bgcolor  = "#ffffff";  branch_bgcolor  = "#ffffc0";
287  branch_lspace   = 5;  branch_lspace   = 5;
288  branch_rspace   = 5;  branch_rspace   = 5;
289  branch_tspace   = 3;  branch_tspace   = 3;
290  branch_bspace   = 3;  branch_bspace   = 3;
291    branch_margin   = 15;
292    branch_connect  = 8;
293    branch_dupbox   = false;
294    branch_fold     = true;
295    branch_foldall  = false;
296    branch_resort   = false;
297    #branch_subtree = "1.2.4";
298    
299  # title <string>  # title <string>
300  #       %c = cvsroot  #       The title string is expanded (see above for details)
 #       %m = module  
 #       %f = filename  
 #       %r = number of revisions  
 #       %b = number of branches  
 #       %% = '%'  
301  # title_[xy] <number>  # title_[xy] <number>
302  #       Postion of title  #       Postion of title
303  # title_font <number>  # title_font <number>
# Line 74  Line 306 
306  #       0 = left  #       0 = left
307  #       1 = center  #       1 = center
308  #       2 = right  #       2 = right
309  title           = "%c/%m/%f\nRevisions: %r, Branches: %b";  # title_color <color>
310    title           = "%c%m%f\nRevisions: %r, Branches: %b";
311  title_x         = 10;  title_x         = 10;
312  title_y         = 5;  title_y         = 5;
313  title_font      = 0;  title_font      = small;
314  title_align     = 0;  title_ttfont    = "/dos/windows/fonts/times.ttf";
315    title_ttsize    = 10.0;
316    title_align     = left;
317  title_color     = "#800000";  title_color     = "#800000";
318    
319  # Margins of the image  # Margins of the image
320  # Note: the title is outside the margin  # Note: the title is outside the margin
321  margin_top      = 25;  margin_top      = 35;
322  margin_bottom   = 10;  margin_bottom   = 10;
323  margin_left     = 10;  margin_left     = 10;
324  margin_right    = 10;  margin_right    = 10;
325    
326  #width_rev      = 3;  # Image format(s)
327  #width_tag      = 1;  # 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    image_type      = png;
338    image_quality   = 75;
339    
340    # HTML ImageMap generation
341    # map_name <string>
342    #       The name= attribute in <map name="mapname">...</map>
343    # map_branch_href <string>
344    # map_branch_alt <string>
345    # map_rev_href <string>
346    # map_rev_alt <string>
347    # map_diff_href <string>
348    # map_diff_alt <string>
349    # map_merge_href <string>
350    # map_merge_alt <string>
351    #       These are the href= and alt= attributes in the <area>
352    #       tags of html. The strings are expanded (see above).
353    map_name        = "MyMapName";
354    map_branch_href = "href=\"%9cvsweb_graph.cgi/%m%p?only_with_tag=%(%t%)%8\"";
355    map_branch_alt  = "alt=\"%0 %(%t%) (%B)\"";
356    map_rev_href    = "href=\"%9cvsweb_graph.cgi/%m%p%F?rev=%R&content-type=text/x-cvsweb-markup%8\"";
357    map_rev_alt     = "alt=\"%1 %(%t%) (%R)\"";
358    map_diff_href   = "href=\"%9cvsweb_graph.cgi/%m%p%F.diff?r1=%P&r2=%R%8\"";
359    map_diff_alt    = "alt=\"%2 %P &lt;-&gt; %R\"";
360    map_merge_href  = "href=\"%9cvsweb_graph.cgi/%m%p%F.diff?r1=%P&r2=%R%8\"";
361    map_merge_alt   = "alt=\"%2 %P &lt;-&gt; %R\"";
362    

Legend:
Removed from v.1.1  
changed lines
  Added in v.1.27

  ViewVC Help
Powered by ViewVC 1.1.0 with CvsGraph 1.7.0