[Bug 65054] New: issues with the documentation of AllowOverride and AllowOverrideList

[bu...@apache.org]

https://bz.apache.org/bugzilla/show_bug.cgi?id=65054

            Bug ID: 65054
           Summary: issues with the documentation of AllowOverride and
                    AllowOverrideList
           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: calestyo@scientia.net
  Target Milestone: ---

Hey.

In mod/core.html with the documentation for AllowOverride and AllowOverrideList
there are IMO a number of issues.


1) Both use the phrase "[...] it needs to know which directives declared in
that file can override earlier configuration directives."

Strictly speaking though, this is wrong, as these directives cannot only
*override* earlier configuration directives (which kinda implies they'd need to
have been set before), but generally *set* them (whether or not they were used
outside of the .htaccess).


2) In the Apache 2.4 documentation it probably makes no sense (and is just
confusing) to mentioned the defaults of earlier versions, i.e.:
"AllowOverride None (2.3.9 and later), AllowOverride All (2.3.8 and earlier)"


3) While it becomes clear from mod/overrides.html (and one can perhaps blindly
assume this behaviour), neither AllowOverride nor AllowOverrideList mention,
that they conjunction of both is the effective set of allowed directives.


4) The syntax field of AllowOverrideList contains a probable copy&paste error:
"AllowOverrideList None|directive [directive-type] ..."
should likely read:
"AllowOverrideList None|directive [directive] ..."


5) Neither AllowOverride nor AllowOverrideList mention, that there is the
"All"-group of directives (as explained in mod/overrides.html), i.e. directives
which are always allowed as soon as the overrides-mechanism (.htaccess) is
enabled with at least one directive or group.
I think this is however rather important to know.


Cheers,
Chris.

-- 
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

[Bug 65054] issues with the documentation of AllowOverride and AllowOverrideList

[bu...@apache.org]

https://bz.apache.org/bugzilla/show_bug.cgi?id=65054

benjamin.demarteau@liege.be changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
            Version|2.5-HEAD                    |2.4.37

-- 
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