From owner-freebsd-hackers Mon Jul 19 4:23:38 1999 Delivered-To: freebsd-hackers@freebsd.org Received: from mpp.pro-ns.net (mpp.pro-ns.net [208.200.182.72]) by hub.freebsd.org (Postfix) with ESMTP id BB4E114BD7 for ; Mon, 19 Jul 1999 04:23:34 -0700 (PDT) (envelope-from mpp@mpp.pro-ns.net) Received: (from mpp@localhost) by mpp.pro-ns.net (8.9.3/8.9.3) id GAA12394; Mon, 19 Jul 1999 06:22:04 -0500 (CDT) (envelope-from mpp) From: Mike Pritchard Message-Id: <199907191122.GAA12394@mpp.pro-ns.net> Subject: Re: All this and documentation too? (was: cvs commit: src/sys/isa sio.c) In-Reply-To: <3792950D.D09F02ED@newsguy.com> from "Daniel C. Sobral" at "Jul 19, 1999 12:01:33 pm" To: dcs@newsguy.com (Daniel C. Sobral) Date: Mon, 19 Jul 1999 06:22:04 -0500 (CDT) Cc: des@flood.ping.uio.no (Dag-Erling Smorgrav), hackers@FreeBSD.org (FreeBSD Hackers) X-Mailer: ELM [version 2.4ME+ PL54 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-hackers@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG > [trimming CC list] > > Dag-Erling Smorgrav wrote: > > > > Greg Lehey writes: > > > mdoc.samples(7). Now tell me that that's not intuitive. > > > > It would seem mdoc.samples(7) does not teach by example :) > > > > des@des ~% man -t mdoc.samples | lpr -Plex > > Usage: .Rv -std sections 2 and 3 only > > This is a bug in man, actually. Section 7 is misc, and anything > *can* go there. It's perfectly possible to have something in need of > section 2/3 features that happens not to qualify as section 2 or 3. It isn't a bug in man. It is a problem with the mdoc macro package. Technically, mdoc.samples is using a *roff macro in a section that shouldn't be using that macro (the .Rv macro). I've known about this problem for quite some time, but just haven't been willing to commit the fix, since mdoc.samples(7) is the only man page that spits out this error. I do have a fixed version of the mdoc macro package that ignores this error for section 7 man pages. Since I've seen a few comments on this in the past few months, I suppose I'll break down and commit my changes. -- Mike Pritchard mpp@FreeBSD.ORG or mpp@mpp.pro-ns.net To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message