From owner-cvs-all Tue Jun 22 12:49: 0 1999 Delivered-To: cvs-all@freebsd.org Received: from smtp05.wxs.nl (smtp05.wxs.nl [195.121.6.57]) by hub.freebsd.org (Postfix) with ESMTP id 66C0C15682; Tue, 22 Jun 1999 12:48:40 -0700 (PDT) (envelope-from asmodai@wxs.nl) Received: from daemon.ninth-circle.org ([195.121.196.201]) by smtp05.wxs.nl (Netscape Messaging Server 3.61) with ESMTP id AAC1725; Tue, 22 Jun 1999 21:48:37 +0200 Received: (from asmodai@localhost) by daemon.ninth-circle.org (8.9.3/8.9.3) id VAA16162; Tue, 22 Jun 1999 21:43:50 +0200 (CEST) (envelope-from asmodai) Date: Tue, 22 Jun 1999 21:43:49 +0200 From: Jeroen Ruigrok/Asmodai To: Mark Newton Cc: hm@hcs.de, nick.hibma@jrc.it, mike@smith.net.au, grog@lemis.com, dfr@nlsystems.com, peter@FreeBSD.ORG, cvs-all@FreeBSD.ORG, hackers@FreeBSD.ORG Subject: Re: All this and documentation too? (was: cvs commit: src/sys/isa sio.c) Message-ID: <19990622214349.C15249@daemon.ninth-circle.org> References: <199906221004.TAA36037@gizmo.internode.com.au> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii User-Agent: Mutt/0.96.3i In-Reply-To: <199906221004.TAA36037@gizmo.internode.com.au>; from Mark Newton on Tue, Jun 22, 1999 at 07:34:14PM +0930 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk * Mark Newton (newton@internode.com.au) [990622 17:38]: > Hellmuth Michaelis wrote: > > > > 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. > > Ok, so let's follow Microsoft's industry-leading documentation standards. Blah, this argument is, pardon my french, utter bullshit. If one looks at, the now deceased, DEC Unix and it's programmer's manuals, ye see what Hellmuth tries to put down with his statement. In fact I have a couple of those pdf/ps files printed out and they make for TOP CLASS programmer's material. Needless to say I hope to reach this level of excellence with the PDP as well... It's all a matter of time and effort and unfortunately not many care to take the time to document, but rather hack on. (And somewhere that's very understandable.) -- Jeroen Ruigrok van der Werven asmodai(at)wxs.nl The *BSD Programmer's Documentation Project Network/Security Specialist *BSD: We are back and will not accept no... To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message