8039074: Tidy warnings cleanup for javax.swing
Reviewed-by: pchelko, alexsch
Contributed-by: Alexander Stepanov <alexander.v.stepanov@oracle.com>
--- a/jdk/src/share/classes/javax/swing/JComboBox.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/JComboBox.java Fri Apr 04 15:43:10 2014 +0400
@@ -65,7 +65,7 @@
* See <a href="http://docs.oracle.com/javase/tutorial/uiswing/components/combobox.html">How to Use Combo Boxes</a>
* in <a href="http://docs.oracle.com/javase/tutorial/"><em>The Java Tutorial</em></a>
* for further information.
- * <p>
+ *
* @see ComboBoxModel
* @see DefaultComboBoxModel
*
--- a/jdk/src/share/classes/javax/swing/JFrame.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/JFrame.java Fri Apr 04 15:43:10 2014 +0400
@@ -123,7 +123,7 @@
* has this set as the close operation and is closed in an applet,
* a <code>SecurityException</code> may be thrown.
* It is recommended you only use this in an application.
- * <p>
+ *
* @since 1.3
*/
public static final int EXIT_ON_CLOSE = 3;
--- a/jdk/src/share/classes/javax/swing/JList.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/JList.java Fri Apr 04 15:43:10 2014 +0400
@@ -260,7 +260,7 @@
* See <a href="http://docs.oracle.com/javase/tutorial/uiswing/components/list.html">How to Use Lists</a>
* in <a href="http://docs.oracle.com/javase/tutorial/"><em>The Java Tutorial</em></a>
* for further documentation.
- * <p>
+ *
* @see ListModel
* @see AbstractListModel
* @see DefaultListModel
--- a/jdk/src/share/classes/javax/swing/JOptionPane.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/JOptionPane.java Fri Apr 04 15:43:10 2014 +0400
@@ -259,7 +259,7 @@
* "Choose one", "Input",
* JOptionPane.INFORMATION_MESSAGE, null,
* possibleValues, possibleValues[0]);
- * </pre><p>
+ * </pre>
* </dl>
* <b>Direct Use:</b><br>
* To create and use an <code>JOptionPane</code> directly, the
--- a/jdk/src/share/classes/javax/swing/JTable.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/JTable.java Fri Apr 04 15:43:10 2014 +0400
@@ -661,7 +661,7 @@
* with the following code:
*
* <pre>((Vector)rowData.elementAt(1)).elementAt(5);</pre>
- * <p>
+ *
* @param rowData the data for the new table
* @param columnNames names of each column
*/
@@ -678,7 +678,7 @@
* <pre> rowData[1][5]; </pre>
* <p>
* All rows must be of the same length as <code>columnNames</code>.
- * <p>
+ *
* @param rowData the data for the new table
* @param columnNames names of each column
*/
--- a/jdk/src/share/classes/javax/swing/RowSorter.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/RowSorter.java Fri Apr 04 15:43:10 2014 +0400
@@ -42,10 +42,10 @@
* <p>
* The view invokes the following methods on the <code>RowSorter</code>:
* <ul>
- * <li><code>toggleSortOrder</code> — The view invokes this when the
+ * <li><code>toggleSortOrder</code> — The view invokes this when the
* appropriate user gesture has occurred to trigger a sort. For example,
* the user clicked a column header in a table.
- * <li>One of the model change methods — The view invokes a model
+ * <li>One of the model change methods — The view invokes a model
* change method when the underlying model
* has changed. There may be order dependencies in how the events are
* delivered, so a <code>RowSorter</code> should not update its mapping
@@ -59,10 +59,10 @@
* <code>RowSorter</code> provides notification of changes by way of
* <code>RowSorterListener</code>. Two types of notification are sent:
* <ul>
- * <li><code>RowSorterEvent.Type.SORT_ORDER_CHANGED</code> — notifies
+ * <li><code>RowSorterEvent.Type.SORT_ORDER_CHANGED</code> — notifies
* listeners that the sort order has changed. This is typically followed
* by a notification that the sort has changed.
- * <li><code>RowSorterEvent.Type.SORTED</code> — notifies listeners that
+ * <li><code>RowSorterEvent.Type.SORTED</code> — notifies listeners that
* the mapping maintained by the <code>RowSorter</code> has changed in
* some way.
* </ul>
--- a/jdk/src/share/classes/javax/swing/SpringLayout.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/SpringLayout.java Fri Apr 04 15:43:10 2014 +0400
@@ -991,7 +991,7 @@
* If <code>constraints</code> is an instance of
* <code>SpringLayout.Constraints</code>,
* associates the constraints with the specified component.
- * <p>
+ *
* @param component the component being added
* @param constraints the component's constraints
*
@@ -1029,7 +1029,7 @@
* <pre>
* value(e1, c1) = value(e2, c2) + pad</pre>
* to take place during all subsequent layout operations.
- * <p>
+ *
* @param e1 the edge of the dependent
* @param c1 the component of the dependent
* @param pad the fixed distance between dependent and anchor
@@ -1056,7 +1056,7 @@
* <code>SpringLayout.VERTICAL_CENTER</code>,
* <code>SpringLayout.HORIZONTAL_CENTER</code> or
* <code>SpringLayout.BASELINE</code>.
- * <p>
+ *
* @param e1 the edge of the dependent
* @param c1 the component of the dependent
* @param s the spring linking dependent and anchor
--- a/jdk/src/share/classes/javax/swing/plaf/basic/BasicButtonUI.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/plaf/basic/BasicButtonUI.java Fri Apr 04 15:43:10 2014 +0400
@@ -325,7 +325,7 @@
/**
* Method which renders the text of the current button.
- * <p>
+ *
* @param g Graphics context
* @param b Current button to render
* @param textRect Bounding rectangle to render the text.
--- a/jdk/src/share/classes/javax/swing/plaf/basic/BasicColorChooserUI.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/plaf/basic/BasicColorChooserUI.java Fri Apr 04 15:43:10 2014 +0400
@@ -39,7 +39,7 @@
/**
* Provides the basic look and feel for a JColorChooser.
- * <p>
+ *
* @author Tom Santos
* @author Steve Wilson
*/
--- a/jdk/src/share/classes/javax/swing/plaf/basic/BasicMenuItemUI.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/plaf/basic/BasicMenuItemUI.java Fri Apr 04 15:43:10 2014 +0400
@@ -664,7 +664,7 @@
/**
* Renders the text of the current menu item.
- * <p>
+ *
* @param g graphics context
* @param menuItem menu item to render
* @param textRect bounding rectangle for rendering the text
--- a/jdk/src/share/classes/javax/swing/plaf/basic/BasicToggleButtonUI.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/plaf/basic/BasicToggleButtonUI.java Fri Apr 04 15:43:10 2014 +0400
@@ -39,7 +39,6 @@
/**
* BasicToggleButton implementation
- * <p>
*
* @author Jeff Dinkins
*/
--- a/jdk/src/share/classes/javax/swing/plaf/basic/BasicToolBarSeparatorUI.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/plaf/basic/BasicToolBarSeparatorUI.java Fri Apr 04 15:43:10 2014 +0400
@@ -39,7 +39,6 @@
/**
* A Basic L&F implementation of ToolBarSeparatorUI. This implementation
* is a "combined" view/controller.
- * <p>
*
* @author Jeff Shapiro
*/
--- a/jdk/src/share/classes/javax/swing/plaf/basic/BasicToolBarUI.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/plaf/basic/BasicToolBarUI.java Fri Apr 04 15:43:10 2014 +0400
@@ -44,7 +44,6 @@
/**
* A Basic L&F implementation of ToolBarUI. This implementation
* is a "combined" view/controller.
- * <p>
*
* @author Georges Saab
* @author Jeff Shapiro
--- a/jdk/src/share/classes/javax/swing/plaf/basic/BasicToolTipUI.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/plaf/basic/BasicToolTipUI.java Fri Apr 04 15:43:10 2014 +0400
@@ -41,7 +41,6 @@
/**
* Standard tool tip L&F.
- * <p>
*
* @author Dave Moore
*/
--- a/jdk/src/share/classes/javax/swing/plaf/basic/BasicTreeUI.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/plaf/basic/BasicTreeUI.java Fri Apr 04 15:43:10 2014 +0400
@@ -50,7 +50,6 @@
/**
* The basic L&F for a hierarchical data structure.
- * <p>
*
* @author Scott Violet
* @author Shannon Hickey (drag and drop)
--- a/jdk/src/share/classes/javax/swing/plaf/metal/MetalInternalFrameUI.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/plaf/metal/MetalInternalFrameUI.java Fri Apr 04 15:43:10 2014 +0400
@@ -37,7 +37,6 @@
/**
* Metal implementation of JInternalFrame.
- * <p>
*
* @author Steve Wilson
*/
--- a/jdk/src/share/classes/javax/swing/plaf/metal/MetalScrollBarUI.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/plaf/metal/MetalScrollBarUI.java Fri Apr 04 15:43:10 2014 +0400
@@ -56,7 +56,6 @@
/**
* Implementation of ScrollBarUI for the Metal Look and Feel
- * <p>
*
* @author Tom Santos
* @author Steve Wilson
--- a/jdk/src/share/classes/javax/swing/plaf/metal/MetalToolBarUI.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/plaf/metal/MetalToolBarUI.java Fri Apr 04 15:43:10 2014 +0400
@@ -50,7 +50,6 @@
/**
* A Metal Look and Feel implementation of ToolBarUI. This implementation
* is a "combined" view/controller.
- * <p>
*
* @author Jeff Shapiro
*/
--- a/jdk/src/share/classes/javax/swing/plaf/nimbus/doc-files/properties.html Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/plaf/nimbus/doc-files/properties.html Fri Apr 04 15:43:10 2014 +0400
@@ -5,7 +5,7 @@
</head>
<body>
<h1 id="primaryColors">Primary Colors</h1>
-<table>
+<table summary="Nimbus primary colors">
<tr><th>Key</th><th>Value</th><th>Preview</th></tr>
<tr>
<td width="250"><code>control</code></td>
@@ -86,7 +86,7 @@
</table>
<h1 id="secondaryColors">Secondary Colors</h1>
-<table>
+<table summary="Nimbus secondary colors">
<tr><th>Key</th><th>Value</th><th>Preview</th></tr>
<tr>
<td width="250"><code>activeCaption</code></td>
--- a/jdk/src/share/classes/javax/swing/plaf/synth/doc-files/componentProperties.html Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/plaf/synth/doc-files/componentProperties.html Fri Apr 04 15:43:10 2014 +0400
@@ -49,7 +49,7 @@
href="#buttonProperties">Button properties</a>, ArrowButton supports
the following properties: </p>
<h5>ArrowButton Specific Properties</h5>
-<table border="1">
+<table border="1" summary="ArrowButton specific properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -71,7 +71,7 @@
to the <a href="#buttonProperties">Button properties</a>, JButton
supports the following property: </p>
<h5>JButton Specific Properties</h5>
-<table border="1">
+<table border="1" summary="JButton specific properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -94,7 +94,7 @@
addition to the <a href="#buttonProperties">Button properties</a>,
JCheckBox supports the following property: </p>
<h5>JCheckBox Specific Properties</h5>
-<table border="1">
+<table border="1" summary="JCheckBox specific properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -114,7 +114,7 @@
<h4><a name="JComboBox">JComboBox</a></h4>
<p> JComboBox is a composite component that consists of the following
child Components: </p>
-<table border="1">
+<table border="1" summary="JComboBox child components">
<thead><tr>
<th>Name</th>
<th>Type</th>
@@ -159,9 +159,9 @@
</tr>
</tbody>
</table>
-<p> </p>
+
<h5>JComboBox Specific Properties</h5>
-<table border="1">
+<table border="1" summary="JComboBox specific properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -181,7 +181,7 @@
<br>
<h4>JFileChooser</h4>
<h5>JFileChooser Specific Properties</h5>
-<table cellpadding="2" cellspacing="2" border="1"
+<table cellpadding="2" cellspacing="2" border="1" summary="JFileChooser specific properties"
style="width: 100%; text-align: left;">
<tbody>
<tr>
@@ -341,7 +341,7 @@
<br>
<h4><a name="JInternalFrame"></a>JInternalFrame</h4>
<h5>JInternalFrame Specific Properties</h5>
-<table cellpadding="2" cellspacing="2" border="1"
+<table cellpadding="2" cellspacing="2" border="1" summary="JInternalFrame specific properties"
style="text-align: left; width: 100%;">
<tbody>
<tr>
@@ -374,7 +374,7 @@
internal frame similar to that found in a frame.<br>
</p>
<h5>JInternalFrameTitlePane Specific Properties</h5>
-<table cellpadding="2" cellspacing="2" border="1"
+<table cellpadding="2" cellspacing="2" border="1" summary="JInternalFrameTitlePane specific properties"
style="text-align: left; width: 100%;">
<tbody>
<tr>
@@ -473,7 +473,7 @@
<p> JList's sets the name of the renderer to List.renderer. JList
supports the following properties: </p>
<h5>JList Specific Properties</h5>
-<table border="1">
+<table border="1" summary="JList specific properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -516,7 +516,7 @@
MENU_ITEM_ACCELERATOR is used for painting the accelerator. Both Regions
paint text using the TEXT_FOREGROUND ColorType. The following set of
properties are supported: </p>
-<table border="1">
+<table border="1" summary="Menu classes common properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -570,7 +570,7 @@
<p> <code>Prefix</code> is one of: CheckBoxMenuItem, Menu, MenuItem, or
RadioButtonMenuItem. </p>
<p> JMenu also supports the following properties: </p>
-<table border="1">
+<table border="1" summary="JMenu specific properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -599,7 +599,7 @@
OptionPane.comboBox, OptionPane.scrollPane, OptionPane.list,
OptionPane.textField, OptionPane.iconLabel. </p>
<h5>JOptionPane Specific Properties</h5>
-<table border="1">
+<table border="1" summary="JOptionPane specific properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -713,7 +713,7 @@
</h4>
<h5>JProgressBar Specific Properties<br>
</h5>
-<table cellpadding="2" cellspacing="2" border="1"
+<table cellpadding="2" cellspacing="2" border="1" summary="JProgressBar specific properties"
style="text-align: left; width: 100%;">
<tbody>
<tr>
@@ -754,7 +754,7 @@
addition to the <a href="#buttonProperties">Button properties</a>,
JRadioButton supports the following property: </p>
<h5>JRadioButton Specific Properties</h5>
-<table border="1">
+<table border="1" summary="JRadioButton specific properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -774,7 +774,7 @@
<h4><a name="JScrollBar">JScrollBar</a></h4>
<p> JScrollBar is a composite component that consists of the following
child Components: </p>
-<table border="1">
+<table border="1" summary="JScrollBar child components">
<thead><tr>
<th>Name</th>
<th>Type</th>
@@ -788,9 +788,9 @@
</tr>
</tbody>
</table>
-<p> </p>
+
<h5>JScrollBar Specific Properties</h5>
-<table border="1">
+<table border="1" summary="JScrollBar specific properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -844,7 +844,7 @@
<h4><a name="Separator">Separators</a></h4>
<p> All of the separator classes, JSeparator, JPopupMenu.Separator and
JToolBar.Separator use the same property: </p>
-<table border="1">
+<table border="1" summary="Separator classes common properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -863,7 +863,7 @@
</tbody>
</table>
<p> JToolBar.Separator also supports the following property: </p>
-<table border="1">
+<table border="1" summary="JToolBar.Separator specific properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -896,7 +896,7 @@
<code>Viewport</code>s border.
</p>
<h5>JScrollPane Specific Properties</h5>
-<table border="1">
+<table border="1" summary="JScrollPane specific properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -920,7 +920,7 @@
SplitPaneDivider.leftOneTouchButton and
SplitPaneDivider.rightOneTouchButton. </p>
<h5>JSplitPane Specific Properties</h5>
-<table border="1">
+<table border="1" summary="JSplitPane specific properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -964,7 +964,7 @@
<br>
<h4><a name="JSlider"></a>JSlider</h4>
<h5>JSlider Specific Properties</h5>
-<table cellpadding="2" cellspacing="2" border="1"
+<table cellpadding="2" cellspacing="2" border="1" summary="JSlider specific properties"
style="text-align: left; width: 100%;">
<tbody>
<tr>
@@ -1024,7 +1024,7 @@
<br>
<h4><a name="JTabbedPane"></a>JTabbedPane</h4>
<h5>JTabbedPane Specific Properties</h5>
-<table cellpadding="2" cellspacing="2" border="1"
+<table cellpadding="2" cellspacing="2" border="1" summary="JTabbedPane specific properties"
style="text-align: left; width: 100%;">
<tbody>
<tr>
@@ -1088,7 +1088,7 @@
<p> JTable sets the name of the renderer to Table.cellRenderer.
JTable supports the following properties: </p>
<h5>JTable Specific Properties</h5>
-<table border="1">
+<table border="1" summary="JTable specific properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -1133,7 +1133,7 @@
<p> JTree sets the name of the renderer to Tree.renderer, the name of
the editor is Tree.cellEditor.</p>
<h5>JTree Specific Properties</h5>
-<table border="1">
+<table border="1" summary="JTree specific properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -1217,7 +1217,7 @@
addition to the <a href="#buttonProperties">Button properties</a>,
JToggleButton supports the following property: </p>
<h5>JToggleButton Specific Properties</h5>
-<table border="1">
+<table border="1" summary="JToggleButton specific properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -1238,7 +1238,7 @@
<p> Each of the Button classes (JButton, JCheckBox, JRadioButton,
JToggleButton and SynthArrowButton) support a similar set of properties.
These properties are: </p>
-<table border="1">
+<table border="1" summary="Button classes common properties">
<thead><tr>
<th>Property</th>
<th>Expected Type</th>
@@ -1283,7 +1283,7 @@
</p>
<h4><a name="textProperties"></a>Text Properties<br>
</h4>
-<table cellpadding="2" cellspacing="2" border="1"
+<table cellpadding="2" cellspacing="2" border="1" summary="Text properties"
style="text-align: left; width: 100%;">
<tbody>
<tr>
--- a/jdk/src/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html Fri Apr 04 15:43:10 2014 +0400
@@ -739,12 +739,12 @@
</state>
</style>
</pre>
- </div>
+ </div>
<p>
The following outlines which painter will be used for what
- SynthPainter method:
+ SynthPainter method:
</p>
- <table border=1>
+ <table border=1 summary="Painters for SynthPainter methods">
<tr><th>State<th>Method<th>Painter
<tr><td>SELECTED<td>paintButtonBackground<td>stateButtonBackgroundPainter
<tr><td>SELECTED<td>Anything but paintButtonBackground<td>stateFallbackPainter
--- a/jdk/src/share/classes/javax/swing/text/GlyphView.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/text/GlyphView.java Fri Apr 04 15:43:10 2014 +0400
@@ -56,7 +56,6 @@
* expanded if this view is embedded in a container that does
* tab expansion. ParagraphView is an example of a container
* that does tab expansion.
- * <p>
*
* @since 1.3
*
--- a/jdk/src/share/classes/javax/swing/text/StyleConstants.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/text/StyleConstants.java Fri Apr 04 15:43:10 2014 +0400
@@ -42,7 +42,6 @@
* <p style="text-align:center"><img src="doc-files/paragraph.gif"
* alt="Diagram shows SpaceAbove, FirstLineIndent, LeftIndent, RightIndent,
* and SpaceBelow a paragraph."></p>
- * <p>
*
* @author Timothy Prinzing
*/
--- a/jdk/src/share/classes/javax/swing/text/View.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/text/View.java Fri Apr 04 15:43:10 2014 +0400
@@ -183,7 +183,6 @@
<li>{@link #removeUpdate removeUpdate}
<li>{@link #changedUpdate changedUpdate}
</ul>
- <p>
</dl>
*
* @author Timothy Prinzing
--- a/jdk/src/share/classes/javax/swing/text/html/StyleSheet.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/text/html/StyleSheet.java Fri Apr 04 15:43:10 2014 +0400
@@ -116,7 +116,7 @@
* concepts we do not currently
* support are pseudo selectors, such as <code>A:link { color: red }</code>,
* and the <code>important</code> modifier.
- * <p>
+ *
* @implNote This implementation is currently
* incomplete. It can be replaced with alternative implementations
* that are complete. Future versions of this class will provide
--- a/jdk/src/share/classes/javax/swing/undo/UndoableEdit.java Thu Apr 03 16:00:56 2014 -0700
+++ b/jdk/src/share/classes/javax/swing/undo/UndoableEdit.java Fri Apr 04 15:43:10 2014 +0400
@@ -47,7 +47,7 @@
* be incorporated into a larger edit and treated as a single edit.
* <li>If <code>addEdit</code> returns false <code>replaceEdit</code>
* is called on the new edit with the current edit passed in as the
- * argument. This is the inverse of <code>addEdit</code> —
+ * argument. This is the inverse of <code>addEdit</code> —
* if the new edit returns true from <code>replaceEdit</code>, the new
* edit replaces the current edit.
* </ol>