From: Fredrik Tolf <fredrik@dolda2000.com>
Date: Thu, 27 Jul 2023 14:55:45 +0000 (+0200)
Subject: dirplex: Document the `dot-allow' directive.
X-Git-Url: http://www.dolda2000.com/gitweb/?p=ashd.git;a=commitdiff_plain;h=a19b6c773491e5bce11aa27c45d19d3cf9eee006

dirplex: Document the `dot-allow' directive.
---

diff --git a/doc/dirplex.doc b/doc/dirplex.doc
index 8a0184f..c18ca14 100644
--- a/doc/dirplex.doc
+++ b/doc/dirplex.doc
@@ -148,6 +148,19 @@ The following configuration directives are recognized:
 	may be given to turn off index file searching completely. The
 	*index-file* directive accepts no follow-up lines.
 
+*dot-allow* ['PATTERN'...]::
+
+	As described under 404 RESPONSES, a path element beginning
+	with a dot character is normally rejected by default, but the
+	*dot-allow* directive allows certain dot-files or -directories
+	to be selectively allowed. Each 'PATTERN' is an ordinary glob
+	pattern, the matching of which allows access to a given path
+	element. When checking for access to dot-files or
+	-directories, only the *dot-allow* directive "closest" to the
+	file under consideration is used. It should be noted that the
+	default configuration file for *dirplex* contains a
+	*dot-allow* directive for the `.well-known` directory.
+
 *child* 'NAME'::
 
 	Declares a named, persistent request handler (see *ashd*(7)