Date: Tue, 22 Jun 1999 21:43:49 +0200 From: Jeroen Ruigrok/Asmodai <asmodai@wxs.nl> To: Mark Newton <newton@internode.com.au> 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> In-Reply-To: <199906221004.TAA36037@gizmo.internode.com.au>; from Mark Newton on Tue, Jun 22, 1999 at 07:34:14PM %2B0930 References: <m10wNKF-0000dCC@hcswork.hcs.de> <199906221004.TAA36037@gizmo.internode.com.au>
next in thread | previous in thread | raw e-mail | index | archive | help
* 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 <http://home.wxs.nl/~asmodai>;
*BSD: We are back and will not accept no...
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-hackers" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19990622214349.C15249>