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 1bf257184b3075eeb7efc36ba62409e99a22c9ae..26177e200ba64b0afcb7c27510e9010765e56e9d 100644 (file)
--- a/docs/manual/rewrite/index.xml
+++ b/docs/manual/rewrite/index.xml
@@ -27,15 +27,18 @@
 
 <summary>
 
-      <p>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
+    <p><module>mod_rewrite</module> provides a way to modify incoming
+    URL requests, dynamically, based on <a href="intro.html#regex">regular 
+    expression</a> rules. This allows you to map arbitrary URLs onto
+    your internal URL structure in any way you like.</p>
+
+      <p>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.</p>
 
       <p>Rewrite rules can operate on the full URLs, including the path-info
@@ -46,7 +49,8 @@
       type="section" module="core">Directory</directive> blocks). The
       rewritten result can lead to further rules, internal
       sub-processing, external request redirection, or proxy
-      passthrough.</p>
+      passthrough, depending on what <a href="flags.html">flags</a> you
+      attach to the rules.</p>
 
       <p>Since mod_rewrite is so powerful, it can indeed be rather
       complex. This document supplements the <a