diff --git a/projects/samskivert/src/java/com/samskivert/swing/Controller.java b/projects/samskivert/src/java/com/samskivert/swing/Controller.java
index 61d4274a..a02f6753 100644
--- a/projects/samskivert/src/java/com/samskivert/swing/Controller.java
+++ b/projects/samskivert/src/java/com/samskivert/swing/Controller.java
@@ -167,11 +167,12 @@ public abstract class Controller
      *
      * <p> The default implementation of this method will reflect on the
      * controller class, looking for a method that matches the name of the
-     * action event. A handler method must provide one of three
-     * signatures: one accepting no arguments, one including only a
+     * action event. For example, if the action was "Exit" a method named
+     * "handleExit" would be sought. A handler method must provide one of
+     * three signatures: one accepting no arguments, one including only a
      * reference to the source object, or one including the source object
      * and an extra argument (which can be used only if the action event
-     * is an instance of {@link CommandEvent}. For example:
+     * is an instance of {@link CommandEvent}). For example:
      *
      * <pre>
      * public void handleCancelClicked (Object source);
@@ -187,7 +188,7 @@ public abstract class Controller
      * </pre>
      *
      * One would have to ensure that the only action events generated with
-     * the action command string "Cancel" were generated by
+     * the action command string "CancelClicked" were generated by
      * <code>JButton</code> instances if such a signature were used.
      *
      * @param action The action to be processed.