Bug ID: JDK-6987309 More than 600 public/protected methods in javax.swing.plaf have no spec

JDK-6987309 : More than 600 public/protected methods in javax.swing.plaf have no spec

Type: Bug
Component: client-libs
Sub-Component: javax.swing
Affected Version: 7

Priority: P3
Status: Closed
Resolution: Duplicate
OS: generic
CPU: generic

Submitted: 2010-09-24
Updated: 2015-04-15
Resolved: 2015-04-15

Versions (Unresolved/Resolved/Fixed)

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.

JDK 9
9Resolved

Related Reports

Duplicate :	JDK-8077095 - Fix missing doclint warnings in the javax.swing.plaf.basic package
Relates :	JDK-8075082 - Fix missing doclint warnings in the javax.swing package
Relates :	JDK-7020860 - BasicTreeUI contains getters/setters with unclear spec

Description

This is an umbrella CR that identifies the problem with absence of method specification in javax.swing.plaf area and shows the scale of it.

When specification for a method appears in JavaDoc it means that:
 - it is attached to the method itself in the source of the class
 - it is inhereted if method overrides or implements some other method

The attached quick-n-dirty program searched through java.swing.plaf sources for JDK7 b109 and prints out all the public/protected methods that don't override/implement anything and have no specification at all.
(it contains some simplifications, but the actual number could be only higher)

Total number of "unique" public/protected methods without any spec is 675.

Detailed report is attached. Extract from it is below:

 -----------------------------------------------------
 ...
        no doc comment for method "<init>"
        no doc comment for method "getDirectories"
        no doc comment for method "getFiles"
        no doc comment for method "validateFileCache"
        no doc comment for method "contains"
        no doc comment for method "indexOf"
        no doc comment for method "sort"
        no doc comment for method "lt"
 in class BasicDirectoryModel
 in file work\javax\swing\plaf\basic\BasicDirectoryModel.java
------------------------------------
        no doc comment for method "<init>"
        no doc comment for method "installComponents"
        no doc comment for method "uninstallComponents"
        no doc comment for method "installListeners"
        no doc comment for method "uninstallListeners"
        no doc comment for method "installDefaults"
        no doc comment for method "installIcons"
        no doc comment for method "installStrings"
        no doc comment for method "uninstallDefaults"
        no doc comment for method "uninstallIcons"
        no doc comment for method "uninstallStrings"
        no doc comment for method "createModel"
        no doc comment for method "getModel"
        no doc comment for method "createPropertyChangeListener"
        no doc comment for method "getFileName"
        no doc comment for method "getDirectoryName"
        no doc comment for method "setFileName"
        no doc comment for method "setDirectoryName"
        no doc comment for method "getFileChooser"
        no doc comment for method "getAccessoryPanel"
        no doc comment for method "getApproveButton"
        no doc comment for method "getApproveButtonToolTipText"
        no doc comment for method "clearIconCache"
        no doc comment for method "createDoubleClickListener"
        no doc comment for method "createListSelectionListener"
            no doc comment for method "<init>"
     in class DoubleClickListener
        no doc comment for method "getApproveButtonMnemonic"
        no doc comment for method "getNewFolderAction"
        no doc comment for method "getGoHomeAction"
        no doc comment for method "getChangeToParentDirectoryAction"
        no doc comment for method "getApproveSelectionAction"
        no doc comment for method "getCancelSelectionAction"
        no doc comment for method "getUpdateAction"
            no doc comment for method "<init>"
     in class NewFolderAction
            no doc comment for method "<init>"
     in class GoHomeAction
            no doc comment for method "<init>"
     in class ChangeToParentDirectoryAction
            no doc comment for method "<init>"
     in class ApproveSelectionAction
            no doc comment for method "<init>"
     in class AcceptAllFileFilter
            no doc comment for method "<init>"
            no doc comment for method "clearIconCache"
            no doc comment for method "getCachedIcon"
            no doc comment for method "cacheIcon"
            no doc comment for method "isHidden"
     in class BasicFileView
 in class BasicFileChooserUI
 in file work\javax\swing\plaf\basic\BasicFileChooserUI.java
