+ * * @param anObject The combo box value or null for no selection. */ public void setSelectedItem(Object anObject) { diff --git a/src/share/classes/javax/swing/GroupLayout.java b/src/share/classes/javax/swing/GroupLayout.java index e3be1ddfdd5f8d1100fa878a43a990cd392de24d..582c96116cacd94a97f50d24df39ad4ae7de83b4 100644 --- a/src/share/classes/javax/swing/GroupLayout.java +++ b/src/share/classes/javax/swing/GroupLayout.java @@ -100,7 +100,7 @@ import static javax.swing.SwingConstants.VERTICAL; * The following diagram shows the same three components, but with the * parallel group along the horizontal axis and the sequential group along * the vertical axis. - *
+ * *
* 
*
diff --git a/src/share/classes/javax/swing/InputVerifier.java b/src/share/classes/javax/swing/InputVerifier.java index aa2a0eeba1f2b31ebcec1dc74f03a5aca1df21cf..2cf4ddcaae61fe08dc00e89c45052283f293d944 100644 --- a/src/share/classes/javax/swing/InputVerifier.java +++ b/src/share/classes/javax/swing/InputVerifier.java @@ -47,7 +47,7 @@ import java.util.*; * either by clicking in it or by pressing TAB. However, if another string * is entered in the first text field, then the user will be unable to * transfer focus to the second text field. - *
+ * *
* import java.awt.*;
* import java.util.*;
diff --git a/src/share/classes/javax/swing/JComponent.java b/src/share/classes/javax/swing/JComponent.java
index 3f4d3f25606d3b7f970aa7c5c0ef2a29df5dae3f..d6f35ac3fea3adaa60f7a0caa6351d7a2a29be92 100644
--- a/src/share/classes/javax/swing/JComponent.java
+++ b/src/share/classes/javax/swing/JComponent.java
@@ -4827,7 +4827,6 @@ public abstract class JComponent extends Container implements Serializable,
* updating differs from the AWT because programs generally no
* longer need to invoke validate to get the contents of the
* GUI to update.
- *
*
* @see java.awt.Component#invalidate
* @see java.awt.Container#validate
diff --git a/src/share/classes/javax/swing/JDialog.java b/src/share/classes/javax/swing/JDialog.java
index 92febed08432fc1427af14ea62389797040074bc..2d8980e3056a45b9b6a6848021db833a55911ee5 100644
--- a/src/share/classes/javax/swing/JDialog.java
+++ b/src/share/classes/javax/swing/JDialog.java
@@ -701,7 +701,7 @@ public class JDialog extends Dialog implements WindowConstants,
* Sets the operation that will happen by default when
* the user initiates a "close" on this dialog.
* You must specify one of the following choices:
- *
+ *
*
-
*
- {@code DO_NOTHING_ON_CLOSE}
* (defined in {@code WindowConstants}):
diff --git a/src/share/classes/javax/swing/JFrame.java b/src/share/classes/javax/swing/JFrame.java
index 27a5a04e276aa68160b80215472d3525752ea1c3..308320c8ecc9c3cd1cd83ea55183b9349ade07eb 100644
--- a/src/share/classes/javax/swing/JFrame.java
+++ b/src/share/classes/javax/swing/JFrame.java
@@ -324,7 +324,7 @@ public class JFrame extends Frame implements WindowConstants,
* Sets the operation that will happen by default when
* the user initiates a "close" on this frame.
* You must specify one of the following choices:
- *
+ *
*-
*
DO_NOTHING_ON_CLOSE* (defined inWindowConstants): diff --git a/src/share/classes/javax/swing/JInternalFrame.java b/src/share/classes/javax/swing/JInternalFrame.java index 901f1371b81742372117692309b965b067fd5aab..3183d5c4e90f2b87734745893aaabd58274bba7d 100644 --- a/src/share/classes/javax/swing/JInternalFrame.java +++ b/src/share/classes/javax/swing/JInternalFrame.java @@ -1645,7 +1645,7 @@ public class JInternalFrame extends JComponent implements * Sets the operation that will happen by default when * the user initiates a "close" on this internal frame. * The possible choices are: - *+ *
*-
*
DO_NOTHING_ON_CLOSE*- Do nothing.
diff --git a/src/share/classes/javax/swing/JLayeredPane.java b/src/share/classes/javax/swing/JLayeredPane.java
index 052fcf34c31c8b74894a795925d20ea5fba9a684..71d57bdabb8dc2240ce74d5edf4aa113d944b705 100644
--- a/src/share/classes/javax/swing/JLayeredPane.java
+++ b/src/share/classes/javax/swing/JLayeredPane.java
@@ -43,7 +43,7 @@ import javax.accessibility.*;
* For task-oriented documentation and examples of using layered panes see
* How to Use a Layered Pane,
* a section in The Java Tutorial.
- *
+ * *
*
* diff --git a/src/share/classes/javax/swing/JList.java b/src/share/classes/javax/swing/JList.java index e62bc80135b63e357ed156dfaec0c4c859028f6c..1aae62e861f7d93f4c6530236f3d2a0ae8565766 100644 --- a/src/share/classes/javax/swing/JList.java +++ b/src/share/classes/javax/swing/JList.java @@ -950,7 +950,7 @@ public class JList extends JComponent implements Scrollable, Accessible /** * Defines the way list cells are layed out. Consider a {@code JList} * with five cells. Cells can be layed out in one of the following ways: - * + * *
* VERTICAL: 0 * 1 diff --git a/src/share/classes/javax/swing/JOptionPane.java b/src/share/classes/javax/swing/JOptionPane.java index 8bbd49db63a72cc04f90f0275e08fd00518750b7..a2dbf810a1dd492c7191210bdd4608a4946340c3 100644 --- a/src/share/classes/javax/swing/JOptionPane.java +++ b/src/share/classes/javax/swing/JOptionPane.java @@ -106,7 +106,6 @@ import static javax.swing.ClientPropertyKey.PopupFactory_FORCE_HEAVYWEIGHT_POPUP ** All dialogs are modal. Each
showXxxDialogmethod blocks * the caller until the user's interaction is complete. - ** *
*
@@ -143,7 +142,7 @@ import static javax.swing.ClientPropertyKey.PopupFactory_FORCE_HEAVYWEIGHT_POPUP * just below the component. This parameter may be null, * in which case a defaultFrameis used as the parent, * and the dialog will be - * centered on the screen (depending on the L&F). + * centered on the screen (depending on the {@literal L&F}). *- message
- * A descriptive message to be placed in the dialog box. * In the most common usage, message is just a
Stringor @@ -225,42 +224,42 @@ import static javax.swing.ClientPropertyKey.PopupFactory_FORCE_HEAVYWEIGHT_POPUP *- Show an error dialog that displays the message, 'alert': *
* JOptionPane.showMessageDialog(null, "alert", "alert", JOptionPane.ERROR_MESSAGE); - *+ * *
- Show an internal information dialog with the message, 'information': - *
- * JOptionPane.showInternalMessageDialog(frame, "information",
- *- "information", JOptionPane.INFORMATION_MESSAGE);
+ *
+ * JOptionPane.showInternalMessageDialog(frame, "information", + * "information", JOptionPane.INFORMATION_MESSAGE); + *
*- Show an information panel with the options yes/no and message 'choose one': - *
JOptionPane.showConfirmDialog(null, - *- "choose one", "choose one", JOptionPane.YES_NO_OPTION);
+ *
JOptionPane.showConfirmDialog(null, + * "choose one", "choose one", JOptionPane.YES_NO_OPTION); + *
*- Show an internal information dialog with the options yes/no/cancel and * message 'please choose one' and title information: - *
JOptionPane.showInternalConfirmDialog(frame, - *- "please choose one", "information",
- JOptionPane.YES_NO_CANCEL_OPTION, JOptionPane.INFORMATION_MESSAGE);
+ *
JOptionPane.showInternalConfirmDialog(frame, + * "please choose one", "information", + * JOptionPane.YES_NO_CANCEL_OPTION, JOptionPane.INFORMATION_MESSAGE); + *
*- Show a warning dialog with the options OK, CANCEL, title 'Warning', and * message 'Click OK to continue': - *
- * Object[] options = { "OK", "CANCEL" };
+ *+ * Object[] options = { "OK", "CANCEL" }; * JOptionPane.showOptionDialog(null, "Click OK to continue", "Warning", - *- JOptionPane.DEFAULT_OPTION, JOptionPane.WARNING_MESSAGE,
- null, options, options[0]);
+ * JOptionPane.DEFAULT_OPTION, JOptionPane.WARNING_MESSAGE, + * null, options, options[0]); + * *
- Show a dialog asking the user to type in a String: *
* String inputValue = JOptionPane.showInputDialog("Please input a value"); - *+ * *
- Show a dialog asking the user to select a String: - *
+ ** Object[] possibleValues = { "First", "Second", "Third" };
* Object selectedValue = JOptionPane.showInputDialog(null, - *- "Choose one", "Input",
- JOptionPane.INFORMATION_MESSAGE, null,
- possibleValues, possibleValues[0]);
+ * "Choose one", "Input", + * JOptionPane.INFORMATION_MESSAGE, null, + * possibleValues, possibleValues[0]); + *
* * Direct Use:
* To create and use anJOptionPanedirectly, the @@ -281,7 +280,7 @@ import static javax.swing.ClientPropertyKey.PopupFactory_FORCE_HEAVYWEIGHT_POPUP * } * //If there is an array of option buttons: * for(int counter = 0, maxCounter = options.length; - * counter < maxCounter; counter++) { + * counter < maxCounter; counter++) { * if(options[counter].equals(selectedValue)) * return counter; * } @@ -1847,9 +1846,9 @@ public class JOptionPane extends JComponent implements Accessible } /** - * Sets the UI object which implements the L&F for this component. + * Sets the UI object which implements the {@literal L&F} for this component. * - * @param ui theOptionPaneUIL&F object + * @param ui theOptionPaneUI{@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 theOptionPaneUIobject */ @@ -1873,7 +1872,7 @@ public class JOptionPane extends JComponent implements Accessible } /** - * Notification from theUIManagerthat the L&F has changed. + * Notification from theUIManagerthat the {@literal L&F} has changed. * Replaces the current UI object with the latest version from the *UIManager. * @@ -1886,7 +1885,7 @@ public class JOptionPane extends JComponent implements Accessible /** * Returns the name of the UI class that implements the - * L&F for this component. + * {@literal L&F} for this component. * * @return the string "OptionPaneUI" * @see JComponent#getUIClassID @@ -2103,7 +2102,7 @@ public class JOptionPane extends JComponent implements Accessible * Sets the options to display. * The option type is used by the Look and Feel to * determine what buttons to show (unless options are supplied). - * @param newType an integer specifying the options the L&F is to display: + * @param newType an integer specifying the options the {@literal L&F} is to display: *DEFAULT_OPTION, *YES_NO_OPTION, *YES_NO_CANCEL_OPTION, diff --git a/src/share/classes/javax/swing/JScrollBar.java b/src/share/classes/javax/swing/JScrollBar.java index efcac8115463754e8b964986610ad2cd98d60d0d..1c0eac1af7ffcd775bbd4ffe3078bcc65255e3e9 100644 --- a/src/share/classes/javax/swing/JScrollBar.java +++ b/src/share/classes/javax/swing/JScrollBar.java @@ -192,9 +192,9 @@ public class JScrollBar extends JComponent implements Adjustable, Accessible /** - * Sets the L&F object that renders this component. + * Sets the {@literal L&F} object that renders this component. * - * @param ui theScrollBarUIL&F object + * @param ui theScrollBarUI{@literal L&F} object * @see UIDefaults#getUI * @since 1.4 * @beaninfo @@ -606,9 +606,9 @@ public class JScrollBar extends JComponent implements Adjustable, Accessible * Sets the four BoundedRangeModel properties after forcing * the arguments to obey the usual constraints: *- * minimum <= value <= value+extent <= maximum + * minimum ≤ value ≤ value+extent ≤ maximum *- *+ * * * @see BoundedRangeModel#setRangeProperties * @see #setValue diff --git a/src/share/classes/javax/swing/JScrollPane.java b/src/share/classes/javax/swing/JScrollPane.java index 4c5f1e88823592e64da1f2e6d857d6279efd4132..ecb3d8f34d9b1c5984990f12327c22bb6731c187 100644 --- a/src/share/classes/javax/swing/JScrollPane.java +++ b/src/share/classes/javax/swing/JScrollPane.java @@ -53,7 +53,7 @@ import java.beans.Transient; * How to Use Scroll Panes, * a section in The Java Tutorial. Note that *
JScrollPanedoes not support heavyweight components. - *+ * *
*
* diff --git a/src/share/classes/javax/swing/JTable.java b/src/share/classes/javax/swing/JTable.java index bdcb27b1b17bbd91524617a1b8cd47ec7b798996..526afcf66bfa117779c0d7122fd8ab2786618c1d 100644 --- a/src/share/classes/javax/swing/JTable.java +++ b/src/share/classes/javax/swing/JTable.java @@ -73,7 +73,7 @@ import sun.swing.SwingLazyValue; * but provides defaults for these features so that simple tables can be * set up easily. For example, to set up a table with 10 rows and 10 * columns of numbers: - * + * *
* TableModel dataModel = new AbstractTableModel() { * public int getColumnCount() { return 10; } @@ -659,7 +659,7 @@ public class JTable extends JComponent implements TableModelListener, Scrollable * should contain the values for that row. In other words, * the value of the cell at row 1, column 5 can be obtained * with the following code: - *+ * *
((Vector)rowData.elementAt(1)).elementAt(5);
** @param rowData the data for the new table @@ -674,7 +674,7 @@ public class JTable extends JComponent implements TableModelListener, Scrollable *
rowData, with column names,columnNames. *rowDatais an array of rows, so the value of the cell at row 1, * column 5 can be obtained with the following code: - *+ * *
rowData[1][5];
** All rows must be of the same length as
columnNames. @@ -3062,9 +3062,9 @@ public class JTable extends JComponent implements TableModelListener, Scrollable * interface that allows any data structure containing a collection * of elements with a size, preferred size, maximum size and minimum size * to have its elements manipulated by the algorithm. - *+ * *
Distributing the delta
- *+ * *
Overview
** Call "DELTA" the difference between the target size and the @@ -3073,7 +3073,7 @@ public class JTable extends JComponent implements TableModelListener, Scrollable * sizes and adding a share of the DELTA - that share being based on * how far each preferred size is from its limiting bound (minimum or * maximum). - *
+ * *
Definition
** Call the individual constraints min[i], max[i], and pref[i]. @@ -3081,21 +3081,21 @@ public class JTable extends JComponent implements TableModelListener, Scrollable * Call their respective sums: MIN, MAX, and PREF. *
* Each new size will be calculated using: - *
+ * *
* size[i] = pref[i] + delta[i] ** where each individual delta[i] is calculated according to: ** If (DELTA < 0) we are in shrink mode where: - *
+ * *
* DELTA * delta[i] = ------------ * (pref[i] - min[i]) * (PREF - MIN) ** If (DELTA > 0) we are in expand mode where: - *+ * *
* DELTA * delta[i] = ------------ * (max[i] - pref[i]) @@ -6373,7 +6373,7 @@ public class JTable extends JComponent implements TableModelListener, Scrollable ** Here's an example of creating a
MessageFormatthat can be * used to print "Duke's Table: Page - " and the current page number: - *+ * *
* // notice the escaping of the single quote * // notice how the page number is included with "{0}" @@ -7686,7 +7686,7 @@ public class JTable extends JComponent implements TableModelListener, Scrollable * Returns a boolean value indicating whether the specified column * is selected. * - * @param r zero-based column of the table + * @param c zero-based column of the table * @return the boolean value true if the specified column is selected. * Otherwise, false. * @since 1.3 diff --git a/src/share/classes/javax/swing/JTextArea.java b/src/share/classes/javax/swing/JTextArea.java index 80b2bb729e3de09fd00b2466ec73c3a0ceec8f9d..06b6ea593b7a2a4455a7b31fcb8061cb93489d17 100644 --- a/src/share/classes/javax/swing/JTextArea.java +++ b/src/share/classes/javax/swing/JTextArea.java @@ -93,7 +93,7 @@ import java.io.IOException; * JTextArea myArea = ??; * myArea.getDocument().addDocumentListener(myListener); *- *+ * *
-
*
- Newlines *
-
diff --git a/src/share/classes/javax/swing/JTextPane.java b/src/share/classes/javax/swing/JTextPane.java
index a6a76edcf320597f508238280554d5da21afe031..b2ca7fc89a46d7d1647d4f48bf869169d849c772 100644
--- a/src/share/classes/javax/swing/JTextPane.java
+++ b/src/share/classes/javax/swing/JTextPane.java
@@ -49,7 +49,7 @@ import javax.swing.plaf.*;
* the default attributes to use if not overridden by attributes set
* on the paragraph or character run. Components and images may
* be embedded in the flow of text.
- *
+ * *
-
*
- Newlines *
-
diff --git a/src/share/classes/javax/swing/JTree.java b/src/share/classes/javax/swing/JTree.java
index fdacb72aa3ca8925e34e124f16cf266c34b80cef..196cde453ab0050625cb9750a8527382b037f837 100644
--- a/src/share/classes/javax/swing/JTree.java
+++ b/src/share/classes/javax/swing/JTree.java
@@ -3956,7 +3956,7 @@ public class JTree extends JComponent implements Scrollable, Accessible
* allows children depends on how it was created.
*
* @return true if this node allows children, false otherwise
- * @see #JTree.DynamicUtilTreeNode
+ * @see JTree.DynamicUtilTreeNode
*/
public boolean isLeaf() {
return !getAllowsChildren();
diff --git a/src/share/classes/javax/swing/LookAndFeel.java b/src/share/classes/javax/swing/LookAndFeel.java
index 024162cfa50e0244022d27a1b55c6ad0bee10fb8..2aad9290fc900cd102773a4bcb0b12841fe606fa 100644
--- a/src/share/classes/javax/swing/LookAndFeel.java
+++ b/src/share/classes/javax/swing/LookAndFeel.java
@@ -91,7 +91,7 @@ import java.util.StringTokenizer;
* to provide a specific set of defaults. These are documented in the
* classes that require the specific default.
*
- *
ComponentUIs and defaults
+ *ComponentUIs and defaults
* * All {@code ComponentUIs} typically need to set various properties * on the {@code JComponent} the {@code ComponentUI} is providing the @@ -120,7 +120,7 @@ import java.util.StringTokenizer; * {@code ComponentUI} implementations should use the various install methods * provided by this class as they handle the necessary checking and install * the property using the recommended guidelines. - *+ * *
Exceptions
* * All of the install methods provided by {@code LookAndFeel} need to diff --git a/src/share/classes/javax/swing/Painter.java b/src/share/classes/javax/swing/Painter.java index 7b2e3ef11effb9f841bd2f9b5edc6f4d3540b688..57ac21fb1e4a99adda359a370d75553d1d552d02 100644 --- a/src/share/classes/javax/swing/Painter.java +++ b/src/share/classes/javax/swing/Painter.java @@ -54,7 +54,7 @@ import java.awt.Graphics2D; * } * } * } - * + * * *This interface makes no guarantees of threadsafety.
* diff --git a/src/share/classes/javax/swing/RowFilter.java b/src/share/classes/javax/swing/RowFilter.java index 6d9fc7f33f8595f9ff778a1d7912707cafaa61bb..ccf779cf137b577e37778c7abb7f8d16fc7247b7 100644 --- a/src/share/classes/javax/swing/RowFilter.java +++ b/src/share/classes/javax/swing/RowFilter.java @@ -31,6 +31,7 @@ import java.util.Date; import java.util.List; import java.util.regex.Matcher; import java.util.regex.Pattern; +import java.util.regex.PatternSyntaxException; /** *RowFilteris used to filter out entries from the @@ -129,7 +130,7 @@ public abstract class RowFilter* The following figure shows the relationship between size and position data * for a multi-column component. - *
+ * *
* ![The first item begins at position 0, the second at the position equal
@@ -76,7 +76,6 @@ package javax.swing;
* However, any other unit of measure (for example, time in days)
* could be just as valid.
*
- * <p>
*
* <h3>Implementation Notes</h3>
*
diff --git a/src/share/classes/javax/swing/Spring.java b/src/share/classes/javax/swing/Spring.java
index 2b18313e7c6bebe396cb2a5ad06fefaed727c632..40320734219a2f8ed2765295851c77117496baec 100644
--- a/src/share/classes/javax/swing/Spring.java
+++ b/src/share/classes/javax/swing/Spring.java
@@ -65,7 +65,7 @@ import java.awt.Component;
* from <code>a</code>
* to <code>b</code>,
* where <code>a <= b</code>).
- * <p>
+ *
* <pre>
* [a1, b1] + [a2, b2] = [a1 + a2, b1 + b2]
*
@@ -78,7 +78,7 @@ import java.awt.Component;
* If we denote <code>Spring</code>s as <code>[a, b, c]</code>,
* where <code>a <= b <= c</code>, we can define the same
* arithmetic operators on <code>Spring</code>s:
- * <p>
+ *
* <pre>
* [a1, b1, c1] + [a2, b2, c2] = [a1 + a2, b1 + b2, c1 + c2]
*
@@ -89,7 +89,7 @@ import java.awt.Component;
* <p>
* With both intervals and <code>Spring</code>s we can define](doc-files/SizeSequence-1.gif)
min
* in terms of negation:
- * + * *
* X - Y = X + (-Y) * diff --git a/src/share/classes/javax/swing/SpringLayout.java b/src/share/classes/javax/swing/SpringLayout.java index dc85b2c1dcde654a8e567f8cbc632f8e79c3f897..95444bfed59db6edb6ff46b2628d4940ab64bf43 100644 --- a/src/share/classes/javax/swing/SpringLayout.java +++ b/src/share/classes/javax/swing/SpringLayout.java @@ -297,7 +297,7 @@ public class SpringLayout implements LayoutManager2 { * and "a - b" is equal to *Spring.sum(a, Spring.minus(b)). * See the - * {@link SpringSpringAPI documentation} + * {@link Spring Spring API documentation} * for further details * of spring arithmetic. * diff --git a/src/share/classes/javax/swing/SwingWorker.java b/src/share/classes/javax/swing/SwingWorker.java index 5775bcb4ea974f0794076f3649d21ded1b1304cc..746b78aa7d2cb1d8e59fda14be29d1807e00fb12 100644 --- a/src/share/classes/javax/swing/SwingWorker.java +++ b/src/share/classes/javax/swing/SwingWorker.java @@ -62,7 +62,6 @@ import sun.swing.AccumulativeRunnable; * * * - ** *
* These constraints mean that a GUI application with time intensive diff --git a/src/share/classes/javax/swing/border/CompoundBorder.java b/src/share/classes/javax/swing/border/CompoundBorder.java index f1a6d8538e6ddfa9ba5c75756ce749ba9c448d5c..6a28c1a3893c77a5e0aa122892e54e161bca1ca3 100644 --- a/src/share/classes/javax/swing/border/CompoundBorder.java +++ b/src/share/classes/javax/swing/border/CompoundBorder.java @@ -36,7 +36,7 @@ import java.beans.ConstructorProperties; * * For example, this class may be used to add blank margin space * to a component with an existing decorative border: - *
+ * *
* Border border = comp.getBorder(); * Border margin = new EmptyBorder(10,10,10,10); diff --git a/src/share/classes/javax/swing/event/TableModelEvent.java b/src/share/classes/javax/swing/event/TableModelEvent.java index 05c5c7bdc765c35d1944e5df3743e951851dd592..ab450cbd72d62660ee628b094f448a5e41c422b4 100644 --- a/src/share/classes/javax/swing/event/TableModelEvent.java +++ b/src/share/classes/javax/swing/event/TableModelEvent.java @@ -34,7 +34,7 @@ import javax.swing.table.*; * and all references to rows and columns are in the co-ordinate * system of the model. * Depending on the parameters used in the constructors, the TableModelevent - * can be used to specify the following types of changes:
+ * can be used to specify the following types of changes: * *
* TableModelEvent(source); // The data, ie. all rows changed diff --git a/src/share/classes/javax/swing/event/TreeModelListener.java b/src/share/classes/javax/swing/event/TreeModelListener.java index b48fdfb25489ebb72ac70a77a951c2d16d623e84..48a945f116f7f5fd0ddc37e8850fddc19ea8bc2b 100644 --- a/src/share/classes/javax/swing/event/TreeModelListener.java +++ b/src/share/classes/javax/swing/event/TreeModelListener.java @@ -86,7 +86,7 @@ public interface TreeModelListener extends EventListener { *Invoked after the tree has drastically changed structure from a * given node down. If the path returned by e.getPath() is of length * one and the first element does not identify the current root node - * the first element should become the new root of the tree.
+ * the first element should become the new root of the tree. * *
Use
e.getPath()* to get the path to the node. diff --git a/src/share/classes/javax/swing/plaf/basic/BasicOptionPaneUI.java b/src/share/classes/javax/swing/plaf/basic/BasicOptionPaneUI.java index 28b1d0a09bba8685b8f95fae7c1d78bd2654daa3..b55f8ab0fbcb9c0d201931ebc6321780690adb0d 100644 --- a/src/share/classes/javax/swing/plaf/basic/BasicOptionPaneUI.java +++ b/src/share/classes/javax/swing/plaf/basic/BasicOptionPaneUI.java @@ -48,7 +48,7 @@ import sun.security.action.GetPropertyAction; * Provides the basic look and feel for aJOptionPane. *BasicMessagePaneUIprovides a means to place an icon, * message and buttons into aContainer. - * Generally, the layout will look like:+ * Generally, the layout will look like: *
* ------------------ * | i | message | diff --git a/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneDivider.java b/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneDivider.java index 9a56bd7b3b8207e7bcdd15bf76593ad3bdca4248..9704705b2f56b39282019ec31b88e70a4380bf36 100644 --- a/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneDivider.java +++ b/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneDivider.java @@ -521,7 +521,7 @@ public class BasicSplitPaneDivider extends Container * MouseHandler is responsible for converting mouse events * (released, dragged...) into the appropriate DragController * methods. - *+ * */ protected class MouseHandler extends MouseAdapter implements MouseMotionListener @@ -890,7 +890,7 @@ public class BasicSplitPaneDivider extends Container * Used to layout a
BasicSplitPaneDivider. * Layout for the divider * involves appropriately moving the left/right buttons around. - *+ * */ protected class DividerLayout implements LayoutManager { diff --git a/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneUI.java b/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneUI.java index 0f47e8965c5e5e9ad4342c43c5eb6335b67b759e..1ec9921426f29b2918d5cb261d275c59a087197b 100644 --- a/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneUI.java +++ b/src/share/classes/javax/swing/plaf/basic/BasicSplitPaneUI.java @@ -2015,7 +2015,7 @@ public class BasicSplitPaneUI extends SplitPaneUI /** * LayoutManager used for JSplitPanes with an orientation of * VERTICAL_SPLIT. - *
+ * */ public class BasicVerticalLayoutManager extends BasicHorizontalLayoutManager diff --git a/src/share/classes/javax/swing/plaf/basic/BasicTreeUI.java b/src/share/classes/javax/swing/plaf/basic/BasicTreeUI.java index 821483049f08e66a23ff4f164786586c1bd97cf0..cd41f8527152c580d8db3bc8fa10e420d3f5ffab 100644 --- a/src/share/classes/javax/swing/plaf/basic/BasicTreeUI.java +++ b/src/share/classes/javax/swing/plaf/basic/BasicTreeUI.java @@ -1398,7 +1398,7 @@ public class BasicTreeUI extends TreeUI /** * Paints the vertical part of the leg. The receiver should - * NOT modify
clipBounds,insets.+ * NOT modify
clipBounds,insets. */ protected void paintVerticalPartOfLeg(Graphics g, Rectangle clipBounds, Insets insets, TreePath path) { diff --git a/src/share/classes/javax/swing/table/DefaultTableModel.java b/src/share/classes/javax/swing/table/DefaultTableModel.java index 5abf1e82aa144280a375e26b321435da82b28c0f..6bf39981d3db5757fbd73549558442e7128bb54b 100644 --- a/src/share/classes/javax/swing/table/DefaultTableModel.java +++ b/src/share/classes/javax/swing/table/DefaultTableModel.java @@ -182,7 +182,7 @@ public class DefaultTableModel extends AbstractTableModel implements Serializabl * each a single row of values. In other words, to get to the cell * at row 1, column 5:* - *
((Vector)getDataVector().elementAt(1)).elementAt(5);+ *
((Vector)getDataVector().elementAt(1)).elementAt(5);* * @return the vector of vectors containing the tables data values * @@ -306,7 +306,7 @@ public class DefaultTableModel extends AbstractTableModel implements Serializabl * Sets the number of rows in the model. If the new size is greater * than the current size, new rows are added to the end of the model * If the new size is less than the current size, all - * rows at indexrowCountand greater are discarded.+ * rows at index
rowCountand 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 indexrowCountand greater are discarded.+ * rows at index
rowCountand 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 indexstart* will be at indexto. * This method will send atableChangednotification - * message to all the listeners.+ message to all the listeners. * *
* Examples of moves: @@ -473,7 +473,7 @@ public class DefaultTableModel extends AbstractTableModel implements Serializabl * of columns, new columns are added to the end of each row in the model. * If the number ofnewIdentifiers is less than the current * number of columns, all the extra columns at the end of a row are - * discarded.+ * discarded. * * @param columnIdentifiers vector of column identifiers. If *
null, set the model @@ -490,7 +490,7 @@ public class DefaultTableModel extends AbstractTableModel implements Serializabl * of columns, new columns are added to the end of each row in the model. * If the number ofnewIdentifiers is less than the current * number of columns, all the extra columns at the end of a row are - * discarded.+ * discarded. * * @param newIdentifiers array of column identifiers. * If
null, set diff --git a/src/share/classes/javax/swing/table/TableModel.java b/src/share/classes/javax/swing/table/TableModel.java index 2c4794bc980b49304c738b8b659f592fe98488cd..5b13fc1aede69175165fc066e63f50a4ffac2765 100644 --- a/src/share/classes/javax/swing/table/TableModel.java +++ b/src/share/classes/javax/swing/table/TableModel.java @@ -34,7 +34,7 @@ import javax.swing.event.*; * * TheJTablecan be set up to display any data * model which implements the - *TableModelinterface with a couple of lines of code:+ *
TableModelinterface with a couple of lines of code: ** TableModel myData = new MyTableModel(); * JTable table = new JTable(myData); @@ -42,7 +42,7 @@ import javax.swing.event.*; * * For further documentation, see Creating a Table Model * in The Java Tutorial. - *
+ * * @author Philip Milne * @see JTable */ diff --git a/src/share/classes/javax/swing/text/AbstractDocument.java b/src/share/classes/javax/swing/text/AbstractDocument.java index 71e9d5d8c6098e1eea54fc7eb7c4b4f13f441f0d..f8a4332a8391fb4f0a7c7d8d246eaa405c533247 100644 --- a/src/share/classes/javax/swing/text/AbstractDocument.java +++ b/src/share/classes/javax/swing/text/AbstractDocument.java @@ -804,7 +804,7 @@ public abstract class AbstractDocument implements Document, Serializable { * returns will give better performance for situations where large * parts of the document are being scanned. The following is an example * of using the partial return to access the entire document: - *
+ * *
* int nleft = doc.getDocumentLength(); * Segment text = new Segment(); diff --git a/src/share/classes/javax/swing/text/DefaultEditorKit.java b/src/share/classes/javax/swing/text/DefaultEditorKit.java index f47a1c62c62a327c5cccbd7d9ef58b54de0dd87c..139615bdf0efd062a3164a2565c17e16d6cf6648 100644 --- a/src/share/classes/javax/swing/text/DefaultEditorKit.java +++ b/src/share/classes/javax/swing/text/DefaultEditorKit.java @@ -41,7 +41,7 @@ import javax.swing.UIManager; * of text document. This implementation provides a default * implementation which treats text as plain text and * provides a minimal set of actions for a simple editor. - *+ * *
-
*
- Newlines *
-
diff --git a/src/share/classes/javax/swing/text/Document.java b/src/share/classes/javax/swing/text/Document.java
index 5b79ac41a28fe2d192b08073598cc49cc6639094..946e18ae2225a079c80be40edf6eb10fcb4cb5aa 100644
--- a/src/share/classes/javax/swing/text/Document.java
+++ b/src/share/classes/javax/swing/text/Document.java
@@ -354,7 +354,7 @@ public interface Document {
* returns will give better performance for situations where large
* parts of the document are being scanned. The following is an example
* of using the partial return to access the entire document:
- *
+ * *
* * int nleft = doc.getDocumentLength(); diff --git a/src/share/classes/javax/swing/text/JTextComponent.java b/src/share/classes/javax/swing/text/JTextComponent.java index 2ec12639cfbe3a09ead150e2bf5237ea5b55e5dd..5f4fd2021be22a8a8f0685c960abd1cdab41fc4b 100644 --- a/src/share/classes/javax/swing/text/JTextComponent.java +++ b/src/share/classes/javax/swing/text/JTextComponent.java @@ -87,7 +87,6 @@ import sun.swing.SwingAccessor; * General Rules for Using Text Components, * a section in The Java Tutorial. * - **
-
*
- Caret Changes *
-
@@ -108,7 +107,6 @@ import sun.swing.SwingAccessor;
* Note: Non-editable text components also have a caret though
* it may not be painted.
*
- *
*
- Commands *
-
* Text components provide a number of commands that can be used
@@ -120,7 +118,6 @@ import sun.swing.SwingAccessor;
* found with the {@link #getActions} method. These actions
* can be bound to key events, fired from buttons, etc.
*
- *
*
- Text Input *
-
* The text components support flexible and internationalized text input, using
@@ -206,7 +203,6 @@ import sun.swing.SwingAccessor;
*
- caret movement forward and backward * * - *
*
- Model/View Split *
- * The text components have a model-view split. A text component pulls @@ -231,14 +227,12 @@ import sun.swing.SwingAccessor; * {@link DocumentListener} * interface and registered interest with the model being observed. * - *
*
- Location Information *
- * The capability of determining the location of text in * the view is provided. There are two methods, {@link #modelToView} * and {@link #viewToModel} for determining this information. * - *
*
- Undo/Redo support *
- * Support for an edit history mechanism is provided to allow @@ -249,7 +243,6 @@ import sun.swing.SwingAccessor; * The support is provided by the Document model, which allows * one to attach UndoableEditListener implementations. * - *
*
- Thread Safety *
- * The swing text components provide some support of thread @@ -261,13 +254,12 @@ import sun.swing.SwingAccessor; * The methods that are safe to call asynchronously are marked * with comments. * - *
*
- Newlines *
- * For a discussion on how newlines are handled, see * DefaultEditorKit. * - *
+ * *
- Printing support *
- * Several {@link #print print} methods are provided for basic diff --git a/src/share/classes/javax/swing/text/View.java b/src/share/classes/javax/swing/text/View.java index 675aad55530a8da357295f5c2b02fe52ef4f8c3f..2b49055ab593ac4ab481035f773d969397c018a5 100644 --- a/src/share/classes/javax/swing/text/View.java +++ b/src/share/classes/javax/swing/text/View.java @@ -144,7 +144,6 @@ A view has the following responsibilities:
- {@link #paint(java.awt.Graphics, java.awt.Shape) paint}
- Translate between the model and view coordinate systems.
- diff --git a/src/share/classes/javax/swing/text/html/HTMLDocument.java b/src/share/classes/javax/swing/text/html/HTMLDocument.java index 8b84bf73ba5a37bc0ac891d0775d583f2f73f20b..852776e61c7780b62ebd98b7cc251fe833501918 100644 --- a/src/share/classes/javax/swing/text/html/HTMLDocument.java +++ b/src/share/classes/javax/swing/text/html/HTMLDocument.java @@ -2089,7 +2089,7 @@ public class HTMLDocument extends DefaultStyledDocument { * *
* The assignment of the actions described is shown in the - * following table for the tags defined in
HTML.Tag.+ * following table for the tags defined in
HTML.Tag. **
Tag Action HTML.Tag.ACharacterAction @@ -3968,7 +3968,7 @@ public class HTMLDocument extends DefaultStyledDocument { } /** - * This is set to true when and end is invoked for . + * This is set to true when and end is invoked for {@literal }. */ private boolean receivedEndHTML; /** Number of times flushBufferhas been invoked. */ @@ -3990,7 +3990,7 @@ public class HTMLDocument extends DefaultStyledDocument { boolean inTitle = false; boolean lastWasNewline = true; boolean emptyAnchor; - /** True if (!emptyDocument && insertTag == null), this is used so + /** True if (!emptyDocument && insertTag == null), this is used so * much it is cached. */ boolean midInsert; /** True when the body has been encountered. */ diff --git a/src/share/classes/javax/swing/text/html/HTMLEditorKit.java b/src/share/classes/javax/swing/text/html/HTMLEditorKit.java index 9cca8f95313a83c172bf08e4088aaeb499dd4c65..468f8626d2fb4e1413e8ef5137d89fb9c7935782 100644 --- a/src/share/classes/javax/swing/text/html/HTMLEditorKit.java +++ b/src/share/classes/javax/swing/text/html/HTMLEditorKit.java @@ -71,7 +71,7 @@ import java.lang.ref.*; * The modeling of HTML is provided by the classHTMLDocument. * Its documentation describes the details of how the HTML is modeled. * The editing support leverages heavily off of the text package. - *+ * *
- * Extendable/Scalable *
- @@ -114,7 +114,7 @@ import java.lang.ref.*; * attributes for display. This helps make the View implementations * more general purpose * - *
+ * *
- * Asynchronous Loading *
- @@ -127,7 +127,7 @@ import java.lang.ref.*; * by the
HTMLDocument.HTMLReaderclass. The actual * work is done by theDefaultStyledDocumentand *AbstractDocumentclasses in the text package. - *+ * *
- * Customization from current LAF *
- @@ -141,7 +141,7 @@ import java.lang.ref.*; * The support for this is provided by the
StyleSheet* class. The presentation of the HTML can be heavily influenced * by the setting of the StyleSheet property on the EditorKit. - *+ * *
- * Not lossy *
- @@ -839,7 +839,7 @@ public class HTMLEditorKit extends StyledEditorKit implements Accessible { * if the given position represents a link. If this was the result * of a mouse click,
xand *ywill give the location of the mouse, otherwise - * they will be < 0. + * they will be {@literal <} 0. * * @param pos the position * @param html the editor pane @@ -2027,8 +2027,8 @@ public class HTMLEditorKit extends StyledEditorKit implements Accessible { * Paints a portion of a highlight. * * @param g the graphics context - * @param offs0 the starting model offset >= 0 - * @param offs1 the ending model offset >= offs1 + * @param offs0 the starting model offset ≥ 0 + * @param offs1 the ending model offset ≥ offs1 * @param bounds the bounding box of the view, which is not * necessarily the region to paint. * @param c the editor diff --git a/src/share/classes/javax/swing/tree/FixedHeightLayoutCache.java b/src/share/classes/javax/swing/tree/FixedHeightLayoutCache.java index c31a96e2f794afcdf72978ef8dafb9f48bb3813f..0cd55cb843db77903def1dae7e9db3bf99980852 100644 --- a/src/share/classes/javax/swing/tree/FixedHeightLayoutCache.java +++ b/src/share/classes/javax/swing/tree/FixedHeightLayoutCache.java @@ -469,7 +469,7 @@ public class FixedHeightLayoutCache extends AbstractLayoutCache { *Invoked after the tree has drastically changed structure from a * given node down. If the path returned by e.getPath() is of length * one and the first element does not identify the current root node - * the first element should become the new root of the tree.
+ * the first element should become the new root of the tree. * *
e.path() holds the path to the node.
*e.childIndices() returns null.
@@ -677,7 +677,7 @@ public class FixedHeightLayoutCache extends AbstractLayoutCache { /** * Messages getTreeNodeForPage(path, onlyIfVisible, shouldCreate, - * path.length) as long as path is non-null and the length is > 0. + * path.length) as long as path is non-null and the length is {@literal >} 0. * Otherwise returns null. */ private FHTreeStateNode getNodeForPath(TreePath path, @@ -1283,7 +1283,7 @@ public class FixedHeightLayoutCache extends AbstractLayoutCache { /** * Messaged when a child has been inserted at index. For all the - * children that have a childIndex >= index their index is incremented + * children that have a childIndex ≥ index their index is incremented * by one. */ protected void childInsertedAtModelIndex(int index, - caret movement forward and backward * * - *