[oclug] documentation rant
Michael P. Soulier
msoulier at storm.ca
Thu Apr 26 20:30:04 EDT 2001
On Thu, Apr 26, 2001 at 05:56:07PM -0400, Gilles J. Seguin wrote:
>
> You have to place you now in the developper perpective.
>
> If you are tire of reading howto, do this.
>
> choose a pakage
> dowload source
> for i in *.c *.h do
> wc -l $i
> done
> now add them up and divide by 60(nbr of lines by page)
> time is a scare resource.
Oh, of course. I'll just read the source! A well-written document
concealing the implementation for those of us who don't care couldn't possibly
help in using it. *sigh*
BTW, I'm referring to user's guides here.
Oh, and don't assume I'm not a developer. I code all day, and my projects
are well-documented. Sorry, but it's not that hard to keep information
accurate. I'm tired of the cop-outs.
Mike
--
Michael P. Soulier <msoulier at storm.ca>
"With sufficient thrust, pigs fly just fine. However, this is not necessarily a
good idea. It is hard to be sure where they are going to land, and it could be
dangerous sitting under them as they fly overhead." -- RFC 1925
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 232 bytes
Desc: not available
Url : http://tux.oclug.on.ca/pipermail/oclug/attachments/20010426/d219cb27/attachment.bin
More information about the OCLUG
mailing list