1 file changed, 16 insertions, 13 deletions
diff --git a/custom/cgitrc b/custom/cgitrc
index c661b2f..f88d832 100644
--- a/custom/cgitrc
+++ b/custom/cgitrc
@@ -78,7 +78,7 @@ root-desc=a fast webinterface for the git dscm
 #root-readme=/var/www/htdocs/about.html
 
 # Default value or values for repo.readme. The first existing file wins. Value
-# is one or more [ref]path entries. Default is none.
+# is a [ref:]path entry, and each readme line adds one. Default is none.
 #readme=:README.md
 
 # CSS document urls added to the head of every page. An empty value disables it.
@@ -127,8 +127,9 @@ embedded=0
 # Default is none.
 #virtual-root=/
 
-# Link format string for submodules in directory listings. Value is a printf
-# format string taking path and object id. Default is none.
+# Link format string for submodules in directory listings. Value is a format
+# string whose two %s take the submodule's directory name and commit id.
+# Default is none.
 #module-link=/%s/commit/?id=%s
 
 # Directory scanned for git repositories at parse time. Value is a filesystem
@@ -440,7 +441,7 @@ age-file=info/web/last-modified
 #repo.owner=Jane Doe
 
 # Urls used to clone this repository. Value is space-separated urls that may use
-# macros. Default is none.
+# macros. Default is the global clone-url value.
 #repo.clone-url=https://example.com/example.git git://example.com/example.git
 
 # Default branch for the repository. Falls back to the first sorted branch.
@@ -448,7 +449,7 @@ age-file=info/web/last-modified
 #repo.defbranch=master
 
 # Override the current section name for this repository. Value is a section
-# name. Default is none.
+# name. Default is the global section value.
 #repo.section=main
 
 # Prefix for snapshot filenames instead of the repository basename. Value is a
@@ -460,7 +461,8 @@ age-file=info/web/last-modified
 #repo.head-content=<meta name="example" content="value">
 
 # File shown as the repository About page. A colon-prefixed value uses the head
-# or defbranch. Value is a [ref]path entry. Default is the global readme value.
+# or defbranch. Value is a [ref:]path entry, and each repo.readme line adds one.
+# Default is the global readme value.
 #repo.readme=:README.md
 
 # Per-repository logo image url. Value is a url. Default is the global logo
@@ -471,12 +473,13 @@ age-file=info/web/last-modified
 # logo-link value.
 #repo.logo-link=/
 
-# Per-repository submodule link format string. Value is a printf format string
-# taking path and object id. Default is the global module-link value.
+# Per-repository submodule link format string. Value is a format string whose
+# two %s take the submodule's directory name and commit id. Default is the
+# global module-link value.
 #repo.module-link=/%s/commit/?id=%s
 
-# Submodule link format for a specific submodule path. Value is a printf format
-# string taking an object id. Default is none.
+# Submodule link format for a specific submodule path. Value is a format string
+# whose %s takes the commit id. Default is none.
 #repo.module-link.path/to/sub=https://example.com/sub/commit/?id=%s
 
 # Snapshot formats offered for this repository, restricted by the global mask.
@@ -537,11 +540,11 @@ age-file=info/web/last-modified
 #repo.enable-html-serving=0
 
 # Per-repository branch ref list ordering. Values are name or age. Default is
-# name.
+# the global branch-sort value.
 #repo.branch-sort=name
 
-# Per-repository commit log ordering. Leaving it out uses the git log default.
-# Values are date or topo. Default is none.
+# Per-repository commit log ordering. Values are date or topo. Default is the
+# global commit-sort value.
 #repo.commit-sort=date
 
 # Per-repository maximum statistics period. A value of 0 disables the statistics