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

[cmpilato]

Author: cmpilato
Date: Sun Feb 25 21:38:34 2007
New Revision: 2707

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

Log:
* src/en/book/ch-repository-admin.xml
  Add a warning about svndumpfilter literal path interpretation as
  requested by Tigris.org user Jeff C <jeffc at tigris.org> in Subversion
  issue #1853 (http://subversion.tigris.org/issues/show_bug.cgi?id=1853).

Modified: trunk/src/en/book/ch-repository-admin.xml
==============================================================================
--- trunk/src/en/book/ch-repository-admin.xml	(original)
+++ trunk/src/en/book/ch-repository-admin.xml	Sun Feb 25 21:38:34 2007
@@ -1521,6 +1521,26 @@
           of this sort in your repository, you might want to rethink
           your set of included/excluded paths.</para>
 
+        <para>Finally, <command>svndumpfilter</command> takes path
+          filtering quite literally.  If you are trying to copy the
+          history of a project rooted at
+          <filename>trunk/my-project</filename> and move it into a
+          repository of its own, you would, of course, use the
+          <command>svndumpfilter include</command> command to keep all
+          the changes in and under
+          <filename>trunk/my-project</filename>.  But the resulting
+          dump file makes no assumptions about the repository into
+          which you plan to load this data.  Specifically, the dump
+          data might begin with the revision which added the
+          <filename>trunk/my-project</filename> directory, but it will
+          <emphasis>not</emphasis> contain directives which would
+          create the <filename>trunk</filename> directory itself
+          (because <filename>trunk</filename> doesn't match the
+          include filter).  You'll need to make sure that any
+          directories which the new dump stream expect to exist
+          actually do exist in the target repository before trying to
+          load the stream into that repository.</para>
+
       </sect3>
 
       <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->