United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: JDK-4760924 doc: -source is documented as a doclet option, but it is a tool option
JDK-4760924 : doc: -source is documented as a doclet option, but it is a tool option

Details
Type:
Bug
Submit Date:
2002-10-10
Status:
Resolved
Updated Date:
2002-10-10
Project Name:
JDK
Resolved Date:
2002-10-10
Component:
docs
OS:
solaris_8
Sub-Component:
doclet
CPU:
generic
Priority:
P3
Resolution:
Fixed
Affected Versions:
1.4.0
Fixed Versions:
1.4.2 (mantis)

Related Reports

Sub Tasks

Description
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.

                                    

Comments
EVALUATION

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

BugTraq+ Release Management Values

COMMIT TO FIX:
mantis

FIXED IN:
mantis

INTEGRATED IN:
mantis


                                     
2004-06-14



Hardware and Software, Engineered to Work Together