You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@subversion.apache.org by Mason Thomas <ml...@sbcglobal.net> on 2003/11/23 07:44:37 UTC

[PATCH] resend: fix typos/consistency in book (ch03.xml)

Hi, this is a resend of an earlier patch...

the following patch fixes a few typos in the Subversion book, including
typos and internal consistency. I've also changed a section heading,
because "Other Frequently Used Commands" really aren't frequently used.

As an aside, I noticed that footnote #2 in this chapter is not present
in the pdf version on red-bean.com, but it appears to be OK in the xml
code. I have no idea how to fix this, but thought the people in power
should know about it.

-Mason

log message:
* doc/book/book/ch03.xml: fix typos and internal consistency


Index: ch03.xml
===================================================================
--- ch03.xml	(revision 7830)
+++ ch03.xml	(working copy)
@@ -31,7 +31,7 @@
 
     <para>Before reading on, here is the most important command you'll
       ever need when using Subversion: <command>svn help</command>.
-      The Subversion command-line client tries to be
+      The Subversion command-line client is
       self-documenting&mdash;at any time, a quick <command>svn help
       &lt;subcommand&gt;</command> will describe the syntax, switches,
       and behavior of the <command>subcommand</command>.</para>
@@ -199,10 +199,10 @@
         a range of changes in the repository using both dates and
         revisions together!</para>
       
-      <para>Subversion accepts an incredible number of date formats
-        &mdash;just remember to use quotes around any date that
-        contains spaces.  Here are just a few of the formats that
-        Subversion accepts:</para>
+      <para>Subversion accepts an incredible number of date
+        formats&mdash;just remember to use quotes around any date
+        that contains spaces.  Here are just a few of the formats
+        that Subversion accepts:</para>
 
       <screen>
 $ svn checkout --revision {2002-02-17}
@@ -422,10 +422,10 @@
             <para><command>svn delete</command></para>
           </listitem>
           <listitem>
-            <para><command>svn move</command></para>
+            <para><command>svn copy</command></para>
           </listitem>
           <listitem>
-            <para><command>svn copy</command></para>
+            <para><command>svn move</command></para>
           </listitem>
         </itemizedlist>
       </listitem>
@@ -720,8 +720,8 @@
       <para>Once you've finished making changes, you need to commit
         them to the repository, but before you do so, it's usually a
         good idea to take a look at exactly what you've changed.  By
-        examining your changes before you commit, you cannot only
-        make a more accurate log message, but you may discover that
+        examining your changes before you commit, you can make a
+        more accurate log message. You may also discover that
         you've inadvertently changed a file, and this gives you a
         chance to revert those changes before committing.
         Additionally, this is a good opportunity to review and
@@ -886,7 +886,7 @@
                 copy is some other kind.  For example, Subversion might
                 have a file in the repository, but you removed the file
                 and created a directory in its place, without using the
-                <command>svn delete</command> nor <command>svn add</command>
+                <command>svn delete</command> or <command>svn add</command>
                 commands.</para>
             </listitem>
           </varlistentry>
@@ -981,7 +981,7 @@
            
         <para>This is the <quote>long form</quote> output of
           <command>svn status</command>.  The first column remains
-          same, but the second column shows the working-revision of
+          the same, but the second column shows the working-revision of
           the item.  The third and fourth columns show the revision in
           which the item last changed, and who changed it.</para>
 
@@ -1047,11 +1047,11 @@
 +
 +#include &lt;stdio.h&gt;
 
-int main(void) {
+ int main(void) {
 -  printf("Sixty-four slices of American Cheese...\n");
 +  printf("Sixty-five slices of American Cheese...\n");
-return 0;
-}
+ return 0;
+ }
 
 Index: ./README
 ===================================================================
@@ -1231,7 +1231,7 @@
         them.</para>
            
       <para>Whenever a conflict occurs, your Subversion client does
-      the three things:</para>
+      three things:</para>
            
       <itemizedlist>
 
@@ -1428,7 +1428,7 @@
         the office and explain to Sally that you can't get sauerkraut
         from an Italian deli.<footnote><para>And if you ask them for
         it, they may very well ride you out of town on a
-        rail</para></footnote>  Once you've agreed on the changes you
+        rail.</para></footnote>  Once you've agreed on the changes you
         will check in, edit your file and remove the conflict markers.</para>
 
         <screen>
@@ -1614,7 +1614,7 @@
       and allows you to explore this history by examining previous
       versions of files and directories as well as the metadata that
       accompanies them.  With a single Subversion command, you can
-      check out (or restore an existing working copy) the repository
+      check out the repository (or restore an existing working copy)
       exactly as it was at any date or revision number in the past.
       However, sometimes you just want to <emphasis>peer
       into</emphasis> the past instead of <emphasis>going
@@ -1997,7 +1997,7 @@
   <!-- ======================== SECTION 7 ============================== -->
   <!-- ================================================================= -->
   <sect1 id="svn-ch-3-sect-7">
-    <title>Other Frequently Used Commands</title>
+    <title>Other Useful Commands</title>
 
       <para>While not as frequently used as the commands previously
       discussed in this chapter, you will need these commands on
@@ -2042,8 +2042,8 @@
     <sect2 id="svn-ch-3-sect-7.3">
       <title><command>svn import</command></title>
 
-      <para>The import command is a quick way to move an unversioned
-        tree of files into a repository.</para>
+      <para>The <command>svn import</command> command is a quick way
+        to move an unversioned tree of files into a repository.</para>
 
       <screen>
 $ svnadmin create /usr/local/svn/newrepos

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Re: [PATCH] resend: fix typos/consistency in book (ch03.xml)

Posted by Julian Foad <ju...@btopenworld.com>.
Mason Thomas wrote:
> Hi, this is a resend of an earlier patch...
> 
> the following patch fixes a few typos in the Subversion book, including
> typos and internal consistency. I've also changed a section heading,
> because "Other Frequently Used Commands" really aren't frequently used.
[...]
> log message:
> * doc/book/book/ch03.xml: fix typos and internal consistency

All looks good.  Committed in r7831.  This is the log message that I used:

[[[
Patch from Mason Thomas <ml...@sbcglobal.net>:

Fix a few things in the Subversion book.

* doc/book/book/ch03.xml: Fix typos and internal consistency.  Change
  a section heading because "Other Frequently Used Commands" really
  aren't frequently used.
]]]

Thanks.

- Julian



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org