From 6d2acb4ae539b828ac99aaff6bc26d3538a834ea Mon Sep 17 00:00:00 2001
From: Bryce Kwon <bryce@brycekwon.com>
Date: Tue, 3 Nov 2026 20:58:27 -1000
Subject: Say which settings must precede scan-path

---
 MANUAL.txt | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

(limited to 'MANUAL.txt')

diff --git a/MANUAL.txt b/MANUAL.txt
index 6f34e4e..451dbcc 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -71,7 +71,8 @@ cache-max-slot-size::
 	limit. Default value: "65536" (64 MB). See also: "The cache".
 
 cache-root::
-	Path used to store the cgit cache entries. Default value:
+	Path used to store the cgit cache entries. A scan-path keeps its cached
+	result under the value defined prior to it. Default value:
 	"/var/cache/cgit". See also: "Macro expansion" and the note on ownership
 	under "The cache".
 
@@ -84,7 +85,8 @@ cache-scan-ttl::
 
 cache-size::
 	The maximum number of entries in the cgit cache. When set to "0",
-	caching is disabled. Default value: "0". See also: "The cache".
+	caching is disabled. A scan-path caches its result only when this is
+	defined prior to it. Default value: "0". See also: "The cache".
 
 cache-snapshot-ttl::
 	Number which specifies the time-to-live, in minutes, for the cached
@@ -580,8 +582,9 @@ trust-scan-config::
 	the filters, head-content, module-link, module-link.<path>, logo,
 	logo-link, clone-url, enable-html-serving and a readme that names a file
 	rather than a git object. Settings in the main cgitrc, the
-	"repo.<option>" form included, never need this. Default value: "0". See
-	also: "scan-path", "enable-git-config".
+	"repo.<option>" form included, never need this. This must be defined
+	prior to scan-path. Default value: "0". See also: "scan-path",
+	"enable-git-config".
 
 virtual-root::
 	Url used as root for all cgit links, such as "/cgit/" for links like
-- 
cgit 2.12.1