From: Eric Covener <covener@apache.org>
Date: Wed, 3 Jul 2024 22:30:14 +0000 (+0000)
Subject: Merge r1918892 from trunk:
X-Git-Tag: 2.4.62-rc1-candidate~35
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=48ad03f85842d18d16d62b6843dea6bc03f862f6;p=thirdparty%2Fapache%2Fhttpd.git

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 2deb201e5e2..fc7731b14db 100644
--- 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>