From 8ca8c78c41f6aae86138146b5412ef229023d83c Mon Sep 17 00:00:00 2001
From: Rich Bowen <rbowen@apache.org>
Date: Fri, 29 Oct 2010 13:30:20 +0000
Subject: [PATCH] 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
---
 docs/manual/rewrite/index.xml | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

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 @@
 
 <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
-- 
2.40.0