[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