[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