svnadmin --ignore-uuid

Julian Foad julianfoad at btopenworld.com
Tue May 19 11:56:27 CDT 2009


On Tue, 2009-03-17, Cousin Scuzzy wrote:
> Hello svnbook devs.  I recently discovered an error in the description
> of the --ignore-uuid option for svnadmin in chapter 9.  The book
> reads:
>  
>         By default, when loading an empty repository, svnadmin will
>         ignore the UUID from the dump stream.
>  
> In fact the behavior is that when loading an empty repository,
> svnadmin by default will apply the UUID from the dump stream,
> replacing the UUID on the previously empty repository.

The phrase "loading an empty repository" may be ambiguous: "loading the
apples (onto the cart)" versus "loading the cart (with apples)".

Is this better?

[[[
Correct the description of "--ignore-uuid".

Found by: "Cousin Scuzzy" <cousinscuzzy {_AT_} hotmail.com>

* src/en/book/ch09-reference.xml
  (svn.ref.svnadmin.sw): Correct the description of "--ignore-uuid".
    Also, improve the description of "force-uuid" along the same lines,
    and lose the "<literal>" mark-up of "UUID", as "UUID" isn't a
    literal quotation and it was inconsistently used.
--This line, and those below, will be ignored--

Index: src/en/book/ch09-reference.xml
===================================================================
--- src/en/book/ch09-reference.xml      (revision 3503)
+++ src/en/book/ch09-reference.xml      (working copy)
@@ -5377,24 +5377,21 @@
         <varlistentry>
           <term><option>--force-uuid</option></term>
           <listitem>
-            <para>By default, when loading data into repository that
-              already contains revisions, <command>svnadmin</command>
-              will ignore the <literal>UUID</literal> from the dump
-              stream.  This option will cause the repository's
-              <literal>UUID</literal> to be set to the
-              <literal>UUID</literal> from the stream.</para>
+            <para>When loading a dump stream into a repository, change
+              the repository's UUID to the UUID from the stream (if
+              there is one).  By default, <command>svnadmin</command>
+              changes it only if the repository was empty.</para>
           </listitem>
         </varlistentry>

         <varlistentry>
           <term><option>--ignore-uuid</option></term>
           <listitem>
-            <para>By default, when loading an empty repository,
-              <command>svnadmin</command> will ignore the
-              <literal>UUID</literal> from the dump stream.  This
-              option will force that UUID to be ignored (useful for
-              overriding your configuration file if it has
-              <option>--force-uuid</option> set).</para>
+            <para>When loading a dump stream into a repository, ignore
+              any UUID in the dump stream and leave the repository's
+              UUID unchanged. By default, <command>svnadmin</command>
+              changes the repository's UUID to the UUID from the stream
+              if the repository was empty.</para>
           </listitem>
         </varlistentry>
]]]

 
> There is also a typo near the beginning of the section for svnadmin in
> chapter 9: svnadmin is misspelled as svmadin.  Both of these errors
> are present in the current book sources.

I have fixed this typo in r3503.

Thanks.
- Julian


> Thanks for the valuable reference book!
> -cousinscuzzy
> 
> 
> ______________________________________________________________________
> Express your personality in color! Preview and select themes for
> Hotmail®. See how.
> _______________________________________________
> svnbook-dev mailing list
> svnbook-dev at red-bean.com
> http://www.red-bean.com/mailman/listinfo/svnbook-dev





More information about the svnbook-dev mailing list