--- a/jdk/src/java.desktop/share/classes/java/awt/Button.java Mon Jan 11 06:10:32 2016 -0800
+++ b/jdk/src/java.desktop/share/classes/java/awt/Button.java Mon Jan 11 17:51:54 2016 +0300
@@ -37,7 +37,7 @@
/**
* This class creates a labeled button. The application can cause
* some action to happen when the button is pushed. This image
- * depicts three views of a "<code>Quit</code>" button as it appears
+ * depicts three views of a "{@code Quit}" button as it appears
* under the Solaris operating system:
* <p>
* <img src="doc-files/Button-1.gif" alt="The following context describes the graphic"
@@ -51,31 +51,31 @@
* requests that an action be performed.
* <p>
* The gesture of clicking on a button with the mouse
- * is associated with one instance of <code>ActionEvent</code>,
+ * is associated with one instance of {@code ActionEvent},
* which is sent out when the mouse is both pressed and released
* over the button. If an application is interested in knowing
* when the button has been pressed but not released, as a separate
- * gesture, it can specialize <code>processMouseEvent</code>,
+ * gesture, it can specialize {@code processMouseEvent},
* or it can register itself as a listener for mouse events by
- * calling <code>addMouseListener</code>. Both of these methods are
- * defined by <code>Component</code>, the abstract superclass of
+ * calling {@code addMouseListener}. Both of these methods are
+ * defined by {@code Component}, the abstract superclass of
* all components.
* <p>
* When a button is pressed and released, AWT sends an instance
- * of <code>ActionEvent</code> to the button, by calling
- * <code>processEvent</code> on the button. The button's
- * <code>processEvent</code> method receives all events
+ * of {@code ActionEvent} to the button, by calling
+ * {@code processEvent} on the button. The button's
+ * {@code processEvent} method receives all events
* for the button; it passes an action event along by
- * calling its own <code>processActionEvent</code> method.
+ * calling its own {@code processActionEvent} method.
* The latter method passes the action event on to any action
* listeners that have registered an interest in action
* events generated by this button.
* <p>
* If an application wants to perform some action based on
* a button being pressed and released, it should implement
- * <code>ActionListener</code> and register the new listener
+ * {@code ActionListener} and register the new listener
* to receive events from this button, by calling the button's
- * <code>addActionListener</code> method. The application can
+ * {@code addActionListener} method. The application can
* make use of the button's action command as a messaging protocol.
*
* @author Sami Shaio
@@ -144,7 +144,7 @@
* Constructs a button with the specified label.
*
* @param label a string label for the button, or
- * <code>null</code> for no label
+ * {@code null} for no label
* @exception HeadlessException if GraphicsEnvironment.isHeadless()
* returns true
* @see java.awt.GraphicsEnvironment#isHeadless
@@ -182,7 +182,7 @@
/**
* Gets the label of this button.
*
- * @return the button's label, or <code>null</code>
+ * @return the button's label, or {@code null}
* if the button has no label.
* @see java.awt.Button#setLabel
*/
@@ -193,7 +193,7 @@
/**
* Sets the button's label to be the specified string.
*
- * @param label the new label, or <code>null</code>
+ * @param label the new label, or {@code null}
* if the button has no label.
* @see java.awt.Button#getLabel
*/
@@ -225,7 +225,7 @@
*
* @param command a string used to set the button's
* action command.
- * If the string is <code>null</code> then the action command
+ * If the string is {@code null} then the action command
* is set to match the label of the button.
* @see java.awt.event.ActionEvent
* @since 1.1
@@ -236,7 +236,7 @@
/**
* Returns the command name of the action event fired by this button.
- * If the command name is <code>null</code> (default) then this method
+ * If the command name is {@code null} (default) then this method
* returns the label of the button.
*
* @return the action command name (or label) for this button
@@ -292,7 +292,7 @@
* Returns an array of all the action listeners
* registered on this button.
*
- * @return all of this button's <code>ActionListener</code>s
+ * @return all of this button's {@code ActionListener}s
* or an empty array if no action
* listeners are currently registered
*
@@ -308,16 +308,16 @@
/**
* Returns an array of all the objects currently registered
* as <code><em>Foo</em>Listener</code>s
- * upon this <code>Button</code>.
+ * upon this {@code Button}.
* <code><em>Foo</em>Listener</code>s are registered using the
* <code>add<em>Foo</em>Listener</code> method.
*
* <p>
- * You can specify the <code>listenerType</code> argument
+ * You can specify the {@code listenerType} argument
* with a class literal, such as
* <code><em>Foo</em>Listener.class</code>.
* For example, you can query a
- * <code>Button</code> <code>b</code>
+ * {@code Button b}
* for its action listeners with the following code:
*
* <pre>ActionListener[] als = (ActionListener[])(b.getListeners(ActionListener.class));</pre>
@@ -326,14 +326,14 @@
*
* @param listenerType the type of listeners requested; this parameter
* should specify an interface that descends from
- * <code>java.util.EventListener</code>
+ * {@code java.util.EventListener}
* @return an array of all objects registered as
* <code><em>Foo</em>Listener</code>s on this button,
* or an empty array if no such
* listeners have been added
- * @exception ClassCastException if <code>listenerType</code>
+ * @exception ClassCastException if {@code listenerType}
* doesn't specify a class or interface that implements
- * <code>java.util.EventListener</code>
+ * {@code java.util.EventListener}
*
* @see #getActionListeners
* @since 1.3
@@ -362,10 +362,10 @@
/**
* Processes events on this button. If an event is
- * an instance of <code>ActionEvent</code>, this method invokes
- * the <code>processActionEvent</code> method. Otherwise,
- * it invokes <code>processEvent</code> on the superclass.
- * <p>Note that if the event parameter is <code>null</code>
+ * an instance of {@code ActionEvent}, this method invokes
+ * the {@code processActionEvent} method. Otherwise,
+ * it invokes {@code processEvent} on the superclass.
+ * <p>Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -385,17 +385,17 @@
/**
* Processes action events occurring on this button
* by dispatching them to any registered
- * <code>ActionListener</code> objects.
+ * {@code ActionListener} objects.
* <p>
* This method is not called unless action events are
* enabled for this button. Action events are enabled
* when one of the following occurs:
* <ul>
- * <li>An <code>ActionListener</code> object is registered
- * via <code>addActionListener</code>.
- * <li>Action events are enabled via <code>enableEvents</code>.
+ * <li>An {@code ActionListener} object is registered
+ * via {@code addActionListener}.
+ * <li>Action events are enabled via {@code enableEvents}.
* </ul>
- * <p>Note that if the event parameter is <code>null</code>
+ * <p>Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
@@ -413,11 +413,11 @@
}
/**
- * Returns a string representing the state of this <code>Button</code>.
+ * Returns a string representing the state of this {@code Button}.
* This method is intended to be used only for debugging purposes, and the
* content and format of the returned string may vary between
* implementations. The returned string may be empty but may not be
- * <code>null</code>.
+ * {@code null}.
*
* @return the parameter string of this button
*/
@@ -437,19 +437,19 @@
/**
* Writes default serializable fields to stream. Writes
- * a list of serializable <code>ActionListeners</code>
+ * a list of serializable {@code ActionListeners}
* as optional data. The non-serializable
- * <code>ActionListeners</code> are detected and
+ * {@code ActionListeners} are detected and
* no attempt is made to serialize them.
*
- * @serialData <code>null</code> terminated sequence of 0 or
- * more pairs: the pair consists of a <code>String</code>
- * and an <code>Object</code>; the <code>String</code>
+ * @serialData {@code null} terminated sequence of 0 or
+ * more pairs: the pair consists of a {@code String}
+ * and an {@code Object}; the {@code String}
* indicates the type of object and is one of the following:
- * <code>actionListenerK</code> indicating an
- * <code>ActionListener</code> object
+ * {@code actionListenerK} indicating an
+ * {@code ActionListener} object
*
- * @param s the <code>ObjectOutputStream</code> to write
+ * @param s the {@code ObjectOutputStream} to write
* @see AWTEventMulticaster#save(ObjectOutputStream, String, EventListener)
* @see java.awt.Component#actionListenerK
* @see #readObject(ObjectInputStream)
@@ -464,15 +464,15 @@
}
/**
- * Reads the <code>ObjectInputStream</code> and if
- * it isn't <code>null</code> adds a listener to
+ * Reads the {@code ObjectInputStream} and if
+ * it isn't {@code null} adds a listener to
* receive action events fired by the button.
* Unrecognized keys or values will be ignored.
*
- * @param s the <code>ObjectInputStream</code> to read
+ * @param s the {@code ObjectInputStream} to read
* @exception HeadlessException if
- * <code>GraphicsEnvironment.isHeadless</code> returns
- * <code>true</code>
+ * {@code GraphicsEnvironment.isHeadless} returns
+ * {@code true}
* @serial
* @see #removeActionListener(ActionListener)
* @see #addActionListener(ActionListener)
@@ -503,15 +503,15 @@
////////////////
/**
- * Gets the <code>AccessibleContext</code> associated with
- * this <code>Button</code>. For buttons, the
- * <code>AccessibleContext</code> takes the form of an
- * <code>AccessibleAWTButton</code>.
- * A new <code>AccessibleAWTButton</code> instance is
+ * Gets the {@code AccessibleContext} associated with
+ * this {@code Button}. For buttons, the
+ * {@code AccessibleContext} takes the form of an
+ * {@code AccessibleAWTButton}.
+ * A new {@code AccessibleAWTButton} instance is
* created if necessary.
*
- * @return an <code>AccessibleAWTButton</code> that serves as the
- * <code>AccessibleContext</code> of this <code>Button</code>
+ * @return an {@code AccessibleAWTButton} that serves as the
+ * {@code AccessibleContext} of this {@code Button}
* @since 1.3
*/
@BeanProperty(expert = true, description
@@ -525,7 +525,7 @@
/**
* This class implements accessibility support for the
- * <code>Button</code> class. It provides an implementation of the
+ * {@code Button} class. It provides an implementation of the
* Java Accessibility API appropriate to button user-interface elements.
* @since 1.3
*/