svn commit: r40951 - head/en_US.ISO8859-1/books/handbook/geom

[Dru Lavigne]

Author: dru
Date: Mon Feb 11 21:50:50 2013
New Revision: 40951
URL: http://svnweb.freebsd.org/changeset/doc/40951

Log:
  Patch to address wblock's comments.
  
  Approved by:  gjb (mentor)

Modified:
  head/en_US.ISO8859-1/books/handbook/geom/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/geom/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/geom/chapter.xml	Mon Feb 11 21:36:00 2013	(r40950)
+++ head/en_US.ISO8859-1/books/handbook/geom/chapter.xml	Mon Feb 11 21:50:50 2013	(r40951)
@@ -316,13 +316,13 @@ Done.</screen>
 	used to replace the old single disk.</para>
 
       <para>&man.gmirror.8; requires a kernel module,
-	<filename>geom_mirror.ko</filename>, either compiled into a
-	custom kernel or loaded at boot- or run-time.  To manually
-	load the kernel module now:</para>
+	<filename>geom_mirror.ko</filename>, either built into the
+	kernel or loaded at boot- or run-time.  Manually load the
+	kernel module now:</para>
 
       <screen>&prompt.root; <userinput>gmirror load</userinput></screen>
 
-      <para>To create the mirror with the two new drives.</para>
+      <para>Create the mirror with the two new drives:</para>
 
       <screen>&prompt.root; <userinput>gmirror label -v gm0 /dev/ada1 /dev/ada2</userinput></screen>
 
@@ -336,8 +336,8 @@ Done.</screen>
 	split-filesystem layout, with partitions for
 	<filename>/</filename>, swap, <filename>/var</filename>,
 	<filename>/tmp</filename>, and <filename>/usr</filename>.  A
-	single <filename>/</filename> and a swap partition will also
-	work.</para>
+	single <filename>/</filename> filesystem and a swap partition
+	will also work.</para>
 
       <para>Partitions on the mirror do not have to be the same size
 	as those on the existing disk, but they must be large enough
@@ -431,15 +431,15 @@ Done.</screen>
     <sect2>
       <title>Creating a Mirror with an Existing Drive</title>
 
-      <para>In this example, &os; has been installed on a single
-	disk, <devicename>ada0</devicename>.  A new disk,
+      <para>In this example, &os; has already been installed on a
+	single disk, <devicename>ada0</devicename>.  A new disk,
 	<devicename>ada1</devicename>, has been connected to the
 	system.  A one-disk mirror will be created on the new disk,
 	the existing system copied onto it, and then the old disk will
 	be inserted into the mirror.  This slightly complex procedure
 	is required because &man.gmirror.8; needs to put a 512-byte
 	block of metadata at the end of each disk, and the existing
-	<devicename>ada0</devicename> usually has all of its space
+	<devicename>ada0</devicename> has usually had all of its space
 	already allocated.</para>
 
       <para>Load the &man.gmirror.8; kernel module:</para>
@@ -463,8 +463,8 @@ Done.</screen>
 	<devicename>gzero.nop</devicename>, even if the new drive
 	(<devicename>ada1</devicename>) has more space.  Note that the
 	<replaceable>1000204821504</replaceable> in the second line
-	should be equal to the size of <devicename>ada0</devicename>
-	as shown by &man.diskinfo.8;.</para>
+	should be equal to <devicename>ada0</devicename>'s media size
+	as shown by &man.diskinfo.8; above.</para>
 
       <screen>&prompt.root; <userinput>geom zero load</userinput>
 &prompt.root; <userinput>gnop create -s 1000204821504 gzero</userinput>
@@ -501,7 +501,7 @@ Done.</screen>
 	be explained later.</para>
 
       <para>In either case, partition tables on the primary disk
-	should be copied first using the &man.gpart.8;
+	should be copied first with the &man.gpart.8;
 	<command>backup</command> and <command>restore</command>
 	subcommands.</para>
 
@@ -526,11 +526,12 @@ BSD 8
 6  freebsd-ufs  130023424  838860800
 7  freebsd-ufs  968884224  984640881</screen>
 
-      <para>If the whole disk shows as used in the output of
-	<command>gpart show</command>, the capacity in these partition
-	tables must be reduced by one sector.  Edit the two files,
-	reducing the size of both the slice and last partition by one.
-	These are the last numbers in each listing.</para>
+      <para>If the output of <command>gpart show</command> shows no
+	free space at the end of the disk, the size of both the slice
+	and the last partition must be reduced by one sector.  Edit
+	the two files, reducing the size of both the slice and last
+	partition by one.  These are the last numbers in each
+	listing.</para>
 
       <screen>&prompt.root; <userinput>cat table.ada0</userinput>
 MBR 4
@@ -706,7 +707,7 @@ mirror/gm0  COMPLETE  ada1 (ACTIVE)
 
 	  <para>BIOS settings may have to be changed to boot from one
 	    of the new mirrored drives.  Either mirror drive can be
-	    used for booting as they contain identical data.</para>
+	    used for booting, as they contain identical data.</para>
 	</sect4>
 
 	<sect4>
@@ -764,7 +765,7 @@ mountroot></screen>
 	    incorrect.  Press the Enter key at the prompt.  Undo the
 	    modifications so far by reverting
 	    <filename>/etc/fstab</filename>, mounting filesystems from
-	    the original <devicename>ada0</devicename> instead
+	    the original disk (<devicename>ada0</devicename>) instead
 	    of the mirror.  Reboot the system and try the procedure
 	    again.</para>