You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@httpd.apache.org by bu...@apache.org on 2026/05/20 04:32:02 UTC
[Bug 70059] New: mod_rewrite reference summary: Unclear reference to “server variables”
https://bz.apache.org/bugzilla/show_bug.cgi?id=70059
Bug ID: 70059
Summary: mod_rewrite reference summary: Unclear reference to
“server variables”
Product: Apache httpd-2
Version: 2.5-HEAD
Hardware: All
URL: https://httpd.apache.org/docs/trunk/en/mod/mod_rewrite
.html
OS: All
Status: UNCONFIRMED
Severity: trivial
Priority: P4
Component: Documentation
Assignee: docs@httpd.apache.org
Reporter: chealer@gmail.com
Target Milestone: ---
The Summary of the mod_rewrite reference contains:
> Each rule can have an unlimited number of attached rule conditions, to allow you to rewrite URLs based on server variables, environment variables, cookies, HTTP headers, or timestamps.
>
It is unclear what “server variables” means in that sentence. The page has
another occurrence, in the RewriteCond Directive section, this time defining
“Server-Variables”. According to ticket #70042 comment 4, “server variables”
and “Server-Variables” (capitalized and hyphenated) mean the same. The section
also uses “server-variables” (uncapitalized and hyphenated).
By the way, as httpd uses “environment variables” in a particular sense, a link
to https://httpd.apache.org/docs/trunk/en/env.html would clarify.
🅭🄍: https://www.philippecloutier.com/Common+infrastructure+licensing#its
--
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 70059] mod_rewrite reference summary: Unclear reference to “server variables”
Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70059
Rich Bowen <rb...@apache.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
Resolution|--- |FIXED
Status|NEEDINFO |RESOLVED
--- Comment #4 from Rich Bowen <rb...@apache.org> ---
Fixed in r1934605 (2.4) and r1934606 (trunk).
Normalized all occurrences of "Server-Variables" and "server-variables" to
unhyphenated "server variables" in mod/mod_rewrite.xml and rewrite/flags.xml.
No RFC precedent exists for the hyphenated form (RFC 3875 uses "meta-variables"
for the CGI concept).
Also reworked the module summary to clarify that HTTP headers and timestamps
are a subset of server variables rather than separate categories, and linked
the term to its definition in the RewriteCond section.
--
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 70059] mod_rewrite reference summary: Unclear reference to “server variables”
Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70059
--- Comment #3 from Philippe Cloutier <ch...@gmail.com> ---
(In reply to Rich Bowen from comment #2)
> Are you asking for consistent capitalization and hyphenation, or something
> else?
If ticket #70042 comment 4 is right, then consistent spelling would indeed be a
good start. But it leaves considerable confusion. A glossary entry
acknowledging both senses would further help. As for real solutions, 2 options
would be avoiding the term, or linking to the specific sense used.
> I had to look up autohyponym and I'm still unsure what you mean by it here.
To illustrate with a particularly confusing statement, if the above claims are
correct, one can state that “Some Server-Variables (like REMOTE_HOST) are not
server variables.”
By the way, there is already a glossary entry for “Environment Variable”;
linking “environment variables” to it would clarify that part.
--
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 70059] mod_rewrite reference summary: Unclear reference to “server variables”
Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70059
Rich Bowen <rb...@apache.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|UNCONFIRMED |NEEDINFO
Ever confirmed|0 |1
--- Comment #2 from Rich Bowen <rb...@apache.org> ---
Are you asking for consistent capitalization and hyphenation, or something
else?
I had to look up autohyponym and I'm still unsure what you mean by it here.
--
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 70059] mod_rewrite reference summary: Unclear reference to “server variables”
Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70059
Philippe Cloutier <ch...@gmail.com> changed:
What |Removed |Added
----------------------------------------------------------------------------
Severity|trivial |minor
--- Comment #1 from Philippe Cloutier <ch...@gmail.com> ---
I see 2 senses:
1. The narrow sense described in ticket #70042 comment #2. This is the
definition which sounds most natural to me, although I would argue the actual
definition could be a little wider, including variables like SERVER_SOFTWARE.
2. The wider sense defined in the RewriteCond Directive section, which includes
variables like REMOTE_HOST.
#1 applying to a subset of #2, #1 would be a hyponym of #2.
The CGIVar Directive and FallbackResource Directive sections attest #2, which
confirms that httpd uses "server variable" as a autohyponym which I would
consider quite confusing. The risk of confusion is high and pointing to a
definition of at least the intended sense would be a minimum.
--
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 70059] mod_rewrite reference summary: Unclear reference to “server variables”
Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70059
Philippe Cloutier <ch...@gmail.com> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|RESOLVED |VERIFIED
--- Comment #5 from Philippe Cloutier <ch...@gmail.com> ---
Thanks again Rich
(In reply to Philippe Cloutier from comment #1)
> I see 2 senses:
> 1. The narrow sense described in ticket #70042 comment #2. This is the
> definition which sounds most natural to me, although I would argue the
> actual definition could be a little wider, including variables like
> SERVER_SOFTWARE.
Following Rich’s fixes here, I believe this sense does not exist.
--
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