From: Eric Covener <covener@apache.org>
Date: Fri, 5 Dec 2014 13:41:05 +0000 (+0000)
Subject: add some hints about using expressions in mod_headers
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ca208b8a01b892f3caeea6c5998617e1dc66dd8d;p=thirdparty%2Fapache%2Fhttpd.git

add some hints about using expressions in mod_headers



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

diff --git a/docs/manual/mod/mod_headers.xml b/docs/manual/mod/mod_headers.xml
index 2729a412b46..7979bab95cb 100644
--- a/docs/manual/mod/mod_headers.xml
+++ b/docs/manual/mod/mod_headers.xml
@@ -503,6 +503,25 @@ available in 2.4.10 and later</compatibility>
       more efficient than <code>%s</code>.</p>
     </note>
 
+    <note><title>Note on expression values</title>
+    <p> When the value parameter uses the <a href="../expr.html">ap_expr</a>
+    parser, some expression syntax will differ from examples that evaluate
+    <em>boolean</em> expressions such as &lt;If&gt;:
+    <ul>
+      <li>The starting point of the grammar is 'string' rather than 'expr'.</li>
+      <li>Function calls use the %{funcname:arg} syntax rather than 
+          funcname(arg).</li>
+      <li>Multi-argument functions are not currently accessible from this
+          starting point</li>
+      <li>Quote the entire parameter, such as 
+          <highlight language="config">
+        Header set foo-checksum "expr=%{md5:foo}"
+          </highlight>
+       </li>
+                   
+    </ul>
+    </p></note>
+
     <p>For <code>edit</code> there is both a <var>value</var> argument
     which is a <glossary ref="regex">regular expression</glossary>,
     and an additional <var>replacement</var> string. As of version 2.4.7