Darren New wrote:
> Invisible wrote:
>>>> if I was to release some library it would be a matter of seconds to 
>>>> generate the documentation file.
>>>
>>> And this, ladies and gentlemen, is why we have textbooks about 
>>> libraries.
>>
>> That and the fact that, like I said, sometimes you need an overview to 
>> describe how the pieces fit together before you can properly 
>> understand the nitty gritty of individual function descriptions and so 
>> on.
> 
> That's exactly what I was referring to. :-)

Oh, right. I thought you meant the ease with which somebody can drop an 
1-line comment into a source file, autogenerate some documentation and 
claim that the library is now "documented".

Post a reply to this message