>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.
I haven't seen the glibc manual. I do know that a C library manual is still
on the FSF todo list so it can't be that complete. I think it should be
possible to create a high quality reference manual from properly written
javadoc comments, plus some additional summary level documents and "glue".
>The free software community could also benefit from having a good free
>Java language tutorial.
True. I would not expect that to come from the javadocs.
>> 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.
I guess technically that might be true, but I think we can do most of what
we want from javadocs, at least from a reference manual perspective.
--
Aaron M. Renn ([EMAIL PROTECTED]) http://www.urbanophile.com/arenn/
