[svnbook] r4015 committed - For issue #79 ("Update 'svnsync sync' and 'svnsync copy-revprops'...
svnbook at googlecode.com
svnbook at googlecode.com
Thu Aug 18 14:30:22 CDT 2011
Revision: 4015
Author: cmpilato at gmail.com
Date: Thu Aug 18 12:29:56 2011
Log: For issue #79 ("Update 'svnsync sync' and 'svnsync copy-revprops'
syntax and recommendations."):
* en/book/ch09-reference.xml
(svn.ref.svnsync.sw): Note the new --revision (-r) option.
(svn.ref.svnsync.c.copy-revprops, svn.ref.svnsync.c.synchronize):
Document the new syntaxes for these subcommands, adding a
recommendation (by way of warning) to each about specifying the
source URL on the command-line.
http://code.google.com/p/svnbook/source/detail?r=4015
Modified:
/trunk/en/book/ch09-reference.xml
=======================================
--- /trunk/en/book/ch09-reference.xml Thu Aug 18 11:19:27 2011
+++ /trunk/en/book/ch09-reference.xml Thu Aug 18 12:29:56 2011
@@ -8013,6 +8013,16 @@
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><option>--revision</option> (<option>-r</option>)
+ <replaceable>ARG</replaceable></term>
+ <listitem>
+ <para>Used by <command>svnsync copy-revprops</command> to
+ specify a particular revision or revision range on which
+ to operate.</para>
+ </listitem>
+ </varlistentry>
+
<varlistentry>
<term><option>--source-password</option>
<replaceable>PASSWD</replaceable></term>
@@ -8093,7 +8103,10 @@
</refnamediv>
<refsect1>
<title>Synopsis</title>
- <para><literal>svnsync copy-revprops DEST_URL
[REV[:REV2]</literal></para>
+ <para><literal>svnsync copy-revprops DEST_URL
+ [SOURCE_URL]</literal></para>
+ <para><literal>svnsync copy-revprops DEST_URL
+ REV[:REV2]</literal></para>
</refsect1>
<refsect1>
<title>Description</title>
@@ -8111,6 +8124,26 @@
copy-revprops</command> is the answer to this problem.
Use it to resynchronize the revision properties for a
particular revision or range of revisions.</para>
+
+ <para>When <replaceable>SOURCE_URL</replaceable> is
+ provided, <command>svnsync</command> will use it as the
+ repository URL which the destination repository is
+ mirroring. Generally, <replaceable>SOURCE_URL</replaceable>
+ will be exactly the same source URL as was used with
+ the <command>svnsync initialize</command> command when the
+ mirror was first set up. You may choose, however, to
+ omit <replaceable>SOURCE_URL</replaceable>, in which
+ case <command>svnsync</command> will consult the mirror
+ repository's records to determine the source URL which
+ should be used.</para>
+
+ <warning>
+ <para>We strongly recommend that you specify the source
+ URL on the command-line, especially when commit access
+ to the mirror server is granted to untrusted
+ users.</para>
+ </warning>
+
</refsect1>
<refsect1>
@@ -8122,6 +8155,7 @@
--no-auth-cache
--non-interactive
--quiet (-q)
+--revision (-r)
--source-password ARG
--source-username ARG
--sync-password ARG
@@ -8134,11 +8168,13 @@
<refsect1>
<title>Examples</title>
- <para>Resynchronize revision properties for a single
revision:</para>
+ <para>Resynchronize the revision properties associated with
+ a single revision (r6):</para>
<informalexample>
<screen>
-$ svnsync copy-revprops file:///var/svn/repos-mirror 6
+$ svnsync copy-revprops -r 6 file:///var/svn/repos-mirror \
+ http://svn.example.com/repos
Copied properties for revision 6.
$
</screen>
@@ -8263,7 +8299,8 @@
</refnamediv>
<refsect1>
<title>Synopsis</title>
- <para><literal>svnsync initialize MIRROR_URL
SOURCE_URL</literal></para>
+ <para><literal>svnsync initialize MIRROR_URL
+ SOURCE_URL</literal></para>
</refsect1>
<refsect1>
<title>Description</title>
@@ -8335,7 +8372,8 @@
<informalexample>
<screen>
-$ svnsync initialize file:///var/svn/repos-mirror
http://svn.example.com/repos
+$ svnsync initialize file:///var/svn/repos-mirror \
+ http://svn.example.com/repos
svnsync: Repository has not been enabled to accept revision propchanges;
ask the administrator to create a pre-revprop-change hook
$
@@ -8348,7 +8386,8 @@
<informalexample>
<screen>
-$ svnsync initialize file:///var/svn/repos-mirror
http://svn.example.com/repos
+$ svnsync initialize file:///var/svn/repos-mirror \
+ http://svn.example.com/repos
Copied properties for revision 0.
$
</screen>
@@ -8374,7 +8413,8 @@
</refnamediv>
<refsect1>
<title>Synopsis</title>
- <para><literal>svnsync synchronize DEST_URL</literal></para>
+ <para><literal>svnsync synchronize DEST_URL
+ [SOURCE_URL]</literal></para>
</refsect1>
<refsect1>
<title>Description</title>
@@ -8389,6 +8429,25 @@
<para><command>svnsync synchronize</command> can be
gracefully canceled and restarted.</para>
+ <para>When <replaceable>SOURCE_URL</replaceable> is
+ provided, <command>svnsync</command> will use it as the
+ repository URL which the destination repository is
+ mirroring. Generally, <replaceable>SOURCE_URL</replaceable>
+ will be exactly the same source URL as was used with
+ the <command>svnsync initialize</command> command when the
+ mirror was first set up. You may choose, however, to
+ omit <replaceable>SOURCE_URL</replaceable>, in which
+ case <command>svnsync</command> will consult the mirror
+ repository's records to determine the source URL which
+ should be used.</para>
+
+ <warning>
+ <para>We strongly recommend that you specify the source
+ URL on the command-line, especially when commit access
+ to the mirror server is granted to untrusted
+ users.</para>
+ </warning>
+
</refsect1>
<refsect1>
@@ -8417,7 +8476,8 @@
<informalexample>
<screen>
-$ svnsync synchronize file:///var/svn/repos-mirror
+$ svnsync synchronize file:///var/svn/repos-mirror \
+ http://svn.example.com/repos
Committed revision 1.
Copied properties for revision 1.
Committed revision 2.
More information about the svnbook-dev
mailing list