[svnbook commit] r3507 - Add the svnsync info subcommand.

[codesite-noreply at google.com]

Author: julianfoad at btopenworld.com
Date: Wed May 20 11:16:31 2009
New Revision: 3507

Modified:
    trunk/src/en/book/ch05-repository-admin.xml
    trunk/src/en/book/ch09-reference.xml

Log:
Add the svnsync info subcommand.

Found by: Chris Foote <cafoote {_AT_} yahoo.com>

* src/en/book/ch05-repository-admin.xml
   (svn.reposadmin.maint.tk.svnsync): Add the info subcommand to the help
     output.
   (svn.reposadmin.maint.replication): In the bookkeeping sidebar mention
     the new svnsync info subcommand for displaying the properties.

* src/en/book/ch09-reference.xml
   (svn.ref.svnsync.c.info): New. Add the svnsync info subcommand.


Modified: trunk/src/en/book/ch05-repository-admin.xml
==============================================================================
--- trunk/src/en/book/ch05-repository-admin.xml	(original)
+++ trunk/src/en/book/ch05-repository-admin.xml	Wed May 20 11:16:31 2009
@@ -1318,6 +1318,7 @@
     initialize (init)
     synchronize (sync)
     copy-revprops
+   info
     help (?, h)
  $
  </screen>
@@ -2894,6 +2895,23 @@
            own special properties in revision 0 of the source
            repository, it simply ignores them.</para>

+        <para>In Subversion 1.6, an <command>svnsync info</command>
+          subcommand has been added to easily display the special
+          bookkeeping properties in the destination repository.</para>
+
+        <screen>
+$ svnsync help info
+info: usage: svnsync info DEST_URL
+
+Print information about the synchronization destination repository
+located at DEST_URL.
+…
+$ svnsync info http://svn.example.com/svn-mirror
+Source URL: http://svn.collab.net/repos/svn
+Source Repository UUID: 612f8ebc-c883-4be0-9ee0-a4e9ef946e3a
+Last Merged Revision: 23408
+$
+</screen>
        </sidebar>

        <para>There is, however, one bit of inelegance in the process.

Modified: trunk/src/en/book/ch09-reference.xml
==============================================================================
--- trunk/src/en/book/ch09-reference.xml	(original)
+++ trunk/src/en/book/ch09-reference.xml	Wed May 20 11:16:31 2009
@@ -7852,6 +7852,68 @@

        </refentry>

+      <refentry id="svn.ref.svnsync.c.info">
+
+        <indexterm>
+          <primary>svnsync</primary>
+          <secondary>subcommands</secondary>
+          <tertiary>info</tertiary>
+        </indexterm>
+
+        <refnamediv>
+          <refname>svnsync info</refname>
+          <refpurpose>Print information about the synchronization
+            of a destination repository.</refpurpose>
+        </refnamediv>
+        <refsect1>
+          <title>Synopsis</title>
+          <programlisting>svnsync info DEST_URL</programlisting>
+        </refsect1>
+        <refsect1>
+          <title>Description</title>
+
+          <para>Print the synchronization source URL, source repository
+            UUID and the last revision merged from the source to the
+            destination repository at  
<replaceable>DEST_URL</replaceable>.</para>
+        </refsect1>
+
+        <refsect1>
+          <title>Alternate names</title>
+          <para>None</para>
+        </refsect1>
+
+        <refsect1>
+          <title>Options</title>
+
+          <screen>
+--config-dir DIR
+--no-auth-cache
+--non-interactive
+--source-password ARG
+--source-username ARG
+--sync-password ARG
+--sync-username ARG
+--trust-server-cert
+</screen>
+        </refsect1>
+
+        <refsect1>
+          <title>Examples</title>
+
+          <para>Print the synchronization information of a mirror
+            repository:</para>
+
+          <screen>
+$ svnsync info file:///var/svn/repos-mirror
+Source URL: http://svn.example.com/repos
+Source Repository UUID: e7fe1b91-8cd5-0310-98dd-2f12e793c5e8
+Last Merged Revision: 47
+$
+</screen>
+
+        </refsect1>
+      </refentry>
+
        <refentry id="svn.ref.svnsync.c.init">

          <indexterm>