From 00789966605deba45b1798b4a2004ec338821e79 Mon Sep 17 00:00:00 2001
From: Luca Toscano <elukey@apache.org>
Date: Fri, 17 Mar 2017 22:09:21 +0000
Subject: [PATCH] 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
---
 docs/manual/mod/core.xml | 8 ++++++++
 docs/manual/sections.xml | 3 ++-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index ce1b9488617..10d228361d0 100644
--- 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 81ee6e3eeea..ea807e837f4 100644
--- 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>
-- 
2.47.3