-
Bug
-
Resolution: Fixed
-
P3
-
10
-
b15
-
generic
-
generic
-
Not verified
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.
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.
- csr for
-
JDK-8203494 Improve javadoc tag specification.
-
- Closed
-
- relates to
-
JDK-8202947 Fix minor issues with taglets
-
- Closed
-