Date: Mon, 1 Oct 2001 18:27:29 +0930 From: Greg Lehey <grog@FreeBSD.org> To: Ruslan Ermilov <ru@FreeBSD.org> Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/usr.bin/calendar calendar.1 Message-ID: <20011001182729.Y31215@wantadilla.lemis.com> In-Reply-To: <20011001114153.A4250@sunbay.com>; from ru@FreeBSD.org on Mon, Oct 01, 2001 at 11:41:53AM %2B0300 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>
next in thread | previous in thread | raw e-mail | index | archive | help
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. 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. Greg -- See complete headers for address and phone numbers 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?20011001182729.Y31215>