JDK-4760924 : doc: -source is documented as a doclet option, but it is a tool option
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.0
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • OS: solaris_8
  • CPU: generic
  • Submitted: 2002-10-10
  • Updated: 2014-05-05
  • Resolved: 2002-10-10
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.
1.4.2 mantisFixed
The javadoc documentation list -source as a doclet options.
That's wrong: it's a tool option.

> Then there's a bug in the tool documentation for both 1.4.0 and
> 1.4.1, at least.
> http://java.sun.com/j2se/1.4.1/docs/tooldocs/windows/javadoc.html#source
> http://java.sun.com/j2se/1.4/docs/tooldocs/windows/javadoc.html#source
> In both of these cases, -source is in the "Options Provided by the 
> Standard Doclet" section, not the "Javadoc Options" section.
> The reason this matters is that, for example, the Ant Javadoc task 
> actually has code to prevent the use of the -source option when a 
> custom doclet is being used. They are mistakenly adhering to the 
> buggy tool documentation.

CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: mantis FIXED IN: mantis INTEGRATED IN: mantis

EVALUATION Fixed in the documentation javadoc.html ###@###.### 2002-10-09