changeset 8951:8534e297484d

8029264: [doclint] more doclint and tidy cleanup Reviewed-by: alexsch, serb, malenkov
author yan
date Thu, 05 Dec 2013 18:04:12 +0400
parents dc2f0c40399a
children d3c4e8fe98c3
files src/share/classes/javax/swing/Action.java src/share/classes/javax/swing/DefaultComboBoxModel.java src/share/classes/javax/swing/GroupLayout.java src/share/classes/javax/swing/InputVerifier.java src/share/classes/javax/swing/JComponent.java src/share/classes/javax/swing/JDialog.java src/share/classes/javax/swing/JFrame.java src/share/classes/javax/swing/JInternalFrame.java src/share/classes/javax/swing/JLayeredPane.java src/share/classes/javax/swing/JList.java src/share/classes/javax/swing/JOptionPane.java src/share/classes/javax/swing/JScrollBar.java src/share/classes/javax/swing/JScrollPane.java src/share/classes/javax/swing/JTable.java src/share/classes/javax/swing/JTextArea.java src/share/classes/javax/swing/JTextPane.java src/share/classes/javax/swing/JTree.java src/share/classes/javax/swing/LookAndFeel.java src/share/classes/javax/swing/Painter.java src/share/classes/javax/swing/RowFilter.java src/share/classes/javax/swing/SizeSequence.java src/share/classes/javax/swing/Spring.java src/share/classes/javax/swing/SpringLayout.java src/share/classes/javax/swing/SwingWorker.java src/share/classes/javax/swing/border/CompoundBorder.java src/share/classes/javax/swing/event/TableModelEvent.java src/share/classes/javax/swing/event/TreeModelListener.java src/share/classes/javax/swing/plaf/basic/BasicOptionPaneUI.java src/share/classes/javax/swing/plaf/basic/BasicSplitPaneDivider.java src/share/classes/javax/swing/plaf/basic/BasicSplitPaneUI.java src/share/classes/javax/swing/plaf/basic/BasicTreeUI.java src/share/classes/javax/swing/table/DefaultTableModel.java src/share/classes/javax/swing/table/TableModel.java src/share/classes/javax/swing/text/AbstractDocument.java src/share/classes/javax/swing/text/DefaultEditorKit.java src/share/classes/javax/swing/text/Document.java src/share/classes/javax/swing/text/JTextComponent.java src/share/classes/javax/swing/text/View.java src/share/classes/javax/swing/text/html/HTMLDocument.java src/share/classes/javax/swing/text/html/HTMLEditorKit.java src/share/classes/javax/swing/tree/FixedHeightLayoutCache.java
diffstat 41 files changed, 103 insertions(+), 115 deletions(-) [+]
line wrap: on
line diff
--- a/src/share/classes/javax/swing/Action.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/Action.java	Thu Dec 05 18:04:12 2013 +0400
@@ -67,7 +67,7 @@
  * functionality and broadcast of property changes.  For this reason,
  * you should take care to only use <code>Action</code>s where their benefits
  * are desired, and use simple <code>ActionListener</code>s elsewhere.
- * <p>
+ * <br>
  *
  * <h3><a name="buttonActions"></a>Swing Components Supporting <code>Action</code></h3>
  * <p>
@@ -93,7 +93,7 @@
  * <code>null</code> property value in an <code>Action</code> (or a
  * <code>Action</code> that is <code>null</code>) results in the
  * button's corresponding property being set to <code>null</code>.
- * <p>
+ *
  * <table border="1" cellpadding="1" cellspacing="0"
  *         summary="Supported Action properties">
  *  <tr valign="top"  align="left">
