docs/58111: Handbook 12.4.3 Rebuilding ATA RAID1 Arrays contains errors

[Siebrand Mazeland]

The following reply was made to PR docs/58111; it has been noted by GNATS.

From: "Siebrand Mazeland" <s.mazeland at xs4all.nl>
To: <freebsd-gnats-submit at FreeBSD.org>, <jmt at twilley.org>
Cc:  
Subject: Re: docs/58111: Handbook 12.4.3 Rebuilding ATA RAID1 Arrays contains errors
Date: Sun, 27 Feb 2005 23:54:02 +0100

 The submitted patch was on the HTML page. Below you find a patch to the
 source file. Please evaluate.
 
 Cheers!
 
 Index: en_US.ISO8859-1/books/handbook/disks/chapter.sgml
 ===================================================================
 RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml,v
 retrieving revision 1.232
 diff -u -r1.232 chapter.sgml
 --- en_US.ISO8859-1/books/handbook/disks/chapter.sgml	27 Feb 2005 12:59:47
 -0000	1.232
 +++ en_US.ISO8859-1/books/handbook/disks/chapter.sgml	27 Feb 2005 22:51:59
 -0000
 @@ -716,7 +716,7 @@
  	</step>
  
  	<step>
 -	  <para>Reattach the disk as a spare:</para>
 +	  <para>Reattach the disk:</para>
  
  	  <screen>&prompt.root; <userinput>atacontrol attach 3</userinput>
  Master:  ad6 <MAXTOR 6L080J4/A93.0500> ATA/ATAPI rev 5
 @@ -724,15 +724,24 @@
  	</step>
  
  	<step>
 +	  <para>Reattach the disk as a spare:</para>
 +
 +	  <screen>&prompt.root; <userinput>atacontrol addspare ar0
 ad6</userinput></screen>
 +	</step>
 +
 +	<step>
  	  <para>Rebuild the array:</para>
  
  	  <screen>&prompt.root; <userinput>atacontrol rebuild
 ar0</userinput></screen>
  	</step>
  
  	<step>
 -	  <para>The rebuild command hangs until complete.  However, it is
 possible to open another
 -	  terminal (using <keycombo action="simul"><keycap>Alt</keycap>
 <keycap>F<replaceable>n</replaceable></keycap></keycombo>)
 -          and check on the progress by issuing the following
 command:</para>
 +	  <para>On older versions of FreeBSD, the rebuild command may
 +	    hang until complete.  However, it is possible to open
 +	    another terminal (using <keycombo
 +	      action="simul"><keycap>Alt</keycap>
 <keycap>F<replaceable>n</replaceable></keycap></keycombo>)
 +	    and check on the progress by issuing the following
 +	    command:</para>
  
  	  <screen>&prompt.root; <userinput>dmesg | tail -10</userinput>
  [output removed]