Return-Path: 
 <cvs-return-38180-apmail-httpd-cvs-archive=httpd.apache.org@httpd.apache.org>
Delivered-To: apmail-httpd-cvs-archive@www.apache.org
Received: (qmail 39105 invoked from network); 22 Feb 2011 23:18:12 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3)
  by minotaur.apache.org with SMTP; 22 Feb 2011 23:18:12 -0000
Received: (qmail 78173 invoked by uid 500); 22 Feb 2011 23:18:12 -0000
Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org
Received: (qmail 78016 invoked by uid 500); 22 Feb 2011 23:18:11 -0000
Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@httpd.apache.org
list-help: <mailto:cvs-help@httpd.apache.org>
list-unsubscribe: <mailto:cvs-unsubscribe@httpd.apache.org>
List-Post: <mailto:cvs@httpd.apache.org>
List-Id: <cvs.httpd.apache.org>
Delivered-To: mailing list cvs@httpd.apache.org
Received: (qmail 78008 invoked by uid 99); 22 Feb 2011 23:18:11 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 22 Feb 2011 23:18:11 +0000
X-ASF-Spam-Status: No, hits=-2000.0 required=5.0
	tests=ALL_TRUSTED
X-Spam-Check-By: apache.org
Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4)
    by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 22 Feb 2011 23:18:10 +0000
Received: by eris.apache.org (Postfix, from userid 65534)
	id 9941B23888D2; Tue, 22 Feb 2011 23:17:50 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Subject: svn commit: r1073543 - in /httpd/httpd/trunk/docs/manual: expr.xml
 mod/mod_authz_core.xml mod/mod_ssl.xml
Date: Tue, 22 Feb 2011 23:17:50 -0000
To: cvs@httpd.apache.org
From: sf@apache.org
X-Mailer: svnmailer-1.0.8
Message-Id: <20110222231750.9941B23888D2@eris.apache.org>

Author: sf
Date: Tue Feb 22 23:17:50 2011
New Revision: 1073543

URL: http://svn.apache.org/viewvc?rev=1073543&view=rev
Log:
Add some links and bits to the ap_expr docs

Modified:
    httpd/httpd/trunk/docs/manual/expr.xml
    httpd/httpd/trunk/docs/manual/mod/mod_authz_core.xml
    httpd/httpd/trunk/docs/manual/mod/mod_ssl.xml

Modified: httpd/httpd/trunk/docs/manual/expr.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/expr.xml?rev=1073543&r1=1073542&r2=1073543&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/expr.xml (original)
+++ httpd/httpd/trunk/docs/manual/expr.xml Tue Feb 22 23:17:50 2011
@@ -31,14 +31,20 @@
         for all configuration directives.
         This document describes the <em>ap_expr</em> expression parser.
     </p>
+    <p>The <em>ap_expr</em> expression is intended to replace most other
+        expression variants in HTTPD. For example, the deprecated
+        <directive module="mod_ssl">SSLRequire</directive> expressions can be
+        replaced by <a href="mod/mod_authz_core.html#reqexpr">Require expr</a>.
+    </p>
   </summary>
 
 <seealso><directive module="core">If</directive></seealso>
-<seealso><module>mod_rewrite</module></seealso>
-<seealso><module>mod_include</module></seealso>
-<seealso><module>mod_setenvif</module></seealso>
-<seealso><directive module="mod_ssl">SSLRequire</directive></seealso>
+<seealso><directive module="mod_rewrite">RewriteCond</directive></seealso>
+<seealso><directive module="mod_setenvif">SetEnvIfExpr</directive></seealso>
 <seealso><directive module="mod_filter">FilterProvider</directive></seealso>
+<seealso><a href="mod/mod_authz_core.html#reqexpr">Require expr</a></seealso>
+<seealso><directive module="mod_ssl">SSLRequire</directive></seealso>
+<seealso><module>mod_include</module></seealso>
 
   <section id="grammar">
     <title>Grammar in Backus–Naur Form notation</title>
