>> Java does not have good free manuals. Free software needs good free
>> documentation <URL:http://www.gnu.org/philosophy/free-doc.html>. You
>> can expect me to work heavily on the free documentation side of things
>> once we replace Sun's proprietary libraries.
>
>I would LOVE to see a javadoc program that generated texinfo instead
>of html. I won't have any time to volunteer until January but if
>nothing like that exists by then I plan on doing it myself. It sucks
>to have to switch to a browser while coding Java and W3 just didn't do
>the job for me.
We discussed this quite some time ago. I actually proposed embedding
Texinfo tags instead of HTML into the doc comments. (The HTML version would
be generated off that). Others thought that it should be just as easy to
convert HTML to Texinfo and that view won out. Paul made a start at a
javadoc replacement. Someone else was supposedly working on it, but I'm not
sure of the status.
Why Texinfo? Because we can turn Texinfo into a high quality printed
reference manual. My goal would be to have the javadoc comments be
automagically transformed into a reference manual. It's also nice to browse
from a terminal.
--
Aaron M. Renn ([EMAIL PROTECTED]) http://www.urbanophile.com/arenn/
