accesslog: Add %p and %P format options.
[ashd.git] / doc / dirplex.doc
index e2769d7..c18ca14 100644 (file)
@@ -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
 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,
 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.
 
        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)
 *child* 'NAME'::
 
        Declares a named, persistent request handler (see *ashd*(7)
@@ -295,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 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.
  * 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.