From pepper@reppep.com  Mon Jul 22 19:53:01 2002
Return-Path: <pepper@reppep.com>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id E6BA037B400
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 22 Jul 2002 19:53:01 -0700 (PDT)
Received: from guest.reppep.com (guest.reppep.com [64.81.19.110])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 8BD2443E65
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 22 Jul 2002 19:53:01 -0700 (PDT)
	(envelope-from pepper@reppep.com)
Received: by guest.reppep.com (Postfix, from userid 501)
	id 50E5FA970; Mon, 22 Jul 2002 22:53:38 -0400 (EDT)
Message-Id: <20020723025338.50E5FA970@guest.reppep.com>
Date: Mon, 22 Jul 2002 22:53:38 -0400 (EDT)
From: Chris Pepper <pepper@rockefeller.edu>
Reply-To: Chris Pepper <pepper@rockefeller.edu>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] Minor improvements for /usr/share/man/man8/usbd.8.gz
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         40911
>Category:       docs
>Synopsis:       [PATCH] Minor improvements for /usr/share/man/man8/usbd.8.gz
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    murray
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jul 22 20:00:03 PDT 2002
>Closed-Date:    Sat May 10 16:46:21 PDT 2003
>Last-Modified:  Sat May 10 16:46:21 PDT 2003
>Originator:     Chris Pepper
>Release:        FreeBSD 4.6-STABLE i386
>Organization:
>Environment:
System: FreeBSD guest.reppep.com 4.6-STABLE FreeBSD 4.6-STABLE #6: Mon Jul 15 21:04:43 EDT 2002 root@guest.reppep.com:/usr/obj/usr/src/sys/GENERIC i386


	
>Description:
	There are some infelicities in usbd.8.
>How-To-Repeat:
	man usbd
>Fix:
	Apply this patch.

--- usbd.8.diff begins here ---
--- usbd.8	Mon Jul  8 22:33:18 2002
+++ usbd.8.fixed	Mon Jul  8 22:44:46 2002
@@ -51,12 +51,12 @@
 .Op Fl v
 .Sh DESCRIPTION
 .Nm
-handles the USB device attachment and detachment.
+handles USB device attachment and detachment.
 It does two things.
 Through opening the
 .Pa /dev/usb0 ,
 .Pa /dev/usb1 ,
-etc. devices, it enables the kernel to do handle change requests from
+etc., devices, it enables the kernel to handle change requests from
 attached hubs.
 This functionality will be removed when the kernel has
 kernel threads.
@@ -70,7 +70,9 @@
 .Dq ohci
 and
 .Dq uhci
-modules are not loaded, it will load them automatically.
+modules are not loaded,
+.Nm
+will load them automatically.
 .Pp
 The second part is the handling of the attachment and detachment of USB
 devices.
@@ -80,7 +82,7 @@
 Whenever a device is attached or
 detached the list of actions read from
 .Pa /etc/usbd.conf
-are searched for a matching entry.
+is searched for a matching entry.
 If found, the corresponding action is
 executed.
 .Pp
--- usbd.8.diff ends here ---


>Release-Note:
>Audit-Trail:

From: parv@subdimension.com
To: Chris Pepper <pepper@rockefeller.edu>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/40911: [PATCH] Minor improvements for /usr/share/man/man8/usbd.8.gz
Date: Tue, 23 Jul 2002 01:00:36 -0400

 in message <20020723025338.50E5FA970@guest.reppep.com>,
 wrote Chris Pepper thusly...
 >
 > 
 > >Number:         40911
 > >Category:       docs
 ...
 >  It does two things.
 >  Through opening the
 >  .Pa /dev/usb0 ,
 >  .Pa /dev/usb1 ,
 > -etc. devices, it enables the kernel to do handle change requests from
 > +etc., devices, it enables the kernel to handle change requests from
 >  attached hubs.
 
 comma after "etc." is incorrect as "etc." is a part of the list
 containing usb[01] devices.  to see this another way...
 
   apples, oranges, pears, etc. fruits were being sold at the fare.
 
 
 >  Whenever a device is attached or
 >  detached the list of actions read from
 >  .Pa /etc/usbd.conf
 > -are searched for a matching entry.
 > +is searched for a matching entry.
 
 actions are being searched, already being read from the file, for a
 match.  as the sentence stands (w/ or w/o patch), it is not the file
 that is being for a particular action.
 
 
 in any case, a comma after "...attached or detached" will be most
 appropriate to read...
 
   Whenever a device is attached or detached, the list of actions
   read from /etc/usbd.conf are searched for a matching entry.
 
 
   - parv
 
 -- 
  

