8029264: [doclint] more doclint and tidy cleanup

Reviewed-by: alexsch, serb, malenkov
This commit is contained in:
Yuri Nesterenko 2013-12-05 18:04:12 +04:00
parent 1c59527f70
commit f6fc8e9104
41 changed files with 103 additions and 115 deletions

View File

@ -67,7 +67,7 @@ import java.beans.*;
* 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 @@ import java.beans.*;
* <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">

View File

@ -83,7 +83,7 @@ public class DefaultComboBoxModel<E> extends AbstractListModel<E> implements Mut
// 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) {

View File

@ -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.
* <p>
*
* <p style="text-align:center">
* <img src="doc-files/groupLayout.2.gif" alt="Sequential group along the vertical axis in three components">
* <p>

View File

@ -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.
* <p>
*
* <pre>
* import java.awt.*;
* import java.util.*;

View File

@ -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 <code>validate</code> to get the contents of the
* GUI to update.
* <p>
*
* @see java.awt.Component#invalidate
* @see java.awt.Container#validate

View File

@ -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:
* <p>
* <br><br>
* <ul>
* <li>{@code DO_NOTHING_ON_CLOSE}
* (defined in {@code WindowConstants}):

View File

@ -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:
* <p>
* <br><br>
* <ul>
* <li><code>DO_NOTHING_ON_CLOSE</code>
* (defined in <code>WindowConstants</code>):

View File

@ -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:
* <p>
* <br><br>
* <dl>
* <dt><code>DO_NOTHING_ON_CLOSE</code>
* <dd> Do nothing.

View File

@ -43,7 +43,7 @@ import javax.accessibility.*;
* 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">

View File

@ -950,7 +950,7 @@ public class JList<E> 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:
* <p>
*
* <pre>
* VERTICAL: 0
* 1

View File

@ -106,7 +106,6 @@ import static javax.swing.ClientPropertyKey.PopupFactory_FORCE_HEAVYWEIGHT_POPUP
* <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 @@ import static javax.swing.ClientPropertyKey.PopupFactory_FORCE_HEAVYWEIGHT_POPUP
* 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 @@ import static javax.swing.ClientPropertyKey.PopupFactory_FORCE_HEAVYWEIGHT_POPUP
* <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 @@ import static javax.swing.ClientPropertyKey.PopupFactory_FORCE_HEAVYWEIGHT_POPUP
* }
* <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 @@ 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 <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 @@ 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 <code>OptionPaneUI</code> object
*/
@ -1873,7 +1872,7 @@ public class JOptionPane extends JComponent implements Accessible
}
/**
* 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 @@ 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:
* <code>DEFAULT_OPTION</code>,
* <code>YES_NO_OPTION</code>,
* <code>YES_NO_CANCEL_OPTION</code>,

View File

@ -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 <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 @@ public class JScrollBar extends JComponent implements Adjustable, Accessible
* 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

View File

@ -53,7 +53,7 @@ import java.beans.Transient;
* <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">

View File

@ -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:
* <p>
*
* <pre>
* 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:
* <p>
*
* <pre>((Vector)rowData.elementAt(1)).elementAt(5);</pre>
* <p>
* @param rowData the data for the new table
@ -674,7 +674,7 @@ public class JTable extends JComponent implements TableModelListener, Scrollable
* <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 @@ 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.
* <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 @@ 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).
* <p>
*
* <H4>Definition</H4>
* <P>
* 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.
* <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 @@ public class JTable extends JComponent implements TableModelListener, Scrollable
* <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 @@ 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

View File

@ -93,7 +93,7 @@ import java.io.IOException;
* JTextArea myArea = ??;
* myArea.getDocument().addDocumentListener(myListener);
* </pre>
* <p>
*
* <dl>
* <dt><b><font size=+1>Newlines</font></b>
* <dd>

View File

@ -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.
* <p>
*
* <dl>
* <dt><b><font size=+1>Newlines</font></b>
* <dd>

View File

@ -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();

View File

@ -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.
*
* <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 @@ 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.
* <p>
*
* <h3><a name="exceptions"></a>Exceptions</h3>
*
* All of the install methods provided by {@code LookAndFeel} need to

View File

@ -54,7 +54,7 @@ import java.awt.Graphics2D;
* }
* }
* }
* </pre></p>
* </pre>
*
* <p>This interface makes no guarantees of threadsafety.</p>
*

View File

@ -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;
/**
* <code>RowFilter</code> is used to filter out entries from the
@ -129,7 +130,7 @@ public abstract class RowFilter<M,I> {
/**
* 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--) {

View File

@ -52,7 +52,7 @@ package javax.swing;
* <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 @@ package javax.swing;
* However, any other unit of measure (for example, time in days)
* could be just as valid.
*
* <p>
*
* <h3>Implementation Notes</h3>
*

View File

@ -65,7 +65,7 @@ import java.awt.Component;
* 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 @@ import java.awt.Component;
* 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 @@ import java.awt.Component;
* <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)
*

View File

@ -297,7 +297,7 @@ public class SpringLayout implements LayoutManager2 {
* 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.
*

View File

@ -62,7 +62,6 @@ import sun.swing.AccumulativeRunnable;
* </li>
* </ul>
*
* <p>
*
* <p>
* These constraints mean that a GUI application with time intensive

View File

@ -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:
* <p>
*
* <pre>
* Border border = comp.getBorder();
* Border margin = new EmptyBorder(10,10,10,10);

View File

@ -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: <p>
* can be used to specify the following types of changes:
*
* <pre>
* TableModelEvent(source); // The data, ie. all rows changed

View File

@ -86,7 +86,7 @@ public interface TreeModelListener extends EventListener {
* <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.

View File

@ -48,7 +48,7 @@ import sun.security.action.GetPropertyAction;
* 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 |

View File

@ -521,7 +521,7 @@ public class BasicSplitPaneDivider extends Container
* 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 @@ public class BasicSplitPaneDivider extends Container
* 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
{

View File

@ -2015,7 +2015,7 @@ public class BasicSplitPaneUI extends SplitPaneUI
/**
* LayoutManager used for JSplitPanes with an orientation of
* VERTICAL_SPLIT.
* <p>
*
*/
public class BasicVerticalLayoutManager extends
BasicHorizontalLayoutManager

