Bug 40911

Summary: [PATCH] Minor improvements for /usr/share/man/man8/usbd.8.gz
Product: Documentation Reporter: Chris Pepper <pepper>
Component: Books & ArticlesAssignee: Murray Stokely <murray>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
usbd.8.diff none

Description Chris Pepper 2002-07-23 04:00:03 UTC 
	There are some infelicities in usbd.8.

Fix: Apply this patch.
How-To-Repeat: 	man usbd
Comment 1 parv 2002-07-23 06:00:36 UTC 
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

--
Comment 2 parv 2002-07-23 06:16:05 UTC 
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).


--
Comment 3 drs 2002-07-23 10:24:58 UTC 
I raised similar points in docs/34529.


--=20
David Sieb=F6rger
drs@rucus.ru.ac.za
Comment 4 Daniel Harris 2002-07-23 13:20:11 UTC 
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
Comment 5 dannyboy freebsd_committer freebsd_triage 2002-07-23 13:34:15 UTC 
I believe my reply to this was lost.  The patch is right AFAICT; 
the list of actions is what is being searched.
Comment 6 Murray Stokely freebsd_committer freebsd_triage 2003-05-04 23:13:19 UTC 
State Changed
From-To: open->analyzed

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.
Comment 7 Murray Stokely freebsd_committer freebsd_triage 2003-05-04 23:13:19 UTC 
Responsible Changed
From-To: freebsd-doc->murray

My MFC reminder.
Comment 8 Murray Stokely freebsd_committer freebsd_triage 2003-05-11 00:46:05 UTC 
State Changed
From-To: analyzed->closed

This change has been merged to -STABLE.  Thanks for the submission.