Bug 65242

Summary:	DirectoryCheckHandler ambiguous
Product:	Apache httpd-2	Reporter:	Christoph Anton Mitterer <calestyo>
Component:	Documentation	Assignee:	HTTP Server Documentation List <docs>
Status:	NEW ---
Severity:	major
Priority:	P2
Version:	2.4.57
Target Milestone:	---
Hardware:	All
OS:	All

Description Christoph Anton Mitterer 2021-04-14 21:17:43 UTC

Hi.

The documentation on DirectoryCheckHandler doesn't really tell which of "On" or "Off" is the one, that enables/disables mod_dir's index/trailing-slash in the case another handler has been set.

- The default is described as "Off", while pre-2.4 is described as having effectively had "On"

- It also says: "In releases prior to 2.4, this module did not take any action if any other handler was configured for a URL." ... which would make one assume, that:
On  = do not index/trailing-slash if another handler is set
Off = do     index/trailing-slash if another handler is set

However, in the next sentence it says the opposite:
"This allows directory indexes to be served even when a SetHandler directive is specified for an entire directory"


It should be clearly explained, what On/Off do... which one will lead mod_dir provide index/trailing-slash if another handler is set, and which one will not.


Cheers,
Chris.

Comment 1 Bachsau 2021-09-05 15:17:33 UTC

I also can't tell what this directive really does. Documentation says "In releases prior to 2.4, this module did not take any action if any other handler was configured for a URL." To me, this means that the module checked for other handlers and refrained from adding a slash or loading an index document, if it found something.

Comment 2 Bachsau 2023-10-19 11:56:15 UTC

Since noone seems to care, I did some tests.

If DirectoryCheckHandler is "On", mod_dir steps back in case another handler is configured. If it is "Off", processing is done anyway.