[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