From: Joe Orton <jorton@apache.org>
Date: Wed, 16 Aug 2023 07:33:45 +0000 (+0000)
Subject: Add docs for DavBasePath.
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ed4cb1db3c7efd861bab87dfa84534b81582cb94;p=thirdparty%2Fapache%2Fhttpd.git

Add docs for DavBasePath.


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

diff --git a/docs/manual/mod/mod_dav.xml b/docs/manual/mod/mod_dav.xml
index 0912f66675e..4f84508c51e 100644
--- a/docs/manual/mod/mod_dav.xml
+++ b/docs/manual/mod/mod_dav.xml
@@ -196,6 +196,36 @@ Alias "/php-source" "/home/gstein/php_files"
 </usage>
 </directivesynopsis>
 
+<directivesynopsis>
+<name>DavBasePath</name>
+<description>Configure repository root path</description>
+<syntax>DavBasePath <var>root-path</var></syntax>
+<default>DavBasePath /repos/</default>
+<contextlist><context>directory</context></contextlist>
+<compatibility>Available in version 2.5.1 and later</compatibility>
+
+<usage>
+  <p>If a DAV repository is configured using a regular expression
+  match (such as <directive module="core">LocationMatch</directive>)
+  then <module>mod_dav</module> will not be able to find the root of
+  the repository from the pathname alone. Third-party providers (for
+  example, Subversion's <a
+  href="https://svnbook.red-bean.com/en/1.7/svn.ref.mod_dav_svn.conf.html">mod_dav_svn</a>)
+  may fail to handle requests without the correct repository root.</p>
+
+  <p>To allow providers to work correctly in such a configuration,
+  <directive>DavBasePath</directive> must be used.</p>
+
+    <highlight language="config">
+&lt;LocationMatch "^/repos/"&gt;
+    Dav svn
+    DavBasePath /repos
+    SVNParentPath /var/svn
+&lt;/LocationMatch&gt;
+    </highlight>
+</usage>
+</directivesynopsis>
+
 <directivesynopsis>
 <name>DavMinTimeout</name>
 <description>Minimum amount of time the server holds a lock on