Bug ID: JDK-8035473 [javadoc] Revamp the existing Doclet APIs

JDK-8035473 : [javadoc] Revamp the existing Doclet APIs

Type: Bug
Component: tools
Sub-Component: javadoc(tool)
Affected Version: 9

Priority: P3
Status: Closed
Resolution: Fixed
OS: generic
CPU: generic

Submitted: 2014-02-20
Updated: 2020-07-22
Resolved: 2016-01-28

Versions (Unresolved/Resolved/Fixed)

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.

JDK 9
9 b104Fixed

Related Reports

Blocks :	JDK-8049396 - [javadoc] add more class-use test cases
Blocks :	JDK-8047157 - [javadoc] fixup tests for determinism and add classes uses
Blocks :	JDK-8040212 - [javadoc] refactor Util.class
Blocks :	JDK-8039410 - [javadoc] fix class-use items to be deterministic and index ordering
Blocks :	JDK-8144287 - Enhance DocTree API to support @index javadoc tags.
Blocks :	JDK-8042829 - [javadoc] index-file output is not sorted correctly
Blocks :	JDK-8039028 - [javadoc] refactor the usage of Util.java
Blocks :	JDK-8038583 - [javadoc] Refactor uses of arrays to Collections
Blocks :	JDK-8042809 - JEP 221: New Doclet API
Blocks :	JDK-8047162 - [javadoc] index files are non deterministic
Relates :	JDK-8249898 - jdk/javadoc/tool/6176978/T6176978.java uses @ignore w/o bug-id
Relates :	JDK-8137067 - Deprecate the old doclet
Relates :	JDK-8152375 - Rename doclet output strings
Relates :	JDK-8055508 - [javadoc] convert all javadoc pages to Element
Relates :	JDK-8140692 - javac does not handle @deprecated tag in package-info.java
Relates :	JDK-8249897 - jdk/javadoc/tool/LangVers.java uses @ignore w/o bug-id
Relates :	JDK-8137326 - Methods for comparing CharSequence, StringBuilder, and StringBuffer
Relates :	JDK-8054925 - [javadoc] refactor the Doclet start method.
Relates :	JDK-8161336 - Remove two javadoc tests from the problem list
Relates :	JDK-6664636 - [Col] API improvements to minimize memory allocations during unicode processing
Relates :	JDK-8132096 - Augment the Compiler Tree API to support the new Simplified Doclet API
Relates :	JDK-8157055 - consider unified release notes for deprecated APIs
Relates :	JDK-8176131 - Simplify new Taglet API
Relates :	JDK-8137066 - Provide an abstract class to improve the new doclet usability.
Relates :	JDK-4790211 - Doclet API: PackageDoc.allClasses() returns nested classes
Relates :	JDK-8042809 - JEP 221: New Doclet API
Relates :	JDK-8249899 - jdk/javadoc/tool/InlineTagsWithBraces.java uses @ignore w/o bug-id

Sub Tasks

JDK-8058261 :

Verify TypeAnnotations - Resolved

Description

The doclet API needs to be updated.

Comments

We should be able to work around JDK-8137326 by using a locally defined Comparator<CharSequence>
19-01-2016
The performance can be improved if we have the following bugs fixed: JDK-8137326 JDK-6664636
18-01-2016
First version http://cr.openjdk.java.net/~ksrini/8035473/webrev-all/webrev.0/ First revision: http://cr.openjdk.java.net/~ksrini/8035473/webrev.01/
13-11-2015
All the main work and subtasks are tracked by JDK-8055508
21-07-2015
Fix JDK-8038583 to refactor the use of TreeMap required for the Doclet API transition use of Doc to Element and back conversion.
02-04-2014