Add a warning in the docs about nested <If> blocks

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

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index ce1b9488617c0fad0bb1dd16a12afd652855336a..10d228361d0d0898a2bfa590905aea946bdf48bb 100644 (file)
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -2214,6 +2214,14 @@ satisfied by a request at runtime</description>
     <p>Only directives that support the <a href="directive-dict.html#Context"
     >directory context</a> can be used within this configuration section.</p>
 
+    <note><title>Not a scripting language</title>
+    The name of this directive is very familiar to programmers and admins 
+    but it should not be confused with its counterpart in scripting languages.
+    For example, the current implementation does not contemplate the possibility
+    of having a <directive type="section">If</directive> section inside another
+    one (the inner <directive type="section">If</directive> will be ignored).
+    </note>
+
     <note type="warning">
     Certain variables, such as <code>CONTENT_TYPE</code> and other
     response headers, are set after &lt;If&gt; conditions have already

diff --git a/docs/manual/sections.xml b/docs/manual/sections.xml
index 81ee6e3eeea6ec7028a67cc6d2eb2770b0bc0951..ea807e837f43476f478ae451fd6d6c1dedb79d07 100644 (file)
--- a/docs/manual/sections.xml
+++ b/docs/manual/sections.xml
@@ -381,7 +381,8 @@ inside <directive type="section" module="core">Directory</directive>.  On
 the other hand, <directive type="section" module="core">If</directive> can
 be used inside <directive type="section" module="core">Directory</directive>,
 <directive type="section" module="core">Location</directive>, and <directive
-type="section" module="core">Files</directive> sections. The regex
+type="section" module="core">Files</directive> sections (but not inside another
+<directive type="section" module="core">If</directive>). The regex
 counterparts of the named section behave identically.</p>
 
 <p>Nested sections are merged after non-nested sections of the same type.</p>