Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8328541

Remove or update obsolete comment in JRootPane

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P4 P4
    • 23
    • 22
    • client-libs

      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 {

            psadhukhan Prasanta Sadhukhan
            jjg Jonathan Gibbons
            Votes:
            0 Vote for this issue
            Watchers:
            4 Start watching this issue

              Created:
              Updated:
              Resolved: