--- old/src/java.desktop/share/classes/javax/swing/Action.java 2017-09-03 00:46:58.000000000 -0700 +++ new/src/java.desktop/share/classes/javax/swing/Action.java 2017-09-03 00:46:57.000000000 -0700 @@ -98,102 +98,88 @@ * Supported Action properties * * - * Component Property - * Components - * Action Key - * Notes + * Component Property + * Components + * Action Key + * Notes * * - * - * enabled - * All - * The isEnabled method - *   - * - * toolTipText - * All - * SHORT_DESCRIPTION - *   - * - * actionCommand - * All - * ACTION_COMMAND_KEY - *   - * - * mnemonic - * All buttons - * MNEMONIC_KEY - * A null value or Action results in the - * button's mnemonic property being set to - * '\0'. - * - * text - * All buttons - * NAME - * If you do not want the text of the button to mirror that - * of the Action, set the property - * hideActionText to true. If - * hideActionText is true, setting the - * Action changes the text of the button to - * null and any changes to NAME - * are ignored. hideActionText is useful for - * tool bar buttons that typically only show an Icon. - * JToolBar.add(Action) sets the property to - * true if the Action has a - * non-null value for LARGE_ICON_KEY or - * SMALL_ICON. - * - * displayedMnemonicIndex - * All buttons - * DISPLAYED_MNEMONIC_INDEX_KEY - * If the value of DISPLAYED_MNEMONIC_INDEX_KEY is - * beyond the bounds of the text, it is ignored. When - * setAction is called, if the value from the - * Action is null, the displayed - * mnemonic index is not updated. In any subsequent changes to - * DISPLAYED_MNEMONIC_INDEX_KEY, null - * is treated as -1. - * - * icon - * All buttons except of JCheckBox, - * JToggleButton and JRadioButton. - * either LARGE_ICON_KEY or - * SMALL_ICON - * The JMenuItem subclasses only use - * SMALL_ICON. All other buttons will use - * LARGE_ICON_KEY; if the value is null they - * use SMALL_ICON. - * - * accelerator - * All JMenuItem subclasses, with the exception of - * JMenu. - * ACCELERATOR_KEY - *   - * - * selected - * JToggleButton, JCheckBox, - * JRadioButton, JCheckBoxMenuItem and - * JRadioButtonMenuItem - * SELECTED_KEY - * Components that honor this property only use - * the value if it is {@code non-null}. For example, if - * you set an {@code Action} that has a {@code null} - * value for {@code SELECTED_KEY} on a {@code JToggleButton}, the - * {@code JToggleButton} will not update it's selected state in - * any way. Similarly, any time the {@code JToggleButton}'s - * selected state changes it will only set the value back on - * the {@code Action} if the {@code Action} has a {@code non-null} - * value for {@code SELECTED_KEY}. - *
- * Components that honor this property keep their selected state - * in sync with this property. When the same {@code Action} is used - * with multiple components, all the components keep their selected - * state in sync with this property. Mutually exclusive - * buttons, such as {@code JToggleButton}s in a {@code ButtonGroup}, - * force only one of the buttons to be selected. As such, do not - * use the same {@code Action} that defines a value for the - * {@code SELECTED_KEY} property with multiple mutually - * exclusive buttons. + * + * {@code enabled} + * All + * The {@code isEnabled} method + *   + * + * {@code toolTipText} + * All + * {@code SHORT_DESCRIPTION} + *   + * + * {@code actionCommand} + * All + * {@code ACTION_COMMAND_KEY} + *   + * + * {@code mnemonic} + * All buttons + * {@code MNEMONIC_KEY} + * A {@code null} value or {@code Action} results in the button's + * {@code mnemonic} property being set to {@code '\0'}. + * + * {@code text} + * All buttons + * {@code NAME} + * If you do not want the text of the button to mirror that of the + * {@code Action}, set the property {@code hideActionText} to {@code true}. + * If {@code hideActionText} is {@code true}, setting the {@code Action} + * changes the text of the button to {@code null} and any changes to + * {@code NAME} are ignored. {@code hideActionText} is useful for tool bar + * buttons that typically only show an {@code Icon}. + * {@code JToolBar.add(Action)} sets the property to {@code true} if the + * {@code Action} has a non-{@code null} value for {@code LARGE_ICON_KEY} or + * {@code SMALL_ICON}. + * + * {@code displayedMnemonicIndex} + * All buttons + * {@code DISPLAYED_MNEMONIC_INDEX_KEY} + * If the value of {@code DISPLAYED_MNEMONIC_INDEX_KEY} is beyond the + * bounds of the text, it is ignored. When {@code setAction} is called, if + * the value from the {@code Action} is {@code null}, the displayed mnemonic + * index is not updated. In any subsequent changes to + * {@code DISPLAYED_MNEMONIC_INDEX_KEY}, {@code null} is treated as -1. + * + * {@code icon} + * All buttons except of {@code JCheckBox}, {@code JToggleButton} and + * {@code JRadioButton}. + * either {@code LARGE_ICON_KEY} or {@code SMALL_ICON} + * The {@code JMenuItem} subclasses only use {@code SMALL_ICON}. All + * other buttons will use {@code LARGE_ICON_KEY}; if the value is + * {@code null} they use {@code SMALL_ICON}. + * + * {@code accelerator} + * All {@code JMenuItem} subclasses, with the exception of {@code JMenu}. + * {@code ACCELERATOR_KEY} + *   + * + * {@code selected} + * {@code JToggleButton}, {@code JCheckBox}, {@code JRadioButton}, + * {@code JCheckBoxMenuItem} and {@code JRadioButtonMenuItem} + * {@code SELECTED_KEY} + * Components that honor this property only use the value if it is + * {@code non-null}. For example, if you set an {@code Action} that has a + * {@code null} value for {@code SELECTED_KEY} on a {@code JToggleButton}, + * the {@code JToggleButton} will not update it's selected state in any way. + * Similarly, any time the {@code JToggleButton}'s selected state changes it + * will only set the value back on the {@code Action} if the {@code Action} + * has a {@code non-null} value for {@code SELECTED_KEY}. + *
+ * Components that honor this property keep their selected state in sync with + * this property. When the same {@code Action} is used with multiple + * components, all the components keep their selected state in sync with this + * property. Mutually exclusive buttons, such as {@code JToggleButton}s in a + * {@code ButtonGroup}, force only one of the buttons to be selected. As + * such, do not use the same {@code Action} that defines a value for the + * {@code SELECTED_KEY} property with multiple mutually exclusive buttons. * * *