View File

@ -1398,7 +1398,7 @@ public class BasicTreeUI extends TreeUI
/**
* 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) {

View File

@ -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: <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 @@ 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 <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 @@ 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 <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 @@ public class DefaultTableModel extends AbstractTableModel implements Serializabl
* 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 @@ 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 <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 @@ 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 <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

View File

@ -34,7 +34,7 @@ import javax.swing.event.*;
*
* 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 @@ import javax.swing.event.*;
*
* 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
*/

View File

@ -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:
* <p>
*
* <pre>
* &nbsp; int nleft = doc.getDocumentLength();
* &nbsp; Segment text = new Segment();

View File

@ -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.
* <p>
*
* <dl>
* <dt><b><font size=+1>Newlines</font></b>
* <dd>

View File

@ -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:
* <p>
*
* <pre><code>
*
* &nbsp; int nleft = doc.getDocumentLength();

View File

@ -87,7 +87,6 @@ import sun.swing.SwingAccessor;
* <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 @@ import sun.swing.SwingAccessor;
* <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 @@ import sun.swing.SwingAccessor;
* 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 @@ import sun.swing.SwingAccessor;
* <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 @@ import sun.swing.SwingAccessor;
* {@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 @@ import sun.swing.SwingAccessor;
* 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 @@ import sun.swing.SwingAccessor;
* 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

View File

@ -144,7 +144,6 @@ A view has the following responsibilities:
<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>

View File

@ -2089,7 +2089,7 @@ public class HTMLDocument extends DefaultStyledDocument {
*
* <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 @@ public class HTMLDocument extends DefaultStyledDocument {
}
/**
* 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 @@ 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 &amp;&amp; insertTag == null), this is used so
* much it is cached. */
boolean midInsert;
/** True when the body has been encountered. */

View File

@ -71,7 +71,7 @@ import java.lang.ref.*;
* 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 @@ import java.lang.ref.*;
* attributes for display. This helps make the View implementations
* more general purpose
* </ol>
* <p>
*
* <dt>
* Asynchronous Loading
* <dd>
@ -127,7 +127,7 @@ import java.lang.ref.*;
* 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 @@ import java.lang.ref.*;
* 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 @@ public class HTMLEditorKit extends StyledEditorKit implements Accessible {
* 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 @@ 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 &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

View File

@ -469,7 +469,7 @@ public class FixedHeightLayoutCache extends AbstractLayoutCache {
* <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 @@ 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 &ge; index their index is incremented
* by one.
*/
protected void childInsertedAtModelIndex(int index,