mod_autoindex/6796: Description of ReadmeName and HeaderName inadequate

[Jerra Pierce <be...@mit.edu>]

>Number:         6796
>Category:       mod_autoindex
>Synopsis:       Description of ReadmeName and HeaderName inadequate
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    apache
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   apache
>Arrival-Date:   Sat Nov 04 16:50:00 PST 2000
>Closed-Date:
>Last-Modified:
>Originator:     belg4mit@mit.edu
>Release:        1.3.9-to date
>Organization:
apache
>Environment:
Redhat 6.1
apache 1.3.11
>Description:
If you grep through your bug databse under mod_autoindex for readme and header,
and also under mod_dir it should become apparent that many people
have issues getting these features to work.

The documentation only mentions MultiViews in passing,
it basically says that if enabled then autoindex
will look for something like HEADER.en.html, etc...

It does not say, that if you DO NOT do +MultiViews these WILL NOT work.
(I just tracked this down in the bug databse, was checking to see if
it was HEADER's were fixed in 1.3.14).

Further, it does not tell you that the inclusion of text/plain documents
will not occur without MuliViews. And it implies that

HeaderName HEADER

means apache will loook for:

HEADER.*.html 9or however mulitviews names things, I've never needed to use, until now)
HEADER.html
HEADER

Well... the only way I was unable to get a text/plain document
was to name it HEADER.txt, *not* HEADER
>How-To-Repeat:

>Fix:
Idealy, nix the depenndency on MultViews
Otherwise, document the hell out of it
>Release-Note:
>Audit-Trail:
>Unformatted:
 [In order for any reply to be added to the PR database, you need]
 [to include <ap...@Apache.Org> in the Cc line and make sure the]
 [subject line starts with the report component and number, with ]
 [or without any 'Re:' prefixes (such as "general/1098:" or      ]
 ["Re: general/1098:").  If the subject doesn't match this       ]
 [pattern, your message will be misfiled and ignored.  The       ]
 ["apbugs" address is not added to the Cc line of messages from  ]
 [the database automatically because of the potential for mail   ]
 [loops.  If you do not include this Cc, your reply may be ig-   ]
 [nored unless you are responding to an explicit request from a  ]
 [developer.  Reply only with text; DO NOT SEND ATTACHMENTS!     ]