------------------------------------
        no doc comment for method "drawEtchedRect"
        no doc comment for method "drawGroove"
        no doc comment for method "drawBezel"
        no doc comment for method "drawLoweredBezel"
        no doc comment for method "drawDashedRect"
        no doc comment for method "getPreferredButtonSize"
 in class BasicGraphicsUtils
 in file work\javax\swing\plaf\basic\BasicGraphicsUtils.java
------------------------------------
        no doc comment for method "getMenuItemCheckIcon"
        no doc comment for method "getMenuItemArrowIcon"
        no doc comment for method "getMenuArrowIcon"
        no doc comment for method "getCheckBoxIcon"
        no doc comment for method "getRadioButtonIcon"
        no doc comment for method "getCheckBoxMenuItemIcon"
        no doc comment for method "getRadioButtonMenuItemIcon"
        no doc comment for method "createEmptyFrameIcon"
 in class BasicIconFactory
 in file work\javax\swing\plaf\basic\BasicIconFactory.java
------------------------------------
        no doc comment for method "<init>"
        no doc comment for method "installTitlePane"
        no doc comment for method "addSubComponents"
        no doc comment for method "createActions"
        no doc comment for method "installListeners"
        no doc comment for method "uninstallListeners"
        no doc comment for method "installDefaults"
        no doc comment for method "uninstallDefaults"
        no doc comment for method "createButtons"
        no doc comment for method "setButtonIcons"
        no doc comment for method "assembleSystemMenu"
        no doc comment for method "addSystemMenuItems"
        no doc comment for method "createSystemMenu"
        no doc comment for method "createSystemMenuBar"
        no doc comment for method "showSystemMenu"
        no doc comment for method "getTitle"
        no doc comment for method "enableActions"
        no doc comment for method "createPropertyChangeListener"
        no doc comment for method "createLayout"
            no doc comment for method "<init>"
     in class CloseAction
            no doc comment for method "<init>"
     in class MaximizeAction
            no doc comment for method "<init>"
     in class IconifyAction
            no doc comment for method "<init>"
     in class RestoreAction
            no doc comment for method "<init>"
     in class MoveAction
            no doc comment for method "<init>"
     in class SizeAction
 in class BasicInternalFrameTitlePane
 in file work\javax\swing\plaf\basic\BasicInternalFrameTitlePane.java

 ....

Comments

The javadoc was added in JDK 9 under the bugs JDK-8077095 and JDK-8077094.
15-04-2015
- this is an issue reported against 7(7u), - there are now affected version 9 filed for this issue - 7u issues are transferred to Sustaining Nevertheless if someone have a report against 9 - please reopen and add affectedVersion 9 or 7u specific escalations might be reopen to Sustaining
10-08-2014
- this is an issue reported against 7(7u), - there are now affected version 9 filed for this issue - 7u issues are transferred to Sustaining Nevertheless if someone have a report against 9 - please reopen and add affectedVersion 9 or 7u specific escalations might be reopen to Sustaining
10-08-2014
These are all approved for deferral to JDK 9 so you can update the FixVersion to state JDK 9. Kind regards, Mathias
29-08-2013
These are all approved for deferral to JDK 9 so you can update the FixVersion to state JDK 9. Kind regards, Mathias
29-08-2013
These are all approved for deferral to JDK 9 so you can update the FixVersion to state JDK 9. Kind regards, Mathias
29-08-2013
Converted "8-client-defer-candidate" label to "8-defer-request" by SQE' OK.
15-08-2013
This is anti-deferral criteria list: - P2 -------------- Engineering's Criteria ------------------------------------- - tck-red labeled - conformance labeled - P3 regressions reported/labeled against jdk8 - findbugs, parfait, eht labeled bugs - CAP <1 year reported - netbeans <1 year reported Victor ----------------- SQE's OK --------------------------------- Yes, we are ok with that thanks, Mikhail
15-08-2013
8-defer-request: This is the issue from 7 GA, when it was approved to defer that time. Requesting to defer again because there are no customer escalations on this issue.
17-06-2013
EVALUATION this is a tremendous bug
04-05-2012