From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Mon, 12 Sep 2005 00:21:41 GMT
Subject: Re: Status of Mac OS/X ports of git and cogito?
Message-ID: <Pine.LNX.4.63.0509120216030.11512@wgmdd8.biozentrum.uni-wuerzburg.de>
In-Reply-To: <Pine.LNX.4.58.0509111642110.3242@g5.osdl.org>

Hi,

On Sun, 11 Sep 2005, Linus Torvalds wrote:

> On Sun, 11 Sep 2005, Linus Torvalds wrote:
> > 
> > And the really sad part is that before the standards bodies started
> > messing around with it, things really _did_ "just work". There was no 
> > question at all about what kind of type to use.
> 
> Btw, here's the result of the "documentation":
> 
> [lots of ugly code]
>
> isn't that nice? Before the "documentation", you could just use
> 
> 	int accept(int, struct sockaddr *, int *);
> 
> and it would work. EVERYWHERE. No autoconf crap required.
> 
> So don't talk to me about documentation. It's pure and unadulterated crap.

Okay. I have to admit that what you presented is a good argument.

However, the code I usually have to deal with is comparable to what you 
read on www.thedailywtf.com, and even a "socklen_t l;" with that type of 
code is more helpful than a simple "int l;", which might even be reused as 
something completely different.

That said, in a well designed and clean project, such as git, such types 
of documentation should not be necessary.

Ciao,
Dscho