From owner-cvs-all Wed Dec 20 17:44:43 2000 From owner-cvs-all@FreeBSD.ORG Wed Dec 20 17:44:37 2000 Return-Path: Delivered-To: cvs-all@freebsd.org Received: from wantadilla.lemis.com (wantadilla.lemis.com [192.109.197.80]) by hub.freebsd.org (Postfix) with ESMTP id BEB7B37B400; Wed, 20 Dec 2000 17:44:35 -0800 (PST) Received: by wantadilla.lemis.com (Postfix, from userid 1004) id 6BD1B6AB69; Thu, 21 Dec 2000 12:14:33 +1030 (CST) Date: Thu, 21 Dec 2000 12:14:33 +1030 From: Greg Lehey To: Ruslan Ermilov , Kazuo Horikawa , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org, doc@FreeBSD.org Subject: mdoc police and MAINTAINER (was Re: cvs commit: src/sbin/ffsinfo ffsinfo.8 src/sbin/init init.8 src/sbin/sysctl sysctl.8) Message-ID: <20001221121433.B52062@wantadilla.lemis.com> References: <200012200508.eBK58gS47238@freefall.freebsd.org> <20001220095935.E87094@sunbay.com> <200012181452.eBIEqH000902@freefall.freebsd.org> <20001219155039E.horikawa@psinet.com> <20001220085916.A87094@sunbay.com> <200012191536.eBJFamr37746@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <200012191536.eBJFamr37746@freefall.freebsd.org>; from ru@FreeBSD.org on Tue, Dec 19, 2000 at 07:36:48AM -0800 Organization: LEMIS, PO Box 460, Echunga SA 5153, Australia Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-418-838-708 WWW-Home-Page: http://www.lemis.com/~grog X-PGP-Fingerprint: 6B 7B C3 8C 61 CD 54 AF 13 24 52 F8 6D A4 95 EF Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG On Wednesday, 20 December 2000 at 9:59:35 +0200, Ruslan Ermilov wrote: > On Tue, Dec 19, 2000 at 09:08:42PM -0800, Greg Lehey wrote: >> grog 2000/12/19 21:08:42 PST >> >> Modified files: >> sbin/vinum vinum.8 >> Log: >> Cosmetics. >> >> Correct location of history file. >> >> Change references from /dev/wd to /dev/ad. >> >> Use more appropriate defaults for stripe size in examples. >> >> Revision Changes Path >> 1.46 +43 -39 src/sbin/vinum/vinum.8 >> > Grey! Where did you get that name from? > What is the reason you did vanish my recent mdoc(7) fixes? I didn't see them. I read my hundreds of commit messages every day, but especially in the very big, global ones, I sometimes miss something. You'll recall that I warned of exactly this possibility the last time you violated the MAINTAINER bit on ffsinfo. > .Nm remembers its first invokation argument, and it is now possible > to write ``.Nm ,'' and have ``vinum,''. Also, there is no point to > reference the manpage from itself, i.e. ``s/Xr vinum 8/Nm/''. Also > you abuse the .Nm macro for internal vinum commands; these commands > should be written using `.Ic'. Thanks for the information. Do these work in NetBSD, OpenBSD and Linux? Remember that Vinum is intended to be used on these systems as well. On Tuesday, 19 December 2000 at 7:36:48 -0800, Ruslan Ermilov wrote: > ru 2000/12/19 07:36:48 PST > > Modified files: > sbin/ffsinfo ffsinfo.8 > sbin/init init.8 > sbin/sysctl sysctl.8 > Log: > Prepare for mdoc(7)NG. > > Revision Changes Path > 1.4 +2 -2 src/sbin/ffsinfo/ffsinfo.8 > 1.27 +2 -2 src/sbin/init/init.8 > 1.29 +63 -63 src/sbin/sysctl/sysctl.8 # $FreeBSD: src/sbin/ffsinfo/Makefile,v 1.1 2000/12/09 15:27:24 tomsoft Exp $ # MAINTAINER= tomsoft@FreeBSD.ORG, chm@FreeBSD.ORG Why did you not respect MAINTAINER? I respect the work you're doing, but the way you do it is not helping. I don't think there should be an artificial distinction between code developers and doc developers. If there were, you would have to do a lot more work at keeping the technical content up to date. At the moment, though, going in and changing documentation without even telling the MAINTAINER is going to make you unpopular. Sure, it's more work doing it the other way, but the way you're doing it, you're making more work for each affected developer. That's not fair on them. Greg -- Finger grog@lemis.com for PGP public key 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