8076286: Fix missing doclint warnings in javax.swing.{colorchooser, event, filechooser}
authordarcy
Thu, 02 Apr 2015 08:41:32 -0700
changeset 29889 ccb2e126626f
parent 29888 660cd235afcc
child 29890 a47b35d53d12
8076286: Fix missing doclint warnings in javax.swing.{colorchooser, event, filechooser} Reviewed-by: serb
jdk/src/java.desktop/share/classes/javax/swing/colorchooser/ColorChooserComponentFactory.java
jdk/src/java.desktop/share/classes/javax/swing/colorchooser/DefaultColorSelectionModel.java
jdk/src/java.desktop/share/classes/javax/swing/event/EventListenerList.java
jdk/src/java.desktop/share/classes/javax/swing/event/TableModelEvent.java
jdk/src/java.desktop/share/classes/javax/swing/filechooser/FileSystemView.java
--- a/jdk/src/java.desktop/share/classes/javax/swing/colorchooser/ColorChooserComponentFactory.java	Wed Apr 01 11:23:47 2015 -0700
+++ b/jdk/src/java.desktop/share/classes/javax/swing/colorchooser/ColorChooserComponentFactory.java	Thu Apr 02 08:41:32 2015 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2015, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -48,6 +48,10 @@
 
     private ColorChooserComponentFactory() { } // can't instantiate
 
+    /**
+     * Returns the default chooser panels.
+     * @return the default chooser panels
+     */
     public static AbstractColorChooserPanel[] getDefaultChooserPanels() {
         return new AbstractColorChooserPanel[] {
                 new DefaultSwatchChooserPanel(),
@@ -58,6 +62,10 @@
         };
     }
 
+    /**
+     * Returns the preview panel.
+     * @return the preview panel
+     */
     public static JComponent getPreviewPanel() {
         return new DefaultPreviewPanel();
     }
--- a/jdk/src/java.desktop/share/classes/javax/swing/colorchooser/DefaultColorSelectionModel.java	Wed Apr 01 11:23:47 2015 -0700
+++ b/jdk/src/java.desktop/share/classes/javax/swing/colorchooser/DefaultColorSelectionModel.java	Thu Apr 02 08:41:32 2015 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2015, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -47,6 +47,9 @@
      */
     protected transient ChangeEvent changeEvent = null;
 
+    /**
+     * The listener list.
+     */
     protected EventListenerList listenerList = new EventListenerList();
 
     private Color selectedColor;
--- a/jdk/src/java.desktop/share/classes/javax/swing/event/EventListenerList.java	Wed Apr 01 11:23:47 2015 -0700
+++ b/jdk/src/java.desktop/share/classes/javax/swing/event/EventListenerList.java	Thu Apr 02 08:41:32 2015 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2015, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -101,7 +101,7 @@
 public class EventListenerList implements Serializable {
     /* A null array to be shared by all empty listener lists*/
     private final static Object[] NULL_ARRAY = new Object[0];
-    /* The list of ListenerType - Listener pairs */
+    /** The list of ListenerType - Listener pairs */
     protected transient Object[] listenerList = NULL_ARRAY;
 
     /**
--- a/jdk/src/java.desktop/share/classes/javax/swing/event/TableModelEvent.java	Wed Apr 01 11:23:47 2015 -0700
+++ b/jdk/src/java.desktop/share/classes/javax/swing/event/TableModelEvent.java	Thu Apr 02 08:41:32 2015 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2015, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -85,9 +85,21 @@
 //  Instance Variables
 //
 
+    /**
+     * The type of the event.
+     */
     protected int       type;
+    /**
+     * The first row that has changed.
+     */
     protected int       firstRow;
+    /**
+     * The last row that has changed.
+     */
     protected int       lastRow;
+    /**
+     * The column for the event.
+     */
     protected int       column;
 
 //
--- a/jdk/src/java.desktop/share/classes/javax/swing/filechooser/FileSystemView.java	Wed Apr 01 11:23:47 2015 -0700
+++ b/jdk/src/java.desktop/share/classes/javax/swing/filechooser/FileSystemView.java	Thu Apr 02 08:41:32 2015 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2015, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -73,6 +73,10 @@
     private boolean useSystemExtensionHiding =
             UIManager.getDefaults().getBoolean("FileChooser.useSystemExtensionHiding");
 
+    /**
+     * Returns the file system view.
+     * @return the file system view
+     */
     public static FileSystemView getFileSystemView() {
         if(File.separatorChar == '\\') {
             if(windowsFileSystemView == null) {
@@ -101,6 +105,9 @@
         return genericFileSystemView;
     }
 
+    /**
+     * Constructs a FileSystemView.
+     */
     public FileSystemView() {
         final WeakReference<FileSystemView> weakReference = new WeakReference<FileSystemView>(this);
 
@@ -424,6 +431,10 @@
     // code. If a given OS can't, override these methods in its
     // implementation.
 
+    /**
+     * Returns the home directory.
+     * @return the home directory
+     */
     public File getHomeDirectory() {
         return createFileObject(System.getProperty("user.home"));
     }