ui-repolist: Add "section-sort" flag to control section sorting.

[ps-cgit] / cgitrc.5.txt

diff --git a/cgitrc.5.txt b/cgitrc.5.txt
index 902fff3e6674115e708cfe2b3f917632468f0070..78bb9fc802ab56f50cdeb9cd4e3db928bc9931f1 100644 (file)
--- a/cgitrc.5.txt
+++ b/cgitrc.5.txt
@@ -72,7 +72,7 @@ cache-static-ttl::
 
 case-sensitive-sort::
        Sort items in the repo list case sensitively. Default value: "1".
-       See also: section-sort.
+       See also: repository-sort, section-sort.
 
 clone-prefix::
        Space-separated list of common prefixes which, when combined with a
@@ -110,24 +110,6 @@ 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-gitweb-desc::
-       If set to "1" and scan-path is enabled, we first check each repository
-       for the git config value "gitweb.description" to determine the owner.
-       Otherwise, the description is read from a file titled "description"
-       inside of the repository directory.
-       Default value: "1". See also: scan-path.
-
-enable-gitweb-owner::
-       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.
-
-enable-gitweb-section::
-       If set to "1" and scan-path is enabled, we first check each repository
-       for the git config value "gitweb.category" to determine the repository's
-       section. This value is overridden if section-from-path is enabled.
-       Default value: "1". See also: scan-path section-from-path.
-
 enable-http-clone::
        If set to "1", cgit will act as an dumb HTTP endpoint for git clones.
        If you use an alternate way of serving git repositories, you may wish
@@ -163,6 +145,15 @@ enable-tree-linenumbers::
        Flag which, when set to "1", will make cgit generate linenumber links
        for plaintext blobs printed in the tree view. Default value: "1".
 
+enable-git-config::
+       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
+       "scan-path" to augment _repo._ settings. The keys gitweb.owner,
+       gitweb.category, and gitweb.description will map to the cgit keys
+       repo.owner, repo.section, and repo.desc, respectivly. All git config
+       keys that begin with "cgit." will be mapped to the corresponding "repo."
+       key in cgit. Default value: "0". See also: scan-path section-from-path.
+
 favicon::
        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
@@ -337,11 +328,17 @@ section::
        after this option will inherit the current section name. Default value:
        none.
 
-section-sort::
+repository-sort::
        The way in which repositories in each section are sorted. Valid values
        are "name" for sorting by the repo name or "age" for sorting by the
        most recently updated repository. Default value: "name". See also:
-       section, case-sensitive-sort.
+       section, case-sensitive-sort, section-sort.
+
+section-sort::
+       Flag which, when set to "1", will sort the sections on the repository
+       listing by name. Set this flag to "0" if the order in the cgitrc file should
+       be preserved. Default value: "1". See also: section,
+       case-sensitive-sort, repository-sort.
 
 section-from-path::
        A number which, if specified before scan-path, specifies how many
@@ -394,6 +391,7 @@ virtual-root::
        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.
 
+
 REPOSITORY SETTINGS
 -------------------
 repo.about-filter::