From owner-freebsd-doc Thu Jun 1 17:16:59 2000 Delivered-To: freebsd-doc@freebsd.org Received: from tomts2-srv.bellnexxia.net (tomts2.bellnexxia.net [209.226.175.140]) by hub.freebsd.org (Postfix) with ESMTP id DFEE937BA02; Thu, 1 Jun 2000 17:16:54 -0700 (PDT) (envelope-from hoek@FreeBSD.org) Received: from orange ([206.172.130.42]) by tomts2-srv.bellnexxia.net (InterMail vM.4.01.02.17 201-229-119) with ESMTP id <20000602001649.GPMN25209.tomts2-srv.bellnexxia.net@orange>; Thu, 1 Jun 2000 20:16:49 -0400 Received: (from tim@localhost) by orange (8.9.3/8.9.1) id UAA19304; Thu, 1 Jun 2000 20:16:46 -0400 (EDT) (envelope-from tim) Date: Thu, 1 Jun 2000 20:16:46 -0400 From: Tim Vanderhoek To: Alexander Langer Cc: FreeBSD-GNATS-submit@freebsd.org, freebsd-doc@freebsd.org Subject: Re: docs/18918: add bus_alloc_resource.9 and bus_release_resource.9 Message-ID: <20000601201645.A18461@orange> References: <200005311510.IAA34279@freefall.freebsd.org> <20000601144703.A8285@cichlids.cichlids.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95i In-Reply-To: <20000601144703.A8285@cichlids.cichlids.com>; from Alexander Langer on Thu, Jun 01, 2000 at 02:47:03PM +0200 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, Jun 01, 2000 at 02:47:03PM +0200, Alexander Langer wrote: > > The bus methods are free to change the RIDs that are passed to it - > that's why it is a pointer. grammar gnit: I think your subject(s) might be having trouble deciding whether it's plural or singular here. > on PCI and device-dependent on ISA and PCCARD). If you specified the default Either add a newline after the period or use two spaces after the period. Preferrably the former. :) > sets the flags for the resource. You can set one or more of these flags: [...] same comment > .Bl -tag -width RF_SHAREABLE > .It Dv RF_ALLOCATED > resource has been reserved. > Resource still needs to be activated with I think that capitalising ``Resource'' here might be confusing. You've chosen to avoid capitalisation when referring to identifiers, which, although it breaks BSD tradition, is ok since it has entered into vogue in the last couple years. Here, although ``resource'' isn't formally an identifier, you've turned it almost into one by saying "resource has been reserved." > This is some example code. The values of [...] spacing Have you had sheldonh@FreeBSD.org review the manpage for its mdoc formatting? I seem to remember he had a standing offer to review all manpages, and a promise to write a list of "common mdoc do's and dont's" which I have yet to see fulfilled. :-) -- Signature withheld by request of author. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message