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