[svnbook] r3972 committed - * src/en/book/ch09-reference.xml...
svnbook at googlecode.com
svnbook at googlecode.com
Tue Aug 9 15:22:24 CDT 2011
Revision: 3972
Author: cmpilato at gmail.com
Date: Tue Aug 9 13:21:16 2011
Log: * src/en/book/ch09-reference.xml
Completely my read-thru edits of this chapter. And the book as a
whole. Yay!
http://code.google.com/p/svnbook/source/detail?r=3972
Modified:
/trunk/src/en/book/ch09-reference.xml
=======================================
--- /trunk/src/en/book/ch09-reference.xml Tue Aug 9 12:10:23 2011
+++ /trunk/src/en/book/ch09-reference.xml Tue Aug 9 13:21:16 2011
@@ -2,40 +2,39 @@
<title>Subversion Complete Reference</title>
<para>This chapter is intended to be a complete reference to using
- Subversion. This includes the command-line client
- (<command>svn</command>) and all its subcommands, as well as the
- repository administration programs (<command>svnadmin</command>
- and <command>svnlook</command>) and their respective
- subcommands.</para>
-
-
+ Subversion. It includes command summaries and examples for all
+ the command-line tools provided as part of the stock Subversion
+ distribution, configuration information for the Subversion server
+ modules, and other information that lends itself to a reference
+ format.</para>
+
<!-- =================================================================
-->
<!-- =================================================================
-->
<!-- =================================================================
-->
<sect1 id="svn.ref.svn">
<title>svn—Subversion Command-Line Client</title>
- <para>To use the command-line client, type
- <command>svn</command>, the subcommand you wish to
- use,<footnote><para>Well, you don't need a subcommand to use the
- <option>--version</option> option, but we'll get to that in just
- a minute.</para></footnote> and any options or targets that you
- wish to operate on—the subcommand and the options need not
- appear in a specific order. For example, all of the following
- are valid ways to use <command>svn status</command>:</para>
+ <para><command>svn</command> is the official command-line client
+ of Subversion. It offers no small number of subcommands and
+ options. Subcommands and other non-option arguments must appear
+ in a specified order on the command line used to
+ invoke <command>svn</command>. Options, on the other hand, may
+ appear anywhere on the command line (after the program name, of
+ course), and in general, their order is irrelevant. For
+ example, all of the following are valid ways to use <command>svn
+ status</command>, and are interpreted in exactly the same
+ way:</para>
<informalexample>
<screen>
-$ svn -v status
-$ svn status -v
-$ svn status -v myfile
+$ svn -vq status myfile
+$ svn status -v -q myfile
+$ svn -q status -v myfile
+$ svn status -vq myfile
+$ svn status myfile -qv
</screen>
</informalexample>
- <para>You can find many more examples of how to use most client
- commands in <xref linkend="svn.tour"/> and commands for managing
- properties in <xref linkend="svn.advanced.props"/>.</para>
-
<!-- ===============================================================
-->
<sect2 id="svn.ref.svn.sw">
<title>svn Options</title>
@@ -293,7 +292,7 @@
"-b -E"</userinput>).</para>
</listitem>
- <!-- TODO(fitz): Document -u -b -w and - -ignore-eol-style -->
+ <!-- ### TODO: Document -u -b -w and - -ignore-eol-style -->
</varlistentry>
@@ -349,8 +348,7 @@
<varlistentry>
<term><option>--help</option> (<option>-h</option> or
- <option>-?</option>)
- </term>
+ <option>-?</option>)</term>
<listitem>
<para>If used with one or more subcommands, shows the
built-in help text for each. If used alone, it displays
@@ -763,6 +761,7 @@
linkend="svn.ref.svn.sw" />) from the subcommand descriptions
which follow.</para>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.add">
<indexterm>
@@ -867,6 +866,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.blame">
<indexterm>
@@ -910,18 +910,17 @@
--xml
</screen>
</informalexample>
-
<!--
-TODO(fitz): doc this:
+### TODO:
- -incremental : give output suitable for concatenation
- -xml : output in XML
-x [- -extensions] arg : Default: '-u'. When Subversion is invoking an
- external diff program, ARG is simply passed
along
- to the program. But when Subversion is using
its
- default internal diff implementation, or when
- Subversion is displaying blame annotations,
ARG
- could be any of the following:
+ external diff program, ARG is simply passed
along
+ to the program. But when Subversion is using
its
+ default internal diff implementation, or when
+ Subversion is displaying blame annotations,
ARG
+ could be any of the following:
-u (- -unified):
Output 3 lines of unified context.
-b (- -ignore-space-change):
@@ -933,11 +932,6 @@
- -force : force operation to run
-->
-
-
-
-
-
</refsect1>
<refsect1>
@@ -998,6 +992,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.cat">
<indexterm>
@@ -1044,6 +1039,7 @@
$ svn cat http://svn.red-bean.com/repos/test/readme.txt
This is a README file.
You should read this.
+$
</screen>
</informalexample>
@@ -1061,15 +1057,16 @@
$ cat foo.c
This file is in my local working copy
and has changes that I've made.
-
$ svn cat -r HEAD foo.c
Latest revision fresh from the repository!
+$
</screen>
</informalexample>
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.changelist">
<indexterm>
@@ -1126,7 +1123,6 @@
Path 'foo.c' is now a member of changelist 'issue1729'.
Path 'bar.c' is now a member of changelist 'issue1729'.
Path 'baz.c' is now a member of changelist 'issue1729'.
-
$ svn status
A someotherfile.c
A test/sometest.c
@@ -1135,27 +1131,27 @@
A foo.c
A bar.c
A baz.c
-
$ svn commit --changelist issue1729 -m "Fixing Issue 1729."
Adding bar.c
Adding baz.c
Adding foo.c
Transmitting file data ...
Committed revision 2.
-
$ svn status
A someotherfile.c
A test/sometest.c
+$
</screen>
</informalexample>
- <para>Note that only the files in changelist
- <replaceable>issue1729</replaceable> were
+ <para>Note that in the previous example, only the files in
+ changelist <literal>issue1729</literal> were
committed.</para>
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.checkout">
<indexterm>
@@ -1209,13 +1205,14 @@
<informalexample>
<screen>
$ svn checkout file:///var/svn/repos/test mine
-A mine/a
-A mine/b
-A mine/c
-A mine/d
+A mine/a
+A mine/b
+A mine/c
+A mine/d
Checked out revision 20.
$ ls
mine
+$
</screen>
</informalexample>
@@ -1224,17 +1221,19 @@
<informalexample>
<screen>
-$ svn checkout file:///var/svn/repos/test file:///var/svn/repos/quiz
-A test/a
-A test/b
-A test/c
-A test/d
+$ svn checkout file:///var/svn/repos/test \
+ file:///var/svn/repos/quiz
+A test/a
+A test/b
+A test/c
+A test/d
Checked out revision 20.
-A quiz/l
-A quiz/m
+A quiz/l
+A quiz/m
Checked out revision 13.
$ ls
quiz test
+$
</screen>
</informalexample>
@@ -1244,14 +1243,16 @@
<informalexample>
<screen>
-$ svn checkout file:///var/svn/repos/test file:///var/svn/repos/quiz
working-copies
-A working-copies/test/a
-A working-copies/test/b
-A working-copies/test/c
-A working-copies/test/d
+$ svn checkout file:///var/svn/repos/test \
+ file:///var/svn/repos/quiz \
+ working-copies
+A working-copies/test/a
+A working-copies/test/b
+A working-copies/test/c
+A working-copies/test/d
Checked out revision 20.
-A working-copies/quiz/l
-A working-copies/quiz/m
+A working-copies/quiz/l
+A working-copies/quiz/m
Checked out revision 13.
$ ls
working-copies
@@ -1267,21 +1268,20 @@
<informalexample>
<screen>
$ svn checkout file:///var/svn/repos/test mine
-A mine/a
-A mine/b
+A mine/a
+A mine/b
^C
svn: The operation was interrupted
svn: caught SIGINT
-
$ svn checkout file:///var/svn/repos/test mine
-A mine/c
+A mine/c
^C
svn: The operation was interrupted
svn: caught SIGINT
-
$ svn update mine
-A mine/d
+A mine/d
Updated to revision 20.
+$
</screen>
</informalexample>
@@ -1293,8 +1293,9 @@
<informalexample>
<screen>
$ svn checkout -r 2 file:///var/svn/repos/test mine
-A mine/a
+A mine/a
Checked out revision 2.
+$
</screen>
</informalexample>
@@ -1320,7 +1321,8 @@
$ mkdir project/lib
$ touch project/lib/file.c
$ svn checkout file:///var/svn/repos/project/trunk project
-svn: Failed to add directory 'project/lib': an unversioned directory of
the same name already exists
+svn: Failed to add directory 'project/lib': an unversioned directory of
the sa
+me name already exists
$ svn checkout file:///var/svn/repos/project/trunk project --force
E project/lib
A project/lib/subdir
@@ -1389,6 +1391,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.cleanup">
<indexterm>
@@ -1447,7 +1450,6 @@
<informalexample>
<screen>
$ svn cleanup
-
$ svn cleanup /var/svn/working-copy
</screen>
</informalexample>
@@ -1455,6 +1457,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.commit">
<indexterm>
@@ -1586,6 +1589,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.copy">
<indexterm>
@@ -1793,6 +1797,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.delete">
<indexterm>
@@ -1901,6 +1906,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.diff">
<indexterm>
@@ -2008,18 +2014,16 @@
is provided) is to display the differences between the
base and working copies
of <replaceable>TARGET</replaceable>. If a
- <option>--revision</option> (<option>-r</option>) option is
specified in this
- scenario, though, it means:</para>
+ <option>--revision</option> (<option>-r</option>) option
+ is specified in this scenario, though, it means:</para>
<variablelist>
<varlistentry>
<term><option>--revision N:M</option></term>
<listitem>
- <para>The server compares
- <replaceable>TARGET at N</replaceable>
- and
- <replaceable>TARGET at M</replaceable>.</para>
+ <para>The server compares
<replaceable>TARGET at N</replaceable>
+ and <replaceable>TARGET at M</replaceable>.</para>
</listitem>
</varlistentry>
@@ -2233,6 +2237,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.export">
<indexterm>
@@ -2304,8 +2309,8 @@
<informalexample>
<screen>
$ svn export file:///var/svn/repos my-export
-A my-export/test
-A my-export/quiz
+A my-export/test
+A my-export/quiz
…
Exported revision 15.
</screen>
@@ -2324,8 +2329,8 @@
<informalexample>
<screen>
$ svn export file:///var/svn/repos my-export --native-eol CRLF
-A my-export/test
-A my-export/quiz
+A my-export/test
+A my-export/quiz
…
Exported revision 15.
</screen>
@@ -2339,8 +2344,7 @@
</refsect1>
</refentry>
-
-
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.help">
<indexterm>
@@ -2373,6 +2377,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.import">
<indexterm>
@@ -2471,6 +2476,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.info">
<indexterm>
@@ -2653,6 +2659,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.list">
<indexterm>
@@ -2789,6 +2796,7 @@
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.lock">
<indexterm>
@@ -2877,6 +2885,7 @@
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.log">
<indexterm>
@@ -3205,6 +3214,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.merge">
<indexterm>
@@ -3343,6 +3353,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.mergeinfo">
<indexterm>
@@ -3434,6 +3445,7 @@
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.mkdir">
<indexterm>
@@ -3509,6 +3521,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.move">
<indexterm>
@@ -3634,6 +3647,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.propdel">
<indexterm>
@@ -3704,6 +3718,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.propedit">
<indexterm>
@@ -3762,18 +3777,24 @@
<informalexample>
<screen>
-$ svn propedit svn:keywords foo.c
- <svn will launch your favorite editor here, with a buffer open
- containing the current contents of the svn:keywords property. You
- can add multiple values to a property easily here by entering one
- value per line.>
+$ svn propedit svn:keywords foo.c
+
+ # svn will open in your favorite text editor a temporary file
+ # containing the current contents of the svn:keywords property. You
+ # can add multiple values to a property easily here by entering one
+ # value per line. When you save the temporary file and exit,
+ # Subversion will re-read the temporary file and use its updated
+ # contents as the new value of the property.
+
Set new value for property 'svn:keywords' on 'foo.c'
+$
</screen>
</informalexample>
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.propget">
<indexterm>
@@ -3883,6 +3904,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.proplist">
<indexterm>
@@ -3985,6 +4007,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.propset">
<indexterm>
@@ -4124,6 +4147,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.resolve">
<indexterm>
@@ -4236,15 +4260,18 @@
(s) show all options: p
C foo.c
Updated to revision 5.
-
+Summary of conflicts:
+ Text conflicts: 1
$ svn resolve --accept mine-full foo.c
Resolved conflicted state of 'foo.c'
+$
</screen>
</informalexample>
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.resolved">
<indexterm>
@@ -4303,13 +4330,16 @@
<informalexample>
<screen>
$ svn update
-C foo.c
+C foo.c
Updated to revision 31.
-$ ls
+Summary of conflicts:
+ Text conflicts: 1
+$ ls foo.c*
foo.c
foo.c.mine
foo.c.r30
foo.c.r31
+$
</screen>
</informalexample>
@@ -4330,6 +4360,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.revert">
<indexterm>
@@ -4435,6 +4466,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.status">
<indexterm>
@@ -4904,6 +4936,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.switch">
<indexterm>
@@ -4999,10 +5032,10 @@
<informalexample>
<screen>
$ svn switch http://svn.red-bean.com/repos/branches/vendors-with-fix .
-U myproj/foo.txt
-U myproj/bar.txt
-U myproj/baz.c
-U myproj/qux.c
+U myproj/foo.txt
+U myproj/bar.txt
+U myproj/baz.c
+U myproj/qux.c
Updated to revision 31.
</screen>
</informalexample>
@@ -5014,10 +5047,10 @@
<informalexample>
<screen>
$ svn switch http://svn.red-bean.com/repos/trunk/vendors .
-U myproj/foo.txt
-U myproj/bar.txt
-U myproj/baz.c
-U myproj/qux.c
+U myproj/foo.txt
+U myproj/bar.txt
+U myproj/baz.c
+U myproj/qux.c
Updated to revision 31.
</screen>
</informalexample>
@@ -5049,8 +5082,8 @@
<informalexample>
<screen>
$ svn checkout file:///var/svn/repos test
-A test/a
-A test/b
+A test/a
+A test/b
…
$ mv /var/svn/repos /var/svn/newlocation
@@ -5094,6 +5127,7 @@
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.unlock">
<indexterm>
@@ -5175,6 +5209,7 @@
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svn.c.update">
<indexterm>
@@ -5304,10 +5339,10 @@
<informalexample>
<screen>
$ svn update
-A newdir/toggle.c
-A newdir/disclose.c
-A newdir/launch.c
-D newdir/README
+A newdir/toggle.c
+A newdir/disclose.c
+A newdir/launch.c
+D newdir/README
Updated to revision 32.
</screen>
</informalexample>
@@ -5320,11 +5355,11 @@
<informalexample>
<screen>
$ svn update -r30
-A newdir/README
-D newdir/toggle.c
-D newdir/disclose.c
-D newdir/launch.c
-U foo.c
+A newdir/README
+D newdir/toggle.c
+D newdir/disclose.c
+D newdir/launch.c
+U foo.c
Updated to revision 30.
</screen>
</informalexample>
@@ -5538,6 +5573,7 @@
<para>Here are the various subcommands
for the <command>svnadmin</command> program.</para>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.crashtest">
<indexterm>
@@ -5588,6 +5624,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.create">
<indexterm>
@@ -5672,6 +5709,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.deltify">
<indexterm>
@@ -5714,6 +5752,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.dump">
<indexterm>
@@ -5822,6 +5861,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.help">
<indexterm>
@@ -5851,6 +5891,7 @@
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.hotcopy">
<indexterm>
@@ -5905,6 +5946,7 @@
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.list-dblogs">
<indexterm>
@@ -5938,6 +5980,7 @@
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.list-unused-dblogs">
<indexterm>
@@ -5989,6 +6032,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.load">
<indexterm>
@@ -6062,6 +6106,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.lslocks">
<indexterm>
@@ -6118,6 +6163,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.lstxns">
<indexterm>
<primary>svnadmin</primary>
@@ -6159,6 +6205,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.pack">
<indexterm>
<primary>svnadmin</primary>
@@ -6189,6 +6236,7 @@
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.recover">
<indexterm>
@@ -6280,6 +6328,7 @@
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.rmlocks">
<indexterm>
@@ -6328,6 +6377,7 @@
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.rmtxns">
<indexterm>
@@ -6389,6 +6439,7 @@
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.setlog">
<indexterm>
@@ -6454,6 +6505,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.setrevprop">
<indexterm>
@@ -6504,7 +6556,7 @@
<informalexample>
<screen>
-$svnadmin setrevprop /var/svn/repos -r 0 repository-photo sandwich.png
+$ svnadmin setrevprop /var/svn/repos -r 0 repository-photo sandwich.png
</screen>
</informalexample>
@@ -6514,6 +6566,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.setuuid">
<indexterm>
@@ -6533,11 +6586,11 @@
<refsect1>
<title>Description</title>
- <para>Reset the repository UUID for the repository located
- at <replaceable>REPOS_PATH</replaceable>.
- If <replaceable>NEW_UUID</replaceable> is provided, use
- that as the new repository UUID; otherwise, generate a
- brand-new UUID for the repository.</para>
+ <para>Reset the repository UUID for the repository located
+ at <replaceable>REPOS_PATH</replaceable>.
+ If <replaceable>NEW_UUID</replaceable> is provided, use
+ that as the new repository UUID; otherwise, generate a
+ brand-new UUID for the repository.</para>
</refsect1>
@@ -6570,6 +6623,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.upgrade">
<indexterm>
@@ -6590,27 +6644,26 @@
<refsect1>
<title>Description</title>
- <para>Upgrade the repository located
- at <replaceable>REPOS_PATH</replaceable> to the latest
- supported schema version.</para>
-
- <para>This functionality is provided as a convenience for
- repository administrators who wish to make use of new
- Subversion functionality without having to undertake a
- potentially costly full repository dump and load
- operation. As such, the upgrade performs only the
- minimum amount of work needed to accomplish this while
- still maintaining the integrity of the repository.
- While a dump and subsequent load guarantee the most
- optimized repository state, <command>svnadmin
- upgrade</command> does not.</para>
-
- <warning>
- <para>You should <emphasis>always</emphasis> back up your
- repository before upgrading.</para>
- </warning>
-
- </refsect1>
+ <para>Upgrade the repository located
+ at <replaceable>REPOS_PATH</replaceable> to the latest
+ supported schema version.</para>
+
+ <para>This functionality is provided as a convenience for
+ repository administrators who wish to make use of new
+ Subversion functionality without having to undertake a
+ potentially costly full repository dump and load
+ operation. As such, the upgrade performs only the minimum
+ amount of work needed to accomplish this while still
+ maintaining the integrity of the repository. While a dump
+ and subsequent load guarantee the most optimized
+ repository state, <command>svnadmin upgrade</command> does
+ not.</para>
+
+ <warning>
+ <para>You should <emphasis>always</emphasis> back up your
+ repository before upgrading.</para>
+ </warning>
+ </refsect1>
<refsect1>
<title>Options</title>
@@ -6638,8 +6691,10 @@
</refsect1>
</refentry>
- <!-- this could use a lot more explanation. When should I use
- it? What do I do if it fails? -->
+ <!-- ### FIXME: This could use a lot more explanation. When
+ should I use it? What do I do if it fails? -->
+
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnadmin.c.verify">
<indexterm>
@@ -6816,6 +6871,7 @@
<para>Here are the various subcommands
for the <command>svnlook</command> program.</para>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnlook.c.author">
<indexterm>
@@ -6866,6 +6922,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnlook.c.cat">
<indexterm>
@@ -6928,6 +6985,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<refentry id="svn.ref.svnlook.c.changed">
<indexterm>
@@ -7060,6 +7118,7 @@
</refsect1>
</refentry>
+ <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
***The diff for this file has been truncated for email.***
More information about the svnbook-dev
mailing list