# HG changeset patch # User darcy # Date 1427989292 25200 # Node ID ccb2e126626ffd2f4fc59280478230b9f4f907c6 # Parent 660cd235afcc42e53395b57548da8024ed8aad08 8076286: Fix missing doclint warnings in javax.swing.{colorchooser, event, filechooser} Reviewed-by: serb diff -r 660cd235afcc -r ccb2e126626f jdk/src/java.desktop/share/classes/javax/swing/colorchooser/ColorChooserComponentFactory.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(); } diff -r 660cd235afcc -r ccb2e126626f jdk/src/java.desktop/share/classes/javax/swing/colorchooser/DefaultColorSelectionModel.java --- 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; diff -r 660cd235afcc -r ccb2e126626f jdk/src/java.desktop/share/classes/javax/swing/event/EventListenerList.java --- 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; /** diff -r 660cd235afcc -r ccb2e126626f jdk/src/java.desktop/share/classes/javax/swing/event/TableModelEvent.java --- 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; // diff -r 660cd235afcc -r ccb2e126626f jdk/src/java.desktop/share/classes/javax/swing/filechooser/FileSystemView.java --- 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 weakReference = new WeakReference(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")); }