cgitrc.5.txt: Specify when scan-path must be defined before.

Several options must be specified prior to scan-path. This is consistant
source of user confusion. Document these facts.

Suggested-by: Lukas Fleischer <cgit@cryptocrack.de>
Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
This commit is contained in:
Jason A. Donenfeld 2013-04-10 14:42:49 +02:00
والد 8c4c2c464b
کامیت a8d613efdc

مشاهده پرونده

@ -163,11 +163,12 @@ enable-tree-linenumbers::
enable-git-config:: enable-git-config::
Flag which, when set to "1", will allow cgit to use git config to set Flag which, when set to "1", will allow cgit to use git config to set
any repo specific settings. This option is used in conjunction with any repo specific settings. This option is used in conjunction with
"scan-path" to augment repo-specific settings. The keys gitweb.owner, "scan-path", and must be defined prior, to augment repo-specific
gitweb.category, and gitweb.description will map to the cgit keys settings. The keys gitweb.owner, gitweb.category, and gitweb.description
repo.owner, repo.section, and repo.desc, respectivly. All git config will map to the cgit keys repo.owner, repo.section, and repo.desc,
keys that begin with "cgit." will be mapped to the corresponding "repo." respectivly. All git config keys that begin with "cgit." will be mapped
key in cgit. Default value: "0". See also: scan-path, section-from-path. to the corresponding "repo." key in cgit. Default value: "0". See also:
scan-path, section-from-path.
favicon:: favicon::
Url used as link to a shortcut icon for cgit. If specified, it is Url used as link to a shortcut icon for cgit. If specified, it is
@ -293,7 +294,8 @@ readme::
remove-suffix:: remove-suffix::
If set to "1" and scan-path is enabled, if any repositories are found 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 with a suffix of ".git", this suffix will be removed for the url and
name. Default value: "0". See also: scan-path. name. This must be defined prior to scan-path. Default value: "0".
See also: scan-path.
renamelimit:: renamelimit::
Maximum number of files to consider when detecting renames. The value Maximum number of files to consider when detecting renames. The value
@ -357,7 +359,7 @@ section-sort::
case-sensitive-sort, repository-sort. case-sensitive-sort, repository-sort.
section-from-path:: section-from-path::
A number which, if specified before scan-path, specifies how many A number which, if defined prior to scan-path, specifies how many
path elements from each repo path to use as a default section name. path elements from each repo path to use as a default section name.
If negative, cgit will discard the specified number of path elements If negative, cgit will discard the specified number of path elements
above the repo directory. Default value: "0". above the repo directory. Default value: "0".
@ -396,8 +398,8 @@ strict-export::
Filename which, if specified, needs to be present within the repository 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 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 gitweb's EXPORT_OK and STRICT_EXPORT functionality and limit cgit's
repositories to match those exported by git-daemon. This option MUST come repositories to match those exported by git-daemon. This option must
before 'scan-path'. be defined prior to scan-path.
virtual-root:: virtual-root::
Url which, if specified, will be used as root for all cgit links. It Url which, if specified, will be used as root for all cgit links. It