[kepler-dev] [Bug 4259] - Fix the 'ant javadoc' command

[bugzilla-daemon at ecoinformatics.org]

http://bugzilla.ecoinformatics.org/show_bug.cgi?id=4259





------- Comment #8 from cxh at eecs.berkeley.edu  2009-07-28 08:31 -------
The javadoc command in kepler uses -private which generates javadoc 
for private methods.  Previously, in Ptolemy, we were not using -private
because the private methods are not part of the public or protected interface
and thus are not of use to developers who are using the class.  However,
over time we have been adding javadoc to private methods.

I just fixed over 120 javadoc warnings in the Ptolemy code.
I also added code that reads the ptolemy-excludes and .classpath.default files.

We are still missing certain third party jars needed by kepler .java files.
Right now we always include the javadoc for the ptolemy packages.  This
might be a mistake, I don't understand -Dfull=true, which looks like it
reads classes from jar files?

"ant javadoc"  now yields 2 errors and 901 warnings. 
I'm not sure about the 2 errors.
Of those 901 warnings, 136 are related to ptolemy.