Date: Tue, 2 Oct 2001 12:40:16 +0930 From: Greg Lehey <grog@FreeBSD.org> To: Ruslan Ermilov <ru@FreeBSD.org>, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/usr.bin/calendar calendar.1 Message-ID: <20011002124016.Q31215@wantadilla.lemis.com> In-Reply-To: <20011001091147.O40556@curie.physics.purdue.edu>; from will@physics.purdue.edu on Mon, Oct 01, 2001 at 09:11:47AM -0500 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> <20011001120308.B7304@sunbay.com> <20011001184256.A31215@wantadilla.lemis.com> <20011001091147.O40556@curie.physics.purdue.edu>
next in thread | previous in thread | raw e-mail | index | archive | help
On Monday, 1 October 2001 at 9:11:47 -0500, Will Andrews wrote: > On Mon, Oct 01, 2001 at 06:42:56PM +0930, Greg Lehey (grog@FreeBSD.org) wrote: >>> Also, if you don't know, I am the official mdoc(7) maintainer in >>> FreeBSD. >> >> That doesn't entitle you to override commits which are in dispute. > > Greg, if you have a real argument to provide for removing X Y or > Z thing in mdoc(7), we're all waiting to hear it. Just saying > ".Fx is an obfuscation and unportable" isn't enough after all the > work Ruslan has done on mdoc(7)... I don't see the logic here. There are a number of issues: - Just because (incontestably) ru has done a lot of good work on the man pages doesn't mean that we shouldn't point out where things look wrong. - If you read the sources and find, say, a .Bsx macro, how do you know what it means? You have to locate the man page to identify it. If is says "BSD/OS", you know immediately what it means. Using a macro just to represent a string seems obfuscatory and a waste of time. - On the other hand, ru pointed out a number of advantages to using .Fx. I accept them, and would have committed the change had he not, despite my requests, done it himself. - The real problem is that nobody knows these reasons. ru has been very good about fixing problems in the man pages, but he hasn't been very communicative about it. - This project is (or at any rate should be) based on cooperation, not confrontation. ru doesn't score very well here. 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?20011002124016.Q31215>