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

cmpilato noreply at red-bean.com
Tue Feb 19 13:10:38 CST 2008


Author: cmpilato
Date: Tue Feb 19 13:10:37 2008
New Revision: 2978

Log:
* src/en/book/ch09-reference.xml
  Rework a bit about 'svn switch --relocate' to not indicate that this
  operation won't contact the repository (which is untrue), and to not
  encourage folks (if only indirectly) to write Perl scripts for
  working copy data fiddling.

Suggested (in part) by: Daniel Shahaf <d.s {at} daniel.shahaf.co.il>

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	Tue Feb 19 13:10:37 2008
@@ -4627,22 +4627,23 @@
               copy.</para>
           </tip>
 
-          <para>Sometimes an administrator might change the
-            <quote>base location</quote> of your repository—in
-            other words, the contents of the repository doesn't
-            change, but the main URL used to reach the root of the
-            repository does.  For example, the hostname may change,
-            the URL scheme may change, or any part of the URL which
-            leads to the repository itself may change.  Rather than
-            check out a new working copy, you can have the
+          <para>Sometimes an administrator might change the location
+            (or apparent location) of your repository—in other
+            words, the content of the repository doesn't change, but
+            the repository's root URL does.  For example, the hostname
+            may change, the URL scheme may change, or any part of the
+            URL which leads to the repository itself may change.
+            Rather than check out a new working copy, you can have the
             <command>svn switch</command> command
-            <quote>rewrite</quote> the beginnings of all the URLs in
-            your working copy.  Use the <option>--relocate</option>
-            option to do the substitution.  No file contents are
-            changed, nor is the repository contacted.  It's similar to
-            running a Perl script over your working copy
-            <filename>.svn/</filename> directories which runs
-            <command>s/OldRoot/NewRoot/</command>.</para>
+            <quote>rewrite</quote> your working copy's administrative
+            metadata to refer to the new repository location.  If you
+            use the <option>--relocate</option> option to <command>svn
+            switch</command>, Subversion will contact the repository
+            to validate the relocation request (looking for the
+            repository at the new URL, of course), and then do this
+            metadata rewriting.  No file contents will be changed as
+            the result of this type of switch operation—this is
+            a metadata-only modification to the working copy.</para>
 
           <screen>
 $ svn checkout file:///var/svn/repos test




More information about the svnbook-dev mailing list