Re: Classpath API javadoc

[Nic Ferrier]

Julian Scheid <address@hidden> 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