8029264: [doclint] more doclint and tidy cleanup
Reviewed-by: alexsch, serb, malenkov
--- a/jdk/src/share/classes/javax/swing/Action.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/DefaultComboBoxModel.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/GroupLayout.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/InputVerifier.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/JComponent.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/JDialog.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/JFrame.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/JInternalFrame.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/JLayeredPane.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/JList.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/JOptionPane.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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 < 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/jdk/src/share/classes/javax/swing/JScrollBar.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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 ≤ value ≤ value+extent ≤ maximum
* </pre>
- * <p>
+ *
*
* @see BoundedRangeModel#setRangeProperties
* @see #setValue
--- a/jdk/src/share/classes/javax/swing/JScrollPane.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/JTable.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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 < 0) we are in shrink mode where:
- * <p>
+ *
* <PRE>
* DELTA
* delta[i] = ------------ * (pref[i] - min[i])
* (PREF - MIN)
* </PRE>
* If (DELTA > 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/jdk/src/share/classes/javax/swing/JTextArea.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/JTextPane.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/JTree.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/LookAndFeel.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/Painter.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/RowFilter.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/SizeSequence.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/Spring.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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 <= 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 <= 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 @@
* <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/jdk/src/share/classes/javax/swing/SpringLayout.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/SwingWorker.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/border/CompoundBorder.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/event/TableModelEvent.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/event/TreeModelListener.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/plaf/basic/BasicOptionPaneUI.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneDivider.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneUI.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/plaf/basic/BasicTreeUI.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/table/DefaultTableModel.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/table/TableModel.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/text/AbstractDocument.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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>
* int nleft = doc.getDocumentLength();
* Segment text = new Segment();
--- a/jdk/src/share/classes/javax/swing/text/DefaultEditorKit.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/text/Document.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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>
*
* int nleft = doc.getDocumentLength();
--- a/jdk/src/share/classes/javax/swing/text/JTextComponent.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/text/View.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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/jdk/src/share/classes/javax/swing/text/html/HTMLDocument.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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 && insertTag == null), this is used so
* much it is cached. */
boolean midInsert;
/** True when the body has been encountered. */
--- a/jdk/src/share/classes/javax/swing/text/html/HTMLEditorKit.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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 ≥ 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
--- a/jdk/src/share/classes/javax/swing/tree/FixedHeightLayoutCache.java Thu Dec 05 09:44:53 2013 +0100
+++ b/jdk/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 ≥ index their index is incremented
* by one.
*/
protected void childInsertedAtModelIndex(int index,