3 # SCM roots are handled by GForge -- don't put the configuration here
4 # docroot variable is set by the "viewcvs" wrapper, and it points to (url of current theme)/viewvc
5 #address = <a href="mailto:cvs-admin@insert.your.domain.here">No admin address has been configured</a>
12 #---------------------------------------------------------------------------
16 # root_as_url_component: Interpret the first path component in the URL
17 # after the script location as the root to use. This is an
18 # alternative to using the "root=" query key. If ViewVC is configured
19 # with multiple repositories, this results in more natural looking
20 # ViewVC URLs and allows you to browse checked out HTML files with
21 # relative links to other repository files within ViewVC.
22 # Note: Enabling this option will break backwards compatibility with
23 # any old ViewVC URL which doesn't have an explicit "root" parameter.
24 root_as_url_component = 0
26 # checkout_magic: Generate checkout links with a magic *checkout* prefix.
27 # This option is enabled for backwards compatibility with URLs used by old
28 # versions of ViewVC. If you disable it, old *checkout* URLs will continue
29 # to work, but old log page urls which don't have explicit "view=log"
30 # parameters will load checkout pages instead. It is recommended that you
31 # disable this option in a fresh viewvc installation, or if you don't need
32 # to support old-style log URLs.
35 # http_expiration_time: Expiration time (in seconds) for cacheable
36 # pages served by ViewVC. Note that in most cases, a cache aware
37 # client will only revalidate the page after it expires (using the
38 # If-Modified-Since and/or If-None-Match headers) and that browsers
39 # will also revalidate the page when the reload button is pressed.
40 # Set to 0 to disable the transmission of these caching headers.
41 http_expiration_time = 600
43 # generate_etags: Generate Etag headers for relevant pages to assist
46 # 0 Don't generate Etags
49 # sort_by: File sort order
50 # file Sort by filename
51 # rev Sort by revision number
52 # date Sort by commit date
53 # author Sort by author
54 # log Sort by log message
57 # sort_group_dirs: Group directories when sorting
58 # 1 Group directories together
59 # 0 No grouping -- sort directories as any other item would be sorted
62 # hide_attic: Hide or show the contents of the Attic subdirectory
63 # 1 Hide dead files inside Attic subdir
64 # 0 Show the files which are inside the Attic subdir
67 # log_sort: Sort order for log messages
68 # date Sort revisions by date
69 # rev Sort revision by revision number
70 # cvs Don't sort them. Same order as CVS/RCS shows them.
73 # diff_format: Default diff format
78 # l Long human readable (more context)
81 # hide_cvsroot: Don't show the CVSROOT directory
82 # 1 Hide CVSROOT directory
83 # 0 Show CVSROOT directory
86 # set to 1 to make lines break at spaces,
87 # set to 0 to make no-break lines,
88 # set to a positive integer to make the lines cut at that length
91 # give out function names in human readable diffs
92 # this just makes sense if we have C-files, otherwise
93 # diff's heuristic doesn't work well ..
94 # ( '-p' option to diff)
97 # ignore whitespaces for human readable diffs
98 # (indendation and stuff ..)
99 # ( '-w' option to diff)
102 # ignore diffs which are caused by
103 # keyword-substitution like $Id - Stuff
104 # ( '-kk' option to rcsdiff)
105 hr_ignore_keyword_subst = 1
107 # allow annotation of files.
110 # allow pretty-printed version of files
113 # allow compression with gzip of output if the Browser accepts it
114 # (HTTP_ACCEPT_ENCODING=gzip)
115 # [make sure to have gzip in the path]
118 # The directory which contains the EZT templates used by ViewVC to
119 # customize the display of the various output views. ViewVC looks in
120 # this directory for files with names that match the name of the view
121 # ("log", "directory", etc.) plus the ".ezt" extension. If specified
122 # as a relative path, it is relative to the ViewVC installation
123 # directory; absolute paths may be used as well.
125 # If %lang% occurs in the pathname, then the selected language will be
128 template_dir = templates
130 # Web path to a directory that contains ViewVC static files
131 # (stylesheets, images, etc.) If set, static files will get
132 # downloaded directory from this location. If unset, static files
133 # will be served by the ViewVC script (at a likely performance
134 # penalty, and from the "docroot" subdirectory of the directory
135 # specified by the "template_dir" option).
136 #docroot = /scm/viewvc/templates/docroot
138 # Show last changelog message for sub directories
139 # The current implementation makes many assumptions and may show the
140 # incorrect file at some times. The main assumption is that the last
141 # modified file has the newest filedate. But some CVS operations
142 # touches the file without even when a new version is not checked in,
143 # and TAG based browsing essentially puts this out of order, unless
144 # the last checkin was on the same tag as you are viewing.
145 # Enable this if you like the feature, but don't rely on correct results.
146 show_subdir_lastmod = 0
148 # show a portion of the most recent log entry in directory listings
151 # Show log when viewing file contents
152 show_log_in_markup = 1
154 # Cross filesystem copies when traversing Subversion file revision histories.
157 # Display dates as UTC or in local time zone
161 # == Configuration defaults ==
162 # Defaults for configuration variables that shouldn't need
166 # If you want to use Marc-Andrew Lemburg's py2html (and Just van Rossum's
167 # PyFontify) to colorize Python files, then you may need to change this
168 # variable to point to their directory location.
170 # This directory AND the standard Python path will be searched.
173 #py2html_path = /usr/local/lib/python1.5/site-python
175 # the length to which the most recent log entry should be truncated when
176 # shown in the directory view
179 # should we use 'enscript' for syntax coloring?
183 # if the enscript program is not on the path, set this value
186 # enscript_path = /usr/bin/
188 # should we use 'highlight' for syntax coloring?
189 # NOTE: use_enscript has to be 0 or escript will be used instead
193 # if the highlight program is not on the path, set this value
195 # highlight_path = /usr/bin
197 # what coloring style should highlight use?
198 highlight_style = emacs
200 # should we add line numbers?
201 highlight_line_numbers = 1
203 # convert tabs to ## spaces (use 0 for no conversion)
204 highlight_convert_tabs = 2
206 # use php to colorize .php and .inc files?
209 # path to php executable
211 # php_exe_path = /usr/local/bin/php
212 # php_exe_path = C:\Program Files\php\cli\php.exe
215 # ViewVC can generate tarball from a repository on the fly.
221 # Use CvsGraph. See http://www.akhphd.au.dk/~bertho/cvsgraph/ for
222 # documentation and download.
228 # if the cvsgraph program is not on the path, set this value
231 # cvsgraph_path = /usr/local/bin/
234 # Location of the customized cvsgraph configuration file.
235 # You will need an absolute pathname here:
237 cvsgraph_conf = cvsgraph.conf
240 # Set to enable regular expression search of all files in a directory
244 # Enabling this option can consume HUGE amounts of server time. A
245 # "checkout" must be performed on *each* file in a directory, and
246 # the result needs to be searched for a match against the regular
250 # SECURITY WARNING: Denial Of Service
252 # Since a user can enter the regular expression, it is possible for
253 # them to enter an expression with many alternatives and a lot of
254 # backtracking. Executing that search over thousands of lines over
255 # dozens of files can easily tie up a server for a long period of
258 # This option should only be used on sites with trusted users. It is
259 # highly inadvisable to use this on a public site.
265 # Split directories and logs into pages.
266 # Allows ViewVC to present discrete pages to the users instead of the
267 # entire log or directory.
268 # Set use_pagesize to the number of entries you want displayed on a page.
273 # Limit number of changed paths shown per commit in the Subversion revision
274 # view and in query results. This is not a hard limit (the UI provides
275 # options to show all changed paths), but it prevents ViewVC from generating
276 # enormous and hard to read pages by default when they happen to contain
277 # import or merge commits affecting hundreds or thousands of files.
278 # Set to 0 to disable the limit.
281 #---------------------------------------------------------------------------
284 # You can override the templates used by various ViewVC views in this
285 # section. By default, ViewVC will look for templates in the
286 # directory specified by the "template_dir" configuration option (see
287 # the documentation for that option for details). But if you want to
288 # use a different template for a particular view, simply uncomment the
289 # appropriate option below and specify the currect location of the EZT
290 # template file you wish to use for that view.
292 # Templates are specified relative to the installation directory, but
293 # absolute paths may also be used as well.
295 # If %lang% occurs in the pathname, then the selected language will be
298 # Note: the selected language is defined by the "languages" item in the
299 # [general] section, and based on the request's Accept-Language
302 #directory = templates/directory.ezt
303 ### an alternative directory view
304 #directory = templates/dir_new.ezt
305 #log = templates/log.ezt
306 ### a table-based alternative log view
307 #log = templates/log_table.ezt
308 #query = templates/query.ezt
309 #diff = templates/diff.ezt
310 #graph = templates/graph.ezt
311 #annotate = templates/annotate.ezt
312 #markup = templates/markup.ezt
313 #revision = templates/revision.ezt
314 #query_form = templates/query_form.ezt
315 #query_results = templates/query_results.ezt
316 #error = templates/error.ezt
317 #roots = templates/roots.ezt
319 #---------------------------------------------------------------------------
325 #database_name = ViewCVS
332 #---------------------------------------------------------------------------
336 # vhost1 = glob1, glob2
337 # vhost2 = glob3, glob4
341 # [vhost1-othersection]
347 # Here is an example:
358 # Note that "lyra" is the "canonical" name for all hosts in the lyra.org
359 # domain. This canonical name is then used within the additional, vhost-
360 # specific sections to override specific values in the common sections.
363 #---------------------------------------------------------------------------