Re: calling java from c++

[Tom Tromey <tromey at redhat dot com>]

>>>>> "Bryce" == Bryce McKinlay <bryce@waitaki.otago.ac.nz> writes:

Bryce> Good point - I'll try to write up some documentation for it soon.

Speaking of documentation, last night I ran javadoc on libgcj.  We
have 652 warnings.  A spot check shows that generally our descriptions
are too terse (for my taste).  Also in many cases the first sentence
either isn't descriptive or follows a formula that, when all the
examples are collated together, reads poorly ("This class ...").

I'm not planning to do anything about this for 3.1.

Well, I would like to get what we have up on the web.  This is a lower
priority for me than all the other stuff for the release, since the
Sun docs are out there and are usable.

According to the ordinary GNU rules, we should be shipping the .texi
documentation along with the distribution.  We took this out of the
repository due to size (and the unlikelihood of our keeping it up to
date).  Maybe we could make it available as a separate tar file.

There's also PR 5303.  I started writing docs for rmic and
rmiregistry, only to realize I don't really know much about what they
do.  I've never even run them (except to test --help).  I have a
partial patch here but it really isn't much more than the --help
output texinfo-ified.

Tom