core/JemmyCore/src/org/jemmy/interfaces/Keyboard.java

@@ -23,92 +23,54 @@
  * questions.
  */
 
 package org.jemmy.interfaces;
 
+import org.jemmy.action.Action;
 import org.jemmy.dock.Shortcut;
+import org.jemmy.env.Environment;
 import org.jemmy.env.Timeout;
 
 
 /**
  * Defines how to simulate keyboard operations.
  */
 public interface Keyboard extends ControlInterface {
 
-    /**
-     *
-     */
     public static final Timeout PUSH = new Timeout("keyboard.push", 100);
 
-    /**
-     *
-     * @param key
-     * @param modifiers
-     */
     @Shortcut
     public void pressKey(KeyboardButton key, Modifier... modifiers);
-    /**
-     *
-     * @param key
-     */
+
     @Shortcut
     public void pressKey(KeyboardButton key);
 
-    /**
-     *
-     * @param key
-     * @param modifiers
-     */
     @Shortcut
     public void releaseKey(KeyboardButton key, Modifier... modifiers);
-    /**
-     *
-     * @param key
-     */
+
     @Shortcut
     public void releaseKey(KeyboardButton key);
 
-    /**
-     *
-     * @param key
-     * @param modifiers
-     * @param pushTime
-     */
     @Shortcut
     public void pushKey(Timeout pushTime, KeyboardButton key, Modifier... modifiers);
-    /**
-     *
-     * @param key
-     * @param modifiers
-     */
+
     @Shortcut
     public void pushKey(KeyboardButton key, Modifier... modifiers);
-    /**
-     *
-     * @param key
-     */
+
     @Shortcut
     public void pushKey(KeyboardButton key);
 
-    /**
-     *
-     * @param keyChar
-     * @param pushTime
-     */
     @Shortcut
     public void typeChar(char keyChar, Timeout pushTime);
-    /**
-     *
-     * @param keyChar
-     */
+
     @Shortcut
     public void typeChar(char keyChar);
 
     /**
      * Detaches the implementation so that all actions of it will be ran detached.
-     * @see org.jemmy.action.ActionExecutor#executeDetached(org.jemmy.env.Environment, org.jemmy.action.Action, java.lang.Object[])
-     * @return
+     * @see org.jemmy.action.ActionExecutor#executeDetached(Environment, boolean, Action, Object...)
+     * @return todo document
      */
     public Keyboard detached();
 
     /**
      * Keyboard button interface (i. e. Q, W, ENTER, LEFT, F1, etc.)

@@ -140,11 +102,10 @@
     /**
      * Keyboard buttons enum (i. e. Q, W, ENTER, LEFT, F1, etc.)
      * to be used in Keyboard interface methods
      */
     public static enum KeyboardButtons implements KeyboardButton {
-
         /**
          *
          */
         ESCAPE,
         /**