gjdoc (was: j2sdk build-depends cannot be satisfied?)

[Mark Wielaard]

Hi,

On Sat, 2002-11-16 at 21:12, Tom Tromey wrote:
> Is gjdoc something we should include in libgcj?
> Can we, licensing-wise?  I think for an application like this we can
> go with the plain GPL; it is only the runtime that needs the exception.
> 
> Since our goal is to ship a complete system, it seems that including a
> javadoc replacement would make sense.

Since we also distribute fastjar, I think distibuting gjdoc does make
sense. But gjdoc need a little bit more love and hacking before it is
really production quality. Currently it needs a copy of the core class
libraries sources around to work (see for an example to generate GNU
Claspath docs: http://klomp.org/mark/classpath/gjdoc/). And I tried to
get it working yesterday night and couldn't make it work quickly :(

Also keep in mind that although it supports standard doclets, its main
way of generating HTML documentation is by extracting all relevant
information into a XML document and then use a program like xsltproc to
generate the actual HTML file. So besides gjdoc you also need some XSLT
processor installed. (Maybe GNU JAXP can come to the rescue here?)

Which reminds me that I promised rms that I would look into making gjdoc
automatically extract the copyright information from the source files so
that info could be easily included into the generated output.

Cheers,

Mark