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

Cleanup doclint warnings in java.desktop module

XMLWordPrintable

    • Icon: Enhancement Enhancement
    • Resolution: Fixed
    • Icon: P4 P4
    • 19
    • 18
    • client-libs

      The changes done under JDK-8278175 suppress on a per-file basis various missing comments that would otherwise trigger doclint warnings. Those missing comments are:

      jdk/src/java.desktop/share/classes/java/awt/BufferCapabilities.java:65: warning: no initial description
           * @return the image capabilities of the front (displayed) buffer
             ^
      jdk/src/java.desktop/share/classes/java/awt/BufferCapabilities.java:72: warning: no initial description
           * @return the image capabilities of all back buffers (intermediate buffers
             ^
      jdk/src/java.desktop/share/classes/java/awt/BufferCapabilities.java:80: warning: no initial description
           * @return whether or not the buffer strategy uses page flipping; a set of
             ^
      jdk/src/java.desktop/share/classes/java/awt/BufferCapabilities.java:94: warning: no initial description
           * @return the resulting contents of the back buffer after page-flipping.
             ^
      jdk/src/java.desktop/share/classes/java/awt/BufferCapabilities.java:112: warning: no initial description
           * @return whether page flipping is only available in full-screen mode. If this
             ^
      jdk/src/java.desktop/share/classes/java/awt/BufferCapabilities.java:123: warning: no initial description
           * @return whether or not
             ^
      jdk/src/java.desktop/share/classes/java/awt/Component.java:4135: warning: no initial description
               * @return direct access to the back buffer, as an image.
                 ^
      jdk/src/java.desktop/share/classes/java/awt/Component.java:4695: warning: no initial description
           * @return whether or not paint messages received from the operating system
             ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:652: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:654: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:656: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:658: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:660: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:662: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:664: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:666: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:668: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:670: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:672: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:674: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:676: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:678: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:680: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:682: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:685: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:687: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:689: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:691: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:694: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:696: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:698: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:928: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:930: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:932: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:934: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:936: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:938: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:940: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/awt/event/KeyEvent.java:942: warning: no initial description
          /** @since 1.2 */
              ^
      jdk/src/java.desktop/share/classes/java/beans/beancontext/BeanContextServicesSupport.java:160: warning: empty comment
          protected class BCSSChild extends BeanContextSupport.BCSChild {
                    ^
      jdk/src/java.desktop/share/classes/java/beans/beancontext/BeanContextServicesSupport.java:790: warning: empty comment
          protected class BCSSProxyServiceProvider implements BeanContextServiceProvider, BeanContextServiceRevokedListener {
                    ^
      jdk/src/java.desktop/share/classes/java/beans/beancontext/BeanContextSupport.java:307: warning: empty comment
          protected class BCSChild implements Serializable {
                    ^
      jdk/src/java.desktop/share/classes/javax/swing/DefaultListSelectionModel.java:208: warning: no initial description
           * @param firstIndex the first index in the interval
             ^
      jdk/src/java.desktop/share/classes/javax/swing/JApplet.java:108: warning: no initial description
           * @see #getRootPane
             ^
      jdk/src/java.desktop/share/classes/javax/swing/JDialog.java:114: warning: no initial description
           * @see #getRootPane
             ^
      jdk/src/java.desktop/share/classes/javax/swing/JScrollBar.java:111: warning: no initial description
           * @see #setOrientation
             ^
      jdk/src/java.desktop/share/classes/javax/swing/JScrollBar.java:117: warning: no initial description
           * @see #setUnitIncrement
             ^
      jdk/src/java.desktop/share/classes/javax/swing/JScrollBar.java:123: warning: no initial description
           * @see #setBlockIncrement
             ^
      jdk/src/java.desktop/share/classes/javax/swing/filechooser/FileSystemView.java:352: warning: no initial description
           * @param parent a <code>File</code> object representing a directory or special folder
             ^
      jdk/src/java.desktop/share/classes/javax/swing/plaf/basic/BasicMenuItemUI.java:260: warning: no initial description
           * @param menuItem a menu item
             ^
      jdk/src/java.desktop/share/classes/javax/swing/plaf/metal/MetalBorders.java:1030: warning: no initial description
           * @since 1.3
             ^
      jdk/src/java.desktop/share/classes/javax/swing/text/LayeredHighlighter.java:32: warning: no initial description
       * @author Scott Violet
         ^
      jdk/src/java.desktop/share/classes/javax/swing/text/LayeredHighlighter.java:70: warning: no initial description
               * @return a shape
                 ^
      jdk/src/java.desktop/share/classes/javax/swing/text/html/HTML.java:62: warning: no initial description
              /** @since 1.3 */
                  ^
      jdk/src/java.desktop/share/classes/javax/swing/text/html/HTMLEditorKit.java:1687: warning: no initial description
               * @param e the JEditorPane
                 ^
      jdk/src/java.desktop/share/classes/javax/swing/text/html/HTMLEditorKit.java:1699: warning: no initial description
               * @param e the JEditorPane
                 ^
      jdk/src/java.desktop/share/classes/javax/swing/text/html/parser/AttributeList.java:113: warning: no initial description
           * @return attribute name
             ^
      jdk/src/java.desktop/share/classes/javax/swing/text/html/parser/AttributeList.java:120: warning: no initial description
           * @return attribute type
             ^
      jdk/src/java.desktop/share/classes/javax/swing/text/html/parser/AttributeList.java:128: warning: no initial description
           * @return attribute modifier
             ^
      jdk/src/java.desktop/share/classes/javax/swing/text/html/parser/AttributeList.java:136: warning: no initial description
           * @return possible attribute values
             ^
      jdk/src/java.desktop/share/classes/javax/swing/text/html/parser/AttributeList.java:143: warning: no initial description
           * @return default attribute value
             ^
      jdk/src/java.desktop/share/classes/javax/swing/text/html/parser/AttributeList.java:150: warning: no initial description
           * @return the next attribute in the list
             ^
      jdk/src/java.desktop/share/classes/javax/swing/text/html/parser/Parser.java:213: warning: no initial description
           * @return the line number of the line currently being parsed
             ^
      jdk/src/java.desktop/share/classes/javax/swing/undo/UndoableEditSupport.java:152: warning: empty comment
          public synchronized void beginUpdate() {
                                   ^

            psadhukhan Prasanta Sadhukhan
            darcy Joe Darcy
            Votes:
            0 Vote for this issue
            Watchers:
            5 Start watching this issue

              Created:
              Updated:
              Resolved: