From owner-cvs-all Tue Jun 22 2:59: 5 1999 Delivered-To: cvs-all@freebsd.org Received: from hcsext.hcs.de (hcshh.hcs.de [194.123.40.1]) by hub.freebsd.org (Postfix) with SMTP id EF2E314D05; Tue, 22 Jun 1999 02:58:51 -0700 (PDT) (envelope-from hm@hcs.de) Received: from hcswork.hcs.de([192.76.124.5]) (2576 bytes) by hcsext.hcs.de via sendmail with P:smtp/R:inet_hosts/T:smtp (sender: ) id for ; Tue, 22 Jun 1999 11:58:51 +0200 (CEST) (Smail-3.2.0.104 1998-Nov-20 #1 built 1998-Dec-11) Received: by hcswork.hcs.de (Smail3.1.29.0 #12) id m10wNKF-0000dCC; Tue, 22 Jun 99 11:58 METDST Message-Id: From: hm@hcs.de (Hellmuth Michaelis) Subject: Re: All this and documentation too? (was: cvs commit: src/sys/isa sio.c) In-Reply-To: from Nick Hibma at "Jun 22, 99 11:25:13 am" To: nick.hibma@jrc.it Date: Tue, 22 Jun 1999 11:58:43 +0200 (METDST) Cc: mike@smith.net.au, grog@lemis.com, hm@hcs.de, dfr@nlsystems.com, peter@FreeBSD.ORG, cvs-all@FreeBSD.ORG, hackers@FreeBSD.ORG Reply-To: hm@hcs.de Organization: HCS Hanseatischer Computerservice GmbH X-Mailer: ELM [version 2.4ME+ PL39 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Length: 1497 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk From the keyboard of Nick Hibma: > 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. In case FreeBSD wants to enter commercial environments, we have to behave like behaving in commercial environments. I know that it is current behaviour, much easier and obviously a commonly accepted thing that code, subsystem and/or changes are not and need not to be documented, but this is not a reason in itself for not changing this. Also, i think that the argument Mike and others use: "don't complain for a lack of things, contribute!" - which i use and used all the time - is not valid for this issue: at least i can't contribute because i don't understand things (now someone could argue, that i'm wrong here ...). The last thing i want is a flamewar on this topic and i don't write this because i want to piss onto someones shoes. And i don't write about a man page for "ls" or "more" but a fundamental change in FreeBSD's inner architecture. hellmuth -- Hellmuth Michaelis Tel +49 40 559747-70 HCS Hanseatischer Computerservice GmbH Fax +49 40 559747-77 Oldesloer Strasse 97-99 Mail hm [at] hcs.de 22457 Hamburg WWW http://www.hcs.de To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message