httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [Bug 57584] New: AddHandler etc. documentation "extension" unintuitive
Date Fri, 13 Feb 2015 17:52:14 GMT

            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

The following issue requested that the extension functionality of AddHandler be
It was closed as invalid due to the definition of "extension" in httpd.  A
filename is interpreted as being able to have _multiple_ extensions.
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
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:
For additional commands, e-mail:

View raw message