aboutsummaryrefslogtreecommitdiff
path: root/cgitrc.5.txt
diff refs
from: back
to: back
| flip
diff options
context:
space:
mode:
Diffstat (limited to 'cgitrc.5.txt')
-rw-r--r--cgitrc.5.txt48
1 files changed, 5 insertions, 43 deletions
diff --git a/cgitrc.5.txt b/cgitrc.5.txt
index 4dc383d..3b16db9 100644
--- a/cgitrc.5.txt
+++ b/cgitrc.5.txt
@@ -54,10 +54,6 @@ cache-root-ttl::
Number which specifies the time-to-live, in minutes, for the cached
version of the repository index page. Default value: "5".
-cache-scanrc-ttl::
- Number which specifies the time-to-live, in minutes, for the result
- of scanning a path for git repositories. Default value: "15".
-
cache-size::
The maximum number of entries in the cgit cache. Default value: "0"
(i.e. caching is disabled).
@@ -88,10 +84,6 @@ embedded::
suitable for embedding in other html pages. Default value: none. See
also: "noheader".
-enable-filter-overrides::
- Flag which, when set to "1", allows all filter settings to be
- overridden in repository-specific cgitrc files. Default value: none.
-
enable-index-links::
Flag which, when set to "1", will make cgit generate extra links for
each repo in the repository index (specifically, to the "summary",
@@ -208,8 +200,8 @@ renamelimit::
`man git-diff`). Default value: "-1".
repo.group::
- Legacy alias for "section". This option is deprecated and will not be
- supported in cgit-1.0.
+ A value for the current repository group, which all repositories
+ specified after this setting will inherit. Default value: none.
robots::
Text used as content for the "robots" meta-tag. Default value:
@@ -228,16 +220,6 @@ root-title::
Text printed as heading on the repository index page. Default value:
"Git Repository Browser".
-scan-path::
- 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. Default value: none. See also: cache-scanrc-ttl.
-
-section::
- The name of the current repository section - all repositories defined
- after this option will inherit the current section name. Default value:
- none.
-
snapshots::
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
@@ -274,16 +256,14 @@ virtual-root::
REPOSITORY SETTINGS
-------------------
repo.about-filter::
- Override the default about-filter. Default value: none. See also:
- "enable-filter-overrides".
+ Override the default about-filter. Default value: <about-filter>.
repo.clone-url::
A list of space-separated urls which can be used to clone this repo.
Default value: none.
repo.commit-filter::
- Override the default commit-filter. Default value: none. See also:
- "enable-filter-overrides".
+ Override the default commit-filter. Default value: <commit-filter>.
repo.defbranch::
The name of the default branch for this repository. If no such branch
@@ -325,32 +305,14 @@ repo.snapshots::
A mask of allowed snapshot-formats for this repo, restricted by the
"snapshots" global setting. Default value: <snapshots>.
-repo.section::
- Override the current section name for this repository. Default value:
- none.
-
repo.source-filter::
- Override the default source-filter. Default value: none. See also:
- "enable-filter-overrides".
+ Override the default source-filter. Default value: <source-filter>.
repo.url::
The relative url used to access the repository. This must be the first
setting specified for each repo. Default value: none.
-REPOSITORY-SPECIFIC CGITRC FILE
--------------------------------
-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".
-
-Note: the "repo." prefix is dropped from the option names in repo-specific
-config files, e.g. "repo.desc" becomes "desc".
-
-
EXAMPLE CGITRC FILE
-------------------