https://bz.apache.org/bugzilla/show_bug.cgi?id=65056
Bug ID: 65056
Summary: some ideas how to better describe the merging of
sections
Product: Apache httpd-2
Version: 2.5-HEAD
Hardware: All
OS: All
Status: NEW
Severity: enhancement
Priority: P2
Component: Documentation
Assignee: docs@httpd.apache.org
Reporter: calestyo@scientia.net
Target Milestone: ---
Hey.
In en/sections.html "How the sections are merged" section it's very nicely
described how sections are merged.
I would however add the following (if true ;-) ):
1) For "* <Directory> (group 1 above) is processed in the order shortest
directory component to longest." I would add something like "(regardless of
their order in the configuration)" ... since this is the main point here that
makes it different from the other sections.
2) A bit below it explains:
"If multiple <Directory> sections apply to the same directory they are
processed in the configuration file order."
This should perhaps be expanded to (nearly) all the other section-directives,
e.g. with a 2nd sentence like:
"This is also the case when two or more of <DirectoryMatch>, <File>,
<FileMatch>, <Location>, <LocationMatch> apply to the very same resource."
And I guess for <If> as well?
3) Similarly than (2), it should perhaps mention that this is NOT ALWAYS the
case for <VirtualHost> sections, i.e. if two or more <VirtualHost> have the
very same literal address:port (or address:*, *:port or *:*) AND none of them
can be chosen by name-based vhosting (via. differing ServerName/ServerAlias)
ONLY the first of them appearing in the configuration will be taken.
I know this is already explained in more detail in the vhosting guides, but
since this (en/sections.html "How the sections are merged") is the
documentation part serving as a cheat sheet for how merging is done, it should
perhaps not miss from there.
HTH,
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 ID: 65056
Summary: some ideas how to better describe the merging of
sections
Product: Apache httpd-2
Version: 2.5-HEAD
Hardware: All
OS: All
Status: NEW
Severity: enhancement
Priority: P2
Component: Documentation
Assignee: docs@httpd.apache.org
Reporter: calestyo@scientia.net
Target Milestone: ---
Hey.
In en/sections.html "How the sections are merged" section it's very nicely
described how sections are merged.
I would however add the following (if true ;-) ):
1) For "* <Directory> (group 1 above) is processed in the order shortest
directory component to longest." I would add something like "(regardless of
their order in the configuration)" ... since this is the main point here that
makes it different from the other sections.
2) A bit below it explains:
"If multiple <Directory> sections apply to the same directory they are
processed in the configuration file order."
This should perhaps be expanded to (nearly) all the other section-directives,
e.g. with a 2nd sentence like:
"This is also the case when two or more of <DirectoryMatch>, <File>,
<FileMatch>, <Location>, <LocationMatch> apply to the very same resource."
And I guess for <If> as well?
3) Similarly than (2), it should perhaps mention that this is NOT ALWAYS the
case for <VirtualHost> sections, i.e. if two or more <VirtualHost> have the
very same literal address:port (or address:*, *:port or *:*) AND none of them
can be chosen by name-based vhosting (via. differing ServerName/ServerAlias)
ONLY the first of them appearing in the configuration will be taken.
I know this is already explained in more detail in the vhosting guides, but
since this (en/sections.html "How the sections are merged") is the
documentation part serving as a cheat sheet for how merging is done, it should
perhaps not miss from there.
HTH,
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