[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

PATCH: BOOK: improvements

From: Julian Foad <julianfoad_at_btopenworld.com>
Date: 2003-08-28 00:31:04 CEST

I'm thinking of committing the following. Comments?

[[[
Improvements to the book.

* doc/book/book/ch01.xml
  Split the list of programs into client-side and server-side.

* doc/book/book/ch03.xml
  Fix an example of "svn resolved" usage.

* doc/book/book/ch08.xml
  Use simpler syntax for indicating repeatable arguments, to match the built-in
  help (issue 1377, r6525).
  Move "propset" and "revert" subcommands to restore alphabetical order.
  Fix simple errors in a few synopsis lines.
  Demote the warning that "svnadmin" refers to the repository by a path rather
  than a URL to a normal paragraph, because no danger is involved and to bring
  it in line with the corresponding note for "svnlook".

* doc/book/book/appc.xml
  Fix mark-up of an email address ("<email>" instead of "<address>").
]]]

- Julian

Index: doc/book/book/appc.xml
===================================================================
--- doc/book/book/appc.xml (revision 6898)
+++ doc/book/book/appc.xml (working copy)
@@ -23,7 +23,7 @@
         Subversion&mdash;from building, to installing, to using
         Subversion. If you can't find the problem you're having here,
         or you've tried everything we recommend with no success, send
- mail to <address>users@subversion.tigris.org</address> with a
+ mail to <email>users@subversion.tigris.org</email> with a
         detailed description of the problem you're having
         <footnote><para>Remember that the amount of detail you provide
         about your setup and your problem is directly proportional to
Index: doc/book/book/ch01.xml
===================================================================
--- doc/book/book/ch01.xml (revision 6898)
+++ doc/book/book/ch01.xml (working copy)
@@ -250,64 +250,79 @@
       Here's a quick overview of what you get.
     </para>
 
- <variablelist>
+ <sect2 id="svn-ch-1-sect-5.1">
 
- <varlistentry>
- <term>svn</term>
- <listitem>
- <para>The command-line client program. This is the main
- tool used to manage data, and its use is covered in
- Chapters 2, 3, 4, and 6.</para>
- </listitem>
- </varlistentry>
+ <title>Client Components (for the User)</title>
 
- <varlistentry>
- <term>svnlook</term>
- <listitem>
- <para>A tool for inspecting a Subversion repository,
- discussed in Chapter 5.</para>
- </listitem>
- </varlistentry>
+ <variablelist>
 
- <varlistentry>
- <term>svnadmin</term>
- <listitem>
- <para>A tool for tweaking or repairing a Subversion
- repository, used mainly by system administrators, also
- discussed in Chapter 5.</para>
- </listitem>
- </varlistentry>
+ <varlistentry>
+ <term>svn</term>
+ <listitem>
+ <para>The command-line client program. This is the main
+ tool used to manage data, and its use is covered in
+ Chapters 2, 3, 4, and 6.</para>
+ </listitem>
+ </varlistentry>
 
- <varlistentry>
- <term>mod_dav_svn</term>
- <listitem>
- <para>A plug-in module for the Apache-2.X web server; used
- to make your repository available to others over a
- network. Discussed in Chapter 5.</para>
- </listitem>
- </varlistentry>
+ <varlistentry>
+ <term>svnversion</term>
+ <listitem>
+ <para>A program for reporting the mixed-revision state of a
+ working copy. (See <xref linkend="svn-ch-2" /> to understand
+ mixed-revision working copies.)</para>
+ </listitem>
+ </varlistentry>
 
- <varlistentry>
- <term>svnserve</term>
- <listitem>
- <para>A standalone server program, runnable as a daemon
- process or invokable by SSH; another way to make your
- repository available to others over a network. Discussed
- in Chapter 5.</para>
- </listitem>
- </varlistentry>
+ </variablelist>
 
- <varlistentry>
- <term>svnversion</term>
- <listitem>
- <para>A program for reporting the mixed-revision state of a
- working copy. (See Chapter 2 to understand mixed-revision
- working copies.)</para>
- </listitem>
- </varlistentry>
+ </sect2>
 
- </variablelist>
+ <sect2 id="svn-ch-1-sect-5.2">
 
+ <title>Server Components (for the Administrator)</title>
+
+ <para>These are all discussed in <xref linkend="svn-ch-5" />.</para>
+
+ <variablelist>
+
+ <varlistentry>
+ <term>svnlook</term>
+ <listitem>
+ <para>A tool for inspecting a Subversion repository.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>svnadmin</term>
+ <listitem>
+ <para>A tool for creating, tweaking or repairing a Subversion
+ repository.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>mod_dav_svn</term>
+ <listitem>
+ <para>A plug-in module for the Apache-2.X web server; used
+ to make your repository available to others over a
+ network.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>svnserve</term>
+ <listitem>
+ <para>A standalone server program, runnable as a daemon
+ process or invokable by SSH; another way to make your
+ repository available to others over a network.</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </sect2>
+
     <para>Assuming you have Subversion installed correctly, you should
       be ready to start. The next two chapters will walk you through
       the use of <command>svn</command>, Subversion's command-line client
Index: doc/book/book/ch03.xml
===================================================================
--- doc/book/book/ch03.xml (revision 6898)
+++ doc/book/book/ch03.xml (working copy)
@@ -1479,7 +1479,7 @@
 $ ls sandwich.*
 sandwich.txt sandwich.txt.mine sandwich.txt.r2 sandwich.txt.r1
 $ cp sandwich.txt.r2 sandwich.txt
-$ svn resolved
+$ svn resolved sandwich.txt
 $ svn commit -m "Go ahead and use Sally's sandwich, discarding my edits."
         </screen>
 
Index: doc/book/book/ch08.xml
===================================================================
--- doc/book/book/ch08.xml (revision 6898)
+++ doc/book/book/ch08.xml (working copy)
@@ -428,7 +428,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn add PATH [PATH [PATH ... ]]</programlisting>
+ <programlisting>svn add PATH...</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -501,7 +501,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn cat TARGET [TARGET [TARGET ... ]]</programlisting>
+ <programlisting>svn cat TARGET...</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -575,7 +575,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn checkout URL [URL [URL ... ]] [PATH]</programlisting>
+ <programlisting>svn checkout URL... [PATH]</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -674,7 +674,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn cleanup [PATH [PATH ... ]]</programlisting>
+ <programlisting>svn cleanup [PATH...]</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -732,7 +732,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn commit [PATH [PATH ... ]]</programlisting>
+ <programlisting>svn commit [PATH...]</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -1001,7 +1001,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn delete [TARGET [TARGET ... ]]</programlisting>
+ <programlisting>svn delete [TARGET...]</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -1104,7 +1104,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn diff [-r N[:M]] [TARGET [TARGET ... ]]</programlisting>
+ <programlisting>svn diff [-r N[:M]] [TARGET...]</programlisting>
           <programlisting>svn diff URL1[@N] URL2[@M]</programlisting>
         </refsect1>
         <refsect1>
@@ -1348,7 +1348,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn help [SUBCOMMAND [SUBCOMMAND ... ]]</programlisting>
+ <programlisting>svn help [SUBCOMMAND...]</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -1472,7 +1472,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn info [PATH [PATH ... ]]</programlisting>
+ <programlisting>svn info [PATH...]</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -1567,7 +1567,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn list URL [URL ... ]</programlisting>
+ <programlisting>svn list URL...</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -1647,7 +1647,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn log [URL] [PATH [PATH ... ]]</programlisting>
+ <programlisting>svn log [URL] [PATH...]</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -1761,8 +1761,8 @@
           </screen>
 
           <para>If you want several distinct paths underneath the
- same URL, you can use the <literal>URL [PATH [PATH
- ...]]</literal> syntax.</para>
+ same URL, you can use the <literal>URL [PATH...]</literal>
+ syntax.</para>
 
           <screen>
 $ svn log http://svn.red-bean.com/repos/test/ foo.c bar.c
@@ -1892,7 +1892,7 @@
         <refsect1>
           <title>Synopsis</title>
           <programlisting>svn merge sourceURL1[@N] sourceURL2[@M] [WCPATH]</programlisting>
- <programlisting>merge -r N:M SOURCE [PATH]</programlisting>
+ <programlisting>svn merge -r N:M SOURCE [PATH]</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -1987,7 +1987,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn mkdir TARGET [TARGET [TARGET ... ]]</programlisting>
+ <programlisting>svn mkdir TARGET...</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -2161,135 +2161,12 @@
       <!-- ================================================================= -->
       <refentry>
         <refnamediv>
- <refname>svn propset</refname>
- <refpurpose>Set PROPNAME to PROPVAL on files, directories, or revisions.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Synopsis</title>
- <programlisting>svn propset PROPNAME [PROPVAL | -F VALFILE] PATH [PATH [PATH ... ]]</programlisting>
- <programlisting>svn propset PROPNAME --revprop -r REV [PROPVAL | -F VALFILE] [URL]</programlisting>
- </refsect1>
-
- <refsect1>
- <title>Description</title>
-
- <para>Set PROPNAME to PROPVAL on files, directories, or
- revisions. The first example creates a versioned, local
- propchange in the working copy, and the second creates an
- unversioned, remote propchange on a repository revision.</para>
-
- <tip>
- <para>Subversion has a number of <quote>special</quote>
- properties that affect its behavior. See <xref
- linkend="svn-ch-6-sect-2.3"/> for more on these
- properties.</para>
- </tip>
-
- </refsect1>
- <refsect1>
- <title>Alternate Names</title>
- <para>pset, ps</para>
- </refsect1>
-
- <refsect1>
- <title>Changes</title>
- <para>Working copy, repository only if operating on a URL</para>
- </refsect1>
-
- <refsect1>
- <title>Accesses Repository</title>
- <para>Only if operating on a URL</para>
- </refsect1>
-
- <refsect1>
- <title>Switches</title>
-
- <screen>
---file (-F) FILE
---quiet (-q)
---revision (-r) REV
---targets FILENAME
---recursive (-R)
---revprop
---encoding ENC
- </screen>
- </refsect1>
-
- <refsect1>
- <title>Examples</title>
-
- <para>Set the mimetype on a file:</para>
-
- <screen>
-$ svn propset svn:mime-type image/jpeg foo.jpg
-property `svn:mime-type' set on 'foo.jpg'
- </screen>
-
- <para>On a UNIX system, if you want a file to have the
- executable permission set:</para>
-
- <screen>
-$ svn propset svn:executable ON somescript
-property `svn:executable' set on 'somescript'
- </screen>
-
- <para>Perhaps you have an internal policy to set certain
- properties for the benefit of your coworkers:</para>
-
- <screen>
-$ svn propset owner sally foo.c
-property `owner' set on 'foo.c'
- </screen>
-
- <para>If you made a mistake in a log message for a
- particular revision and want to change it, use
- <option>--revprop</option> and set svn:log to the new
- log message:</para>
-
- <screen>
-$ svn propset --revprop -r 25 svn:log "Journaled about trip to New York."
-property `svn:log' set on repository revision '25'
- </screen>
-
- <para>Or, if you don't have a working copy, you can
- provide a URL.</para>
-
- <screen>
-$ svn propset --revprop -r 26 svn:log "Document nap." http://svn.red-bean.com/repos
-property `svn:log' set on repository revision '25'
- </screen>
-
- <para>Lastly, you can tell propset to take its input from
- a file. You could even use this to set the contents of a
- property to something binary:</para>
-
- <screen>
-$ svn propset owner-pic -F sally.jpg moo.c
-property `owner-pic' set on 'moo.c'
- </screen>
-
- <warning>
- <para>By default, you cannot modify revision properties
- in a Subversion repository. Your repository
- administrator must explicitly enable revision property
- modifications by creating a hook named
- 'pre-revprop-change'. See <xref
- linkend="svn-ch-5-sect-2.1"/> for more information on
- hook scripts.</para>
- </warning>
-
- </refsect1>
- </refentry>
-
- <!-- ================================================================= -->
- <refentry>
- <refnamediv>
           <refname>svn propdel</refname>
           <refpurpose>Remove a property from an item.</refpurpose>
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn propdel PROPNAME [PATH [PATH ... ]]</programlisting>
+ <programlisting>svn propdel PROPNAME [PATH...]</programlisting>
           <programlisting>svn propdel PROPNAME --revprop -r REV [URL]</programlisting>
         </refsect1>
         <refsect1>
@@ -2356,7 +2233,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn propedit PROPNAME PATH [PATH [PATH ... ]]</programlisting>
+ <programlisting>svn propedit PROPNAME PATH...</programlisting>
           <programlisting>svn propedit PROPNAME --revprop -r REV [URL]</programlisting>
         </refsect1>
         <refsect1>
@@ -2419,7 +2296,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn propget PROPNAME [PATH [PATH ... ]]</programlisting>
+ <programlisting>svn propget PROPNAME [PATH...]</programlisting>
           <programlisting>svn propget PROPNAME --revprop -r REV [URL]</programlisting>
         </refsect1>
         <refsect1>
@@ -2490,7 +2367,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn proplist [PATH [PATH ... ]]</programlisting>
+ <programlisting>svn proplist [PATH...]</programlisting>
           <programlisting>svn proplist --revprop -r REV [URL]</programlisting>
         </refsect1>
         <refsect1>
@@ -2560,95 +2437,121 @@
       <!-- ================================================================= -->
       <refentry>
         <refnamediv>
- <refname>svn revert</refname>
- <refpurpose>Undo all local edits.</refpurpose>
+ <refname>svn propset</refname>
+ <refpurpose>Set PROPNAME to PROPVAL on files, directories, or revisions.</refpurpose>
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn revert PATH [PATH [PATH ... ]]</programlisting>
+ <programlisting>svn propset PROPNAME [PROPVAL | -F VALFILE] PATH...</programlisting>
+ <programlisting>svn propset PROPNAME --revprop -r REV [PROPVAL | -F VALFILE] [URL]</programlisting>
         </refsect1>
+
         <refsect1>
           <title>Description</title>
 
- <para>Reverts any local changes to a file or directory and
- resolves any conflicted states. <command>svn
- revert</command> will not only revert the contents of an
- item in your working copy, but also any property
- changes. Finally, you can use it to undo any scheduling
- operations that you may have done (e.g. files scheduled
- for addition or deletion can be
- <quote>unscheduled</quote>).</para>
- </refsect1>
+ <para>Set PROPNAME to PROPVAL on files, directories, or
+ revisions. The first example creates a versioned, local
+ propchange in the working copy, and the second creates an
+ unversioned, remote propchange on a repository revision.</para>
 
+ <tip>
+ <para>Subversion has a number of <quote>special</quote>
+ properties that affect its behavior. See <xref
+ linkend="svn-ch-6-sect-2.3"/> for more on these
+ properties.</para>
+ </tip>
+
+ </refsect1>
         <refsect1>
           <title>Alternate Names</title>
- <para>None</para>
+ <para>pset, ps</para>
         </refsect1>
 
         <refsect1>
           <title>Changes</title>
- <para>Working copy</para>
+ <para>Working copy, repository only if operating on a URL</para>
         </refsect1>
 
         <refsect1>
           <title>Accesses Repository</title>
- <para>No</para>
+ <para>Only if operating on a URL</para>
         </refsect1>
 
         <refsect1>
           <title>Switches</title>
 
           <screen>
+--file (-F) FILE
+--quiet (-q)
+--revision (-r) REV
 --targets FILENAME
 --recursive (-R)
---quiet (-q)
+--revprop
+--encoding ENC
           </screen>
         </refsect1>
 
         <refsect1>
           <title>Examples</title>
 
- <para>Discard changes to a file:</para>
+ <para>Set the mimetype on a file:</para>
 
           <screen>
-$ svn revert foo.c
-Reverted foo.c
+$ svn propset svn:mime-type image/jpeg foo.jpg
+property `svn:mime-type' set on 'foo.jpg'
           </screen>
 
- <para>If you want to revert a whole directory of files,
- use the <option>--recursive</option> flag:</para>
+ <para>On a UNIX system, if you want a file to have the
+ executable permission set:</para>
 
           <screen>
-$svn revert --recursive .
-Reverted newdir/afile
-Reverted foo.c
-Reverted bar.txt
+$ svn propset svn:executable ON somescript
+property `svn:executable' set on 'somescript'
           </screen>
 
- <para>Lastly, you can undo any scheduling
- operations:</para>
+ <para>Perhaps you have an internal policy to set certain
+ properties for the benefit of your coworkers:</para>
 
           <screen>
-$ svn add mistake.txt whoops
-A mistake.txt
-A whoops
-A whoops/oopsie.c
+$ svn propset owner sally foo.c
+property `owner' set on 'foo.c'
+ </screen>
 
-$ svn revert mistake.txt whoops
-Reverted mistake.txt
-Reverted whoops
+ <para>If you made a mistake in a log message for a
+ particular revision and want to change it, use
+ <option>--revprop</option> and set svn:log to the new
+ log message:</para>
 
-$ svn status
-? mistake.txt
-? whoops
+ <screen>
+$ svn propset --revprop -r 25 svn:log "Journaled about trip to New York."
+property `svn:log' set on repository revision '25'
           </screen>
 
+ <para>Or, if you don't have a working copy, you can
+ provide a URL.</para>
+
+ <screen>
+$ svn propset --revprop -r 26 svn:log "Document nap." http://svn.red-bean.com/repos
+property `svn:log' set on repository revision '25'
+ </screen>
+
+ <para>Lastly, you can tell propset to take its input from
+ a file. You could even use this to set the contents of a
+ property to something binary:</para>
+
+ <screen>
+$ svn propset owner-pic -F sally.jpg moo.c
+property `owner-pic' set on 'moo.c'
+ </screen>
+
           <warning>
- <para>If you provide no targets to <command>svn
- revert</command>, it will do nothing&mdash;to protect
- you from accidentally losing changes in your working
- copy, <command>svn revert</command> requires you to
- provide at least one target.</para>
+ <para>By default, you cannot modify revision properties
+ in a Subversion repository. Your repository
+ administrator must explicitly enable revision property
+ modifications by creating a hook named
+ 'pre-revprop-change'. See <xref
+ linkend="svn-ch-5-sect-2.1"/> for more information on
+ hook scripts.</para>
           </warning>
 
         </refsect1>
@@ -2663,7 +2566,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn resolved PATH [PATH [PATH ... ]]</programlisting>
+ <programlisting>svn resolved PATH...</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -2740,12 +2643,109 @@
       <!-- ================================================================= -->
       <refentry>
         <refnamediv>
+ <refname>svn revert</refname>
+ <refpurpose>Undo all local edits.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Synopsis</title>
+ <programlisting>svn revert PATH...</programlisting>
+ </refsect1>
+ <refsect1>
+ <title>Description</title>
+
+ <para>Reverts any local changes to a file or directory and
+ resolves any conflicted states. <command>svn
+ revert</command> will not only revert the contents of an
+ item in your working copy, but also any property
+ changes. Finally, you can use it to undo any scheduling
+ operations that you may have done (e.g. files scheduled
+ for addition or deletion can be
+ <quote>unscheduled</quote>).</para>
+ </refsect1>
+
+ <refsect1>
+ <title>Alternate Names</title>
+ <para>None</para>
+ </refsect1>
+
+ <refsect1>
+ <title>Changes</title>
+ <para>Working copy</para>
+ </refsect1>
+
+ <refsect1>
+ <title>Accesses Repository</title>
+ <para>No</para>
+ </refsect1>
+
+ <refsect1>
+ <title>Switches</title>
+
+ <screen>
+--targets FILENAME
+--recursive (-R)
+--quiet (-q)
+ </screen>
+ </refsect1>
+
+ <refsect1>
+ <title>Examples</title>
+
+ <para>Discard changes to a file:</para>
+
+ <screen>
+$ svn revert foo.c
+Reverted foo.c
+ </screen>
+
+ <para>If you want to revert a whole directory of files,
+ use the <option>--recursive</option> flag:</para>
+
+ <screen>
+$svn revert --recursive .
+Reverted newdir/afile
+Reverted foo.c
+Reverted bar.txt
+ </screen>
+
+ <para>Lastly, you can undo any scheduling
+ operations:</para>
+
+ <screen>
+$ svn add mistake.txt whoops
+A mistake.txt
+A whoops
+A whoops/oopsie.c
+
+$ svn revert mistake.txt whoops
+Reverted mistake.txt
+Reverted whoops
+
+$ svn status
+? mistake.txt
+? whoops
+ </screen>
+
+ <warning>
+ <para>If you provide no targets to <command>svn
+ revert</command>, it will do nothing&mdash;to protect
+ you from accidentally losing changes in your working
+ copy, <command>svn revert</command> requires you to
+ provide at least one target.</para>
+ </warning>
+
+ </refsect1>
+ </refentry>
+
+ <!-- ================================================================= -->
+ <refentry>
+ <refnamediv>
           <refname>svn status</refname>
           <refpurpose>Print the status of working copy files and directories.</refpurpose>
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn status [PATH [PATH ... ]]</programlisting>
+ <programlisting>svn status [PATH...]</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -3145,7 +3145,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn update [PATH [PATH ... ]]</programlisting>
+ <programlisting>svn update [PATH...]</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -3287,12 +3287,9 @@
       detailed information, see <xref
         linkend="svn-ch-5-sect-3.1.2"/></para>
 
- <warning>
- <para>Unlike <command>svn</command>,
- <command>svnadmin</command> (as well as other repository
- administration tools) operates on <emphasis>paths</emphasis>
- not <emphasis>URLs</emphasis>.</para>
- </warning>
+ <para>Since <command>svnadmin</command> works via direct repository access
+ (and thus can only be used on the machine that holds the
+ repository), it refers to the repository with a path, not a URL.</para>
       
     <sect2 id="svn-ch-8-sect-2.1">
       <title><command>svnadmin</command> Switches</title>
@@ -3536,7 +3533,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svn help [SUBCOMMAND1 [SUBCOMMAND2] ...]</programlisting>
+ <programlisting>svnadmin help [SUBCOMMAND...]</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -3735,7 +3732,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svnadmin rmtxns REPOS_PATH TXN_NAME [TXN_NAME2 ...]</programlisting>
+ <programlisting>svnadmin rmtxns REPOS_PATH TXN_NAME...</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -3831,17 +3828,17 @@
   <sect1 id="svn-ch-8-sect-3">
     <title><command>svnlook</command></title>
     
- <para><command>svnlook</command> is a command line utility for
+ <para><command>svnlook</command> is a command-line utility for
       examining different aspects of a Subversion repository. It
       does not make any changes to the repository&mdash;it's just
- used for <quote>peeking</quote>.</para>
-
- <para><command>svnlook</command> is typically used by the
+ used for <quote>peeking</quote>.
+ <command>svnlook</command> is typically used by the
       repository hooks, but a repository administrator might find it
- useful for diagnostic purposes. Since
- <command>svnlook</command> works via direct repository access
+ useful for diagnostic purposes.</para>
+
+ <para>Since <command>svnlook</command> works via direct repository access
       (and thus can only be used on the machine that holds the
- repository), it takes paths as targets and not URLs.</para>
+ repository), it refers to the repository with a path, not a URL.</para>
 
     <para>If no revision or transaction is specified,
       <command>svnlook</command> defaults to the youngest (most
@@ -3951,7 +3948,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svnlook cat REPOS_PATH FILE_PATH</programlisting>
+ <programlisting>svnlook cat REPOS_PATH PATH_IN_REPOS</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>
@@ -4291,8 +4288,7 @@
         </refnamediv>
         <refsect1>
           <title>Synopsis</title>
- <programlisting>svnlook proplist REPOS_PATH
- PATH_IN_REPOS</programlisting>
+ <programlisting>svnlook proplist REPOS_PATH PATH_IN_REPOS</programlisting>
         </refsect1>
         <refsect1>
           <title>Description</title>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Thu Aug 28 00:31:26 2003

This is an archived mail posted to the Subversion Dev mailing list.

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.