Sophie

Sophie

distrib > Fedora > 14 > x86_64 > by-pkgid > 465c0a89b5750e023351489282ae7298 > files > 13

cgit-0.9.0.2-2.fc14.x86_64.rpm

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>CGITRC(5)</title><link rel="stylesheet" type="text/css" href="cgit-doc.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.76.1" /></head><body><div xml:lang="en" class="article" title="CGITRC(5)" lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="id439116"></a>CGITRC(5)</h2></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl><dt><span class="section"><a href="#_name">1. NAME</a></span></dt><dt><span class="section"><a href="#_synopsis">2. SYNOPSIS</a></span></dt><dt><span class="section"><a href="#_location">3. LOCATION</a></span></dt><dt><span class="section"><a href="#_global_settings">4. GLOBAL SETTINGS</a></span></dt><dt><span class="section"><a href="#_repository_settings">5. REPOSITORY SETTINGS</a></span></dt><dt><span class="section"><a href="#_repository_specific_cgitrc_file">6. REPOSITORY-SPECIFIC CGITRC FILE</a></span></dt><dt><span class="section"><a href="#_macro_expansion">7. MACRO EXPANSION</a></span></dt><dt><span class="section"><a href="#_example_cgitrc_file">8. EXAMPLE CGITRC FILE</a></span></dt><dt><span class="section"><a href="#_bugs">9. BUGS</a></span></dt><dt><span class="section"><a href="#_author">10. AUTHOR</a></span></dt></dl></div><div class="section" title="1. NAME"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_name"></a>1. NAME</h2></div></div></div><p>cgitrc - runtime configuration for cgit</p></div><div class="section" title="2. SYNOPSIS"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_synopsis"></a>2. SYNOPSIS</h2></div></div></div><p>Cgitrc contains all runtime settings for cgit, including the list of git
repositories, formatted as a line-separated list of NAME=VALUE pairs. Blank
lines, and lines starting with <span class="emphasis"><em>#</em></span>, are ignored.</p></div><div class="section" title="3. LOCATION"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_location"></a>3. LOCATION</h2></div></div></div><p>The default location of cgitrc, defined at compile time, is /etc/cgitrc. At
runtime, cgit will consult the environment variable CGIT_CONFIG and, if
defined, use its value instead.</p></div><div class="section" title="4. GLOBAL SETTINGS"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_global_settings"></a>4. GLOBAL SETTINGS</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
about-filter
</span></dt><dd>
        Specifies a command which will be invoked to format the content of
        about pages (both top-level and for each repository). The command will
        get the content of the about-file on its STDIN, and the STDOUT from the
        command will be included verbatim on the about page. Default value:
        none.
</dd><dt><span class="term">
agefile
</span></dt><dd>
        Specifies a path, relative to each repository path, which can be used
        to specify the date and time of the youngest commit in the repository.
        The first line in the file is used as input to the "parse_date"
        function in libgit. Recommended timestamp-format is "yyyy-mm-dd
        hh:mm:ss". Default value: "info/web/last-modified".
</dd><dt><span class="term">
cache-root
</span></dt><dd>
        Path used to store the cgit cache entries. Default value:
        "/var/cache/cgit". See also: "MACRO EXPANSION".
</dd><dt><span class="term">
cache-dynamic-ttl
</span></dt><dd>
        Number which specifies the time-to-live, in minutes, for the cached
        version of repository pages accessed without a fixed SHA1. Default
        value: "5".
</dd><dt><span class="term">
cache-repo-ttl
</span></dt><dd>
        Number which specifies the time-to-live, in minutes, for the cached
        version of the repository summary page. Default value: "5".
</dd><dt><span class="term">
cache-root-ttl
</span></dt><dd>
        Number which specifies the time-to-live, in minutes, for the cached
        version of the repository index page. Default value: "5".
</dd><dt><span class="term">
cache-scanrc-ttl
</span></dt><dd>
        Number which specifies the time-to-live, in minutes, for the result
        of scanning a path for git repositories. Default value: "15".
</dd><dt><span class="term">
cache-size
</span></dt><dd>
        The maximum number of entries in the cgit cache. Default value: "0"
        (i.e. caching is disabled).
</dd><dt><span class="term">
cache-static-ttl
</span></dt><dd>
        Number which specifies the time-to-live, in minutes, for the cached
        version of repository pages accessed with a fixed SHA1. Default value:
        "5".
