[svnbook] r5627 committed - trunk/en/book/ch06-server-configuration.xml
cmpilato at users.sourceforge.net
cmpilato at users.sourceforge.net
Tue Feb 6 13:30:24 CST 2018
Revision: 5627
http://sourceforge.net/p/svnbook/source/5627
Author: cmpilato
Date: 2018-02-06 19:30:24 +0000 (Tue, 06 Feb 2018)
Log Message:
-----------
Fix #277 (Inconsistent documentation for SVNAllowBulkUpdates)
* en/book/ch06-server-configuration.xml
(svn.serverconfig.httpd.ref.mod_dav_svn): Document the "Prefer"
value of the SVNAllowBulkUpdates directive.
Modified Paths:
--------------
trunk/en/book/ch06-server-configuration.xml
Modified: trunk/en/book/ch06-server-configuration.xml
===================================================================
--- trunk/en/book/ch06-server-configuration.xml 2018-02-06 12:30:16 UTC (rev 5626)
+++ trunk/en/book/ch06-server-configuration.xml 2018-02-06 19:30:24 UTC (rev 5627)
@@ -4143,29 +4143,39 @@
</varlistentry>
<varlistentry>
- <term><literal>SVNAllowBulkUpdates On|Off</literal></term>
+ <term><literal>SVNAllowBulkUpdates On|Off|Prefer</literal></term>
<listitem>
- <para>Toggles support for all-inclusive
- responses to update-style <literal>REPORT</literal>
- requests. Subversion clients use
+ <para>Toggles support for all-inclusive responses to
+ update-style requests. Subversion clients use
<literal>REPORT</literal> requests to get information
about directory tree checkouts and updates from
<command>mod_dav_svn</command>. They can ask the
server to send that information in one of two ways:
with the entirety of the tree's information in one
- massive response, or with a
+ massive (bulk) response, or with a
<firstterm>skelta</firstterm> (a skeletal
representation of a tree delta) which contains just
enough information for the client to know what
- <emphasis>additional</emphasis> data to request from
- the server. When this directive is included with a
- value of <literal>Off</literal>,
+ <emphasis>additional</emphasis> data to fetch from the
+ server using subsequent requests. When this directive
+ is included with a value of <literal>Off</literal>,
<command>mod_dav_svn</command> will only ever respond
to these <literal>REPORT</literal> requests with
skelta responses, regardless of the type of responses
requested by the client.</para>
+ <para>The default value of this directive is
+ <literal>On</literal>, which permits the server to
+ reply to update requests using the style of response
+ (bulk or skelta) requested by the client. As a
+ special consideration, this directive also accepts a
+ value of <literal>Prefer</literal>, which is similar
+ to <literal>On</literal> but additionally causes the
+ server to announce to clients that it
+ <emphasis>prefers</emphasis> to handle bulk update
+ requests.</para>
+
<para>Most folks won't need to use this directive at
all. It primarily exists for administrators who
wish—for security or auditing reasons—to
@@ -4173,8 +4183,7 @@
files and directories needed for updates and
checkouts, thus leaving an audit trail of
<literal>GET</literal> and <literal>PROPFIND</literal>
- requests in Apache's logs. The default value of this
- directive is <literal>On</literal>.</para>
+ requests in Apache's logs.</para>
</listitem>
</varlistentry>
More information about the svnbook-dev
mailing list