From: Rich Bowen Date: Fri, 29 Oct 2010 13:30:20 +0000 (+0000) Subject: Makes the intro paragraph a little less jargon-y, in response to X-Git-Tag: 2.3.9~209 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=8ca8c78c41f6aae86138146b5412ef229023d83c;p=apache Makes the intro paragraph a little less jargon-y, in response to https://issues.apache.org/bugzilla/show_bug.cgi?id=49298 git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1028730 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/rewrite/index.xml b/docs/manual/rewrite/index.xml index 1bf257184b..26177e200b 100644 --- a/docs/manual/rewrite/index.xml +++ b/docs/manual/rewrite/index.xml @@ -27,15 +27,18 @@ -

mod_rewrite uses a rule-based rewriting engine (based on a - regular-expression parser) to rewrite requested URLs on the - fly. It supports an unlimited number of rules and an +

mod_rewrite provides a way to modify incoming + URL requests, dynamically, based on regular + expression rules. This allows you to map arbitrary URLs onto + your internal URL structure in any way you like.

+ +

It supports an unlimited number of rules and an unlimited number of attached rule conditions for each rule to provide a really flexible and powerful URL manipulation mechanism. The URL manipulations can depend on various tests: server variables, environment variables, HTTP - headers, time stamps external database lookups, and various other - external processes or handlers, can be used to achieve granular URL + headers, time stamps, external database lookups, and various other + external programs or handlers, can be used to achieve granular URL matching.

Rewrite rules can operate on the full URLs, including the path-info @@ -46,7 +49,8 @@ type="section" module="core">Directory blocks). The rewritten result can lead to further rules, internal sub-processing, external request redirection, or proxy - passthrough.

+ passthrough, depending on what flags you + attach to the rules.

Since mod_rewrite is so powerful, it can indeed be rather complex. This document supplements the