Merge r1918892 from trunk:

mention quirks, add example, clarify

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

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index 2deb201e5e2a2d29aa266f4089f72d44c69ed883..fc7731b14db88411200e338e799b782fb17c7eb3 100644 (file)
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -5175,7 +5175,7 @@ hostname or IP address</description>
 <name>UNCList</name>
 <description>Controls what UNC host names can be accessed by the server
 </description>
-<syntax>UNCList<var>hostname</var> ...</syntax>
+<syntax>UNCList <var>hostname</var> [<var>hostname</var>...]</syntax>
 <default>unset</default>
 <contextlist><context>server config</context>
 </contextlist>
@@ -5187,15 +5187,22 @@ hostname or IP address</description>
     has been specified by this directive. The intent is to limit access to
     paths derived from untrusted inputs.</p>
 
-<note type="warning"><title>Security</title>
-<p>UNC paths accessed outside of request processing, such as during startup,
-are not checked against the hosts configured with this directive.</p>
-</note>
-</usage>
-</directivesynopsis>
+    <example>
+    UNCList example.com other.example.com
+    </example>
+
+    <note type="warning"><title>Security</title>
+    <p>UNC paths accessed outside of request processing, such as during startup,
+    are not necessarily checked against the hosts configured with this directive.</p>
+    </note>
 
+    <note type="warning"><title>Directive Ordering</title>
+    <p>This directive should be placed before UNC paths used in httpd.conf. 
+    Multiple occurrences of the directive reset the list.</p>
+    </note>
 
-UNCList
+</usage>
+</directivesynopsis>
 
 
 <directivesynopsis>