From owner-freebsd-current  Mon Jun 29 03:27:12 1998
Return-Path: <owner-freebsd-current@FreeBSD.ORG>
Received: (from majordom@localhost)
          by hub.freebsd.org (8.8.8/8.8.8) id DAA18901
          for freebsd-current-outgoing; Mon, 29 Jun 1998 03:27:12 -0700 (PDT)
          (envelope-from owner-freebsd-current@FreeBSD.ORG)
Received: from godzilla.zeta.org.au (godzilla.zeta.org.au [203.15.68.22])
          by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id DAA18875
          for <current@FreeBSD.ORG>; Mon, 29 Jun 1998 03:27:04 -0700 (PDT)
          (envelope-from bde@godzilla.zeta.org.au)
Received: (from bde@localhost)
	by godzilla.zeta.org.au (8.8.7/8.8.7) id UAA20289;
	Mon, 29 Jun 1998 20:27:00 +1000
Date: Mon, 29 Jun 1998 20:27:00 +1000
From: Bruce Evans <bde@zeta.org.au>
Message-Id: <199806291027.UAA20289@godzilla.zeta.org.au>
To: dfr@nlsystems.com, tomdean@ix.netcom.com
Subject: Re: Draft manpages available for review
Cc: current@FreeBSD.ORG
Sender: owner-freebsd-current@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.ORG

>I didn't bother with a 'Return Values' section for functions which were
>void or where the return value was described in the 'Description' section.

Perhaps the 'Description' section shouldn't say much about return values.

>> devclass            - /usr/include/sys/device.h contains enum devclass { ... }
>
>What I really want to to is 'cvs rm -f sys/device.h' :-).  The concepts
>there are not compatible with the new framework.

It is only used by ccd.c and subr_autoconf.c.  You can start by
unstandardiz^Hsing subr_autoconf.c, which seems to be completely unused
(it's not used by LINT) although only half of it is `#ifdef UNUSED'.

>> devclass_add_driver - ispell says 'initialisation' should be 'initialization'
>
>Do we have any convention in our manpages for which dialect of English
>spelling to use?

Native.

Bruce

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-current" in the body of the message