Improve readability.

Submitted by: bjk
Sponsored by: iXsystems

en_US.ISO8859-1/books/handbook/mirrors/chapter.xml

@@ -133,10 +133,10 @@
       remote directory tree in sync with a central one.  It is built
       into &os; and can be used to synchronize a system with &os;'s
       source repositories.  It supports synchronization of an entire
-      repository or just the specified branches.</para>
+      repository or just a specified set of branches.</para>
 
     <para><application>CTM</application> is specifically designed for
-      use on lousy or non-existent TCP/IP connections.  It provides
+      use on lousy or non-existent TCP/IP connections and provides
       the ability for changes to be automatically sent by email.  It
       requires the user to obtain up to three deltas per day for the
       most active branches.  Update sizes are always kept as small as
@@ -153,7 +153,7 @@
     <para>Little documentation exists on the process of creating
       deltas or using <application>CTM</application> for other
       purposes.  Contact the &a.ctm-users.name; mailing list for
-      questions on using <application>CTM</application>.</para>
+      answers to questions on using <application>CTM</application>.</para>
 
     <sect2 xml:id="mirrors-ctm">
       <title>Getting Deltas</title>
@@ -165,8 +165,8 @@
       <para><acronym>FTP</acronym> deltas can be obtained from the
 	following mirror sites.  When using anonymous
 	<acronym>FTP</acronym> to obtain
-	<application>CTM</application> deltas, select a geographically
-	close mirror.  In case of problems, contact the
+	<application>CTM</application> deltas, select a mirror that is
+	geographically nearby.  In case of problems, contact the
 	&a.ctm-users.name; mailing list.</para>
 
       <variablelist>
@@ -228,7 +228,7 @@
 	of the <literal>ctm-src</literal> distribution lists available
 	from <uri
 	  xlink:href="http://lists.freebsd.org/mailman/listinfo">http://lists.freebsd.org/mailman/listinfo</uri>.
-	For example, &a.ctm-src-cur.name; supports the HEAD of the
+	For example, &a.ctm-src-cur.name; supports the head
 	development branch and  &a.ctm-src-9.name; supports the 9.X
 	release branch.</para>
 
@@ -242,8 +242,8 @@
 	<para>Regardless of the method which is used to get deltas,
 	  <application>CTM</application> users should subscribe
 	  to the &a.ctm-announce.name; mailing list as this is the
-	  only place where announcements concerning the operation of
-	  the <application>CTM</application> system are posted.</para>
+	  only mechanism by which <application>CTM</application>
+	  announcements are posted.</para>
       </note>
     </sect2>
 
@@ -275,18 +275,18 @@
       <screen>&prompt.root; <userinput>cd /directory/to/store/the/stuff</userinput>
 &prompt.root; <userinput>ctm -v -v /directory/which/stores/the/deltas/src-xxx.*</userinput></screen>
 
-      <para>Multiple deltas can be applied at one time as they will
+      <para>Multiple deltas can be applied with a single command as they will
 	be processed one at a time and any deltas that are already
 	applied will be ignored.  <application>CTM</application>
-	understands deltas which have been put through
-	<command>gzip</command>, which saves disk space.</para>
+	understands
+	<command>gzip</command> compressed deltas, which saves disk space.</para>
 
       <para>To verify a delta without applying it, include
-	<option>-c</option>.  <application>CTM</application> will not
-	actually touch the local tree but will instead verify the
+	<option>-c</option> in the command line.  <application>CTM</application> will not
+	actually modify the local tree but will instead verify the
 	integrity of the delta to see if it would apply cleanly.
 	Refer to &man.ctm.1; for more information about available
-	switches and an overview of the process
+	options and an overview of the process
 	<application>CTM</application> uses when applying
 	deltas.</para>
 
@@ -295,8 +295,9 @@
 	<application>CTM</application>.</para>
 
       <para>Once applied, it is recommended to not delete the deltas
-	if it is a burden to download them again.  This way, a loca
-	copy is available in case something bad happens.</para>
+	if it is a burden to download them again.  This way, a local
+	copy is available in case it is needed for future disaster
+	recovery.</para>
     </sect2>
 
     <sect2>
@@ -343,7 +344,7 @@
 	  <listitem>
 	    <para>To backup all of the files that would be changed by
 	      a <application>CTM</application> update, specify
-	      <option>-B backup-file</option>.  This option tells
+	      <option>-B <replaceable>backup-file</replaceable></option>.  This option tells
 	      <application>CTM</application> to backup all files
 	      touched by the applied <application>CTM</application>
 	      delta to <filename>backup-file</filename>.</para>