Date: Fri, 24 Sep 1999 03:59:39 -0500 (CDT) From: Mike Pritchard <mpp@FreeBSD.org> To: phantom@cris.net (Alexey Zelkin) Cc: freebsd@gndrsh.dnsmgr.net (Rodney W. Grimes), cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/contrib/groff/tmac tmac.doc Message-ID: <199909240859.DAA03941@mpp.pro-ns.net> In-Reply-To: <19990923084222.A9515@scorpion.crimea.ua> from Alexey Zelkin at "Sep 23, 1999 08:42:22 am"
next in thread | previous in thread | raw e-mail | index | archive | help
> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199909240859.DAA03941>