[svnbook commit] r2954 - trunk/src/en/book

[cmpilato]

Author: cmpilato
Date: Fri Dec 28 11:19:03 2007
New Revision: 2954

Log:
* src/en/book/ch05-repository-admin.xml
  Describe limitations of the dumpfile format in terms of data
  transferred.  (For ticket #94).


Modified:
   trunk/src/en/book/ch05-repository-admin.xml

Modified: trunk/src/en/book/ch05-repository-admin.xml
==============================================================================
--- trunk/src/en/book/ch05-repository-admin.xml	(original)
+++ trunk/src/en/book/ch05-repository-admin.xml	Fri Dec 28 11:19:03 2007
@@ -1823,6 +1823,14 @@
           the file by automatically converting line endings.</para>
       </warning>
 
+      <note>
+        <para>The Subversion repository dump format describes
+          versioned repository changes only.  It will not carry any
+          information about uncommitted transactions, user locks on
+          filesystem paths, repository or server configuration
+          customizations (including hook scripts), and so on.</para>
+      </note>
+
       <para>There are many reasons for dumping and loading Subversion
         repository data.  Early in Subversion's life, the most common
         reason was due to the evolution of Subversion itself.  As
@@ -2769,12 +2777,14 @@
 
       <para>Finally, be aware that the revision-based replication
         provided by <command>svnsync</command> is only
-        that—replication of revisions.  It does not include such
-        things as the hook implementations, repository or server
-        configuration data, uncommitted transactions, or information
-        about user locks on repository paths.  Only information
-        carried by the Subversion repository dump file format is
-        available for replication.</para>
+        that—replication of revisions.  Only information carried
+        by the Subversion repository dump file format is available for
+        replication.  As such, <command>svnsync</command> has the same
+        sorts of limitations that the repository dump stream has, and
+        does not include such things as the hook implementations,
+        repository or server configuration data, uncommitted
+        transactions, or information about user locks on repository
+        paths.</para>
 
     </sect2>