From: Eric Covener <covener@apache.org>
Date: Wed, 3 Jul 2024 22:29:46 +0000 (+0000)
Subject: mention quirks, add example, clarify
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=48e7588fdbe38fb84464998025a5ddbe43d0abe2;p=thirdparty%2Fapache%2Fhttpd.git

mention quirks, add example, clarify


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

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index 4b15a909a93..bd61ec0a2f0 100644
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -5322,7 +5322,7 @@ recognized methods to modules.</p>
 <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>
@@ -5334,15 +5334,22 @@ recognized methods to modules.</p>
     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>