/[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.20 - (hide annotations)
Fri Mar 14 01:38:39 2003 UTC (14 years, 9 months ago) by bertho
Branch: MAIN
Changes since 1.19: +3 -0 lines
- Fixed a bug in the initial placing of left to right displaying.
- Half-fixed a bug in the kerning code, where a loop-safeguard was triggered
  way too soon (at 100 iterations). This has now been changed to 10000, but
  should be dependent on the number of drawable branches, as the function is
  _at least_ order O(N^2). However, more analysis is required to ensure
  safe guarding under all circumstances.
- Implemented folding of empty branches. Many uses of CVS create many
  branches on the same revision but have no commits on them. This occurs
  often with stable files like .cvsignore files and the like. A new
  configuration option branch_fold enables imaging consequtive brances
  with no commits in the same branch-box. This reduces images by a huge
  factor (28000x1700 -> 2100x2300, i.e. a factor of 10). It also speeds up
  drawing considerably. The branch_fold option is *on* by default.
- Fix duplicate branch-boxes (branch_dupbox=true). No duplicates should be
  created if there are no commits on a specific branch. There is no reason
  for having two boxes on top of each other.
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     # parse_logs <boolean>
133     # Enable the parsing of the *entire* ,v file to read the
134     # log-entries between revisions. This is necessary for
135 bertho 1.19 # the %L expansion to work, but slows down parsing by
136 bertho 1.16 # a very large factor. You're warned.
137     parse_logs = false;
138 bertho 1.6
139 bertho 1.4 tag_font = medium;
140 bertho 1.14 tag_ttfont = "/dos/windows/fonts/ariali.ttf";
141     tag_ttsize = 11.0;
142 bertho 1.6 tag_color = "#007000";
143 bertho 1.1
144 bertho 1.4 rev_font = giant;
145 bertho 1.14 rev_ttfont = "/dos/windows/fonts/arial.ttf";
146     rev_ttsize = 12.0;
147 bertho 1.1 rev_color = "#000000";
148 bertho 1.6 rev_bgcolor = "#f0f0f0";
149 bertho 1.1 rev_separator = 1;
150     rev_minline = 15;
151 bertho 1.14 rev_maxline = 75;
152 bertho 1.1 rev_lspace = 5;
153     rev_rspace = 5;
154     rev_tspace = 3;
155     rev_bspace = 3;
156 bertho 1.14 rev_text = "%d"; # or "%d\n%a, %s" for author and state too
157 bertho 1.6 rev_text_font = tiny;
158 bertho 1.14 rev_text_ttfont = "/dos/windows/fonts/times.ttf";
159     rev_text_ttsize = 9.0;
160 bertho 1.6 rev_text_color = "#500020";
161 bertho 1.18 rev_maxtags = 25;
162 bertho 1.1
163 bertho 1.19 # merge_color <color>
164     # The color of the line connecting merges
165     # merge_front <boolean>
166     # If true, draw the merge-lines on top if the image
167     # merge_nocase <boolean>
168     # Ignore case in regular expressions
169     # merge_from <string>
170     # A regex describing a tag that is used as the merge source
171     # merge_to <string>
172     # A regex describing a tag that is the target of the merge
173     #
174     # NOTE:
175     # - The merge_from is an extended regular expression as described in
176     # regex(7) and POSIX 1003.2 (see also Single Unix Specification at
177     # http://www.opengroup.com).
178     # - The merge_to is an extended regular expression with a twist. All
179     # subexpressions from the merge_from are expanded into merge_to
180     # using %[1-9] (in contrast to \[1-9] for backreferences). Care is
181     # taken to escape the constructed expression.
182     # - A '$' at the end of the merge_to expression can be important to
183     # prevent 'near match' references. Normally, you want the destination
184     # to be a good representation of the source. However, this depends
185     # on how well you defined the tags in the first place.
186     #
187     # Example:
188     # merge_from = "^f_(.*)";
189     # merge_to = "^t_%1$";
190     # tags: f_foo, f_bar, f_foobar, t_foo, t_bar
191     # result:
192     # f_foo -> "^t_foo$" -> t_foo
193     # f_bar -> "^t_bar$" -> t_bar
194     # f_foobar-> "^t_foobar$" -> <no match>
195     #
196     merge_color = "#a000a0";
197     merge_front = false;
198     merge_nocase = false;
199     merge_from = "^f_(.*)";
200     merge_to = "^t_%1$";
201    
202 bertho 1.4 # branch_font <number>
203     # The font of the number and tags
204     # branch_color <color>
205     # All branch element's color
206     # branch_[lrtb]space <number>
207     # Interior spacing (margin)
208     # branch_margin <number>
209     # Exterior spacing
210     # branch_connect <number>
211     # Length of the vertical connector
212 bertho 1.12 # branch_dupbox <boolean>
213 bertho 1.11 # Add the branch-tag also at the bottom/top of the trunk
214 bertho 1.20 # branch_fold <boolean>
215     # Fold empty branches in one box to save space
216 bertho 1.4 branch_font = medium;
217 bertho 1.14 branch_ttfont = "/dos/windows/fonts/arialbd.ttf";
218     branch_ttsize = 18.0;
219     branch_tag_color= "#000080";
220     branch_tag_font = medium;
221     branch_tag_ttfont = "/dos/windows/fonts/arialbi.ttf";
222     branch_tag_ttsize = 14.0;
223 bertho 1.1 branch_color = "#0000c0";
224 bertho 1.6 branch_bgcolor = "#ffffc0";
225 bertho 1.1 branch_lspace = 5;
226     branch_rspace = 5;
227     branch_tspace = 3;
228     branch_bspace = 3;
229 bertho 1.4 branch_margin = 15;
230     branch_connect = 8;
231 bertho 1.12 branch_dupbox = false;
232 bertho 1.20 branch_fold = true;
233 bertho 1.1
234     # title <string>
235 bertho 1.5 # The title string is expanded (see above for details)
236 bertho 1.1 # title_[xy] <number>
237     # Postion of title
238     # title_font <number>
239     # The font
240     # title_align <number>
241     # 0 = left
242     # 1 = center
243     # 2 = right
244 bertho 1.4 # title_color <color>
245 bertho 1.6 title = "%c%m%f\nRevisions: %r, Branches: %b";
246 bertho 1.1 title_x = 10;
247     title_y = 5;
248 bertho 1.6 title_font = small;
249 bertho 1.14 title_ttfont = "/dos/windows/fonts/times.ttf";
250     title_ttsize = 10.0;
251 bertho 1.4 title_align = left;
252 bertho 1.1 title_color = "#800000";
253    
254     # Margins of the image
255     # Note: the title is outside the margin
256 bertho 1.6 margin_top = 35;
257 bertho 1.1 margin_bottom = 10;
258     margin_left = 10;
259     margin_right = 10;
260    
261 bertho 1.2 # Image format(s)
262     # image_type <number|{gif,jpeg,png}>
263     # gif (0) = Create gif image
264     # png (1) = Create png image
265     # jpeg (2) = Create jpeg image
266     # Image types are available if they can be found in
267     # the gd library. Newer versions of gd do not have
268     # gif anymore. CvsGraph will automatically generate
269     # png images instead.
270     # image_quality <number>
271     # The quality of a jpeg image (1..100)
272 bertho 1.6 image_type = png;
273 bertho 1.2 image_quality = 75;
274    
275 bertho 1.3 # HTML ImageMap generation
276 bertho 1.5 # map_name <string>
277 bertho 1.7 # The name= attribute in <map name="mapname">...</map>
278 bertho 1.5 # map_branch_href <string>
279     # map_branch_alt <string>
280     # map_rev_href <string>
281     # map_rev_alt <string>
282 bertho 1.6 # map_diff_href <string>
283     # map_diff_alt <string>
284 bertho 1.5 # These are the href= and alt= attributes in the <area>
285     # tags of html. The strings are expanded (see above).
286 bertho 1.3 map_name = "MyMapName";
287 bertho 1.19 map_branch_href = "href=\"%9cvsweb_graph.cgi/%m%p?only_with_tag=%(%t%)%8\"";
288     map_branch_alt = "alt=\"%0 %(%t%) (%B)\"";
289 bertho 1.10 map_rev_href = "href=\"%9cvsweb_graph.cgi/%m%p%F?rev=%R&content-type=text/x-cvsweb-markup%8\"";
290 bertho 1.19 map_rev_alt = "alt=\"%1 %(%t%) (%R)\"";
291 bertho 1.10 map_diff_href = "href=\"%9cvsweb_graph.cgi/%m%p%F.diff?r1=%P&r2=%R%8\"";
292 bertho 1.8 map_diff_alt = "alt=\"%2 %P &lt;-&gt; %R\"";
293 bertho 1.3

  ViewVC Help
Powered by ViewVC 1.1.0 with CvsGraph 1.7.0