X-Git-Url: http://www.dolda2000.com/gitweb/?a=blobdiff_plain;f=doc%2Fdirplex.doc;h=10b76091637620cb80298f41cbf5145c22d61c68;hb=fa88545551d709cdff26b5421bd69ac6b1af7e3b;hp=fce3565953439730bb3b8de7b758fd309328f0ee;hpb=79ad402f4c4756d7bf6129513be9b6784ff41696;p=ashd.git diff --git a/doc/dirplex.doc b/doc/dirplex.doc index fce3565..10b7609 100644 --- a/doc/dirplex.doc +++ b/doc/dirplex.doc @@ -126,7 +126,7 @@ as part of the word. Empty lines are ignored, and lines whose first character after leading whitespace is a hash character (`#`) are treated as comments and ignored. -The follow configuration directives are recognized: +The following configuration directives are recognized: *include* ['FILENAME'...]:: @@ -182,17 +182,19 @@ The follow configuration directives are recognized: pattern-matching procedure and the follow-up lines accepted by this stanza are described below, under MATCHING. -*capture* 'HANDLER':: +*capture* 'HANDLER' ['FLAGS']:: Only meaningful in `.htrc` files. If a *capture* directive is specified, then the URL-to-file mapping procedure as described above is aborted as soon as the directory containing the `.htrc` file is encountered. The request is passed, with any remaining rest string, to the specified 'HANDLER', which must - by a named request handler specified either in the same + 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. + 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. MATCHING -------- @@ -274,7 +276,7 @@ optional directives: *xset* 'HEADER' 'VALUE':: - *xset* does exactly the same thing as *set*, except the + *xset* does exactly the same thing as *set*, except that 'HEADER' is automatically prepended with the `X-Ash-` prefix. The intention is only to make configuration files look nicer in this very common case. @@ -288,7 +290,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; + a regular file (or 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. @@ -313,7 +315,7 @@ fchild send exec sendfile match - filename *.html + filename *.html *.htm xset content-type text/html handler send -------- @@ -350,9 +352,9 @@ match directory The following configuration can be placed in a `.htrc` file in order to dedicate the directory containing that file to some external SCGI script engine. Note that *callscgi*, and therefore the script engine -itself, is started in the directory itself, so that arbitrary code -modules or data files can be put directly in that directory and easily -found. +itself, is started in the same directory, so that arbitrary code +modules or data files can be put directly in that directory and be +easily found. -------- child foo