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