8076286: Fix missing doclint warnings in javax.swing.{colorchooser, event, filechooser}
Reviewed-by: serb
--- 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"));
}