"Aaron M. Renn" <[EMAIL PROTECTED]> writes:
> Perhaps Paul is an exception to the rule, but I don't think most
> programmers particularly enjoy documentation.
Doc comments are nice, but they certainly don't match the level of
documentation found in the GNU C Library Manual. I'd like to at least
have documentation that is as good as glibc's.
The free software community could also benefit from having a good free
Java language tutorial.
> By creating the docs as we go, we reduce the pain involved and
> increase the likelihood that the documentation job will get done.
I don't consider doc comments, in and of itself, to be adequate.
--
Paul Fisher * [EMAIL PROTECTED]
