Date: Thu, 5 Apr 2001 09:50:28 +0300 From: Ruslan Ermilov <ru@FreeBSD.org> To: Maxim Sobolev <sobomax@FreeBSD.org> Cc: John Baldwin <jhb@FreeBSD.org>, cvs-all@FreeBSD.org, cvs-committers@FreeBSD.org Subject: Re: cvs commit: src/share/man/man4 witness.4 Message-ID: <20010405095028.C42614@sunbay.com> In-Reply-To: <3ACB5AF4.29BE83D7@FreeBSD.org>; from sobomax@FreeBSD.org on Wed, Apr 04, 2001 at 08:33:41PM %2B0300 References: <200104041152.f34Bq0C79971@freefall.freebsd.org> <XFMail.010404094705.jhb@FreeBSD.org> <20010404200441.A94213@sunbay.com> <3ACB5AF4.29BE83D7@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, Apr 04, 2001 at 08:33:41PM +0300, Maxim Sobolev wrote: > Ruslan Ermilov wrote: > > > On Wed, Apr 04, 2001 at 09:47:05AM -0700, John Baldwin wrote: > > > > > > On 04-Apr-01 Ruslan Ermilov wrote: > > > > ru 2001/04/04 04:52:00 PDT > > > > > > > > Modified files: > > > > share/man/man4 witness.4 > > > > Log: > > > > mdoc(7) police: fix markup and spelling. > > > > > > > > Revision Changes Path > > > > 1.2 +13 -9 src/share/man/man4/witness.4 > > > > > > Please go fix all the other manpages that specify kernel options to use .Qq Dv > > > as well so that there is a consistent style to pull from. > > > > > Look, I do my best, but I can't do all at once. If you want to help, > > you are welcome! If you wonder why this is required, I will explain. > > Putting the name in -mdoc macro prevents it from being hyphenated. > > PostScript output looks better, etc. > > This brings up another old question: is anybody from the -doc team > considering to create a mdoclint script, that can catch and report > common inconsistencies in the manpage? Thus each particular non-doc > committer would be able to fix his own 3hit instead of consuming > valuable time of other committers. > You know, -mdocNG is a really good thing; it warns about virtually every possible error. Another issue is style. The new mdoc(7) manpage covers many gory details of writing manual pages under -mdoc. Hopefully, you will see it in FreeBSD really soon now. Cheers, -- Ruslan Ermilov Oracle Developer/DBA, ru@sunbay.com Sunbay Software AG, ru@FreeBSD.org FreeBSD committer, +380.652.512.251 Simferopol, Ukraine http://www.FreeBSD.org The Power To Serve http://www.oracle.com Enabling The Information Age 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?20010405095028.C42614>