[svnbook commit] r2970 - trunk/src/en/book

[cmpilato]

Author: cmpilato
Date: Tue Jan 22 15:48:25 2008
New Revision: 2970

Log:
Update book text around recent changelist feature changes.

Modified:
   trunk/src/en/book/ch03-advanced-topics.xml
   trunk/src/en/book/ch09-reference.xml

Modified: trunk/src/en/book/ch03-advanced-topics.xml
==============================================================================
--- trunk/src/en/book/ch03-advanced-topics.xml	(original)
+++ trunk/src/en/book/ch03-advanced-topics.xml	Tue Jan 22 15:48:25 2008
@@ -3341,17 +3341,16 @@
       labels applied to working copy files for the express purpose of
       associating multiple files together.  Users of many of Google's
       software offerings are familiar with this concept already.  For
-      example, Gmail doesn't provide the traditional folders-based
-      email organization mechanism.  In <ulink
-      url="http://mail.google.com/">Gmail</ulink>, you apply arbitrary
-      labels to emails, and multiple emails can be said to be part of
-      the same group if they happen to share a particular label.
-      Viewing only a group of similarly labeled emails then becomes a
-      simple user interface trick.  Many other Web 2.0 sites have
-      similar mechanisms—consider the <quote>tags</quote> used
-      by sites like <ulink
-      url="http://www.youtube.com/">YouTube</ulink> and <ulink
-      url="http://www.flickr.com/">Flickr</ulink>,
+      example, <ulink url="http://mail.google.com/">Gmail</ulink>
+      doesn't provide the traditional folders-based email organization
+      mechanism.  In Gmail, you apply arbitrary labels to emails, and
+      multiple emails can be said to be part of the same group if they
+      happen to share a particular label.  Viewing only a group of
+      similarly labeled emails then becomes a simple user interface
+      trick.  Many other Web 2.0 sites have similar
+      mechanisms—consider the <quote>tags</quote> used by sites
+      like <ulink url="http://www.youtube.com/">YouTube</ulink> and
+      <ulink url="http://www.flickr.com/">Flickr</ulink>,
       <quote>categories</quote> applied to blog posts, and so on.
       Folks understand today that organization of data is critical,
       but that how that data is organized needs to be a flexible
@@ -3562,7 +3561,7 @@
         user interface fix by doing the following:</para>
 
       <screen>
-$ svn ci -m "Fix a user interface bug found while working on math logic." \
+$ svn ci -m "Fix a UI bug found while working on math logic." \
       --changelist ui-fix
 Sending        button.c
 Transmitting file data .
@@ -3572,9 +3571,9 @@
 
       <para>In fact, the <command>svn commit</command> command
         provides a second changelists-related option:
-        <option>--keep-changelist</option>.  Normally, changelist
+        <option>--keep-changelists</option>.  Normally, changelist
         assignments are removed from files after they are committed.
-        But if <option>--keep-changelist</option> is provided,
+        But if <option>--keep-changelists</option> is provided,
         Subversion will leave the changelist assignment on the
         committed (and now unmodified) files.  In any case, committing
         files assigned to one changelist leaves other changelists
@@ -3611,17 +3610,22 @@
         quickly and easily rename or remove a changelist.</para>
 
       <screen>
-$ svn changelist math-bugs --changelist math-fixes
+$ svn changelist math-bugs --changelist math-fixes --depth infinity
 svn: warning: Removing 'integer.c' from changelist 'math-fixes'.
 Path 'integer.c' is now a member of changelist 'math-bugs'.
 svn: warning: Removing 'mathops.c' from changelist 'math-fixes'.
 Path 'mathops.c' is now a member of changelist 'math-bugs'.
-$ svn changelist --remove --changelist math-bugs
+$ svn changelist --remove --changelist math-bugs --depth infinity
 Path 'integer.c' is no longer a member of a changelist.
 Path 'mathops.c' is no longer a member of a changelist.
 $
 </screen>
 
+      <para>Finally, you can specify multiple instances of the
+        <option>--changelist</option> option on a single command
+        line.  Doing so limits the operation you are performing to
+        files found in any of the specified changesets.</para>
+
     </sect2>
 
     <!-- =============================================================== -->

Modified: trunk/src/en/book/ch09-reference.xml
==============================================================================
--- trunk/src/en/book/ch09-reference.xml	(original)
+++ trunk/src/en/book/ch09-reference.xml	Tue Jan 22 15:48:25 2008
@@ -85,7 +85,8 @@
             <replaceable>ARG</replaceable></term>
           <listitem>
             <para>Operate only on members of changelist named
-              <replaceable>ARG</replaceable>.</para>
+              <replaceable>ARG</replaceable>.  This option can be used
+              multiple times to specify sets of changelists.</para>
           </listitem>
         </varlistentry>
 
@@ -1026,6 +1027,7 @@
 
           <screen>
 --remove
+--depth ARG
 --targets ARG
 --changelist ARG
 --config-dir ARG
@@ -2661,7 +2663,6 @@
 --no-auth-cache
 --non-interactive
 --config-dir DIR
---changelist ARG
 </screen>
         </refsect1>
 
@@ -2789,7 +2790,6 @@
 --no-auth-cache
 --non-interactive
 --config-dir DIR
---changelist ARG
 </screen>
         </refsect1>
 
@@ -4744,7 +4744,6 @@
 --non-interactive
 --config-dir DIR
 --force
---changelist ARG
 </screen>
         </refsect1>