From: Nick Kew <niq@apache.org>
Date: Mon, 31 Mar 2008 13:49:56 +0000 (+0000)
Subject: Add upgrading section to mod_filter docs.
X-Git-Tag: 2.3.0~835
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=13a49c46af2d2199c0a32af05efc005ca26cf9d4;p=apache

Add upgrading section to mod_filter docs.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@642992 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/mod_filter.xml b/docs/manual/mod/mod_filter.xml
index 7d373a4890..1eed15420d 100644
--- a/docs/manual/mod/mod_filter.xml
+++ b/docs/manual/mod/mod_filter.xml
@@ -128,6 +128,23 @@
     beginning or end of the chain, remove a filter, or clear the chain.</dd>
 </dl>
 </section>
+<section id="upgrade"><title>Upgrading from HTTPD 2.2 Configuration</title>
+    <p>The <directive module="mod_filter">FilterProvider</directive>
+    directive has changed from HTTPD 2.2: the <var>match</var> and
+    <var>dispatch</var> arguments are replaced with a single but
+    more versatile <var>expression</var>.  In general, you can convert
+    a match/dispatch pair to the two sides of an expression, using
+    something like:</p>
+    <example>"dispatch = match"</example>
+    <p>The Request headers, Response headers and Environment variables
+    are now interpreted from syntax <var>$req{foo}</var>,
+    <var>$resp{foo}</var> and <var>$env{foo}</var> respectively.
+    The variables <var>$handler</var> and <var>$Content-Type</var>
+    are also supported.</p>
+    <p>Note that the match no longer supports integer comparisons
+    or substring matches.  The latter can be replaced by regular
+    expression matches.</p>
+</section>
 
 <section id="examples"><title>Examples</title>
     <dl>