From 04b5ea769568312d7b94cb4f8b8fde2285df2b14 Mon Sep 17 00:00:00 2001 From: yan Date: Thu, 5 Dec 2013 18:04:12 +0400 Subject: [PATCH] 8029264: [doclint] more doclint and tidy cleanup Reviewed-by: alexsch, serb, malenkov --- src/share/classes/javax/swing/Action.java | 4 +- .../javax/swing/DefaultComboBoxModel.java | 2 +- .../classes/javax/swing/GroupLayout.java | 2 +- .../classes/javax/swing/InputVerifier.java | 2 +- src/share/classes/javax/swing/JComponent.java | 1 - src/share/classes/javax/swing/JDialog.java | 2 +- src/share/classes/javax/swing/JFrame.java | 2 +- .../classes/javax/swing/JInternalFrame.java | 2 +- .../classes/javax/swing/JLayeredPane.java | 2 +- src/share/classes/javax/swing/JList.java | 2 +- .../classes/javax/swing/JOptionPane.java | 63 +++++++++---------- src/share/classes/javax/swing/JScrollBar.java | 8 +-- .../classes/javax/swing/JScrollPane.java | 2 +- src/share/classes/javax/swing/JTable.java | 22 +++---- src/share/classes/javax/swing/JTextArea.java | 2 +- src/share/classes/javax/swing/JTextPane.java | 2 +- src/share/classes/javax/swing/JTree.java | 2 +- .../classes/javax/swing/LookAndFeel.java | 4 +- src/share/classes/javax/swing/Painter.java | 2 +- src/share/classes/javax/swing/RowFilter.java | 3 +- .../classes/javax/swing/SizeSequence.java | 3 +- src/share/classes/javax/swing/Spring.java | 6 +- .../classes/javax/swing/SpringLayout.java | 2 +- .../classes/javax/swing/SwingWorker.java | 1 - .../javax/swing/border/CompoundBorder.java | 2 +- .../javax/swing/event/TableModelEvent.java | 2 +- .../javax/swing/event/TreeModelListener.java | 2 +- .../swing/plaf/basic/BasicOptionPaneUI.java | 2 +- .../plaf/basic/BasicSplitPaneDivider.java | 4 +- .../swing/plaf/basic/BasicSplitPaneUI.java | 2 +- .../javax/swing/plaf/basic/BasicTreeUI.java | 2 +- .../javax/swing/table/DefaultTableModel.java | 12 ++-- .../classes/javax/swing/table/TableModel.java | 4 +- .../javax/swing/text/AbstractDocument.java | 2 +- .../javax/swing/text/DefaultEditorKit.java | 2 +- .../classes/javax/swing/text/Document.java | 2 +- .../javax/swing/text/JTextComponent.java | 10 +-- src/share/classes/javax/swing/text/View.java | 1 - .../javax/swing/text/html/HTMLDocument.java | 6 +- .../javax/swing/text/html/HTMLEditorKit.java | 14 ++--- .../swing/tree/FixedHeightLayoutCache.java | 6 +- 41 files changed, 103 insertions(+), 115 deletions(-) diff --git a/src/share/classes/javax/swing/Action.java b/src/share/classes/javax/swing/Action.java index 7223d8196..66fcf836d 100644 --- a/src/share/classes/javax/swing/Action.java +++ b/src/share/classes/javax/swing/Action.java @@ -67,7 +67,7 @@ import java.beans.*; * functionality and broadcast of property changes. For this reason, * you should take care to only use Actions where their benefits * are desired, and use simple ActionListeners elsewhere. - *

+ *
* *

Swing Components Supporting Action

*

@@ -93,7 +93,7 @@ import java.beans.*; * null property value in an Action (or a * Action that is null) results in the * button's corresponding property being set to null. - *

+ * * * diff --git a/src/share/classes/javax/swing/DefaultComboBoxModel.java b/src/share/classes/javax/swing/DefaultComboBoxModel.java index 6e35b6156..3cb3c6f22 100644 --- a/src/share/classes/javax/swing/DefaultComboBoxModel.java +++ b/src/share/classes/javax/swing/DefaultComboBoxModel.java @@ -83,7 +83,7 @@ public class DefaultComboBoxModel extends AbstractListModel implements Mut // implements javax.swing.ComboBoxModel /** * Set the value of the selected item. The selected item may be null. - *

