-
Bug
-
Resolution: Fixed
-
P4
-
22
-
b17
There is an old obsolete comment in JRootPane that is between the main documentation comment for the class and the declaration of the class itself.
While currently benign, it is the one single instance in JDK source code of a `///` comment between a doc comment and its declaration. As such, it causes interference with the work to support Markdown in documentation comments using the `///` style of comment. (JEP 467)
The comment is marked PENDING and appears to date back to JDK 1.2. If the comment still has merit, it would be good to change it to a single `//` comment; otherwise, it might be deemed worthy of removal.
line 196 in JRootPane:
* @author David Kloba
* @since 1.2
*/
/// PENDING(klobad) Who should be opaque in this component? <<<<<======
@SuppressWarnings("serial")
public class JRootPane extends JComponent implements Accessible {
While currently benign, it is the one single instance in JDK source code of a `///` comment between a doc comment and its declaration. As such, it causes interference with the work to support Markdown in documentation comments using the `///` style of comment. (JEP 467)
The comment is marked PENDING and appears to date back to JDK 1.2. If the comment still has merit, it would be good to change it to a single `//` comment; otherwise, it might be deemed worthy of removal.
line 196 in JRootPane:
* @author David Kloba
* @since 1.2
*/
/// PENDING(klobad) Who should be opaque in this component? <<<<<======
@SuppressWarnings("serial")
public class JRootPane extends JComponent implements Accessible {