--- a/src/share/classes/javax/swing/DefaultComboBoxModel.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/DefaultComboBoxModel.java	Thu Dec 05 18:04:12 2013 +0400
@@ -83,7 +83,7 @@
     // implements javax.swing.ComboBoxModel
     /**
      * Set the value of the selected item. The selected item may be null.
-     * <p>
+     *
      * @param anObject The combo box value or null for no selection.
      */
     public void setSelectedItem(Object anObject) {
--- a/src/share/classes/javax/swing/GroupLayout.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/GroupLayout.java	Thu Dec 05 18:04:12 2013 +0400
@@ -100,7 +100,7 @@
  * 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.
- * <p>
+ *
  * <p style="text-align:center">
  * <img src="doc-files/groupLayout.2.gif" alt="Sequential group along the vertical axis in three components">
  * <p>
--- a/src/share/classes/javax/swing/InputVerifier.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/InputVerifier.java	Thu Dec 05 18:04:12 2013 +0400
@@ -47,7 +47,7 @@
  * 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.
- * <p>
+ *
  * <pre>
  * import java.awt.*;
  * import java.util.*;
--- a/src/share/classes/javax/swing/JComponent.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/JComponent.java	Thu Dec 05 18:04:12 2013 +0400
@@ -4827,7 +4827,6 @@
      * updating differs from the AWT because programs generally no
      * longer need to invoke <code>validate</code> to get the contents of the
      * GUI to update.
-     * <p>
      *
      * @see java.awt.Component#invalidate
      * @see java.awt.Container#validate
--- a/src/share/classes/javax/swing/JDialog.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/JDialog.java	Thu Dec 05 18:04:12 2013 +0400
@@ -701,7 +701,7 @@
      * 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:
-     * <p>
+     * <br><br>
      * <ul>
      * <li>{@code DO_NOTHING_ON_CLOSE}
      * (defined in {@code WindowConstants}):
--- a/src/share/classes/javax/swing/JFrame.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/JFrame.java	Thu Dec 05 18:04:12 2013 +0400
@@ -324,7 +324,7 @@
      * 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:
-     * <p>
+     * <br><br>
      * <ul>
      * <li><code>DO_NOTHING_ON_CLOSE</code>
      * (defined in <code>WindowConstants</code>):
--- a/src/share/classes/javax/swing/JInternalFrame.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/JInternalFrame.java	Thu Dec 05 18:04:12 2013 +0400
@@ -1645,7 +1645,7 @@
      * Sets the operation that will happen by default when
      * the user initiates a "close" on this internal frame.
      * The possible choices are:
-     * <p>
+     * <br><br>
      * <dl>
      * <dt><code>DO_NOTHING_ON_CLOSE</code>
      * <dd> Do nothing.
--- a/src/share/classes/javax/swing/JLayeredPane.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/JLayeredPane.java	Thu Dec 05 18:04:12 2013 +0400
@@ -43,7 +43,7 @@
  * For task-oriented documentation and examples of using layered panes see
  * <a href="http://docs.oracle.com/javase/tutorial/uiswing/components/layeredpane.html">How to Use a Layered Pane</a>,
  * a section in <em>The Java Tutorial</em>.
- * <P>
+ *
  * <TABLE STYLE="FLOAT:RIGHT" BORDER="0" SUMMARY="layout">
  * <TR>
  *   <TD ALIGN="CENTER">
--- a/src/share/classes/javax/swing/JList.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/JList.java	Thu Dec 05 18:04:12 2013 +0400
@@ -950,7 +950,7 @@
     /**
      * 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:
-     * <p>
+     *
      * <pre>
      * VERTICAL:          0
      *                    1
--- a/src/share/classes/javax/swing/JOptionPane.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/JOptionPane.java	Thu Dec 05 18:04:12 2013 +0400
@@ -106,7 +106,6 @@
  * <p>
  * All dialogs are modal. Each <code>showXxxDialog</code> method blocks
  * the caller until the user's interaction is complete.
- * <p>
  *
  * <table cellspacing=6 cellpadding=4 border=0 style="float:right" summary="layout">
  * <tr>
@@ -143,7 +142,7 @@
  * just below the component. This parameter may be <code>null</code>,
  * in which case a default <code>Frame</code> 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}).
  * <dt><a name=message>message</a><dd>
  * A descriptive message to be placed in the dialog box.
  * In the most common usage, message is just a <code>String</code> or
@@ -225,42 +224,42 @@
  * <dt>Show an error dialog that displays the message, 'alert':
  * <dd><code>
  * JOptionPane.showMessageDialog(null, "alert", "alert", JOptionPane.ERROR_MESSAGE);
- * </code><p>
+ * </code>
  * <dt>Show an internal information dialog with the message, 'information':
- * <dd><code>
- * JOptionPane.showInternalMessageDialog(frame, "information",<br>
- *             <ul><ul>"information", JOptionPane.INFORMATION_MESSAGE);</ul></ul>
- * </code><p>
+ * <dd><pre>
+ * JOptionPane.showInternalMessageDialog(frame, "information",
+ *             "information", JOptionPane.INFORMATION_MESSAGE);
+ * </pre>
  * <dt>Show an information panel with the options yes/no and message 'choose one':
- * <dd><code>JOptionPane.showConfirmDialog(null,
- *             <ul><ul>"choose one", "choose one", JOptionPane.YES_NO_OPTION);</ul></ul>
- * </code><p>
+ * <dd><pre>JOptionPane.showConfirmDialog(null,
+ *             "choose one", "choose one", JOptionPane.YES_NO_OPTION);
+ * </pre>
  * <dt>Show an internal information dialog with the options yes/no/cancel and
  * message 'please choose one' and title information:
- * <dd><code>JOptionPane.showInternalConfirmDialog(frame,
- *             <ul><ul>"please choose one", "information",</ul></ul>
- *             <ul><ul>JOptionPane.YES_NO_CANCEL_OPTION, JOptionPane.INFORMATION_MESSAGE);</ul></ul>
- * </code><p>
+ * <dd><pre>JOptionPane.showInternalConfirmDialog(frame,
+ *             "please choose one", "information",
+ *             JOptionPane.YES_NO_CANCEL_OPTION, JOptionPane.INFORMATION_MESSAGE);
+ * </pre>
  * <dt>Show a warning dialog with the options OK, CANCEL, title 'Warning', and
  * message 'Click OK to continue':
- * <dd><code>
- * Object[] options = { "OK", "CANCEL" };<br>
+ * <dd><pre>
+ * Object[] options = { "OK", "CANCEL" };
  * JOptionPane.showOptionDialog(null, "Click OK to continue", "Warning",
- *             <ul><ul>JOptionPane.DEFAULT_OPTION, JOptionPane.WARNING_MESSAGE,</ul></ul>
- *             <ul><ul>null, options, options[0]);</ul></ul>
- * </code><p>
+ *             JOptionPane.DEFAULT_OPTION, JOptionPane.WARNING_MESSAGE,
+ *             null, options, options[0]);
+ * </pre>
  * <dt>Show a dialog asking the user to type in a String:
  * <dd><code>
  * String inputValue = JOptionPane.showInputDialog("Please input a value");
- * </code><p>
+ * </code>
  * <dt>Show a dialog asking the user to select a String:
- * <dd><code>
+ * <dd><pre>
  * Object[] possibleValues = { "First", "Second", "Third" };<br>
  * Object selectedValue = JOptionPane.showInputDialog(null,
- *             <ul><ul>"Choose one", "Input",</ul></ul>
- *             <ul><ul>JOptionPane.INFORMATION_MESSAGE, null,</ul></ul>
- *             <ul><ul>possibleValues, possibleValues[0]);</ul></ul>
- * </code><p>
+ *             "Choose one", "Input",
+ *             JOptionPane.INFORMATION_MESSAGE, null,
+ *             possibleValues, possibleValues[0]);
+ * </pre><p>
  * </dl>
  * <b>Direct Use:</b><br>
  * To create and use an <code>JOptionPane</code> directly, the
@@ -281,7 +280,7 @@
  *     }
  *     <i>//If there is an array of option buttons:</i>
  *     for(int counter = 0, maxCounter = options.length;
- *        counter < maxCounter; counter++) {
+ *        counter &lt; maxCounter; counter++) {
  *        if(options[counter].equals(selectedValue))
  *        return counter;
  *     }
@@ -1847,9 +1846,9 @@
     }
 
     /**
-     * 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 <code>OptionPaneUI</code> L&F object
+     * @param ui  the <code>OptionPaneUI</code> {@literal L&F} object
      * @see UIDefaults#getUI
      * @beaninfo
      *       bound: true
@@ -1864,7 +1863,7 @@
     }
 
     /**
-     * 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 <code>OptionPaneUI</code> object
      */
@@ -1873,7 +1872,7 @@
     }
 
     /**
-     * Notification from the <code>UIManager</code> that the L&F has changed.
+     * Notification from the <code>UIManager</code> that the {@literal L&F} has changed.
      * Replaces the current UI object with the latest version from the
      * <code>UIManager</code>.
      *
@@ -1886,7 +1885,7 @@
 
     /**
      * 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 @@
      * 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:
      *                  <code>DEFAULT_OPTION</code>,
      *                  <code>YES_NO_OPTION</code>,
      *                  <code>YES_NO_CANCEL_OPTION</code>,
--- a/src/share/classes/javax/swing/JScrollBar.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/JScrollBar.java	Thu Dec 05 18:04:12 2013 +0400
@@ -192,9 +192,9 @@
 
 
     /**
-     * Sets the L&F object that renders this component.
+     * Sets the {@literal L&F} object that renders this component.
      *
-     * @param ui  the <code>ScrollBarUI</code> L&F object
+     * @param ui  the <code>ScrollBarUI</code> {@literal L&F} object
      * @see UIDefaults#getUI
      * @since 1.4
      * @beaninfo
@@ -606,9 +606,9 @@
      * Sets the four BoundedRangeModel properties after forcing
      * the arguments to obey the usual constraints:
      * <pre>
-     * minimum <= value <= value+extent <= maximum
+     * minimum &le; value &le; value+extent &le; maximum
      * </pre>
-     * <p>
+     *
      *
      * @see BoundedRangeModel#setRangeProperties
      * @see #setValue
--- a/src/share/classes/javax/swing/JScrollPane.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/JScrollPane.java	Thu Dec 05 18:04:12 2013 +0400
@@ -53,7 +53,7 @@
  *  <a href="http://docs.oracle.com/javase/tutorial/uiswing/components/scrollpane.html">How to Use Scroll Panes</a>,
  * a section in <em>The Java Tutorial</em>.  Note that
  * <code>JScrollPane</code> does not support heavyweight components.
- * <p>
+ *
  * <TABLE STYLE="FLOAT:RIGHT" BORDER="0" SUMMARY="layout">
  *    <TR>
  *    <TD ALIGN="CENTER">
--- a/src/share/classes/javax/swing/JTable.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/JTable.java	Thu Dec 05 18:04:12 2013 +0400
@@ -73,7 +73,7 @@
  * 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:
- * <p>
+ *
  * <pre>
  *      TableModel dataModel = new AbstractTableModel() {
  *          public int getColumnCount() { return 10; }
@@ -659,7 +659,7 @@
      * 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:
-     * <p>
+     *
      * <pre>((Vector)rowData.elementAt(1)).elementAt(5);</pre>
      * <p>
      * @param rowData           the data for the new table
@@ -674,7 +674,7 @@
      * <code>rowData</code>, with column names, <code>columnNames</code>.
      * <code>rowData</code> is an array of rows, so the value of the cell at row 1,
      * column 5 can be obtained with the following code:
-     * <p>
+     *
      * <pre> rowData[1][5]; </pre>
      * <p>
      * All rows must be of the same length as <code>columnNames</code>.
@@ -3062,9 +3062,9 @@
      *   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.
-     * <p>
+     *
      * <H3> Distributing the delta </H3>
-     * <p>
+     *
      * <H4> Overview </H4>
      * <P>
      * Call "DELTA" the difference between the target size and the
@@ -3073,7 +3073,7 @@
      * 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).
-     * <p>
+     *
      * <H4>Definition</H4>
      * <P>
      * Call the individual constraints min[i], max[i], and pref[i].
@@ -3081,21 +3081,21 @@
      * Call their respective sums: MIN, MAX, and PREF.
      * <p>
      * Each new size will be calculated using:
-     * <p>
+     *
      * <pre>
      *          size[i] = pref[i] + delta[i]
      * </pre>
      * where each individual delta[i] is calculated according to:
      * <p>
      * If (DELTA &lt; 0) we are in shrink mode where:
-     * <p>
+     *
      * <PRE>
      *                        DELTA
      *          delta[i] = ------------ * (pref[i] - min[i])
      *                     (PREF - MIN)
      * </PRE>
      * If (DELTA &gt; 0) we are in expand mode where:
-     * <p>
+     *
      * <PRE>
      *                        DELTA
      *          delta[i] = ------------ * (max[i] - pref[i])
@@ -6373,7 +6373,7 @@
      * <p>
      * Here's an example of creating a <code>MessageFormat</code> that can be
      * used to print "Duke's Table: Page - " and the current page number:
-     * <p>
+     *
      * <pre>
      *     // notice the escaping of the single quote
      *     // notice how the page number is included with "{0}"
@@ -7686,7 +7686,7 @@
              * 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
--- a/src/share/classes/javax/swing/JTextArea.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/JTextArea.java	Thu Dec 05 18:04:12 2013 +0400
@@ -93,7 +93,7 @@
  *    JTextArea myArea = ??;
  *    myArea.getDocument().addDocumentListener(myListener);
  * </pre>
- * <p>
+ *
  * <dl>
  * <dt><b><font size=+1>Newlines</font></b>
  * <dd>
--- a/src/share/classes/javax/swing/JTextPane.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/JTextPane.java	Thu Dec 05 18:04:12 2013 +0400
@@ -49,7 +49,7 @@
  * 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.
- * <p>
+ *
  * <dl>
  * <dt><b><font size=+1>Newlines</font></b>
  * <dd>
--- a/src/share/classes/javax/swing/JTree.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/JTree.java	Thu Dec 05 18:04:12 2013 +0400
@@ -3956,7 +3956,7 @@
          * 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();
--- a/src/share/classes/javax/swing/LookAndFeel.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/LookAndFeel.java	Thu Dec 05 18:04:12 2013 +0400
@@ -91,7 +91,7 @@
  * to provide a specific set of defaults. These are documented in the
  * classes that require the specific default.
  *
- * <h3><a name="#defaultRecommendation">ComponentUIs and defaults</a></h3>
+ * <h3><a name="defaultRecommendation">ComponentUIs and defaults</a></h3>
  *
  * All {@code ComponentUIs} typically need to set various properties
  * on the {@code JComponent} the {@code ComponentUI} is providing the
@@ -120,7 +120,7 @@
  * {@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.
- * <p>
+ *
  * <h3><a name="exceptions"></a>Exceptions</h3>
  *
  * All of the install methods provided by {@code LookAndFeel} need to
--- a/src/share/classes/javax/swing/Painter.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/Painter.java	Thu Dec 05 18:04:12 2013 +0400
@@ -54,7 +54,7 @@
  *     }
  * }
  * }
- * </pre></p>
+ * </pre>
  *
  * <p>This interface makes no guarantees of threadsafety.</p>
  *
--- a/src/share/classes/javax/swing/RowFilter.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/RowFilter.java	Thu Dec 05 18:04:12 2013 +0400
@@ -31,6 +31,7 @@
 import java.util.List;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
+import java.util.regex.PatternSyntaxException;
 
 /**
  * <code>RowFilter</code> is used to filter out entries from the
@@ -129,7 +130,7 @@
 
     /**
      * 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--) {
--- a/src/share/classes/javax/swing/SizeSequence.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/SizeSequence.java	Thu Dec 05 18:04:12 2013 +0400
@@ -52,7 +52,7 @@
  * <p>
  * The following figure shows the relationship between size and position data
  * for a multi-column component.
- * <p>
+ *
  * <center>
  * <img src="doc-files/SizeSequence-1.gif" width=384 height = 100
  * alt="The first item begins at position 0, the second at the position equal
@@ -76,7 +76,6 @@
  * However, any other unit of measure (for example, time in days)
  * could be just as valid.
  *
- * <p>
  *
  * <h3>Implementation Notes</h3>
  *
--- a/src/share/classes/javax/swing/Spring.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/Spring.java	Thu Dec 05 18:04:12 2013 +0400
@@ -65,7 +65,7 @@
  *  from <code>a</code>
  *  to <code>b</code>,
  *  where <code>a &lt;= b</code>).
- *  <p>
+ *
  *  <pre>
  *          [a1, b1] + [a2, b2] = [a1 + a2, b1 + b2]
  *
@@ -78,7 +78,7 @@
  *  If we denote <code>Spring</code>s as <code>[a, b, c]</code>,
  *  where <code>a &lt;= b &lt;= 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 @@
  *  <p>
  *  With both intervals and <code>Spring</code>s we can define "-" and <em>min</em>
  *  in terms of negation:
- *  <p>
+ *
  *  <pre>
  *      X - Y = X + (-Y)
  *
--- a/src/share/classes/javax/swing/SpringLayout.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/SpringLayout.java	Thu Dec 05 18:04:12 2013 +0400
@@ -297,7 +297,7 @@
      * and "a - b" is equal to
      * <code>Spring.sum(a, Spring.minus(b))</code>.
      * See the
-     * {@link Spring <code>Spring</code> API documentation}
+     * {@link Spring Spring API documentation}
      * for further details
      * of spring arithmetic.
      *
--- a/src/share/classes/javax/swing/SwingWorker.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/SwingWorker.java	Thu Dec 05 18:04:12 2013 +0400
@@ -62,7 +62,6 @@
  *   </li>
  * </ul>
  *
- * <p>
  *
  * <p>
  * These constraints mean that a GUI application with time intensive
--- a/src/share/classes/javax/swing/border/CompoundBorder.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/border/CompoundBorder.java	Thu Dec 05 18:04:12 2013 +0400
@@ -36,7 +36,7 @@
  *
  * For example, this class may be used to add blank margin space
  * to a component with an existing decorative border:
- * <p>
+ *
  * <pre>
  *    Border border = comp.getBorder();
  *    Border margin = new EmptyBorder(10,10,10,10);
--- a/src/share/classes/javax/swing/event/TableModelEvent.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/event/TableModelEvent.java	Thu Dec 05 18:04:12 2013 +0400
@@ -34,7 +34,7 @@
  * 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: <p>
+ * can be used to specify the following types of changes:
  *
  * <pre>
  * TableModelEvent(source);              //  The data, ie. all rows changed
--- a/src/share/classes/javax/swing/event/TreeModelListener.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/event/TreeModelListener.java	Thu Dec 05 18:04:12 2013 +0400
@@ -86,7 +86,7 @@
      * <p>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.<p>
+     * the first element should become the new root of the tree.
      *
      * <p>Use <code>e.getPath()</code>
      * to get the path to the node.
--- a/src/share/classes/javax/swing/plaf/basic/BasicOptionPaneUI.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/plaf/basic/BasicOptionPaneUI.java	Thu Dec 05 18:04:12 2013 +0400
@@ -48,7 +48,7 @@
  * Provides the basic look and feel for a <code>JOptionPane</code>.
  * <code>BasicMessagePaneUI</code> provides a means to place an icon,
  * message and buttons into a <code>Container</code>.
- * Generally, the layout will look like:<p>
+ * Generally, the layout will look like:
  * <pre>
  *        ------------------
  *        | i | message    |
--- a/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneDivider.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneDivider.java	Thu Dec 05 18:04:12 2013 +0400
@@ -521,7 +521,7 @@
      * MouseHandler is responsible for converting mouse events
      * (released, dragged...) into the appropriate DragController
      * methods.
-     * <p>
+     *
      */
     protected class MouseHandler extends MouseAdapter
             implements MouseMotionListener