From: parv <parv@subdimension.com>
To: f-gnats-submit <freebsd-gnats-submit@freebsd.org>
Cc: pepper@rockefeller.edu
Subject: Re: docs/40911: [PATCH] Minor improvements for /usr/share/man/man8/usbd.8.gz
Date: Tue, 23 Jul 2002 01:16:05 -0400

 i see the errors of my ways.
 
 
 wrote i thus...
 >    apples, oranges, pears, etc. fruits were being sold at the fare.
 
 s/fare/fair/
 
 
 >  actions are being searched, already being read from the file, for a
 >  match. 
 
 "already being read" should read "already having been read".
 
 
 all that doesn't help while commenting on someone else's (errors).
 
 
 -- 
  

From: =?ISO-8859-1?Q?David_Sieb=F6rger?= <drs@rucus.ru.ac.za>
To: freebsd-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/40911: [PATCH] Minor improvements for /usr/share/man/man8/usbd.8.gz
Date: Tue, 23 Jul 2002 11:24:58 +0200

 I raised similar points in docs/34529.
 
 
 --=20
 David Sieb=F6rger
 drs@rucus.ru.ac.za
 

From: Daniel Harris <dh@askdh.com>
To: parv@subdimension.com
Cc: freebsd-doc@FreeBSD.org
Subject: Re: docs/40911: [PATCH] Minor improvements for /usr/share/man/man8/usbd.8.gz
Date: Tue, 23 Jul 2002 08:20:11 -0400

 On Mon, Jul 22, 2002 at 10:00:09PM -0700, parv@subdimension.com wrote:
 >  in any case, a comma after "...attached or detached" will be most
 >  appropriate to read...
 >  
 >    Whenever a device is attached or detached, the list of actions
 >    read from /etc/usbd.conf are searched for a matching entry.
 
 
 ??.  The _list_ of actions _is_ being searched as I read it, I believe
 the originator is correct.  The list of actions has entries, it is searched
 for an entry.
 
 Or maybe it's just too early for me?  Not sure.
 
 -- 
 Daniel Harris
 
 To Unsubscribe: send mail to majordomo@FreeBSD.org
 with "unsubscribe freebsd-doc" in the body of the message
 

From: dannyboy@freebsd.org
To: freebsd-gnats-submit@FreeBSD.org, pepper@rockefeller.edu
Cc:  
Subject: Re: docs/40911: [PATCH] Minor improvements for /usr%
Date: Tue, 23 Jul 2002 08:34:15 -0400 (EDT)

 I believe my reply to this was lost.  The patch is right AFAICT; 
 the list of actions is what is being searched.
 
State-Changed-From-To: open->analyzed 
State-Changed-By: murray 
State-Changed-When: Sun May 4 15:13:19 PDT 2003 
State-Changed-Why:  
This patch has been applied to -CURRENT (modulo the incorrect comma 
addition).  Thanks for the submission.  This will be MFCed to -STABLE 
in a few days. 



Responsible-Changed-From-To: freebsd-doc->murray 
Responsible-Changed-By: murray 
Responsible-Changed-When: Sun May 4 15:13:19 PDT 2003 
Responsible-Changed-Why:  
My MFC reminder. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=40911 
State-Changed-From-To: analyzed->closed 
State-Changed-By: murray 
State-Changed-When: Sat May 10 16:46:05 PDT 2003 
State-Changed-Why:  
This change has been merged to -STABLE.  Thanks for the submission. 


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