From bff2f0553cd217759088f912f9eaa1d05bd98aac Mon Sep 17 00:00:00 2001 From: Bryce Kwon Date: Thu, 5 Nov 2026 22:19:45 -1000 Subject: State which section a scanned repository takes add_repo reads the git config before it applies section-from-path, and the repository's cgitrc after both. A repository too shallow for the count takes no section from its path and keeps its gitweb.category. --- MANUAL.txt | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/MANUAL.txt b/MANUAL.txt index 214bd36..e169453 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -223,9 +223,10 @@ enable-git-config:: gitweb.category, and gitweb.description map to the cgit keys repo.owner, repo.section, and repo.desc respectively. All git config keys that begin with "cgit." are mapped to the corresponding "repo." key in cgit, - subject to "trust-scan-config" the way a repository's cgitrc is. Default - value: "0". See also: "scan-path", "section-from-path", - "trust-scan-config". + subject to "trust-scan-config" the way a repository's cgitrc is. A + section that "section-from-path" takes from the path overrides + gitweb.category and cgit.section. Default value: "0". See also: + "scan-path", "section-from-path", "trust-scan-config". enable-gitmodules-links:: Flag which, when set to "1", makes submodule listings derive a link from @@ -544,7 +545,10 @@ section-from-path:: elements from each repository path to use as a default section name. If negative, cgit instead drops that many path elements from the end, the repository directory included, so "-1" uses every directory above the - repository. Default value: "0". + repository. A section taken from the path overrides one that + "enable-git-config" reads from gitweb.category or cgit.section, and a + section line in the repository's own cgitrc overrides both. Default + value: "0". See also: "enable-git-config". section-sort:: Flag which, when set to "1", sorts the sections on the repository -- cgit 2.12.1