* mod/mod_authz_host.xml:

note negation of env-var (env=!)

* howto/access.xml
add an example of env=! (revert r665707)

PR: 44901

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

diff --git a/docs/manual/howto/access.xml b/docs/manual/howto/access.xml
index 07657cd4767825c17d0233215549ae8eca2a9ebe..ea81c3cb581cb3626d909451208be2226cefee88 100644 (file)
--- a/docs/manual/howto/access.xml
+++ b/docs/manual/howto/access.xml
@@ -139,6 +139,14 @@ discussed in this document include <module>mod_setenvif</module> and
     this variable is set. This blocks that particular user agent from
     the site.
     </p>
+
+    <p>An environment variable test can be negated using the <code>=!</code>
+    syntax:</p>
+
+    <example><p>
+    Allow from env=!GoAway
+    </p></example>
+
 </section>
 
 <section id="rewrite"><title>Access control with mod_rewrite</title>

diff --git a/docs/manual/mod/mod_authz_host.xml b/docs/manual/mod/mod_authz_host.xml
index 0a0da91564aea0800aca9925ae04579d96134511..f451495c7c71f92209802518c003785aec7e7d46 100644 (file)
--- a/docs/manual/mod/mod_authz_host.xml
+++ b/docs/manual/mod/mod_authz_host.xml
@@ -69,8 +69,8 @@ address)</description>
 <name>Allow</name>
 <description>Controls which hosts can access an area of the
 server</description>
-<syntax> Allow from all|<var>host</var>|env=<var>env-variable</var>
-[<var>host</var>|env=<var>env-variable</var>] ...</syntax>
+<syntax> Allow from all|<var>host</var>|env=[!]<var>env-variable</var>
+[<var>host</var>|env=[!]<var>env-variable</var>] ...</syntax>
 <contextlist><context>directory</context><context>.htaccess</context>
 </contextlist>
 <override>Limit</override>
@@ -168,7 +168,10 @@ server</description>
     href="../env.html">environment variable</a>. When <code>Allow from
     env=<var>env-variable</var></code> is specified, then the request is
     allowed access if the environment variable <var>env-variable</var>
-    exists. The server provides the ability to set environment
+    exists. When <code>Allow from env=!<var>env-variable</var></code> is 
+    specified, then the request is allowed access if the environment 
+    variable <var>env-variable</var> doesn't exist.
+    The server provides the ability to set environment
     variables in a flexible way based on characteristics of the client
     request using the directives provided by
     <module>mod_setenvif</module>. Therefore, this directive can be
@@ -197,8 +200,8 @@ server</description>
 <name>Deny</name>
 <description>Controls which hosts are denied access to the
 server</description>
-<syntax> Deny from all|<var>host</var>|env=<var>env-variable</var>
-[<var>host</var>|env=<var>env-variable</var>] ...</syntax>
+<syntax> Deny from all|<var>host</var>|env=[!]<var>env-variable</var>
+[<var>host</var>|env=[!]<var>env-variable</var>] ...</syntax>
 <contextlist><context>directory</context><context>.htaccess</context>
 </contextlist>
 <override>Limit</override>