Re: Classpath API javadoc

[John Leuner]

> John> I think it's a waste of all the effort that has gone into
> John> commenting code, this resource should be made available and
> John> people should be encouraged to use it.
> 
> I agree.  Also it will make RMS happy -- he likes it when free
> documentation is available so that people don't have to rely on the
> proprietary stuff.

Definitely.
 
> About a month ago I ran javadoc on the libgcj tree.  There were tons
> of warnings.  Also the output isn't really that good.  For example,
> the first line of a description is used on the index pages; for our
> docs this line is typically not very informative, so the output is
> harder to use.
> 
> I think if we ran this regularly it might help us know what needs to
> be edited.  It seems to be harder to see these problems in the source
> than it is in the output.

This is my experience too. 

So what do we have to do to get a cron job set up somewhere to produce a daily 
javadoc run of the Classpath CVS code?

I really think this would be a worthwhile effort.

John Leuner