Julian Scheid <[EMAIL PROTECTED]> writes: > > Brian Jones wrote: > > Javadoc is a non-free tool, so installing and running it > > systematically on a FSF server is not possible. Using one of the free > > alternatives that exist or waiting for a working gjdoc is necessary. > > Why not setup something like this using an early, perhaps incomplete > version of gjdoc, TexInfo doclet and/or XML doclet and then iron out > bugs and add missing functionality over time? One could wait with > linking the docs into the main Classpath web pages, or add a warning > message next to the link until the documentation quality is sufficient. > That's release early - when more eyes look at the output, bugs or > inadequacies will be spotted more quickly.
You don't need a GNU machine to do that. I will happily give you (or anyone else who will take on this task) an account on one of my machines (available over ADSL) where you can work on a daily update of the classpath source tree and where you can check out the gjdoc stuff. We want a GNU machine to be doing it in the end because we'll want to make the doc available across the web - it would be dumb to copy it up every day from a remote server. But when you've got things working then we can ask Paul to set it up on a machine somewhere. > What I'm going to do next is see that I can run gjdoc on the full > Classpath source code with TexInfo doclet and/or the XML doclet > together with the XSLT sheet - this goal is not far away. I'll then > upload the output somewhere and post a link here so that you can judge > the tools current state. After that, if the quality is sufficient for a > primal online documentation site, we could move on and create the > cron job. > > All that may take a couple of days, as I'm quiet occupied at the time, > but I'll see that I get to this soon. Cool. Let me know if you want an account at the ashdown forest. I am also looking at your gjdoc build file to see what I can do about automakejar-ing it. Nic _______________________________________________ Classpath mailing list [EMAIL PROTECTED] http://mail.gnu.org/mailman/listinfo/classpath
