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