etc: Add environment option to run init.d/ashd silently.

[ashd.git] / doc / dirplex.doc

diff --git a/doc/dirplex.doc b/doc/dirplex.doc
index 7080bc2..c18ca14 100644 (file)
--- a/doc/dirplex.doc
+++ b/doc/dirplex.doc
@@ -71,7 +71,7 @@ element. If there is such a file, it is considered the result of the
 mapping.
 
 If the result of the mapping procedure is a directory, it is checked
-for the presence of a filed named by the *index-file* configuration
+for the presence of a file named by the *index-file* configuration
 directive (see CONFIGURATION below). If there is such a file, it is
 considered the final result instead of the directory itself. If the
 index file name contains no dots and there is no exact match, then,
@@ -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)
@@ -193,9 +206,10 @@ The following configuration directives are recognized:
        be a named request handler specified either in the same
        `.htrc` file or elsewhere. The *capture* directive accepts no
        follow-up lines. Note that the `X-Ash-File` header is not
-       added to requests passed via *capture* directives.  If 'FLAGS'
-       contain the character `R`, this *capture* directive will be
-       ignored if it is in the root directory that *dirplex* serves.
+       added to requests passed via *capture* directives. Normally,
+       *capture* directives will be ignored if they appear in the
+       root directory that *dirplex* serves, but not if 'FLAGS'
+       contain the character `D`.
 
 MATCHING
 --------
@@ -294,7 +308,7 @@ A HTTP 404 response is sent to the client if
  * A path element is encountered during mapping which, after URL
    unescaping, either begins with a dot or contains slashes;
  * The mapping procedure finds a file which is neither a directory nor
-   a regular file (or a symbolic link to any of the same);
+   a regular file (nor a symbolic link to any of the same);
  * An empty, non-final path element is encountered during mapping; or
  * The mapping procedure results in a file which is not matched by any
    *match* stanza.