From owner-freebsd-doc Fri Feb 1 11:30:29 2002 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 186EA37B400 for ; Fri, 1 Feb 2002 11:30:04 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g11JU4Y67232; Fri, 1 Feb 2002 11:30:04 -0800 (PST) (envelope-from gnats) Date: Fri, 1 Feb 2002 11:30:04 -0800 (PST) Message-Id: <200202011930.g11JU4Y67232@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Giorgos Keramidas Subject: Re: docs/34529: [patch] Grammar nits in usbd.conf(5) and usbd(8) Reply-To: Giorgos Keramidas Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR docs/34529; it has been noted by GNATS. From: Giorgos Keramidas To: =?ISO-8859-7?Q?David_Sieb=F6rger?= Cc: bug-followup@freebsd.org Subject: Re: docs/34529: [patch] Grammar nits in usbd.conf(5) and usbd(8) Date: Fri, 1 Feb 2002 21:16:53 +0200 (EET) David Sieb=F6rger wrote: > --- usr.sbin/usbd/usbd.conf.5.orig=09Thu Aug 16 17:56:41 2001 > +++ usr.sbin/usbd/usbd.conf.5=09Fri Feb 1 15:57:51 2002 > @@ -64,7 +64,7 @@ > There are 3 types of fields: > descriptive fields, selection criteria and commands to execute on > events. > -The field name is case sensitive and should be all lower case. > +The field names are case sensitive and should be all lower case. Mmm, seems ok. > -Product Id=09> -Vendor Id=09> -Release Id > +Product ID=09> +Vendor ID=09> +Release ID Hum, capitalization is prime time flamefest/bikeshed material. I can't comment on this. Someone with more 'english style' expertize will probably know better. > @@ -156,8 +156,8 @@ > .Xr usbd 8 , > .Xr usbdevs 8 > .Sh BUGS > -It is currently not possible to use a selection criterium more than once= =2E For > -example it is not possible to specify more than one vendor Id. > +It is currently not possible to use a selection criterion more than once= =2E For > +example, it is not possible to specify more than one vendor ID. > .Sh AUTHORS > -The man page for the usbd configuration file was written by > +The manual page for the usbd configuration file was written by > .An Nick Hibma Aq n_hibma@FreeBSD.org . Is this even necessary? I haven't searched the sources for -all- the manpages to see which have an 'AUTHORS' section. Others do have a section like that (ipfw.8 for instance). What do others think? > --- usr.sbin/usbd/usbd.8.orig=09Thu Aug 16 17:56:41 2001 > +++ usr.sbin/usbd/usbd.8=09Fri Feb 1 15:57:51 2002 > @@ -56,7 +56,7 @@ > 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. Good catch :) > @@ -80,7 +80,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. `The list .. is searched.' This is correct as it is IMHO. I'm not a native speaker, and I might be wrong here, but this would probably look OK, if written as the following: =09Whenever a device is attached or detached, =09the list of actions (which is read from =09.Pa /etc/usbd.conf ) =09is searched for a matching entry. or something similar. What do you think? --=20 Giorgos Keramidas . . . . . . . . . keramida@{ceid.upatras.gr,freebsd.org} FreeBSD Documentation Project . . . http://www.freebsd.org/docproj/ FreeBSD: The power to serve . . . . http://www.freebsd.org/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message