From owner-cvs-all Wed Apr 4 23:50:44 2001 Delivered-To: cvs-all@freebsd.org Received: from whale.sunbay.crimea.ua (whale.sunbay.crimea.ua [212.110.138.65]) by hub.freebsd.org (Postfix) with ESMTP id 940A037B43F; Wed, 4 Apr 2001 23:50:30 -0700 (PDT) (envelope-from ru@whale.sunbay.crimea.ua) Received: (from ru@localhost) by whale.sunbay.crimea.ua (8.11.2/8.11.2) id f356oSx42900; Thu, 5 Apr 2001 09:50:28 +0300 (EEST) (envelope-from ru) Date: Thu, 5 Apr 2001 09:50:28 +0300 From: Ruslan Ermilov To: Maxim Sobolev Cc: John Baldwin , cvs-all@FreeBSD.org, cvs-committers@FreeBSD.org Subject: Re: cvs commit: src/share/man/man4 witness.4 Message-ID: <20010405095028.C42614@sunbay.com> Mail-Followup-To: Maxim Sobolev , John Baldwin , cvs-all@FreeBSD.org, cvs-committers@FreeBSD.org References: <200104041152.f34Bq0C79971@freefall.freebsd.org> <20010404200441.A94213@sunbay.com> <3ACB5AF4.29BE83D7@FreeBSD.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <3ACB5AF4.29BE83D7@FreeBSD.org>; from sobomax@FreeBSD.org on Wed, Apr 04, 2001 at 08:33:41PM +0300 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG 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