@@ -153,7 +159,11 @@ listfunction ::= listfuncname "<strong>(
     <tr><td><code>REQUEST_URI</code></td>
         <td>The URI of the request</td></tr>
     <tr><td><code>REQUEST_FILENAME</code></td>
-        <td></td></tr>
+        <td>The full local filesystem path to the file or script matching the
+            request, if this has already been determined by the server at the
+            time <code>REQUEST_FILENAME</code> is referenced. Otherwise, such
+            as when used in virtual host context, the same value as
+            <code>REQUEST_URI</code> </td></tr>
     <tr><td><code>SCRIPT_FILENAME</code></td>
         <td>Same as <code>REQUEST_FILENAME</code></td></tr>
     <tr><td><code>SCRIPT_USER</code></td>
@@ -161,7 +171,8 @@ listfunction ::= listfuncname "<strong>(
     <tr><td><code>SCRIPT_GROUP</code></td>
         <td>The group name of the group of the script.</td></tr>
     <tr><td><code>PATH_INFO</code></td>
-        <td></td></tr>
+        <td>The trailing path name information, see
+            <directive module="core">AcceptPathInfo</directive></td></tr>
     <tr><td><code>QUERY_STRING</code></td>
         <td>The query string of the current request</td></tr>
     <tr><td><code>IS_SUBREQ</code></td>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_authz_core.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_authz_core.xml?rev=1073543&r1=1073542&r2=1073543&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_authz_core.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_authz_core.xml Tue Feb 22 23:17:50 2011
@@ -240,8 +240,8 @@
         Require expr %{TIME_HOUR} &gt;= 9 &amp; %{TIME_HOUR} &lt;= 17 <br />
     </example>
 
-    <p>TODO: Include a link to a description of the ap_expr syntax, once we have
-        such a description.</p>
+  <p>The syntax is described in the <a href="../expr.html">ap_expr</a>
+  documentation.</p>
 
   </section>
 

Modified: httpd/httpd/trunk/docs/manual/mod/mod_ssl.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_ssl.xml?rev=1073543&r1=1073542&r2=1073543&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_ssl.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_ssl.xml Tue Feb 22 23:17:50 2011
@@ -1343,10 +1343,34 @@ the left-hand-side expression.</p></li>
 </ul>
 </note>
 
+<note><title>SSLRequire is deprecated</title>
+<p><code>SSLRequire</code> is deprecated and should in general be replaced
+by <a href="mod/mod_authz_core.html#reqexpr">Require expr</a>. The so called
+<a href="../expr.html">ap_expr</a> syntax of <code>Require expr</code> is
+a superset of the syntax of <code>SSLRequire</code>, with the following
+exception:</p>
+
+<p>In <code>SSLRequire</code>, the comparison operators <code>&lt;</code>,
+<code>&lt;=</code>, ...  completely equivalent to the operators
+<code>lt</code>, <code>le</code>, ... and work in a somewhat pecular way that
+first compares the length of two strings and then the lexical order.
+On the other hand, <a href="../expr.html">ap_expr</a> has two sets of
+comparison operators: The operators <code>&lt;</code>,
+<code>&lt;=</code>, ... do lexical string comparison, while the operators
+<code>-lt</code>, <code>-le</code>, ... do integer comparison.
+For the latter, there are also aliases without the leading dashes:
+<code>lt</code>, <code>le</code>, ...
+</p>
+
+</note>
+
 </usage>
 <seealso><a href="../env.html">Environment Variables in Apache HTTP Server</a>,
 for additional examples.
 </seealso>
+<seealso><a href="mod/mod_authz_core.html#reqexpr">Require expr</a></seealso>
+<seealso><a href="../expr.html">Generic expression syntax in Apache HTTP Server</a>
+</seealso>
 </directivesynopsis>
 
 <directivesynopsis>