Date: Tue, 2 Oct 2001 10:47:01 +0300 From: Ruslan Ermilov <ru@FreeBSD.org> To: Greg Lehey <grog@FreeBSD.org> Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/usr.bin/calendar calendar.1 Message-ID: <20011002104701.D74839@sunbay.com> In-Reply-To: <20011002124016.Q31215@wantadilla.lemis.com>; from grog@FreeBSD.org on Tue, Oct 02, 2001 at 12:40:16PM %2B0930 References: <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> <20011002124016.Q31215@wantadilla.lemis.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, Oct 02, 2001 at 12:40:16PM +0930, Greg Lehey wrote: > 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. > This issue wasn't raised in this thread. > - 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. > If you look at the C code and find, say, a shutdown(2) function, how do you know what it means? You have to read the shutdown(2) manpage for it. Exactly for mdoc(7). It's (almost) all there. > - 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. > I wouldn't if you'd say you will. I didn't hear anything positive from you since I replied to your commit. > - 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. > Nobody is just untrue. And doesn't my reply to your message was just a (failed) attempt so that you also know the reasons? And I'm VERY SORRY, Greg, that mdoc(7) is not as simple as you'd have liked it to be. > - This project is (or at any rate should be) based on cooperation, not > confrontation. ru doesn't score very well here. > Words, only words, nothing more. Start from yourself! Let me take this oppotrunity to say this once again in public: "If you are writing a man page and need some advice on the structure, or the markup, ask Ruslan." This is my last posting in this thread. 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?20011002104701.D74839>