[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

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

[bu...@apache.org]

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

Rich Bowen <rb...@apache.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|---                         |FIXED

--- Comment #1 from Rich Bowen <rb...@apache.org> ---
Addressed 4 of the 5 reported issues (point 1 regarding "override"
terminology was intentionally left as-is — "override" is the
established term for what htaccess files do - they override the base server
configuration - and we're very consistent with that term, so I'm not inclined
to change it based on this ticket.

2. Simplified the AllowOverride default to just "AllowOverride None"
   — removed the 2.3.8 historical reference.

3. Added a sentence clarifying that the effective set of permitted
   directives is the union of AllowOverride and AllowOverrideList.

4. Fixed the AllowOverrideList syntax line — "directive-type" was a
   copy-paste error; corrected to "directive".

5. Added a paragraph noting that certain directives (the "All"
   override class) are always permitted in .htaccess whenever the
   override mechanism is enabled, with a link to the override class
   index.

Patched in r1933685 (trunk), r1933686 (2.4).

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