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: apa...@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-unsubscr...@httpd.apache.org
For additional commands, e-mail: docs-h...@httpd.apache.org
