#--------------------------------------------------------------------------- # # Configuration file for ViewCVS # # Information on ViewCVS is located at the following web site: # http://viewcvs.sourceforge.net/ # #--------------------------------------------------------------------------- # # BASIC CONFIGURATION # # For correct operation, you will probably need to change the following # configuration variables: # # cvs_roots (for CVS) # svn_roots (for Subversion) # root_parents (for CVS or Subversion) # default_root # rcs_path or cvsnt_exe_path # mime_types_file # # It is usually desirable to change the following variables: # # address # main_title # forbidden # # use_enscript # use_cvsgraph # # For Python source colorization: # # py2html_path # # If your icons or ViewCVS static files are in special locations: # # icons # docroot # # Also, review the .ezt templates in the templates/ directory to adjust them # for your particular site. # # # FORMAT INFORMATION # # This file is delineated by sections, specified in [brackets]. Within each # section, are a number of configuration settings. These settings take the # form of: name = value. Values may be continued on the following line by # indenting the continued line. # # WARNING: indentation *always* means continuation. name=value lines should # always start in column zero. # # Comments should always start in column zero, and are identified with "#". # # Certain configuration settings may have multiple values. These should be # separated by a comma. The settings where this is allowed are noted below. # # Any other setting that requires special syntax is noted at that setting. # #--------------------------------------------------------------------------- [general] # # This setting specifies each of the CVS roots on your system and assigns # names to them. Each root should be given by a "name: path" value. Multiple # roots should be separated by commas and can be placed on separate lines. # cvs_roots = cvs: /var/cvs # # This setting specifies each of the Subversion roots (repositories) # on your system and assigns names to them. Each root should be given # by a "name: path" value. Multiple roots should be separated by # commas and can be placed on separate lines. # svn_roots = svn: /var/svn # The 'root_parents' setting specifies a list of directories in which # any number of repositories may reside. Rather than force you to add # a new entry to 'cvs_roots' or 'svn_roots' each time you create a new # repository, ViewCVS rewards you for organising all your repositories # under a few parent directories by allowing you to simply specifiy # just those parent directories. ViewCVS will then notice each # repository in that directory as a new root whose name is the # subdirectory of the parent path in which that repository lives. # # You can specify multiple parent paths separated by commas or new lines. # # Caution: these names can, of course, clash with names you have # defined in your cvs_roots or svn_roots configuration items. If this # occurs, you can either rename the offending repository on disk, or # grant new names to the clashing item in cvs_roots or svn_roots. # Each parent path is processed sequentially, so repositories under # later parent paths may override earlier ones. # #root_parents = /home/svn-repositories : svn, # /home/cvs-repositories : cvs # this is the name of the default root. default_root = # uncomment if the RCS binaries are not on the standard path #rcs_path = /usr/bin/ # ViewCVS can use CVSNT (www.cvsnt.org) instead of the RCS # utilities to retrieve information from CVS repositories. # To enable use of CVSNT, set the "cvsnt_exe_path" value # to the path of the CVSNT executable. (If CVSNT is on the # standard path, you can also set it to the name of the # CVSNT executable). By default "cvsnt_exe_path" is set to # "cvs" on Windows and is not set on other platforms. # #cvsnt_exe_path = #cvsnt_exe_path = cvs #cvsnt_exe_path = K:\Program Files\cvsnt\cvs.exe #cvsnt_exe_path = /usr/bin/cvs # use rcsparse python module to retrieve cvs repository information instead # of invoking rcs utilities. this feature is experimental use_rcsparse = 1 # # This is a pathname to a MIME types file to help viewcvs to guess the # correct MIME type on checkout. # # If you are having problems with the default guess on the MIME type, then # uncomment this option and point it at a MIME type file. # # For example, you can use the mime.types from apache here: #mime_types_file = /usr/local/apache/conf/mime.types # This address is shown in the footer of the generated pages. # It must be replaced with the address of the local repository maintainer. address = Michael R. Head # this title is used on the main entry page main_title = Repository # # This should contain a list of modules in the repository that should not be # displayed (by default or by explicit path specification). # # This configuration can be a simple list of modules, or it can get quite # complex: # # *) The "!" can be used before a module to explicitly state that it # is NOT forbidden. Whenever this form is seen, then all modules will # be forbidden unless one of the "!" modules match. # # *) Shell-style "glob" expressions may be used. "*" will match any # sequence of zero or more characters, "?" will match any single # character, "[seq]" will match any character in seq, and "[!seq]" # will match any character not in seq. # # *) Tests are performed in sequence. The first match will terminate the # testing. This allows for more complex allow/deny patterns. # # Tests are case-sensitive. # forbidden = # forbidden = !example1, !example2 # # Forbid modules starting with "x": # forbidden = x* # # Allow modules starting with "x" but no others: # forbidden = !x* # # Allow "xml", forbid other modules starting with "x", and allow the rest: # forbidden = !xml, x*, !* # # # This option provides a mechanism for custom key/value pairs to be # available to templates. These are stored in key/value files (KV files). # # Pathnames to the KV files are listed here, specified as absolute paths # or relative to this configuration file. The kV files follow the same # format as this configuration file. It may have multiple, user-defined # sections, and user-defined options in those sections. These are all # placed into a structure available to the templates as: # # kv.SECTION.OPTION # # Note that an option name can be dotted. For example: # # [my_images] # logos.small = /images/small-logo.png # logos.big = /images/big-logo.png # # Templates can use these with a directive like: [kv.my_images.logos.small] # # Note that sections across multiple files will be merged. If two files # have a [my_images] section, then the options will be merged together. # If two files have the same option name in a section, then one will # overwrite the other (it is unspecified regarding which "wins"). # # To further categorize the KV files, and how the values are provided to # the templates, a KV file name may be annotated with an additional level # of dotted naming. For example: # # kv_files = [asf]kv/images.conf # # Assuming the same section as above, the template would refer to an image # using [kv.asf.my_images.logos.small] # # Lastly, it is possible to use %lang% in the filenames to specify a # substitution of the selected language-tag. # kv_files = # example: # kv_files = kv/file1.conf, kv/file2.conf, [i18n]kv/%lang%_data.conf # # # The languages available to ViewCVS. There are several i18n mechanisms # available: # # 1) using key/value extension system and reading KV files based on # the selected language # 2) GNU gettext to substitute text in the templates # 3) using different templates, based on the selected language # # ### NOTE: at the moment, the GNU gettext style is not implemented # # This option is a comma-separated list of language-tag values. The first # language-tag listed is the default language, and will be used if an # Accept-Language header is not present in the request, or none of the # user's requested languages are available. If there are ties on the # selection of a language, then the first to appear in the list is chosen. # languages = en-us # other examples: # # languages = en-us, de # languages = en-us, en-gb, de # languages = de, fr, en-us # #--------------------------------------------------------------------------- [templates] # # The templates are specified relative to the configuration file. Absolute # paths may be used, if you want to keep these elsewhere. # # If %lang% occurs in the pathname, then the selected language will be # substituted. # # Note: the selected language is defined by the "languages" item in the # [general] section, and based on the request's Accept-Language # header. # query = templates/query.ezt diff = templates/diff.ezt graph = templates/graph.ezt annotate = templates/annotate.ezt markup = templates/markup.ezt revision = templates/revision.ezt query_form = templates/query_form.ezt query_results = templates/query_results.ezt error = templates/error.ezt directory = templates/directory.ezt # For an alternate form, where the first column displays a revision number # and brings you to the log view (and the filename displays the HEAD), then # you may use this template: # directory = templates/dir_alternate.ezt log = templates/log.ezt # For a log view where the revisions are displayed in a table, you may # want to try this template: # log = templates/log_table.ezt #--------------------------------------------------------------------------- [cvsdb] enabled = 0 #host = localhost #database_name = ViewCVS #user = #passwd = #readonly_user = #readonly_passwd = #row_limit = 1000 #--------------------------------------------------------------------------- [options] ### DOC # root_as_url_component: Interpret the first path component in the URL # after the script location as the root to use. This is an # alternative to using the 'root=' query key. If no path components # exists in the script url after the script location, or if the first # such path component does not identify the name of configured root # (see the 'cvs_roots', 'svn_roots', and 'svn_parent_path' # configuration items), the path will be expected to exist inside the # configured default root (the 'default_root' configuration item). # 1 Treat first path component as root name # 0 No special treatment of first path component (use root=) root_as_url_component = 0 # http_expiration_time: Expiration time (in seconds) for cacheable # pages served by ViewCVS. Note that in most cases, a cache aware # client will only revalidate the page after it expires (using the # If-Modified-Since and/or If-None-Match headers) and that browsers # will also revalidate the page when the reload button is pressed. # Set to 0 to disable the transmission of these caching headers. http_expiration_time = 600 # generate_etags: Generate Etag headers for relevant pages to assist # in browser caching. # 1 Generate Etags # 0 Don't generate Etags generate_etags = 1 # sort_by: File sort order # file Sort by filename # rev Sort by revision number # date Sort by commit date # author Sort by author # log Sort by log message sort_by = file # hide_attic: Hide or show the contents of the Attic subdirectory # 1 Hide dead files inside Attic subdir # 0 Show the files which are inside the Attic subdir hide_attic = 1 # log_sort: Sort order for log messages # date Sort revisions by date # rev Sort revision by revision number # cvs Don't sort them. Same order as CVS/RCS shows them. log_sort = date # diff_format: Default diff format # h Human readable # u Unified diff # c Context diff # s Side by side # l Long human readable (more context) diff_format = h # hide_cvsroot: Don't show the CVSROOT directory # 1 Hide CVSROOT directory # 0 Show CVSROOT directory hide_cvsroot = 1 # set to 1 to make lines break at spaces, # set to 0 to make no-break lines, # set to a positive integer to make the lines cut at that length hr_breakable = 1 # give out function names in human readable diffs # this just makes sense if we have C-files, otherwise # diff's heuristic doesn't work well .. # ( '-p' option to diff) hr_funout = 0 # ignore whitespaces for human readable diffs # (indendation and stuff ..) # ( '-w' option to diff) hr_ignore_white = 1 # ignore diffs which are caused by # keyword-substitution like $Id - Stuff # ( '-kk' option to rcsdiff) hr_ignore_keyword_subst = 1 # allow annotation of files. allow_annotate = 1 # allow pretty-printed version of files allow_markup = 1 # allow compression with gzip of output if the Browser accepts it # (HTTP_ACCEPT_ENCODING=gzip) # [make sure to have gzip in the path] allow_compress = 1 # If you have files which automatically refers to other files # (such as HTML) then this allows you to browse the checked # out files as if outside the repository. checkout_magic = 1 # Web path to a directory containing apache icon files icons = /icons # Web path to a directory that contains ViewCVS static files. # (The ones installed in /usr/lib/python2.4/site-packages/viewcvs/doc). If set, static # files will get served from this location, otherwise static files will # be served by the ViewCVS script which is less efficient docroot = /viewvc # Show last changelog message for sub directories # The current implementation makes many assumptions and may show the # incorrect file at some times. The main assumption is that the last # modified file has the newest filedate. But some CVS operations # touches the file without even when a new version is't checked in, # and TAG based browsing essientially puts this out of order, unless # the last checkin was on the same tag as you are viewing. # Enable this if you like the feature, but don't rely on correct results. show_subdir_lastmod = 0 # show a portion of the most recent log entry in directory listings show_logs = 1 # Show log when viewing file contents show_log_in_markup = 1 # Cross filesystem copies when traversing Subversion file revision histories. cross_copies = 1 # Display dates as UTC or in local time zone use_localtime = 0 #use_localtime = 1 # == Configuration defaults == # Defaults for configuration variables that shouldn't need # to be configured.. # # If you want to use Marc-Andrew Lemburg's py2html (and Just van Rossum's # PyFontify) to colorize Python files, then you may need to change this # variable to point to their directory location. # # This directory AND the standard Python path will be searched. # py2html_path = . #py2html_path = /usr/local/lib/python1.5/site-python # the length to which the most recent log entry should be truncated when # shown in the directory view short_log_len = 80 # should we use 'enscript' for syntax coloring? use_enscript = 1 # # if the enscript program is not on the path, set this value # enscript_path = # enscript_path = /usr/bin/ # use php to colorize .php and .inc files? use_php = 1 # path to php executable php_exe_path = php # php_exe_path = /usr/local/bin/php # php_exe_path = C:\Program Files\php\cli\php.exe # # ViewCVS has its own set of mappings from filename extensions and filenames # to languages. If the language is not supported by enscript, then it can # be listed here to disable the use of enscript. # disable_enscript_lang = # disable_enscript_lang = perl, cpp # # ViewCVS can generate tarball from a repository on the fly. # allow_tar = 1 # allow_tar = 1 # # Use CvsGraph # You will need to install the cvsgraph package #use_cvsgraph = 0 use_cvsgraph = 1 # # The location of the cvsgraph configuration file # cvsgraph_conf = /etc/cvsgraph/cvsgraph.conf # # Set to enable regular expression search of all files in a directory # # WARNING: # # Enabling this option can consume HUGE amounts of server time. A # "checkout" must be performed on *each* file in a directory, and # the result needs to be searched for a match against the regular # expression. # # # SECURITY WARNING: Denial Of Service # # Since a user can enter the regular expression, it is possible for # them to enter an expression with many alternatives and a lot of # backtracking. Executing that search over thousands of lines over # dozens of files can easily tie up a server for a long period of # time. # # This option should only be used on sites with trusted users. It is # highly inadvisable to use this on a public site. # use_re_search = 0 # use_re_search = 1 # # Split directories and logs into pages. # Allows ViewCVS to present discrete pages to the users instead of the # entire log or directory. # Set use_pagesize to the number of entries you want displayed on a page. # use_pagesize = 0 # use_pagesize = 20 #--------------------------------------------------------------------------- [vhosts] ### DOC # vhost1 = glob1, glob2 # vhost2 = glob3, glob4 # [vhost1-section] # option = value # [vhost1-othersection] # option = value # [vhost2-section] # option = value # # Here is an example: # # [vhosts] # lyra = *lyra.org # # [lyra-general] # forbidden = hideme # # [lyra-options] # show_logs = 0 # # Note that "lyra" is the "canonical" name for all hosts in the lyra.org # domain. This canonical name is then used within the additional, vhost- # specific sections to override specific values in the common sections. # #---------------------------------------------------------------------------