+ * * @param anObject The combo box value or null for no selection. */ public void setSelectedItem(Object anObject) { diff --git a/src/share/classes/javax/swing/GroupLayout.java b/src/share/classes/javax/swing/GroupLayout.java index e3be1ddfd..582c96116 100644 --- a/src/share/classes/javax/swing/GroupLayout.java +++ b/src/share/classes/javax/swing/GroupLayout.java @@ -100,7 +100,7 @@ import static javax.swing.SwingConstants.VERTICAL; * The following diagram shows the same three components, but with the * parallel group along the horizontal axis and the sequential group along * the vertical axis. - *

+ * *

* Sequential group along the vertical axis in three components *

diff --git a/src/share/classes/javax/swing/InputVerifier.java b/src/share/classes/javax/swing/InputVerifier.java index aa2a0eeba..2cf4ddcaa 100644 --- a/src/share/classes/javax/swing/InputVerifier.java +++ b/src/share/classes/javax/swing/InputVerifier.java @@ -47,7 +47,7 @@ import java.util.*; * either by clicking in it or by pressing TAB. However, if another string * is entered in the first text field, then the user will be unable to * transfer focus to the second text field. - *

+ * * 

  * import java.awt.*;
  * import java.util.*;
diff --git a/src/share/classes/javax/swing/JComponent.java b/src/share/classes/javax/swing/JComponent.java
index 3f4d3f256..d6f35ac3f 100644
--- a/src/share/classes/javax/swing/JComponent.java
+++ b/src/share/classes/javax/swing/JComponent.java
@@ -4827,7 +4827,6 @@ public abstract class JComponent extends Container implements Serializable,
      * updating differs from the AWT because programs generally no
      * longer need to invoke validate to get the contents of the
      * GUI to update.
-     * 

      *
      * @see java.awt.Component#invalidate
      * @see java.awt.Container#validate
diff --git a/src/share/classes/javax/swing/JDialog.java b/src/share/classes/javax/swing/JDialog.java
index 92febed08..2d8980e30 100644
--- a/src/share/classes/javax/swing/JDialog.java
+++ b/src/share/classes/javax/swing/JDialog.java
@@ -701,7 +701,7 @@ public class JDialog extends Dialog implements WindowConstants,
      * Sets the operation that will happen by default when
      * the user initiates a "close" on this dialog.
      * You must specify one of the following choices:
-     * 

+     * 


      * 
    
      * 
  • {@code DO_NOTHING_ON_CLOSE}
      * (defined in {@code WindowConstants}):
diff --git a/src/share/classes/javax/swing/JFrame.java b/src/share/classes/javax/swing/JFrame.java
index 27a5a04e2..308320c8e 100644
--- a/src/share/classes/javax/swing/JFrame.java
+++ b/src/share/classes/javax/swing/JFrame.java
@@ -324,7 +324,7 @@ public class JFrame  extends Frame implements WindowConstants,
      * Sets the operation that will happen by default when
      * the user initiates a "close" on this frame.
      * You must specify one of the following choices:
-     * 
    
+     * 

    
      * 
      
      * 
    • DO_NOTHING_ON_CLOSE
      * (defined in WindowConstants):
diff --git a/src/share/classes/javax/swing/JInternalFrame.java b/src/share/classes/javax/swing/JInternalFrame.java
index 901f1371b..3183d5c4e 100644
--- a/src/share/classes/javax/swing/JInternalFrame.java
+++ b/src/share/classes/javax/swing/JInternalFrame.java
@@ -1645,7 +1645,7 @@ public class JInternalFrame extends JComponent implements
      * Sets the operation that will happen by default when
      * the user initiates a "close" on this internal frame.
      * The possible choices are:
-     * 
      
+     * 

      
      * 
      
      * 
      DO_NOTHING_ON_CLOSE
      * 
       Do nothing.
diff --git a/src/share/classes/javax/swing/JLayeredPane.java b/src/share/classes/javax/swing/JLayeredPane.java
index 052fcf34c..71d57bdab 100644
--- a/src/share/classes/javax/swing/JLayeredPane.java
+++ b/src/share/classes/javax/swing/JLayeredPane.java
@@ -43,7 +43,7 @@ import javax.accessibility.*;
  * For task-oriented documentation and examples of using layered panes see
  * How to Use a Layered Pane,
  * a section in The Java Tutorial.
- * 
      
+ *
  *
* *
diff --git a/src/share/classes/javax/swing/JList.java b/src/share/classes/javax/swing/JList.java index e62bc8013..1aae62e86 100644 --- a/src/share/classes/javax/swing/JList.java +++ b/src/share/classes/javax/swing/JList.java @@ -950,7 +950,7 @@ public class JList extends JComponent implements Scrollable, Accessible /** * Defines the way list cells are layed out. Consider a {@code JList} * with five cells. Cells can be layed out in one of the following ways: - *

+ * * 

      * VERTICAL:          0
      *                    1
diff --git a/src/share/classes/javax/swing/JOptionPane.java b/src/share/classes/javax/swing/JOptionPane.java
index 8bbd49db6..a2dbf810a 100644
--- a/src/share/classes/javax/swing/JOptionPane.java
+++ b/src/share/classes/javax/swing/JOptionPane.java
@@ -106,7 +106,6 @@ import static javax.swing.ClientPropertyKey.PopupFactory_FORCE_HEAVYWEIGHT_POPUP
  * 

  * All dialogs are modal. Each showXxxDialog method blocks
  * the caller until the user's interaction is complete.
- * 

  *
  * 
  * 
@@ -143,7 +142,7 @@ import static javax.swing.ClientPropertyKey.PopupFactory_FORCE_HEAVYWEIGHT_POPUP
  * just below the component. This parameter may be null,
  * in which case a default Frame is used as the parent,
  * and the dialog will be
- * centered on the screen (depending on the L&F).
+ * centered on the screen (depending on the {@literal L&F}).
  * 
message

  * A descriptive message to be placed in the dialog box.
  * In the most common usage, message is just a String or
@@ -225,42 +224,42 @@ import static javax.swing.ClientPropertyKey.PopupFactory_FORCE_HEAVYWEIGHT_POPUP
  * 
Show an error dialog that displays the message, 'alert':
  * 

  * JOptionPane.showMessageDialog(null, "alert", "alert", JOptionPane.ERROR_MESSAGE);
- * 

+ * 
  * 
Show an internal information dialog with the message, 'information':
- * 

- * JOptionPane.showInternalMessageDialog(frame, "information",

- *             
      "information", JOptionPane.INFORMATION_MESSAGE);

- * 

+ * 
+ * JOptionPane.showInternalMessageDialog(frame, "information",
+ *             "information", JOptionPane.INFORMATION_MESSAGE);
+ * 

  * 
Show an information panel with the options yes/no and message 'choose one':
- * 
JOptionPane.showConfirmDialog(null,
- *             
      "choose one", "choose one", JOptionPane.YES_NO_OPTION);

- * 

+ * 
JOptionPane.showConfirmDialog(null,
+ *             "choose one", "choose one", JOptionPane.YES_NO_OPTION);
+ * 

  * 
Show an internal information dialog with the options yes/no/cancel and
  * message 'please choose one' and title information:
- * 
JOptionPane.showInternalConfirmDialog(frame,
- *             
      "please choose one", "information",

- *             
      JOptionPane.YES_NO_CANCEL_OPTION, JOptionPane.INFORMATION_MESSAGE);

- * 

+ * 
JOptionPane.showInternalConfirmDialog(frame,
+ *             "please choose one", "information",
+ *             JOptionPane.YES_NO_CANCEL_OPTION, JOptionPane.INFORMATION_MESSAGE);
+ * 

  * 
Show a warning dialog with the options OK, CANCEL, title 'Warning', and
  * message 'Click OK to continue':
- * 

- * Object[] options = { "OK", "CANCEL" };

+ * 
+ * Object[] options = { "OK", "CANCEL" };
  * JOptionPane.showOptionDialog(null, "Click OK to continue", "Warning",
- *             
      JOptionPane.DEFAULT_OPTION, JOptionPane.WARNING_MESSAGE,

- *             
      null, options, options[0]);

- * 

+ *             JOptionPane.DEFAULT_OPTION, JOptionPane.WARNING_MESSAGE,
+ *             null, options, options[0]);
+ * 

  * 
Show a dialog asking the user to type in a String:
  * 

  * String inputValue = JOptionPane.showInputDialog("Please input a value");
- * 

+ * 
  * 
Show a dialog asking the user to select a String:
- * 

+ * 
  * Object[] possibleValues = { "First", "Second", "Third" };

  * Object selectedValue = JOptionPane.showInputDialog(null,
- *             
      "Choose one", "Input",

- *             
      JOptionPane.INFORMATION_MESSAGE, null,

- *             
      possibleValues, possibleValues[0]);

- * 

+ *             "Choose one", "Input",
+ *             JOptionPane.INFORMATION_MESSAGE, null,
+ *             possibleValues, possibleValues[0]);
+ * 

  * 
  * Direct Use:

  * To create and use an JOptionPane directly, the
@@ -281,7 +280,7 @@ import static javax.swing.ClientPropertyKey.PopupFactory_FORCE_HEAVYWEIGHT_POPUP
  *     }
  *     //If there is an array of option buttons:
  *     for(int counter = 0, maxCounter = options.length;
- *        counter < maxCounter; counter++) {
+ *        counter < maxCounter; counter++) {
  *        if(options[counter].equals(selectedValue))
  *        return counter;
  *     }
@@ -1847,9 +1846,9 @@ public class JOptionPane extends JComponent implements Accessible
     }
 
     /**
-     * Sets the UI object which implements the L&F for this component.
+     * Sets the UI object which implements the {@literal L&F} for this component.
      *
-     * @param ui  the OptionPaneUI L&F object
+     * @param ui  the OptionPaneUI {@literal L&F} object
      * @see UIDefaults#getUI
      * @beaninfo
      *       bound: true
@@ -1864,7 +1863,7 @@ public class JOptionPane extends JComponent implements Accessible
     }
 
     /**
-     * Returns the UI object which implements the L&F for this component.
+     * Returns the UI object which implements the {@literal L&F} for this component.
      *
      * @return the OptionPaneUI object
      */
@@ -1873,7 +1872,7 @@ public class JOptionPane extends JComponent implements Accessible
     }
 
     /**
-     * Notification from the UIManager that the L&F has changed.
+     * Notification from the UIManager that the {@literal L&F} has changed.
      * Replaces the current UI object with the latest version from the
      * UIManager.
      *
@@ -1886,7 +1885,7 @@ public class JOptionPane extends JComponent implements Accessible
 
     /**
      * Returns the name of the UI class that implements the
-     * L&F for this component.
+     * {@literal L&F} for this component.
      *
      * @return the string "OptionPaneUI"
      * @see JComponent#getUIClassID
@@ -2103,7 +2102,7 @@ public class JOptionPane extends JComponent implements Accessible
      * Sets the options to display.
      * The option type is used by the Look and Feel to
      * determine what buttons to show (unless options are supplied).
-     * @param newType an integer specifying the options the L&F is to display:
+     * @param newType an integer specifying the options the {@literal L&F} is to display:
      *                  DEFAULT_OPTION,
      *                  YES_NO_OPTION,
      *                  YES_NO_CANCEL_OPTION,
diff --git a/src/share/classes/javax/swing/JScrollBar.java b/src/share/classes/javax/swing/JScrollBar.java
index efcac8115..1c0eac1af 100644
--- a/src/share/classes/javax/swing/JScrollBar.java
+++ b/src/share/classes/javax/swing/JScrollBar.java
@@ -192,9 +192,9 @@ public class JScrollBar extends JComponent implements Adjustable, Accessible
 
 
     /**
-     * Sets the L&F object that renders this component.
+     * Sets the {@literal L&F} object that renders this component.
      *
-     * @param ui  the ScrollBarUI L&F object
+     * @param ui  the ScrollBarUI {@literal L&F} object
      * @see UIDefaults#getUI
      * @since 1.4
      * @beaninfo
@@ -606,9 +606,9 @@ public class JScrollBar extends JComponent implements Adjustable, Accessible
      * Sets the four BoundedRangeModel properties after forcing
      * the arguments to obey the usual constraints:
      * 
-     * minimum <= value <= value+extent <= maximum
+     * minimum ≤ value ≤ value+extent ≤ maximum
      * 

-     * 

+     *
      *
      * @see BoundedRangeModel#setRangeProperties
      * @see #setValue
diff --git a/src/share/classes/javax/swing/JScrollPane.java b/src/share/classes/javax/swing/JScrollPane.java
index 4c5f1e888..ecb3d8f34 100644
--- a/src/share/classes/javax/swing/JScrollPane.java
+++ b/src/share/classes/javax/swing/JScrollPane.java
@@ -53,7 +53,7 @@ import java.beans.Transient;
  *  How to Use Scroll Panes,
  * a section in The Java Tutorial.  Note that
  * JScrollPane does not support heavyweight components.
- * 

+ *
  * 

  *    
  *    

diff --git a/src/share/classes/javax/swing/JTable.java b/src/share/classes/javax/swing/JTable.java
index bdcb27b1b..526afcf66 100644
--- a/src/share/classes/javax/swing/JTable.java
+++ b/src/share/classes/javax/swing/JTable.java
@@ -73,7 +73,7 @@ import sun.swing.SwingLazyValue;
  * but provides defaults for these features so that simple tables can be
  * set up easily.  For example, to set up a table with 10 rows and 10
  * columns of numbers:
- * 

+ *
  * 
  *      TableModel dataModel = new AbstractTableModel() {
  *          public int getColumnCount() { return 10; }
@@ -659,7 +659,7 @@ public class JTable extends JComponent implements TableModelListener, Scrollable
      * should contain the values for that row. In other words,
      * the value of the cell at row 1, column 5 can be obtained
      * with the following code:
-     * 

+     *
      * 
((Vector)rowData.elementAt(1)).elementAt(5);

      * 

      * @param rowData           the data for the new table
@@ -674,7 +674,7 @@ public class JTable extends JComponent implements TableModelListener, Scrollable
      * rowData, with column names, columnNames.
      * rowData is an array of rows, so the value of the cell at row 1,
      * column 5 can be obtained with the following code:
-     * 

+     *
      * 
 rowData[1][5]; 

      * 

      * All rows must be of the same length as columnNames.
@@ -3062,9 +3062,9 @@ public class JTable extends JComponent implements TableModelListener, Scrollable
      *   interface that allows any data structure containing a collection
      *   of elements with a size, preferred size, maximum size and minimum size
      *   to have its elements manipulated by the algorithm.
-     * 

+     *
      * 
 Distributing the delta 

-     * 

+     *
      * 
 Overview 

      * 

      * Call "DELTA" the difference between the target size and the
@@ -3073,7 +3073,7 @@ public class JTable extends JComponent implements TableModelListener, Scrollable
      * sizes and adding a share of the DELTA - that share being based on
      * how far each preferred size is from its limiting bound (minimum or
      * maximum).
-     * 

+     *
      * 
Definition

      * 

      * Call the individual constraints min[i], max[i], and pref[i].
@@ -3081,21 +3081,21 @@ public class JTable extends JComponent implements TableModelListener, Scrollable
      * Call their respective sums: MIN, MAX, and PREF.
      * 

      * Each new size will be calculated using:
-     * 

+     *
      * 
      *          size[i] = pref[i] + delta[i]
      * 

      * where each individual delta[i] is calculated according to:
      * 

      * If (DELTA < 0) we are in shrink mode where:
-     * 

+     *
      * 
      *                        DELTA
      *          delta[i] = ------------ * (pref[i] - min[i])
      *                     (PREF - MIN)
      * 

      * If (DELTA > 0) we are in expand mode where:
-     * 

+     *
      * 
      *                        DELTA
      *          delta[i] = ------------ * (max[i] - pref[i])
@@ -6373,7 +6373,7 @@ public class JTable extends JComponent implements TableModelListener, Scrollable
      * 

      * Here's an example of creating a MessageFormat that can be
      * used to print "Duke's Table: Page - " and the current page number:
-     * 

+     *
      * 
      *     // notice the escaping of the single quote
      *     // notice how the page number is included with "{0}"
@@ -7686,7 +7686,7 @@ public class JTable extends JComponent implements TableModelListener, Scrollable
              * Returns a boolean value indicating whether the specified column
              * is selected.
              *
-             * @param r zero-based column of the table
+             * @param c zero-based column of the table
              * @return the boolean value true if the specified column is selected.
              * Otherwise, false.
              * @since 1.3
diff --git a/src/share/classes/javax/swing/JTextArea.java b/src/share/classes/javax/swing/JTextArea.java
index 80b2bb729..06b6ea593 100644
--- a/src/share/classes/javax/swing/JTextArea.java
+++ b/src/share/classes/javax/swing/JTextArea.java
@@ -93,7 +93,7 @@ import java.io.IOException;
  *    JTextArea myArea = ??;
  *    myArea.getDocument().addDocumentListener(myListener);
  * 

- * 

+ *
  * 

  * 
Newlines
  * 

diff --git a/src/share/classes/javax/swing/JTextPane.java b/src/share/classes/javax/swing/JTextPane.java
index a6a76edcf..b2ca7fc89 100644
--- a/src/share/classes/javax/swing/JTextPane.java
+++ b/src/share/classes/javax/swing/JTextPane.java
@@ -49,7 +49,7 @@ import javax.swing.plaf.*;
  * the default attributes to use if not overridden by attributes set
  * on the paragraph or character run.  Components and images may
  * be embedded in the flow of text.
- * 

+ *
  * 

  * 
Newlines
  * 

diff --git a/src/share/classes/javax/swing/JTree.java b/src/share/classes/javax/swing/JTree.java
index fdacb72aa..196cde453 100644
--- a/src/share/classes/javax/swing/JTree.java
+++ b/src/share/classes/javax/swing/JTree.java
@@ -3956,7 +3956,7 @@ public class JTree extends JComponent implements Scrollable, Accessible
          * allows children depends on how it was created.
          *
          * @return true if this node allows children, false otherwise
-         * @see #JTree.DynamicUtilTreeNode
+         * @see JTree.DynamicUtilTreeNode
          */
         public boolean isLeaf() {
             return !getAllowsChildren();
diff --git a/src/share/classes/javax/swing/LookAndFeel.java b/src/share/classes/javax/swing/LookAndFeel.java
index 024162cfa..2aad9290f 100644
--- a/src/share/classes/javax/swing/LookAndFeel.java
+++ b/src/share/classes/javax/swing/LookAndFeel.java
@@ -91,7 +91,7 @@ import java.util.StringTokenizer;
  * to provide a specific set of defaults. These are documented in the
  * classes that require the specific default.
  *
- * 
ComponentUIs and defaults

+ * 
ComponentUIs and defaults

  *
  * All {@code ComponentUIs} typically need to set various properties
  * on the {@code JComponent} the {@code ComponentUI} is providing the
@@ -120,7 +120,7 @@ import java.util.StringTokenizer;
  * {@code ComponentUI} implementations should use the various install methods
  * provided by this class as they handle the necessary checking and install
  * the property using the recommended guidelines.
- * 

+ *
  * 
Exceptions

  *
  * All of the install methods provided by {@code LookAndFeel} need to
diff --git a/src/share/classes/javax/swing/Painter.java b/src/share/classes/javax/swing/Painter.java
index 7b2e3ef11..57ac21fb1 100644
--- a/src/share/classes/javax/swing/Painter.java
+++ b/src/share/classes/javax/swing/Painter.java
@@ -54,7 +54,7 @@ import java.awt.Graphics2D;
  *     }
  * }
  * }