@@ -890,7 +890,7 @@
      * Used to layout a <code>BasicSplitPaneDivider</code>.
      * Layout for the divider
      * involves appropriately moving the left/right buttons around.
-     * <p>
+     *
      */
     protected class DividerLayout implements LayoutManager
     {
--- a/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneUI.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneUI.java	Thu Dec 05 18:04:12 2013 +0400
@@ -2015,7 +2015,7 @@
     /**
      * LayoutManager used for JSplitPanes with an orientation of
      * VERTICAL_SPLIT.
-     * <p>
+     *
      */
     public class BasicVerticalLayoutManager extends
             BasicHorizontalLayoutManager
--- a/src/share/classes/javax/swing/plaf/basic/BasicTreeUI.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/plaf/basic/BasicTreeUI.java	Thu Dec 05 18:04:12 2013 +0400
@@ -1398,7 +1398,7 @@
 
     /**
      * Paints the vertical part of the leg. The receiver should
-     * NOT modify <code>clipBounds</code>, <code>insets</code>.<p>
+     * NOT modify <code>clipBounds</code>, <code>insets</code>.
      */
     protected void paintVerticalPartOfLeg(Graphics g, Rectangle clipBounds,
                                           Insets insets, TreePath path) {
--- a/src/share/classes/javax/swing/table/DefaultTableModel.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/table/DefaultTableModel.java	Thu Dec 05 18:04:12 2013 +0400
@@ -182,7 +182,7 @@
      *  each a single row of values.  In other words, to get to the cell
      *  at row 1, column 5: <p>
      *
-     *  <code>((Vector)getDataVector().elementAt(1)).elementAt(5);</code><p>
+     *  <code>((Vector)getDataVector().elementAt(1)).elementAt(5);</code>
      *
      * @return  the vector of vectors containing the tables data values
      *
@@ -306,7 +306,7 @@
      *  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 <code>rowCount</code> and greater are discarded. <p>
+     *  rows at index <code>rowCount</code> and greater are discarded.
      *
      * @param   rowCount   the new number of rows
      * @see #setRowCount
@@ -330,7 +330,7 @@
      *  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 <code>rowCount</code> and greater are discarded. <p>
+     *  rows at index <code>rowCount</code> and greater are discarded.
      *
      *  @see #setColumnCount
      * @since 1.3
@@ -414,7 +414,7 @@
      *  After the move, the row that was at index <code>start</code>
      *  will be at index <code>to</code>.
      *  This method will send a <code>tableChanged</code> notification
-     *  message to all the listeners. <p>
+       message to all the listeners.
      *
      *  <pre>
      *  Examples of moves:
@@ -473,7 +473,7 @@
      * of columns, new columns are added to the end of each row in the model.
      * If the number of <code>newIdentifier</code>s is less than the current
      * number of columns, all the extra columns at the end of a row are
-     * discarded. <p>
+     * discarded.
      *
      * @param   columnIdentifiers  vector of column identifiers.  If
      *                          <code>null</code>, set the model
@@ -490,7 +490,7 @@
      * of columns, new columns are added to the end of each row in the model.
      * If the number of <code>newIdentifier</code>s is less than the current
      * number of columns, all the extra columns at the end of a row are
-     * discarded. <p>
+     * discarded.
      *
      * @param   newIdentifiers  array of column identifiers.
      *                          If <code>null</code>, set
--- a/src/share/classes/javax/swing/table/TableModel.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/table/TableModel.java	Thu Dec 05 18:04:12 2013 +0400
@@ -34,7 +34,7 @@
  *
  *  The <code>JTable</code> can be set up to display any data
  *  model which implements the
- *  <code>TableModel</code> interface with a couple of lines of code:  <p>
+ *  <code>TableModel</code> interface with a couple of lines of code:
  *  <pre>
  *      TableModel myData = new MyTableModel();
  *      JTable table = new JTable(myData);
@@ -42,7 +42,7 @@
  *
  * For further documentation, see <a href="http://docs.oracle.com/javase/tutorial/uiswing/components/table.html#data">Creating a Table Model</a>
  * in <em>The Java Tutorial</em>.
- * <p>
+ *
  * @author Philip Milne
  * @see JTable
  */
--- a/src/share/classes/javax/swing/text/AbstractDocument.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/text/AbstractDocument.java	Thu Dec 05 18:04:12 2013 +0400
@@ -804,7 +804,7 @@
      * 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:
-     * <p>
+     *
      * <pre>
      * &nbsp; int nleft = doc.getDocumentLength();
      * &nbsp; Segment text = new Segment();
--- a/src/share/classes/javax/swing/text/DefaultEditorKit.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/text/DefaultEditorKit.java	Thu Dec 05 18:04:12 2013 +0400
@@ -41,7 +41,7 @@
  * 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.
- * <p>
+ *
  * <dl>
  * <dt><b><font size=+1>Newlines</font></b>
  * <dd>
--- a/src/share/classes/javax/swing/text/Document.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/text/Document.java	Thu Dec 05 18:04:12 2013 +0400
@@ -354,7 +354,7 @@
      * 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:
-     * <p>
+     *
      * <pre><code>
      *
      * &nbsp; int nleft = doc.getDocumentLength();
--- a/src/share/classes/javax/swing/text/JTextComponent.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/text/JTextComponent.java	Thu Dec 05 18:04:12 2013 +0400
@@ -87,7 +87,6 @@
  * <a href="http://docs.oracle.com/javase/tutorial/uiswing/components/generaltext.html">General Rules for Using Text Components</a>,
  * a section in <em>The Java Tutorial.</em>
  *
- * <p>
  * <dl>
  * <dt><b><font size=+1>Caret Changes</font></b>
  * <dd>
@@ -108,7 +107,6 @@
  * <b>Note</b>: Non-editable text components also have a caret though
  * it may not be painted.
  *
- * <p>
  * <dt><b><font size=+1>Commands</font></b>
  * <dd>
  * Text components provide a number of commands that can be used
@@ -120,7 +118,6 @@
  * found with the {@link #getActions} method.  These actions
  * can be bound to key events, fired from buttons, etc.
  *
- * <p>
  * <dt><b><font size=+1>Text Input</font></b>
  * <dd>
  * The text components support flexible and internationalized text input, using
@@ -206,7 +203,6 @@
  * <li>caret movement forward and backward
  * </ul>
  *
- * <p>
  * <dt><b><font size=+1>Model/View Split</font></b>
  * <dd>
  * The text components have a model-view split.  A text component pulls
@@ -231,14 +227,12 @@
  * {@link DocumentListener}
  * interface and registered interest with the model being observed.
  *
- * <p>
  * <dt><b><font size=+1>Location Information</font></b>
  * <dd>
  * 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.
  *
- * <p>
  * <dt><b><font size=+1>Undo/Redo support</font></b>
  * <dd>
  * Support for an edit history mechanism is provided to allow
@@ -249,7 +243,6 @@
  * The support is provided by the Document model, which allows
  * one to attach UndoableEditListener implementations.
  *
- * <p>
  * <dt><b><font size=+1>Thread Safety</font></b>
  * <dd>
  * The swing text components provide some support of thread
@@ -261,13 +254,12 @@
  * The methods that are safe to call asynchronously are marked
  * with comments.
  *
- * <p>
  * <dt><b><font size=+1>Newlines</font></b>
  * <dd>
  * For a discussion on how newlines are handled, see
  * <a href="DefaultEditorKit.html">DefaultEditorKit</a>.
  *
- * <p>
+ *
  * <dt><b><font size=+1>Printing support</font></b>
  * <dd>
  * Several {@link #print print} methods are provided for basic
--- a/src/share/classes/javax/swing/text/View.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/text/View.java	Thu Dec 05 18:04:12 2013 +0400
@@ -144,7 +144,6 @@
     <ul>
     <li>{@link #paint(java.awt.Graphics, java.awt.Shape) paint}
     </ul>
-    <p>
 
     <dt><b>Translate between the model and view coordinate systems.</b>
     <dd>
--- a/src/share/classes/javax/swing/text/html/HTMLDocument.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/text/html/HTMLDocument.java	Thu Dec 05 18:04:12 2013 +0400
@@ -2089,7 +2089,7 @@
      *
      * <p>
      * The assignment of the actions described is shown in the
-     * following table for the tags defined in <code>HTML.Tag</code>.<P>
+     * following table for the tags defined in <code>HTML.Tag</code>.
      * <table border=1 summary="HTML tags and assigned actions">
      * <tr><th>Tag</th><th>Action</th></tr>
      * <tr><td><code>HTML.Tag.A</code>         <td>CharacterAction
@@ -3968,7 +3968,7 @@
         }
 
         /**
-         * This is set to true when and end is invoked for <html>.
+         * This is set to true when and end is invoked for {@literal <html>}.
          */
         private boolean receivedEndHTML;
         /** Number of times <code>flushBuffer</code> has been invoked. */
@@ -3990,7 +3990,7 @@
         boolean inTitle = false;
         boolean lastWasNewline = true;
         boolean emptyAnchor;
-        /** True if (!emptyDocument && insertTag == null), this is used so
+        /** True if (!emptyDocument &amp;&amp; insertTag == null), this is used so
          * much it is cached. */
         boolean midInsert;
         /** True when the body has been encountered. */
--- a/src/share/classes/javax/swing/text/html/HTMLEditorKit.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/text/html/HTMLEditorKit.java	Thu Dec 05 18:04:12 2013 +0400
@@ -71,7 +71,7 @@
  * The modeling of HTML is provided by the class <code>HTMLDocument</code>.
  * Its documentation describes the details of how the HTML is modeled.
  * The editing support leverages heavily off of the text package.
- * <p>
+ *
  * <dt>
  * Extendable/Scalable
  * <dd>
@@ -114,7 +114,7 @@
  *   attributes for display.  This helps make the View implementations
  *   more general purpose
  * </ol>
- * <p>
+ *
  * <dt>
  * Asynchronous Loading
  * <dd>
@@ -127,7 +127,7 @@
  * by the <code>HTMLDocument.HTMLReader</code> class.  The actual
  * work is done by the <code>DefaultStyledDocument</code> and
  * <code>AbstractDocument</code> classes in the text package.
- * <p>
+ *
  * <dt>
  * Customization from current LAF
  * <dd>
@@ -141,7 +141,7 @@
  * The support for this is provided by the <code>StyleSheet</code>
  * class.  The presentation of the HTML can be heavily influenced
  * by the setting of the StyleSheet property on the EditorKit.
- * <p>
+ *
  * <dt>
  * Not lossy
  * <dd>
@@ -839,7 +839,7 @@
          * if the given position represents a link. If this was the result
          * of a mouse click, <code>x</code> and
          * <code>y</code> 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 @@
              * 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 &ge; 0
+             * @param offs1 the ending model offset &ge; offs1
              * @param bounds the bounding box of the view, which is not
              *        necessarily the region to paint.
              * @param c the editor
--- a/src/share/classes/javax/swing/tree/FixedHeightLayoutCache.java	Thu Dec 05 09:44:53 2013 +0100
+++ b/src/share/classes/javax/swing/tree/FixedHeightLayoutCache.java	Thu Dec 05 18:04:12 2013 +0400
@@ -469,7 +469,7 @@
      * <p>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.<p>
+     * the first element should become the new root of the tree.
      *
      * <p>e.path() holds the path to the node.</p>
      * <p>e.childIndices() returns null.</p>
@@ -677,7 +677,7 @@
 
     /**
      * 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 @@
 
         /**
          * 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 &ge; index their index is incremented
          * by one.
          */
         protected void childInsertedAtModelIndex(int index,