From: Eric Covener <covener@apache.org>
Date: Fri, 5 Dec 2014 13:41:31 +0000 (+0000)
Subject: Merge r1643277 from trunk:
X-Git-Tag: 2.4.11~110
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=25fad973b0f673e9d9cb77bd4635e49dd2954a48;p=apache

Merge r1643277 from trunk:

add some hints about using expressions in mod_headers




git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1643278 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/mod_headers.xml b/docs/manual/mod/mod_headers.xml
index 2729a412b4..7979bab95c 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