Date: Fri, 1 Feb 2002 11:30:04 -0800 (PST) From: Giorgos Keramidas <keramida@ceid.upatras.gr> To: freebsd-doc@freebsd.org Subject: Re: docs/34529: [patch] Grammar nits in usbd.conf(5) and usbd(8) Message-ID: <200202011930.g11JU4Y67232@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/34529; it has been noted by GNATS.
From: Giorgos Keramidas <keramida@ceid.upatras.gr>
To: =?ISO-8859-7?Q?David_Sieb=F6rger?= <drs@rucus.ru.ac.za>
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200202011930.g11JU4Y67232>