From owner-cvs-all Tue Jun 22 2:29:21 1999 Delivered-To: cvs-all@freebsd.org Received: from mrelay.jrc.it (mrelay.jrc.it [139.191.1.65]) by hub.freebsd.org (Postfix) with ESMTP id 849B814C85; Tue, 22 Jun 1999 02:29:11 -0700 (PDT) (envelope-from nick.hibma@jrc.it) Received: from elect8 (elect8.jrc.it [139.191.71.152]) by mrelay.jrc.it (LMC5692) with SMTP id LAA20270; Tue, 22 Jun 1999 11:25:16 +0200 (MET DST) Date: Tue, 22 Jun 1999 11:25:13 +0200 (MET DST) From: Nick Hibma X-Sender: n_hibma@elect8 Reply-To: Nick Hibma To: Mike Smith Cc: Greg Lehey , hm@hcs.de, dfr@nlsystems.com, peter@FreeBSD.ORG, cvs-all@FreeBSD.ORG, FreeBSD Hackers Subject: Re: All this and documentation too? (was: cvs commit: src/sys/isa sio.c) In-Reply-To: <199906220842.BAA01553@dingo.cdrom.com> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk In short: Where's the patch? And as to the author: Writing docu while you are implementing something might work in a commercial environment where you want to be able to market something before it's sell-by date, but for hobbiests who basically spend the odd evening doing something, it is too much hassle. Writing the manual after the fact or manuals written by someone else are far easier to get coherent and useful. Nick > Perhaps I should have been clearer; the sort of documentation that the > original set of plaintiffs were asking for is the mythical "describe > everything as it was, is and will be, and make it constantly > representative and up to date". These are the same people that will > complain about disparities between any extant documentation and > reality, as well as carp incessantly about the lack of some form > of documentation other than what already exists ("why isn't there a > permuted index?" "where's the sanskrit translation?" "my cat can't read > _this_!"). > > As always, complaining about the _lack_ of something is the wrong > approach for this project. Step up and fill the gap, or expose > yourself to criticism for failing to do so. There has to be a way to > make a verb from Brett Glass' name, but I'm sure you get the point. > > -- > \\ The mind's the standard \\ Mike Smith > \\ of the man. \\ msmith@freebsd.org > \\ -- Joseph Merrick \\ msmith@cdrom.com > > > > > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-hackers" in the body of the message > > -- ISIS/STA, T.P.270, Joint Research Centre, 21020 Ispra, Italy To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message