From oberman@es.net  Mon Aug  8 18:42:35 2005
Return-Path: <oberman@es.net>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id A30B616A41F
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  8 Aug 2005 18:42:35 +0000 (GMT)
	(envelope-from oberman@es.net)
Received: from postal2.es.net (postal2.es.net [198.128.3.206])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 6B76F43D46
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  8 Aug 2005 18:42:35 +0000 (GMT)
	(envelope-from oberman@es.net)
Received: from ptavv.es.net ([198.128.4.29])
        by postal2.es.net (Postal Node 2) with ESMTP (SSL) id IBA74465
        for <FreeBSD-gnats-submit@freebsd.org>; Mon, 08 Aug 2005 11:42:34 -0700
Received: by ptavv.es.net (Tachyon Server, from userid 9381)
	id 1E0485D08; Mon,  8 Aug 2005 11:42:34 -0700 (PDT)
Message-Id: <20050808184234.1E0485D08@ptavv.es.net>
Date: Mon,  8 Aug 2005 11:42:34 -0700 (PDT)
From: Kevin Oberman <oberman@es.net>
Reply-To: Kevin Oberman <oberman@es.net>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: atacontrol manpage not current for V5, V6, and -current
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         84676
>Category:       docs
>Synopsis:       [patch] atacontrol manpage not current for V5, V6, and -current
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    brueffer
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Aug 08 18:50:10 GMT 2005
>Closed-Date:    Mon Aug 22 06:19:31 CEST 2005
>Last-Modified:  Mon Aug 22 06:19:31 CEST 2005
>Originator:     Kevin Oberman
>Release:        FreeBSD 5.4-STABLE i386
>Organization:
>Environment:
System: FreeBSD ptavv.es.net 5.4-STABLE FreeBSD 5.4-STABLE #37: Fri Jan 28 11:48:02 PST 2005 oberman@ptavv.es.net:/usr/obj/usr/src/sys/PTAVV i386

>Description:
The man page for atacontrol(8) does not reflect the current syntax of
the command. The argumnets for several commands have changed from
simply the controller number to the controller name, but the man pages
don't reflect this.

>How-To-Repeat:
N/A

>Fix:

--- atacontrol.8	Mon May 16 08:09:13 2005
+++ atacontrol.8.new	Fri May 20 09:27:35 2005
@@ -38,13 +38,13 @@
 .Pp
 .Nm
 .Ic attach
-.Ar channel
+.Ar controller
 .Nm
 .Ic detach
-.Ar channel
+.Ar controller
 .Nm
 .Ic reinit
-.Ar channel
+.Ar controller
 .Nm
 .Ic create
 .Ar type Oo Ar interleave Oc Ar disk0 ... diskN
@@ -65,7 +65,7 @@
 .Ar device
 .Nm
 .Ic info
-.Ar channel
+.Ar controller
 .Nm
 .Ic cap
 .Ar device
@@ -87,25 +87,26 @@
 exercise caution when using this command!
 .Pp
 The
-.Ar channel
-argument is the number of the ATA channel on which to operate.
+.Ar controller
+argument is the name of the ATA controller on which to operate. Ususally
+'ataN'.
 The following commands are supported:
 .Bl -tag -width "rebuild"
 .It Ic attach
 Attach an ATA
-.Ar channel .
-Devices on the channel are probed and attached as
+Ar controller .
+Devices on the controller are probed and attached as
 is done on boot.
 .It Ic detach
 Detach an ATA
-.Ar channel .
-Devices on the channel are removed from the kernel,
+.Ar controller .
+Devices on the controlller are removed from the kernel,
 and all outstanding transfers etc.\& are returned back to the system marked
 as failed.
 .It Ic reinit
 Reinitialize an ATA
-.Ar channel .
-Both devices on the channel are reset and
+.Ar controller .
+Both devices on the controller are reset and
 initialized to the parameters the ATA driver has stored internally.
 Devices that have gone bad and no longer respond to the probe, or devices
 that have physically been removed, are removed from the kernel.
@@ -192,7 +193,7 @@
 .Ar device .
 .It Ic info
 Show info about the attached devices on the
-.Ar channel .
+.Ar controller .
 .It Ic list
 Show info about all attached devices on all active controllers.
 .El



>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: brueffer 
State-Changed-When: Tue Aug 16 23:14:31 CEST 2005 
State-Changed-Why:  
Committed a modified version of Jeremie Le Hen's patch 
from the doc@ list.  Thanks for the submission! 


Responsible-Changed-From-To: freebsd-doc->brueffer 
Responsible-Changed-By: brueffer 
Responsible-Changed-When: Tue Aug 16 23:14:31 CEST 2005 
Responsible-Changed-Why:  
MFC reminder. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=84676 
State-Changed-From-To: patched->closed 
State-Changed-By: brueffer 
State-Changed-When: Mon Aug 22 06:19:08 CEST 2005 
State-Changed-Why:  
MFC done. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=84676 
>Unformatted:
