From owner-cvs-all Mon Oct 1 2: 5:30 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 2E7D037B414; Mon, 1 Oct 2001 02:03:16 -0700 (PDT) Received: (from ru@localhost) by whale.sunbay.crimea.ua (8.11.6/8.11.2) id f91939M08581; Mon, 1 Oct 2001 12:03:09 +0300 (EEST) (envelope-from ru) Date: Mon, 1 Oct 2001 12:03:08 +0300 From: Ruslan Ermilov To: Greg Lehey Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/usr.bin/calendar calendar.1 Message-ID: <20011001120308.B7304@sunbay.com> References: <200110010235.f912ZqW96382@freefall.freebsd.org> <20011001100857.F91045@sunbay.com> <20011001174710.W31215@wantadilla.lemis.com> <20011001112916.H91045@sunbay.com> <20011001180443.X31215@wantadilla.lemis.com> <20011001114153.A4250@sunbay.com> <20011001182729.Y31215@wantadilla.lemis.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20011001182729.Y31215@wantadilla.lemis.com>; from grog@FreeBSD.org on Mon, Oct 01, 2001 at 06:27:29PM +0930 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG On Mon, Oct 01, 2001 at 06:27:29PM +0930, Greg Lehey wrote: > On Monday, 1 October 2001 at 11:41:53 +0300, Ruslan Ermilov wrote: > > On Mon, Oct 01, 2001 at 06:04:43PM +0930, Greg Lehey wrote: > >> On Monday, 1 October 2001 at 11:29:16 +0300, Ruslan Ermilov wrote: > >>> On Mon, Oct 01, 2001 at 05:47:10PM +0930, Greg Lehey wrote: > >>>> On Monday, 1 October 2001 at 10:08:57 +0300, Ruslan Ermilov wrote: > >>>>> On Sun, Sep 30, 2001 at 07:35:52PM -0700, Greg Lehey wrote: > >>>>>> grog 2001/09/30 19:35:52 PDT > >>>>>> > >>>>>> Modified files: > >>>>>> usr.bin/calendar calendar.1 > >>>>>> Log: > >>>>>> Add description for calendar.freebsd. > >>>>>> > >>>>>> Revision Changes Path > >>>>>> 1.23 +3 -1 src/usr.bin/calendar/calendar.1 > >>>>> > >>>>> FreeBSD is to be spelled ".Fx" in mdoc(7). > >>>> > >>>> That doesn't work on other systems, and even on FreeBSD it only tends > >>>> to obfuscate. > >>> > >>> This works on other systems that use the compatible version of > >>> the mdoc(7) macro package distributed with Groff. > >> > >> Precisely. What's the advantage? > >> > > .Fx uses a special font/size and prevents undesirable hyphenation. > > When used with the version argument, it also checks the version. > > I suppose that's a reason. > > >>>>> Also, you forgot to update document date. > >>>> > >>>> My understanding was that the document date had nothing to do with > >>>> when it was updated. Can you state the policy? > >>>> > >>> This is from share/examples/mdoc: > >>> > >>> .\" Note: The date here should be updated whenever a non-trivial > >>> .\" change is made to the manual page. > >> > >> This change was trivial. > >> > > I myself consider the following changes trivial: markup and/or spelling > > fixes. If you change the content, OTOH, e.g. you document new option or > > new functionality, or add a paragpraph about functionality that wasn't > > previously documented, you should bump document date. > > > > Note "should" but not "must". This is because if you don't do this, > > I will. :-) > > No, that is contrary to the committer guidelines. Please don't do > that. > > I am getting thoroughly fed up with your attitude. You have no > authority to dictate this sort of change. Sure, you've done a lot of > good grunt-work tidying up the man pages, but things would have been a > lot easier to handle if you didn't try to impose such a policeman-like > attitude, and discussed things instead. What you personally consider > to be trivial is of no consequence. We have a docmeister who doesn't > try to throw his weight around, and who hasn't commented on most of > these trivialities. > Note that I replied in private, you turned this into public. Well, your right. So far, you are the only person who doesn't agree on almost every bit of mdoc(7) fixes I made. Also, if you don't know, I am the official mdoc(7) maintainer in FreeBSD. This is documented in the Committer's Guide, and was committed by docmeister (that's how you call Nik I suppose). > Personally, I would much rather see the date changed every time the > document was changed. That would alert people to the fact that > *something* has changed. > Markup and spelling don't qualify. Everything else -- yes. 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