From owner-cvs-all Fri Sep 24 2: 2: 8 1999 Delivered-To: cvs-all@freebsd.org Received: from mpp.pro-ns.net (pppdsle45.mpls.uswest.net [216.160.23.45]) by hub.freebsd.org (Postfix) with ESMTP id 7F3841513F; Fri, 24 Sep 1999 02:02:01 -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 DAA03941; Fri, 24 Sep 1999 03:59:39 -0500 (CDT) (envelope-from mpp) From: Mike Pritchard Message-Id: <199909240859.DAA03941@mpp.pro-ns.net> Subject: Re: cvs commit: src/contrib/groff/tmac tmac.doc In-Reply-To: <19990923084222.A9515@scorpion.crimea.ua> from Alexey Zelkin at "Sep 23, 1999 08:42:22 am" To: phantom@cris.net (Alexey Zelkin) Date: Fri, 24 Sep 1999 03:59:39 -0500 (CDT) Cc: freebsd@gndrsh.dnsmgr.net (Rodney W. Grimes), cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org 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-cvs-all@FreeBSD.ORG Precedence: bulk > hi, > > On Wed, Sep 22, 1999 at 06:23:59PM -0700, Rodney W. Grimes wrote: > > > phantom 1999/09/22 15:38:39 PDT > > > > > > Modified files: (Branch: RELENG_3) > > > contrib/groff/tmac tmac.doc > > > Log: > > > MFC: Allow .Rv macro to be used in 7th man section. > > > > What in section 7 of the manual is talking about Return Values > > from function calls? If your talking about the mdoc.samples > > use of this to demonstrate how it works, it should not have > > been done by invoking the .Rv macro itself, but by proper > Yes, this applied to mdoc.samples.7. And I strongly disagree to > use hardcoded text: I've been meaning to make this exact change myself for a while, and when Alexey showed me a patch that did it, I said go ahead and do it. I would rather have mdoc(7) and mdoc.samples(7) have all of their example text generated by the actual mdoc macros, rather than "faking" the text by some other means to prevent "man 7 mdoc.samples" from generating a error. This prevents those two man pages from rotting when someone changes the actual macro, but forgets to update the section 7 man pages. Several other macros were not documented, but seldom used until I ran across them a couple of years ago by reading the mdoc sources. .Rv is one of them. Since section 7 is pretty open about its contents, I don't see a real problem here. -Mike -- Mike Pritchard mpp@FreeBSD.org or mpp@mpp.pro-ns.net To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message