</dd><dt><span class="term">
clone-prefix
</span></dt><dd>
        Space-separated list of common prefixes which, when combined with a
        repository url, generates valid clone urls for the repository. This
        setting is only used if <code class="literal">repo.clone-url</code> is unspecified. Default value:
        none.
</dd><dt><span class="term">
commit-filter
</span></dt><dd>
        Specifies a command which will be invoked to format commit messages.
        The command will get the message on its STDIN, and the STDOUT from the
        command will be included verbatim as the commit message, i.e. this can
        be used to implement bugtracker integration. Default value: none.
</dd><dt><span class="term">
css
</span></dt><dd>
        Url which specifies the css document to include in all cgit pages.
        Default value: "/cgit.css".
</dd><dt><span class="term">
embedded
</span></dt><dd>
        Flag which, when set to "1", will make cgit generate a html fragment
        suitable for embedding in other html pages. Default value: none. See
        also: "noheader".
</dd><dt><span class="term">
enable-commit-graph
</span></dt><dd>
        Flag which, when set to "1", will make cgit print an ASCII-art commit
        history graph to the left of the commit messages in the repository
        log page. Default value: "0".
</dd><dt><span class="term">
enable-filter-overrides
</span></dt><dd>
        Flag which, when set to "1", allows all filter settings to be
        overridden in repository-specific cgitrc files. Default value: none.
</dd><dt><span class="term">
enable-gitweb-owner
</span></dt><dd>
        If set to "1" and scan-path is enabled, we first check each repository
        for the git config value "gitweb.owner" to determine the owner.
        Default value: "1". See also: scan-path.
</dd><dt><span class="term">
enable-index-links
</span></dt><dd>
        Flag which, when set to "1", will make cgit generate extra links for
        each repo in the repository index (specifically, to the "summary",
        "commit" and "tree" pages). Default value: "0".
</dd><dt><span class="term">
enable-log-filecount
</span></dt><dd>
        Flag which, when set to "1", will make cgit print the number of
        modified files for each commit on the repository log page. Default
        value: "0".
</dd><dt><span class="term">
enable-log-linecount
</span></dt><dd>
        Flag which, when set to "1", will make cgit print the number of added
        and removed lines for each commit on the repository log page. Default
        value: "0".
</dd><dt><span class="term">
enable-remote-branches
</span></dt><dd>
        Flag which, when set to "1", will make cgit display remote branches
        in the summary and refs views. Default value: "0". See also:
        "repo.enable-remote-branches".
</dd><dt><span class="term">
enable-subject-links
</span></dt><dd>
        Flag which, when set to "1", will make cgit use the subject of the
        parent commit as link text when generating links to parent commits
        in commit view. Default value: "0". See also:
        "repo.enable-subject-links".
</dd><dt><span class="term">
enable-tree-linenumbers
</span></dt><dd>
        Flag which, when set to "1", will make cgit generate linenumber links
        for plaintext blobs printed in the tree view. Default value: "1".
</dd><dt><span class="term">
favicon
</span></dt><dd>
        Url used as link to a shortcut icon for cgit. If specified, it is
        suggested to use the value "/favicon.ico" since certain browsers will
        ignore other values. Default value: none.
