[svnbook commit] r3091 - trunk/src/en/book
cmpilato
noreply at red-bean.com
Thu May 29 12:55:45 CDT 2008
Author: cmpilato
Date: Thu May 29 12:55:45 2008
New Revision: 3091
Log:
Finish issue #116 - ch09: Document SVNAllowBulkUpdates mod_dav_svn directive.
* src/en/book/ch09-reference.xml
Document the SVNAllowBulkUpdates mod_dav_svn directory. While here,
change the headers for the other directives to more closely resemble
the way Apache documents its own built-in directives.
Modified:
trunk/src/en/book/ch09-reference.xml
Modified: trunk/src/en/book/ch09-reference.xml
==============================================================================
--- trunk/src/en/book/ch09-reference.xml (original)
+++ trunk/src/en/book/ch09-reference.xml Thu May 29 12:55:45 2008
@@ -7763,26 +7763,65 @@
</varlistentry>
<varlistentry>
- <term><literal>SVNAutoversioning On</literal></term>
+ <term><literal>SVNAllowBulkUpdates On|Off</literal></term>
<listitem>
- <para>This directive allows write requests from WebDAV
- clients to result in automatic commits. A generic log
- message is autogenerated and attached to each
- revision. If you enable Autoversioning, you'll likely
- want to set <literal>ModMimeUsePathInfo On</literal>
- so that <literal>mod_mime</literal> can set
- <literal>svn:mime-type</literal> to the correct
+ <para>This directive toggles support for all-inclusive
+ responses to update-style <literal>REPORT</literal>
+ requests. Subversion clients use
+ <literal>REPORT</literal> requests to get information
+ about directory tree checkouts and updates from
+ <literal>mod_dav_svn</literal>. 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
+ <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>,
+ <literal>mod_dav_svn</literal> 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>Most folks won't need to use this directive at
+ all. It primarily exists for administrators who
+ wish—for security or auditing reasons—to
+ force Subversion clients to fetch individually all the
+ 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>
+
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>SVNAutoversioning On|Off</literal></term>
+ <listitem>
+
+ <para>This directive, when its value is
+ <literal>on</literal>, allows write requests from
+ WebDAV clients to result in automatic commits. A
+ generic log message is autogenerated and attached to
+ each revision. If you enable Autoversioning, you'll
+ likely want to set <literal>ModMimeUsePathInfo
+ On</literal> so that <literal>mod_mime</literal> can
+ set <literal>svn:mime-type</literal> to the correct
mime-type automatically (as best as
<literal>mod_mime</literal> is able to, of course).
For more information, see <xref
- linkend="svn.webdav"/>.</para>
+ linkend="svn.webdav"/>. The default value of this
+ directive is <literal>off</literal>.</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>SVNPath</literal></term>
+ <term><literal>SVNPath
+ <replaceable>directory-path</replaceable></literal></term>
<listitem>
<para>This directive specifies the location in the
@@ -7796,7 +7835,8 @@
</varlistentry>
<varlistentry>
- <term><literal>SVNSpecialURI</literal></term>
+ <term><literal>SVNSpecialURI
+ <replaceable>component</replaceable></literal></term>
<listitem>
<para>Specifies the URI component (namespace) for
@@ -7814,7 +7854,8 @@
</varlistentry>
<varlistentry>
- <term><literal>SVNReposName</literal></term>
+ <term><literal>SVNReposName
+ <replaceable>name</replaceable></literal></term>
<listitem>
<para>Specifies the name of a Subversion repository for
@@ -7828,7 +7869,8 @@
</varlistentry>
<varlistentry>
- <term><literal>SVNIndexXSLT</literal></term>
+ <term><literal>SVNIndexXSLT
+ <replaceable>directory-path</replaceable></literal></term>
<listitem>
<para>Specifies the URI of an XSL transformation for
@@ -7838,7 +7880,8 @@
</varlistentry>
<varlistentry>
- <term><literal>SVNParentPath</literal></term>
+ <term><literal>SVNParentPath
+ <replaceable>directory-path</replaceable></literal></term>
<listitem>
<para>Specifies the location in the filesystem of a
@@ -7852,7 +7895,8 @@
</varlistentry>
<varlistentry>
- <term><literal>SVNPathAuthz</literal></term>
+ <term><literal>SVNPathAuthz
+ <replaceable>file-path</replaceable></literal></term>
<listitem>
<para>Control path-based authorization by enabling or
@@ -7864,7 +7908,7 @@
</varlistentry>
<varlistentry>
- <term><literal>SVNListParentPath</literal></term>
+ <term><literal>SVNListParentPath On|Off</literal></term>
<listitem>
<para>When set to <literal>On</literal>, allows
@@ -7878,7 +7922,8 @@
</varlistentry>
<varlistentry>
- <term><literal>SVNMasterURI</literal></term>
+ <term><literal>SVNMasterURI
+ <replaceable>url</replaceable></literal></term>
<listitem>
<para>Specifies a URI to the master Subversion
@@ -7888,7 +7933,8 @@
</varlistentry>
<varlistentry>
- <term><literal>SVNActivitiesDB</literal></term>
+ <term><literal>SVNActivitiesDB
+ <replaceable>directory-path</replaceable></literal></term>
<listitem>
<para>Specifies the location in the filesystem where the
More information about the svnbook-dev
mailing list