JDK-4748238 : Doclet API: RootDoc.classes() and PackageDoc.allClasses() inconsistent comments
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.0
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2002-09-16
  • Updated: 2014-05-05
  • Resolved: 2002-10-26
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
Other
1.4.2 mantisFixed
Description
Name: eaT66865			Date: 09/16/2002


The RootDoc.classes() and PackageDoc.allClasses()
appear to do the same thing, but have different names.
If different, the api comments should make it clear.

Note:
allClasses() indicates that it includes errors
and exceptions, but classes() doesn't. But classes()
must do so, so that should be clarified, as well.

======================================================================
Comments
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: mantis FIXED IN: mantis INTEGRATED IN: mantis mantis-b05
14-06-2004
WORK AROUND Name: eaT66865 Date: 09/16/2002 ======================================================================
11-06-2004
PUBLIC COMMENTS The distinction between classes() and allClasses() has been made clearer in the doc comments. No regression test is required as this is a change only to the doc comments. ###@###.### 2002-10-10
10-10-2002
EVALUATION Changed synopsis from: JavaDoc API inconsistency to: RootDoc.classes() and PackageDoc.allClasses() inconsistent comments The methods do similar things: RootDoc.classes() gets all doc'd classes & interfaces in all packages, while PackageDoc.allClasses() gets all doc'd classes & interfaces in given package. ###@###.### 2002-09-25
25-09-2002