</dd><dt><span class="term">
footer
</span></dt><dd>
        The content of the file specified with this option will be included
        verbatim at the bottom of all pages (i.e. it replaces the standard
        "generated by…" message. Default value: none.
</dd><dt><span class="term">
head-include
</span></dt><dd>
        The content of the file specified with this option will be included
        verbatim in the html HEAD section on all pages. Default value: none.
</dd><dt><span class="term">
header
</span></dt><dd>
        The content of the file specified with this option will be included
        verbatim at the top of all pages. Default value: none.
</dd><dt><span class="term">
include
</span></dt><dd>
        Name of a configfile to include before the rest of the current config-
        file is parsed. Default value: none. See also: "MACRO EXPANSION".
</dd><dt><span class="term">
index-header
</span></dt><dd>
        The content of the file specified with this option will be included
        verbatim above the repository index. This setting is deprecated, and
        will not be supported by cgit-1.0 (use root-readme instead). Default
        value: none.
</dd><dt><span class="term">
index-info
</span></dt><dd>
        The content of the file specified with this option will be included
        verbatim below the heading on the repository index page. This setting
        is deprecated, and will not be supported by cgit-1.0 (use root-desc
        instead). Default value: none.
</dd><dt><span class="term">
local-time
</span></dt><dd>
        Flag which, if set to "1", makes cgit print commit and tag times in the
        servers timezone. Default value: "0".
</dd><dt><span class="term">
logo
</span></dt><dd>
        Url which specifies the source of an image which will be used as a logo
        on all cgit pages. Default value: "/cgit.png".
</dd><dt><span class="term">
logo-link
</span></dt><dd>
        Url loaded when clicking on the cgit logo image. If unspecified the
        calculated url of the repository index page will be used. Default
        value: none.
</dd><dt><span class="term">
max-atom-items
</span></dt><dd>
        Specifies the number of items to display in atom feeds view. Default
        value: "10".
</dd><dt><span class="term">
max-commit-count
</span></dt><dd>
        Specifies the number of entries to list per page in "log" view. Default
        value: "50".
</dd><dt><span class="term">
max-message-length
</span></dt><dd>
        Specifies the maximum number of commit message characters to display in
        "log" view. Default value: "80".
</dd><dt><span class="term">
max-repo-count
</span></dt><dd>
        Specifies the number of entries to list per page on the repository
        index page. Default value: "50".
</dd><dt><span class="term">
max-repodesc-length
</span></dt><dd>
        Specifies the maximum number of repo description characters to display
        on the repository index page. Default value: "80".
</dd><dt><span class="term">
max-blob-size
</span></dt><dd>
        Specifies the maximum size of a blob to display HTML for in KBytes.
        Default value: "0" (limit disabled).
</dd><dt><span class="term">
max-stats
</span></dt><dd>
        Set the default maximum statistics period. Valid values are "week",
        "month", "quarter" and "year". If unspecified, statistics are
        disabled. Default value: none. See also: "repo.max-stats".
</dd><dt><span class="term">
mimetype.&lt;ext&gt;
</span></dt><dd>
        Set the mimetype for the specified filename extension. This is used
        by the <code class="literal">plain</code> command when returning blob content.
</dd><dt><span class="term">
module-link
</span></dt><dd>
        Text which will be used as the formatstring for a hyperlink when a
        submodule is printed in a directory listing. The arguments for the
        formatstring are the path and SHA1 of the submodule commit. Default
        value: "./?repo=%s&amp;page=commit&amp;id=%s"
</dd><dt><span class="term">
nocache
</span></dt><dd>
        If set to the value "1" caching will be disabled. This settings is
        deprecated, and will not be honored starting with cgit-1.0. Default
        value: "0".
</dd><dt><span class="term">
noplainemail
</span></dt><dd>
        If set to "1" showing full author email adresses will be disabled.
        Default value: "0".
</dd><dt><span class="term">
noheader
</span></dt><dd>
        Flag which, when set to "1", will make cgit omit the standard header
        on all pages. Default value: none. See also: "embedded".
</dd><dt><span class="term">
project-list
</span></dt><dd>
        A list of subdirectories inside of scan-path, relative to it, that
        should loaded as git repositories. This must be defined prior to
        scan-path. Default value: none. See also: scan-path, "MACRO
        EXPANSION".
</dd><dt><span class="term">
readme
</span></dt><dd>
        Text which will be used as default value for "repo.readme". Default
        value: none.
</dd><dt><span class="term">
remove-suffix
</span></dt><dd>
        If set to "1" and scan-path is enabled, if any repositories are found
        with a suffix of ".git", this suffix will be removed for the url and
        name. Default value: "0". See also: scan-path.
</dd><dt><span class="term">
renamelimit
</span></dt><dd>
        Maximum number of files to consider when detecting renames. The value
         "-1" uses the compiletime value in git (for further info, look at
          <code class="literal">man git-diff</code>). Default value: "-1".
</dd><dt><span class="term">
repo.group
</span></dt><dd>
        Legacy alias for "section". This option is deprecated and will not be
        supported in cgit-1.0.
</dd><dt><span class="term">
robots
</span></dt><dd>
        Text used as content for the "robots" meta-tag. Default value:
        "index, nofollow".
</dd><dt><span class="term">
root-desc
</span></dt><dd>
        Text printed below the heading on the repository index page. Default
        value: "a fast webinterface for the git dscm".
</dd><dt><span class="term">
root-readme
</span></dt><dd>
        The content of the file specified with this option will be included
        verbatim below the "about" link on the repository index page. Default
        value: none.
</dd><dt><span class="term">
root-title
</span></dt><dd>
        Text printed as heading on the repository index page. Default value:
        "Git Repository Browser".
</dd><dt><span class="term">
scan-hidden-path
</span></dt><dd>
        If set to "1" and scan-path is enabled, scan-path will recurse into
        directories whose name starts with a period (<span class="emphasis"><em>.</em></span>). Otherwise,
        scan-path will stay away from such directories (considered as
        "hidden"). Note that this does not apply to the ".git" directory in
        non-bare repos. This must be defined prior to scan-path.
        Default value: 0. See also: scan-path.
</dd><dt><span class="term">
scan-path
</span></dt><dd>
        A path which will be scanned for repositories. If caching is enabled,
        the result will be cached as a cgitrc include-file in the cache
        directory. If project-list has been defined prior to scan-path,
        scan-path loads only the directories listed in the file pointed to by
        project-list. Be advised that only the global settings taken
        before the scan-path directive will be applied to each repository.
        Default value: none. See also: cache-scanrc-ttl, project-list,
        "MACRO EXPANSION".
</dd><dt><span class="term">
section
</span></dt><dd>
        The name of the current repository section - all repositories defined
        after this option will inherit the current section name. Default value:
        none.
</dd><dt><span class="term">
section-from-path
</span></dt><dd>
        A number which, if specified before scan-path, specifies how many
        path elements from each repo path to use as a default section name.
        If negative, cgit will discard the specified number of path elements
        above the repo directory. Default value: 0.
</dd><dt><span class="term">
side-by-side-diffs
</span></dt><dd>
        If set to "1" shows side-by-side diffs instead of unidiffs per
        default. Default value: "0".
</dd><dt><span class="term">
snapshots
</span></dt><dd>
        Text which specifies the default set of snapshot formats generated by
        cgit. The value is a space-separated list of zero or more of the
        values "tar", "tar.gz", "tar.bz2", "tar.xz" and "zip". Default value:
        none.
</dd><dt><span class="term">
source-filter
</span></dt><dd>
        Specifies a command which will be invoked to format plaintext blobs
        in the tree view. The command will get the blob content on its STDIN
        and the name of the blob as its only command line argument. The STDOUT
        from the command will be included verbatim as the blob contents, i.e.
        this can be used to implement e.g. syntax highlighting. Default value:
        none.
</dd><dt><span class="term">
summary-branches
</span></dt><dd>
        Specifies the number of branches to display in the repository "summary"
        view. Default value: "10".
</dd><dt><span class="term">
summary-log
</span></dt><dd>
        Specifies the number of log entries to display in the repository
        "summary" view. Default value: "10".
</dd><dt><span class="term">
summary-tags
</span></dt><dd>
        Specifies the number of tags to display in the repository "summary"
        view. Default value: "10".
</dd><dt><span class="term">
strict-export
</span></dt><dd>
        Filename which, if specified, needs to be present within the repository
        for cgit to allow access to that repository. This can be used to emulate
        gitweb’s EXPORT_OK and STRICT_EXPORT functionality and limit cgit’s
        repositories to match those exported by git-daemon. This option MUST come
        before <span class="emphasis"><em>scan-path</em></span>.
</dd><dt><span class="term">
virtual-root
</span></dt><dd>
        Url which, if specified, will be used as root for all cgit links. It
        will also cause cgit to generate <span class="emphasis"><em>virtual urls</em></span>, i.e. urls like
        <span class="emphasis"><em>/cgit/tree/README</em></span> as opposed to <span class="emphasis"><em>?r=cgit&amp;p=tree&amp;path=README</em></span>. Default
        value: none.
        NOTE: cgit has recently learned how to use PATH_INFO to achieve the
        same kind of virtual urls, so this option will probably be deprecated.
</dd></dl></div></div><div class="section" title="5. REPOSITORY SETTINGS"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_repository_settings"></a>5. REPOSITORY SETTINGS</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
repo.about-filter
</span></dt><dd>
        Override the default about-filter. Default value: none. See also:
        "enable-filter-overrides".
</dd><dt><span class="term">
repo.clone-url
</span></dt><dd>
        A list of space-separated urls which can be used to clone this repo.
        Default value: none.
</dd><dt><span class="term">
repo.commit-filter
</span></dt><dd>
        Override the default commit-filter. Default value: none. See also:
        "enable-filter-overrides".
</dd><dt><span class="term">
repo.defbranch
</span></dt><dd>
        The name of the default branch for this repository. If no such branch
        exists in the repository, the first branch name (when sorted) is used
        as default instead. Default value: "master".
</dd><dt><span class="term">
repo.desc
</span></dt><dd>
        The value to show as repository description. Default value: none.
</dd><dt><span class="term">
repo.enable-commit-graph
</span></dt><dd>
        A flag which can be used to disable the global setting
        ‘enable-commit-graph’. Default value: none.
</dd><dt><span class="term">
repo.enable-log-filecount
</span></dt><dd>
        A flag which can be used to disable the global setting
        ‘enable-log-filecount’. Default value: none.
</dd><dt><span class="term">
repo.enable-log-linecount
</span></dt><dd>
        A flag which can be used to disable the global setting
        ‘enable-log-linecount’. Default value: none.
</dd><dt><span class="term">
repo.enable-remote-branches
</span></dt><dd>
        Flag which, when set to "1", will make cgit display remote branches
        in the summary and refs views. Default value: &lt;enable-remote-branches&gt;.
</dd><dt><span class="term">
repo.enable-subject-links
</span></dt><dd>
        A flag which can be used to override the global setting
        ‘enable-subject-links’. Default value: none.
</dd><dt><span class="term">
repo.logo
</span></dt><dd>
        Url which specifies the source of an image which will be used as a logo
        on this repo’s pages. Default value: global logo.
</dd><dt><span class="term">
repo.logo-link
</span></dt><dd>
        Url loaded when clicking on the cgit logo image. If unspecified the
        calculated url of the repository index page will be used. Default
        value: global logo-link.
</dd><dt><span class="term">
repo.module-link
</span></dt><dd>
        Text which will be used as the formatstring for a hyperlink when a
        submodule is printed in a directory listing. The arguments for the
        formatstring are the path and SHA1 of the submodule commit. Default
        value: &lt;module-link&gt;
</dd><dt><span class="term">
repo.max-stats
</span></dt><dd>
        Override the default maximum statistics period. Valid values are equal
        to the values specified for the global "max-stats" setting. Default
        value: none.
</dd><dt><span class="term">
repo.name
</span></dt><dd>
        The value to show as repository name. Default value: &lt;repo.url&gt;.
</dd><dt><span class="term">
repo.owner
</span></dt><dd>
        A value used to identify the owner of the repository. Default value:
        none.
</dd><dt><span class="term">
repo.path
</span></dt><dd>
        An absolute path to the repository directory. For non-bare repositories
        this is the .git-directory. Default value: none.
</dd><dt><span class="term">
repo.readme
</span></dt><dd>
        A path (relative to &lt;repo.path&gt;) which specifies a file to include
        verbatim as the "About" page for this repo. You may also specify a
        git refspec by head or by hash by prepending the refspec followed by
        a colon. For example, "master:docs/readme.mkd" Default value: &lt;readme&gt;.
</dd><dt><span class="term">
repo.snapshots
</span></dt><dd>
        A mask of allowed snapshot-formats for this repo, restricted by the
        "snapshots" global setting. Default value: &lt;snapshots&gt;.
</dd><dt><span class="term">
repo.section
</span></dt><dd>
        Override the current section name for this repository. Default value:
        none.
</dd><dt><span class="term">
repo.source-filter
</span></dt><dd>
        Override the default source-filter. Default value: none. See also:
        "enable-filter-overrides".
</dd><dt><span class="term">
repo.url
</span></dt><dd>
        The relative url used to access the repository. This must be the first
        setting specified for each repo. Default value: none.
</dd></dl></div></div><div class="section" title="6. REPOSITORY-SPECIFIC CGITRC FILE"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_repository_specific_cgitrc_file"></a>6. REPOSITORY-SPECIFIC CGITRC FILE</h2></div></div></div><p>When the option "scan-path" is used to auto-discover git repositories, cgit
will try to parse the file "cgitrc" within any found repository. Such a
repo-specific config file may contain any of the repo-specific options
described above, except "repo.url" and "repo.path". Additionally, the "filter"
options are only acknowledged in repo-specific config files when
"enable-filter-overrides" is set to "1".</p><p>Note: the "repo." prefix is dropped from the option names in repo-specific
config files, e.g. "repo.desc" becomes "desc".</p></div><div class="section" title="7. MACRO EXPANSION"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_macro_expansion"></a>7. MACRO EXPANSION</h2></div></div></div><p>The following cgitrc options supports a simple macro expansion feature,
where tokens prefixed with "$" are replaced with the value of a similary
named environment variable:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
cache-root
</li><li class="listitem">
include
</li><li class="listitem">
project-list
</li><li class="listitem">
scan-path
</li></ul></div><p>Macro expansion will also happen on the content of $CGIT_CONFIG, if
defined.</p><p>One usage of this feature is virtual hosting, which in its simplest form
can be accomplished by adding the following line to /etc/cgitrc:</p><pre class="literallayout">include=/etc/cgitrc.d/$HTTP_HOST</pre></div><div class="section" title="8. EXAMPLE CGITRC FILE"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_example_cgitrc_file"></a>8. EXAMPLE CGITRC FILE</h2></div></div></div><pre class="literallayout"># Enable caching of up to 1000 output entriess
cache-size=1000


# Specify some default clone prefixes
clone-prefix=git://example.com ssh://example.com/pub/git http://example.com/git

# Specify the css url
css=/css/cgit.css


# Show extra links for each repository on the index page
enable-index-links=1


# Enable ASCII art commit history graph on the log pages
enable-commit-graph=1


# Show number of affected files per commit on the log pages
enable-log-filecount=1


# Show number of added/removed lines per commit on the log pages
enable-log-linecount=1


# Add a cgit favicon
favicon=/favicon.ico


# Use a custom logo
logo=/img/mylogo.png


# Enable statistics per week, month and quarter
max-stats=quarter


# Set the title and heading of the repository index page
root-title=example.com git repositories


# Set a subheading for the repository index page
root-desc=tracking the foobar development


# Include some more info about example.com on the index page
root-readme=/var/www/htdocs/about.html


# Allow download of tar.gz, tar.bz2 and zip-files
snapshots=tar.gz tar.bz2 zip


##
## List of common mimetypes
##

mimetype.gif=image/gif
mimetype.html=text/html
mimetype.jpg=image/jpeg
mimetype.jpeg=image/jpeg
mimetype.pdf=application/pdf
mimetype.png=image/png
mimetype.svg=image/svg+xml


##
## List of repositories.
## PS: Any repositories listed when section is unset will not be
##     displayed under a section heading
## PPS: This list could be kept in a different file (e.g. '/etc/cgitrepos')
##      and included like this:
##        include=/etc/cgitrepos
##


repo.url=foo
repo.path=/pub/git/foo.git
repo.desc=the master foo repository
repo.owner=fooman@example.com
repo.readme=info/web/about.html


repo.url=bar
repo.path=/pub/git/bar.git
repo.desc=the bars for your foo
repo.owner=barman@example.com
repo.readme=info/web/about.html


# The next repositories will be displayed under the 'extras' heading
section=extras


repo.url=baz
repo.path=/pub/git/baz.git
repo.desc=a set of extensions for bar users

repo.url=wiz
repo.path=/pub/git/wiz.git
repo.desc=the wizard of foo


# Add some mirrored repositories
section=mirrors


repo.url=git
repo.path=/pub/git/git.git
repo.desc=the dscm


repo.url=linux
repo.path=/pub/git/linux.git
repo.desc=the kernel

# Disable adhoc downloads of this repo
repo.snapshots=0

# Disable line-counts for this repo
repo.enable-log-linecount=0

# Restrict the max statistics period for this repo
repo.max-stats=month</pre></div><div class="section" title="9. BUGS"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_bugs"></a>9. BUGS</h2></div></div></div><p>Comments currently cannot appear on the same line as a setting; the comment
will be included as part of the value. E.g. this line:</p><pre class="literallayout">robots=index  # allow indexing</pre><p>will generate the following html element:</p><pre class="literallayout">&lt;meta name='robots' content='index  # allow indexing'/&gt;</pre></div><div class="section" title="10. AUTHOR"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_author"></a>10. AUTHOR</h2></div></div></div><p>Lars Hjemli &lt;<a class="ulink" href="mailto:hjemli@gmail.com" target="_top">hjemli@gmail.com</a>&gt;
Jason A. Donenfeld &lt;<a class="ulink" href="mailto:Jason@zx2c4.com" target="_top">Jason@zx2c4.com</a>&gt;</p></div></div></body></html>