httpd-bugs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject DO NOT REPLY [Bug 49298] New: mod_rewrite is quite useful but documentation hides it
Date Sat, 15 May 2010 20:44:02 GMT

           Summary: mod_rewrite is quite useful but documentation hides it
           Product: Apache httpd-2
           Version: 2.3-HEAD
          Platform: Macintosh
            Status: NEW
          Severity: trivial
          Priority: P2
         Component: Documentation

I tried to enter this on the Documentation Wiki but the pages where I thought
the information maybe should be are immutable.

In the documentation of mod_rewrite,

the first sentence in the summary is:

<quote>This module uses a rule-based rewriting engine (based on a
regular-expression parser) to rewrite requested URLs on the fly.</quote> ...

That's fine if you know what a "rewriting engine" is, or at least what a
"rewrite" is in Apache's context.  But I still can't find these definitions in
.  To me, "writing" or "rewriting" is something that you do to a hard disk, and
I had no idea that this was what I wanted until I got help from some of the
helpful people in the forums at  I would have been up and
running much faster if that first sentence were replaced with these:

<quote>This module allows you to set *URL Rewrites* on a site.  A *URL Rewrite*
is similar to a *URL Redirect*, in that it intercepts requests prior to
processing by the server.  However, instead of sending a response back to the
client with HTTP Status 301 or 302 and the new URL, it simply overwrites
(rewrites) the requested URL with the new URL and then forwards the *rewritten*
request to the server for processing.  The Client is not given any indication
that this happened because it's all done internally.  Therefore, for example,
if the Client is a web browser, the address bar will indicate the
originally-requested URL when a response is received from the resource
specified by the rewritten URL.

URL Rewrites are implemented by regular expression (regex) search and replace
rules which the webmaster adds to the site's .htaccess file.</quote> ...

Configure bugmail:
------- You are receiving this mail because: -------
You are the assignee for the bug.

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message