[fedora-java] Improving Fedora javadoc

[Anthony Green]

There are a couple of big problems with our javadoc situation right now:

 - We don't install javadoc for the core classes.

 - There are no links between javadoc packages.

If would be nice to fix this for FC5. 

Here are my suggested actions:

1. If we aren't going to modify the gcc spec file to generate libgcj
javadoc, then we should use something like this package, which builds
core javadoc from the libgcj-src RPM...
http://people.redhat.com/green/libgcj-docs-4.0.0-1.src.rpm

2. Modify all our spec files to include links between packages.

3. All the javadoc gets installed in directories
under /usr/share/javadoc.  It would be nice if there were a top level
index.html to tie them all together.  We could add a %post(un) script to
maintain this file.

4. The Eclipse help system should refer to this top level index.html, so
it shows up along with the other Eclipse docs.  Maybe it could also go
on the main Gnome menu under Applications/Programming.

Any other ideas?  It all starts with [1], which we've discussed before
but I'm afraid we're kind of stalled on.

AG