- * 

+ * 

  *
  * 
This interface makes no guarantees of threadsafety.

  *
diff --git a/src/share/classes/javax/swing/RowFilter.java b/src/share/classes/javax/swing/RowFilter.java
index 6d9fc7f33..ccf779cf1 100644
--- a/src/share/classes/javax/swing/RowFilter.java
+++ b/src/share/classes/javax/swing/RowFilter.java
@@ -31,6 +31,7 @@ import java.util.Date;
 import java.util.List;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
+import java.util.regex.PatternSyntaxException;
 
 /**
  * RowFilter is used to filter out entries from the
@@ -129,7 +130,7 @@ public abstract class RowFilter {
 
     /**
      * Throws an IllegalArgumentException if any of the values in
-     * columns are < 0.
+     * columns are {@literal <} 0.
      */
     private static void checkIndices(int[] columns) {
         for (int i = columns.length - 1; i >= 0; i--) {
diff --git a/src/share/classes/javax/swing/SizeSequence.java b/src/share/classes/javax/swing/SizeSequence.java
index a04fe2cb8..4d8d65e13 100644
--- a/src/share/classes/javax/swing/SizeSequence.java
+++ b/src/share/classes/javax/swing/SizeSequence.java
@@ -52,7 +52,7 @@ package javax.swing;
  * 

  * The following figure shows the relationship between size and position data
  * for a multi-column component.
- * 

+ *
  * 

  * The first item begins at position 0, the second at the position equal
@@ -76,7 +76,6 @@ package javax.swing;
  * However, any other unit of measure (for example, time in days)
  * could be just as valid.
  *
- * <p>
  *
  * <h3>Implementation Notes</h3>
  *
diff --git a/src/share/classes/javax/swing/Spring.java b/src/share/classes/javax/swing/Spring.java
index 2b18313e7..403207342 100644
--- a/src/share/classes/javax/swing/Spring.java
+++ b/src/share/classes/javax/swing/Spring.java
@@ -65,7 +65,7 @@ import java.awt.Component;
  *  from <code>a</code>
  *  to <code>b</code>,
  *  where <code>a <= b</code>).
- *  <p>
+ *
  *  <pre>
  *          [a1, b1] + [a2, b2] = [a1 + a2, b1 + b2]
  *
@@ -78,7 +78,7 @@ import java.awt.Component;
  *  If we denote <code>Spring</code>s as <code>[a, b, c]</code>,
  *  where <code>a <= b <= c</code>, we can define the same
  *  arithmetic operators on <code>Spring</code>s:
- *  <p>
+ *
  *  <pre>
  *          [a1, b1, c1] + [a2, b2, c2] = [a1 + a2, b1 + b2, c1 + c2]
  *
@@ -89,7 +89,7 @@ import java.awt.Component;
  *  <p>
  *  With both intervals and <code>Spring</code>s we can define min
  *  in terms of negation:
- *  

+ *
  *  
  *      X - Y = X + (-Y)
  *
diff --git a/src/share/classes/javax/swing/SpringLayout.java b/src/share/classes/javax/swing/SpringLayout.java
index dc85b2c1d..95444bfed 100644
--- a/src/share/classes/javax/swing/SpringLayout.java
+++ b/src/share/classes/javax/swing/SpringLayout.java
@@ -297,7 +297,7 @@ public class SpringLayout implements LayoutManager2 {
      * and "a - b" is equal to
      * Spring.sum(a, Spring.minus(b)).
      * See the
-     * {@link Spring Spring API documentation}
+     * {@link Spring Spring API documentation}
      * for further details
      * of spring arithmetic.
      *
diff --git a/src/share/classes/javax/swing/SwingWorker.java b/src/share/classes/javax/swing/SwingWorker.java
index 5775bcb4e..746b78aa7 100644
--- a/src/share/classes/javax/swing/SwingWorker.java
+++ b/src/share/classes/javax/swing/SwingWorker.java
@@ -62,7 +62,6 @@ import sun.swing.AccumulativeRunnable;
  *   
  * 
  *
- * 

  *
  * 

  * These constraints mean that a GUI application with time intensive
diff --git a/src/share/classes/javax/swing/border/CompoundBorder.java b/src/share/classes/javax/swing/border/CompoundBorder.java
index f1a6d8538..6a28c1a38 100644
--- a/src/share/classes/javax/swing/border/CompoundBorder.java
+++ b/src/share/classes/javax/swing/border/CompoundBorder.java
@@ -36,7 +36,7 @@ import java.beans.ConstructorProperties;
  *
  * For example, this class may be used to add blank margin space
  * to a component with an existing decorative border:
- * 

+ *
  * 
  *    Border border = comp.getBorder();
  *    Border margin = new EmptyBorder(10,10,10,10);
diff --git a/src/share/classes/javax/swing/event/TableModelEvent.java b/src/share/classes/javax/swing/event/TableModelEvent.java
index 05c5c7bdc..ab450cbd7 100644
--- a/src/share/classes/javax/swing/event/TableModelEvent.java
+++ b/src/share/classes/javax/swing/event/TableModelEvent.java
@@ -34,7 +34,7 @@ import javax.swing.table.*;
  * and all references to rows and columns are in the co-ordinate
  * system of the model.
  * Depending on the parameters used in the constructors, the TableModelevent
- * can be used to specify the following types of changes: 

+ * can be used to specify the following types of changes:
  *
  * 
  * TableModelEvent(source);              //  The data, ie. all rows changed
diff --git a/src/share/classes/javax/swing/event/TreeModelListener.java b/src/share/classes/javax/swing/event/TreeModelListener.java
index b48fdfb25..48a945f11 100644
--- a/src/share/classes/javax/swing/event/TreeModelListener.java
+++ b/src/share/classes/javax/swing/event/TreeModelListener.java
@@ -86,7 +86,7 @@ public interface TreeModelListener extends EventListener {
      * 
Invoked after the tree has drastically changed structure from a
      * given node down.  If the path returned by e.getPath() is of length
      * one and the first element does not identify the current root node
-     * the first element should become the new root of the tree.

+     * the first element should become the new root of the tree.
      *
      * 
Use e.getPath()
      * to get the path to the node.
diff --git a/src/share/classes/javax/swing/plaf/basic/BasicOptionPaneUI.java b/src/share/classes/javax/swing/plaf/basic/BasicOptionPaneUI.java
index 28b1d0a09..b55f8ab0f 100644
--- a/src/share/classes/javax/swing/plaf/basic/BasicOptionPaneUI.java
+++ b/src/share/classes/javax/swing/plaf/basic/BasicOptionPaneUI.java
@@ -48,7 +48,7 @@ import sun.security.action.GetPropertyAction;
  * Provides the basic look and feel for a JOptionPane.
  * BasicMessagePaneUI provides a means to place an icon,
  * message and buttons into a Container.
- * Generally, the layout will look like:

+ * Generally, the layout will look like:
  * 
  *        ------------------
  *        | i | message    |
diff --git a/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneDivider.java b/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneDivider.java
index 9a56bd7b3..9704705b2 100644
--- a/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneDivider.java
+++ b/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneDivider.java
@@ -521,7 +521,7 @@ public class BasicSplitPaneDivider extends Container
      * MouseHandler is responsible for converting mouse events
      * (released, dragged...) into the appropriate DragController
      * methods.
-     * 

+     *
      */
     protected class MouseHandler extends MouseAdapter
             implements MouseMotionListener
@@ -890,7 +890,7 @@ public class BasicSplitPaneDivider extends Container
      * Used to layout a BasicSplitPaneDivider.
      * Layout for the divider
      * involves appropriately moving the left/right buttons around.
-     * 

+     *
      */
     protected class DividerLayout implements LayoutManager
     {
diff --git a/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneUI.java b/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneUI.java
index 0f47e8965..1ec992142 100644
--- a/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneUI.java
+++ b/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneUI.java
@@ -2015,7 +2015,7 @@ public class BasicSplitPaneUI extends SplitPaneUI
     /**
      * LayoutManager used for JSplitPanes with an orientation of
      * VERTICAL_SPLIT.
-     * 

+     *
      */
     public class BasicVerticalLayoutManager extends
             BasicHorizontalLayoutManager
diff --git a/src/share/classes/javax/swing/plaf/basic/BasicTreeUI.java b/src/share/classes/javax/swing/plaf/basic/BasicTreeUI.java
index 821483049..cd41f8527 100644
--- a/src/share/classes/javax/swing/plaf/basic/BasicTreeUI.java
+++ b/src/share/classes/javax/swing/plaf/basic/BasicTreeUI.java
@@ -1398,7 +1398,7 @@ public class BasicTreeUI extends TreeUI
 
     /**
      * Paints the vertical part of the leg. The receiver should
-     * NOT modify clipBounds, insets.

+     * NOT modify clipBounds, insets.
      */
     protected void paintVerticalPartOfLeg(Graphics g, Rectangle clipBounds,
                                           Insets insets, TreePath path) {
diff --git a/src/share/classes/javax/swing/table/DefaultTableModel.java b/src/share/classes/javax/swing/table/DefaultTableModel.java
index 5abf1e82a..6bf39981d 100644
--- a/src/share/classes/javax/swing/table/DefaultTableModel.java
+++ b/src/share/classes/javax/swing/table/DefaultTableModel.java
@@ -182,7 +182,7 @@ public class DefaultTableModel extends AbstractTableModel implements Serializabl
      *  each a single row of values.  In other words, to get to the cell
      *  at row 1, column 5: 

      *
-     *  ((Vector)getDataVector().elementAt(1)).elementAt(5);

+     *  ((Vector)getDataVector().elementAt(1)).elementAt(5);
      *
      * @return  the vector of vectors containing the tables data values
      *
@@ -306,7 +306,7 @@ public class DefaultTableModel extends AbstractTableModel implements Serializabl
      *  Sets the number of rows in the model.  If the new size is greater
      *  than the current size, new rows are added to the end of the model
      *  If the new size is less than the current size, all
-     *  rows at index rowCount and greater are discarded. 

+     *  rows at index rowCount and greater are discarded.
      *
      * @param   rowCount   the new number of rows
      * @see #setRowCount
@@ -330,7 +330,7 @@ public class DefaultTableModel extends AbstractTableModel implements Serializabl
      *  Sets the number of rows in the model.  If the new size is greater
      *  than the current size, new rows are added to the end of the model
      *  If the new size is less than the current size, all
-     *  rows at index rowCount and greater are discarded. 

+     *  rows at index rowCount and greater are discarded.
      *
      *  @see #setColumnCount
      * @since 1.3
@@ -414,7 +414,7 @@ public class DefaultTableModel extends AbstractTableModel implements Serializabl
      *  After the move, the row that was at index start
      *  will be at index to.
      *  This method will send a tableChanged notification
-     *  message to all the listeners. 

+       message to all the listeners.
      *
      *  
      *  Examples of moves:
@@ -473,7 +473,7 @@ public class DefaultTableModel extends AbstractTableModel implements Serializabl
      * of columns, new columns are added to the end of each row in the model.
      * If the number of newIdentifiers is less than the current
      * number of columns, all the extra columns at the end of a row are
-     * discarded. 

+     * discarded.
      *
      * @param   columnIdentifiers  vector of column identifiers.  If
      *                          null, set the model
@@ -490,7 +490,7 @@ public class DefaultTableModel extends AbstractTableModel implements Serializabl
      * of columns, new columns are added to the end of each row in the model.
      * If the number of newIdentifiers is less than the current
      * number of columns, all the extra columns at the end of a row are
-     * discarded. 

+     * discarded.
      *
      * @param   newIdentifiers  array of column identifiers.
      *                          If null, set
diff --git a/src/share/classes/javax/swing/table/TableModel.java b/src/share/classes/javax/swing/table/TableModel.java
index 2c4794bc9..5b13fc1ae 100644
--- a/src/share/classes/javax/swing/table/TableModel.java
+++ b/src/share/classes/javax/swing/table/TableModel.java
@@ -34,7 +34,7 @@ import javax.swing.event.*;
  *
  *  The JTable can be set up to display any data
  *  model which implements the
- *  TableModel interface with a couple of lines of code:  

+ *  TableModel interface with a couple of lines of code:
  *  
  *      TableModel myData = new MyTableModel();
  *      JTable table = new JTable(myData);
@@ -42,7 +42,7 @@ import javax.swing.event.*;
  *
  * For further documentation, see Creating a Table Model
  * in The Java Tutorial.
- * 

+ *
  * @author Philip Milne
  * @see JTable
  */
diff --git a/src/share/classes/javax/swing/text/AbstractDocument.java b/src/share/classes/javax/swing/text/AbstractDocument.java
index 71e9d5d8c..f8a4332a8 100644
--- a/src/share/classes/javax/swing/text/AbstractDocument.java
+++ b/src/share/classes/javax/swing/text/AbstractDocument.java
@@ -804,7 +804,7 @@ public abstract class AbstractDocument implements Document, Serializable {
      * returns will give better performance for situations where large
      * parts of the document are being scanned.  The following is an example
      * of using the partial return to access the entire document:
-     * 

+     *
      * 
      *   int nleft = doc.getDocumentLength();
      *   Segment text = new Segment();
diff --git a/src/share/classes/javax/swing/text/DefaultEditorKit.java b/src/share/classes/javax/swing/text/DefaultEditorKit.java
index f47a1c62c..139615bdf 100644
--- a/src/share/classes/javax/swing/text/DefaultEditorKit.java
+++ b/src/share/classes/javax/swing/text/DefaultEditorKit.java
@@ -41,7 +41,7 @@ import javax.swing.UIManager;
  * of text document.  This implementation provides a default
  * implementation which treats text as plain text and
  * provides a minimal set of actions for a simple editor.
- * 

+ *
  * 

  * 
Newlines
  * 

diff --git a/src/share/classes/javax/swing/text/Document.java b/src/share/classes/javax/swing/text/Document.java
index 5b79ac41a..946e18ae2 100644
--- a/src/share/classes/javax/swing/text/Document.java
+++ b/src/share/classes/javax/swing/text/Document.java
@@ -354,7 +354,7 @@ public interface Document {
      * returns will give better performance for situations where large
      * parts of the document are being scanned.  The following is an example
      * of using the partial return to access the entire document:
-     * 

+     *
      * 

      *
      *   int nleft = doc.getDocumentLength();
diff --git a/src/share/classes/javax/swing/text/JTextComponent.java b/src/share/classes/javax/swing/text/JTextComponent.java
index 2ec12639c..5f4fd2021 100644
--- a/src/share/classes/javax/swing/text/JTextComponent.java
+++ b/src/share/classes/javax/swing/text/JTextComponent.java
@@ -87,7 +87,6 @@ import sun.swing.SwingAccessor;
  * General Rules for Using Text Components,
  * a section in The Java Tutorial.
  *
- * 

  * 

  * 
Caret Changes
  * 

@@ -108,7 +107,6 @@ import sun.swing.SwingAccessor;
  * Note: Non-editable text components also have a caret though
  * it may not be painted.
  *
- * 

  * 
Commands
  * 

  * Text components provide a number of commands that can be used
@@ -120,7 +118,6 @@ import sun.swing.SwingAccessor;
  * found with the {@link #getActions} method.  These actions
  * can be bound to key events, fired from buttons, etc.
  *
- * 

  * 
Text Input
  * 

  * The text components support flexible and internationalized text input, using
@@ -206,7 +203,6 @@ import sun.swing.SwingAccessor;
  * 
  • caret movement forward and backward
  * 
  *
- * 
    
  * 
    Model/View Split
  * 
    
  * The text components have a model-view split.  A text component pulls
@@ -231,14 +227,12 @@ import sun.swing.SwingAccessor;
  * {@link DocumentListener}
  * interface and registered interest with the model being observed.
  *
- * 
    
  * 
    Location Information
  * 
    
  * The capability of determining the location of text in
  * the view is provided.  There are two methods, {@link #modelToView}
  * and {@link #viewToModel} for determining this information.
  *
- * 
    
  * 
    Undo/Redo support
  * 
    
  * Support for an edit history mechanism is provided to allow
@@ -249,7 +243,6 @@ import sun.swing.SwingAccessor;
  * The support is provided by the Document model, which allows
  * one to attach UndoableEditListener implementations.
  *
- * 
    
  * 
    Thread Safety
  * 
    
  * The swing text components provide some support of thread
@@ -261,13 +254,12 @@ import sun.swing.SwingAccessor;
  * The methods that are safe to call asynchronously are marked
  * with comments.
  *
- * 
    
  * 
    Newlines
  * 
    
  * For a discussion on how newlines are handled, see
  * DefaultEditorKit.
  *
- * 
    
+ *
  * 
    Printing support
  * 
    
  * Several {@link #print print} methods are provided for basic
diff --git a/src/share/classes/javax/swing/text/View.java b/src/share/classes/javax/swing/text/View.java
index 675aad555..2b49055ab 100644
--- a/src/share/classes/javax/swing/text/View.java
+++ b/src/share/classes/javax/swing/text/View.java
@@ -144,7 +144,6 @@ A view has the following responsibilities:
     
      
     
    • {@link #paint(java.awt.Graphics, java.awt.Shape) paint}
     
    
-    
    
 
     
    Translate between the model and view coordinate systems.
     
    
diff --git a/src/share/classes/javax/swing/text/html/HTMLDocument.java b/src/share/classes/javax/swing/text/html/HTMLDocument.java
index 8b84bf73b..852776e61 100644
--- a/src/share/classes/javax/swing/text/html/HTMLDocument.java
+++ b/src/share/classes/javax/swing/text/html/HTMLDocument.java
@@ -2089,7 +2089,7 @@ public class HTMLDocument extends DefaultStyledDocument {
      *
      * 
    
      * The assignment of the actions described is shown in the
-     * following table for the tags defined in HTML.Tag.
    
+     * following table for the tags defined in HTML.Tag.
      * 
      * 
      * 
    TagAction
    HTML.Tag.A         CharacterAction
@@ -3968,7 +3968,7 @@ public class HTMLDocument extends DefaultStyledDocument {
         }
 
         /**
-         * This is set to true when and end is invoked for .
+         * This is set to true when and end is invoked for {@literal }.
          */
         private boolean receivedEndHTML;
         /** Number of times flushBuffer has been invoked. */
@@ -3990,7 +3990,7 @@ public class HTMLDocument extends DefaultStyledDocument {
         boolean inTitle = false;
         boolean lastWasNewline = true;
         boolean emptyAnchor;
-        /** True if (!emptyDocument && insertTag == null), this is used so
+        /** True if (!emptyDocument && insertTag == null), this is used so
          * much it is cached. */
         boolean midInsert;
         /** True when the body has been encountered. */
diff --git a/src/share/classes/javax/swing/text/html/HTMLEditorKit.java b/src/share/classes/javax/swing/text/html/HTMLEditorKit.java
index 9cca8f953..468f8626d 100644
--- a/src/share/classes/javax/swing/text/html/HTMLEditorKit.java
+++ b/src/share/classes/javax/swing/text/html/HTMLEditorKit.java
@@ -71,7 +71,7 @@ import java.lang.ref.*;
  * The modeling of HTML is provided by the class HTMLDocument.
  * Its documentation describes the details of how the HTML is modeled.
  * The editing support leverages heavily off of the text package.
- * 
    
+ *
  * 
    
  * Extendable/Scalable
  * 
    
@@ -114,7 +114,7 @@ import java.lang.ref.*;
  *   attributes for display.  This helps make the View implementations
  *   more general purpose
  * 
- * 
    
+ *
  * 
    
  * Asynchronous Loading
  * 
    
@@ -127,7 +127,7 @@ import java.lang.ref.*;
  * by the HTMLDocument.HTMLReader class.  The actual
  * work is done by the DefaultStyledDocument and
  * AbstractDocument classes in the text package.
- * 
    
+ *
  * 
    
  * Customization from current LAF
  * 
    
@@ -141,7 +141,7 @@ import java.lang.ref.*;
  * The support for this is provided by the StyleSheet
  * class.  The presentation of the HTML can be heavily influenced
  * by the setting of the StyleSheet property on the EditorKit.
- * 
    
+ *
  * 
    
  * Not lossy
  * 
    
@@ -839,7 +839,7 @@ public class HTMLEditorKit extends StyledEditorKit implements Accessible {
          * if the given position represents a link. If this was the result
          * of a mouse click, x and
          * y will give the location of the mouse, otherwise
-         * they will be < 0.
+         * they will be {@literal <} 0.
          *
          * @param pos the position
          * @param html the editor pane
@@ -2027,8 +2027,8 @@ public class HTMLEditorKit extends StyledEditorKit implements Accessible {
              * Paints a portion of a highlight.
              *
              * @param g the graphics context
-             * @param offs0 the starting model offset >= 0
-             * @param offs1 the ending model offset >= offs1
+             * @param offs0 the starting model offset ≥ 0
+             * @param offs1 the ending model offset ≥ offs1
              * @param bounds the bounding box of the view, which is not
              *        necessarily the region to paint.
              * @param c the editor
diff --git a/src/share/classes/javax/swing/tree/FixedHeightLayoutCache.java b/src/share/classes/javax/swing/tree/FixedHeightLayoutCache.java
index c31a96e2f..0cd55cb84 100644
--- a/src/share/classes/javax/swing/tree/FixedHeightLayoutCache.java
+++ b/src/share/classes/javax/swing/tree/FixedHeightLayoutCache.java
@@ -469,7 +469,7 @@ public class FixedHeightLayoutCache extends AbstractLayoutCache {
      * 
    Invoked after the tree has drastically changed structure from a
      * given node down.  If the path returned by e.getPath() is of length
      * one and the first element does not identify the current root node
-     * the first element should become the new root of the tree.
    
+     * the first element should become the new root of the tree.
      *
      * 
    e.path() holds the path to the node.
    
      * 
    e.childIndices() returns null.
    
@@ -677,7 +677,7 @@ public class FixedHeightLayoutCache extends AbstractLayoutCache {
 
     /**
      * Messages getTreeNodeForPage(path, onlyIfVisible, shouldCreate,
-     * path.length) as long as path is non-null and the length is > 0.
+     * path.length) as long as path is non-null and the length is {@literal >} 0.
      * Otherwise returns null.
      */
     private FHTreeStateNode getNodeForPath(TreePath path,
@@ -1283,7 +1283,7 @@ public class FixedHeightLayoutCache extends AbstractLayoutCache {
 
         /**
          * Messaged when a child has been inserted at index. For all the
-         * children that have a childIndex >= index their index is incremented
+         * children that have a childIndex ≥ index their index is incremented
          * by one.
          */
         protected void childInsertedAtModelIndex(int index,
-- 
GitLab