From owner-freebsd-doc@FreeBSD.ORG  Sun Feb 27 23:00:33 2005
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id BDBEA16A4CF
	for <freebsd-doc@hub.freebsd.org>;
	Sun, 27 Feb 2005 23:00:33 +0000 (GMT)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 7D02043D53
	for <freebsd-doc@hub.freebsd.org>;
	Sun, 27 Feb 2005 23:00:33 +0000 (GMT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.13.1/8.13.1) with ESMTP id j1RN0XrP071515
	for <freebsd-doc@freefall.freebsd.org>; Sun, 27 Feb 2005 23:00:33 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.13.1/8.13.1/Submit) id j1RN0XGS071514;
	Sun, 27 Feb 2005 23:00:33 GMT
	(envelope-from gnats)
Date: Sun, 27 Feb 2005 23:00:33 GMT
Message-Id: <200502272300.j1RN0XGS071514@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: "Siebrand Mazeland" <s.mazeland@xs4all.nl>
Subject: Re: docs/58111: Handbook 12.4.3 Rebuilding ATA RAID1 Arrays
	contains errors
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
Reply-To: Siebrand Mazeland <s.mazeland@xs4all.nl>
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 27 Feb 2005 23:00:33 -0000

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

From: "Siebrand Mazeland" <s.mazeland@xs4all.nl>
To: <freebsd-gnats-submit@FreeBSD.org>, <jmt@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 &lt;MAXTOR 6L080J4/A93.0500&gt; 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]