JDK-8186260 : Improve javadoc tag specification.
- Type: Bug
- Component: tools
- Sub-Component: javadoc(tool)
- Affected Version: 10
- Priority: P3
- Status: Closed
- Resolution: Fixed
- OS: generic
- CPU: generic
- Submitted: 2017-08-15
- Updated: 2018-10-13
- Resolved: 2018-10-09
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.
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 12 |
|---|
12 b15Fixed  |
Related Reports
|
CSR :
|
|
|
Relates :
|
Description
The following specification needs some cleanup. https://docs.oracle.com/javase/10/docs/specs/doc-comment-spec.html 1. The table at the end which contains valid locations for javadoc tags, this could be re-written in a nicer way, suggestion is to have a matrix and use a bullet for each application location, the locations are along the X-axis and the tags are on the Y-axis. At the very least, duplications can be eliminated using a All declarations with Overview. 2. The serialField tag erroneously appears in overview, this should not be the case as serialField can only be used fields.