modules/javafx.controls/src/main/java/javafx/scene/control/ButtonBase.java

@@ -89,10 +89,11 @@
      * will cause the button's action to be invoked. This is subtly different
      * from pressed. Pressed indicates that the mouse has been
      * pressed on a Node and has not yet been released. {@code arm} however
      * also takes into account whether the mouse is actually over the
      * button and pressed.
+     * @return the property to indicate that the button has been "armed"
      */
     public final ReadOnlyBooleanProperty armedProperty() { return armed.getReadOnlyProperty(); }
     private void setArmed(boolean value) { armed.set(value); }
     public final boolean isArmed() { return armedProperty().get(); }
     private ReadOnlyBooleanWrapper armed = new ReadOnlyBooleanWrapper() {

@@ -114,10 +115,12 @@
     /**
      * The button's action, which is invoked whenever the button is fired. This
      * may be due to the user clicking on the button with the mouse, or by
      * a touch event, or by a key press, or if the developer programmatically
      * invokes the {@link #fire()} method.
+     * @return the property to represent the button's action, which is invoked
+     * whenever the button is fired
      */
     public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty() { return onAction; }
     public final void setOnAction(EventHandler<ActionEvent> value) { onActionProperty().set(value); }
     public final EventHandler<ActionEvent> getOnAction() { return onActionProperty().get(); }
     private ObjectProperty<EventHandler<ActionEvent>> onAction = new ObjectPropertyBase<EventHandler<ActionEvent>>() {

@@ -147,22 +150,22 @@
      * Arms the button. An armed button will fire an action (whether that be
      * the action of a {@link Button} or toggling selection on a
      * {@link CheckBox} or some other behavior) on the next expected UI
      * gesture.
      *
-     * @expert This function is intended to be used by experts, primarily
+     * Note: This function is intended to be used by experts, primarily
      *         by those implementing new Skins or Behaviors. It is not common
      *         for developers or designers to access this function directly.
      */
     public void arm() {
         setArmed(true);
     }
 
     /**
      * Disarms the button. See {@link #arm()}.
      *
-     * @expert This function is intended to be used by experts, primarily
+     * Note: This function is intended to be used by experts, primarily
      *         by those implementing new Skins or Behaviors. It is not common
      *         for developers or designers to access this function directly.
      */
     public void disarm() {
         setArmed(false);