[Bug 57584] New: AddHandler etc. documentation "extension" unintuitive

[bu...@apache.org]

https://issues.apache.org/bugzilla/show_bug.cgi?id=57584

            Bug ID: 57584
           Summary: AddHandler etc. documentation "extension" unintuitive
           Product: Apache httpd-2
           Version: 2.5-HEAD
          Hardware: All
                OS: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Documentation
          Assignee: docs@httpd.apache.org
          Reporter: apache@chrispennello.com

The following issue requested that the extension functionality of AddHandler be
changed.
https://issues.apache.org/bugzilla/show_bug.cgi?id=10768
It was closed as invalid due to the definition of "extension" in httpd.  A
filename is interpreted as being able to have _multiple_ extensions.
See
http://httpd.apache.org/docs/2.2/mod/mod_mime.html#multipleext
and
http://httpd.apache.org/docs/current/mod/directive-dict.html
under "extension".

This is a frequent cause of problems when the AddHandler etc. directives are
used.  I would like to suggest a couple possible remedies to assist users in
more quickly understanding httpd's behavior.

1. Don't use the word "extension" in the AddHandler etc. documentation. 
Instead, use a word like "substring", which is more accurate, and also more
intuitively in line with readers' expectations.
2. Alternatively, add a brief note in the directive documentation mentioning
the unusual definition of extension used in httpd, and link to further details.

I would also like to suggest that the section describing files with multiple
extensions, at
http://httpd.apache.org/docs/2.2/mod/mod_mime.html#multipleext
include a note about the suggested solution with FilesMatch.  It could be
helpful to note that that example will match (potentially unexpectedly) the
hidden file ".cgi".

-- 
You are receiving this mail because:
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org