From: Daniel Gruno <humbedooh@apache.org>
Date: Fri, 30 Mar 2012 08:46:16 +0000 (+0000)
Subject: Add some examples of how expressions might be used.
X-Git-Tag: 2.5.0-alpha~7293
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=52408a0fef109c74044ba35898483cc5cd4cc7f3;p=thirdparty%2Fapache%2Fhttpd.git

Add some examples of how expressions might be used.
This should probably be extended at some point.

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

diff --git a/docs/manual/expr.xml b/docs/manual/expr.xml
index bdb3e687bd3..8d3165d47b4 100644
--- a/docs/manual/expr.xml
+++ b/docs/manual/expr.xml
@@ -471,6 +471,33 @@ listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>"
 
 </section>
 
+<section id="examples">
+    
+	<title>Example expressions</title>
+	<p>The following examples show how expressions might be used to evaluate requests:</p>
+	<!-- This section should probably be extended with more, useful examples -->
+	<example>
+	# Compare the host name to example.com and redirect to www.example.com if it matches<br />
+	&lt;If "%{HTTP_HOST} == 'example.com'"&gt;<br />
+	<indent>
+		Redirect permanent / http://www.example.com<br />
+	</indent>
+	&lt;/If&gt;<br /><br />
+	# Force text/plain if requesting a file with the query string contains 'forcetext'<br />
+	&lt;If "%{QUERY_STRING} =~ /forcetext/"&gt;<br />
+	<indent>
+		ForceType text/plain<br />
+	</indent>
+	&lt;/If&gt;<br /><br />
+	# Only allow access to this content during business hours<br />
+	&lt;Directory "/foo/bar/business"&gt;<br />
+	<indent>
+		Require expr %{TIME_HOUR} &gt;= 9 &amp;&amp; %{TIME_HOUR} &lt;= 17 <br />
+	</indent>
+	&lt;/Directory&gt;	
+	</example>
+</section>
+
 <section id="other">
     <title>Other</title>