Deprecate the JSON Wire Protocol Action primitives

We may need to leave these post a 4.x release, but they'll
be removed at some point.

Author: shs96c

java/client/src/org/openqa/selenium/interactions/HasInputDevices.java

@@ -21,6 +21,7 @@
 /**
  * Interface implemented by each driver that allows access to the raw input devices.
  */
+@Deprecated
 public interface HasInputDevices {
   Keyboard getKeyboard();
 

java/client/src/org/openqa/selenium/interactions/HasTouchScreen.java

@@ -20,6 +20,7 @@
 /**
  * Interface implemented by each driver that allows access to touch screen capabilities.
  */
+@Deprecated
 public interface HasTouchScreen {
 
   TouchScreen getTouch();

java/client/src/org/openqa/selenium/interactions/Keyboard.java

@@ -20,7 +20,10 @@
 /**
  * Interface representing basic, low-level keyboard operations.  It offers a set of low-level "do as
  * I say" commands to allow precise emulation of user input.
+ *
+ * @deprecated Use {@link Actions} and {@link KeyInput} instead.
  */
+@Deprecated
 public interface Keyboard {
 
   /**

java/client/src/org/openqa/selenium/interactions/Mouse.java

@@ -19,7 +19,10 @@
 
 /**
  * Interface representing basic mouse operations.
+ *
+ * @deprecated Use {@link Actions} and the {@link PointerInput} instead.
  */
+@Deprecated
 public interface Mouse {
   void click(Coordinates where);
 

java/client/src/org/openqa/selenium/interactions/TouchScreen.java

@@ -19,7 +19,10 @@
 
 /**
  * Interface representing basic touch screen operations.
+ *
+ * @deprecated Replaced by {@link Actions} and {@link PointerInput}.
  */
+@Deprecated
 public interface TouchScreen {
 
   /**

java/client/src/org/openqa/selenium/interactions/internal/BaseAction.java

@@ -25,6 +25,7 @@
 /**
  * Base class for all actions.
  */
+@Deprecated
 public abstract class BaseAction {
   protected final Locatable where;
 

java/client/src/org/openqa/selenium/interactions/internal/DisplayAction.java

@@ -23,6 +23,7 @@
 /**
  * This class represents an abstraction of devices that can execute an action within a display area.
  */
+@Deprecated
 public abstract class DisplayAction extends BaseAction {
 
   protected DisplayAction(Locatable locationProvider) {

java/client/src/org/openqa/selenium/interactions/internal/KeysRelatedAction.java

@@ -37,6 +37,7 @@
 /**
  * Represents a general action related to keyboard input.
  */
+@Deprecated
 public abstract class KeysRelatedAction extends BaseAction implements IsInteraction {
   protected final Keyboard keyboard;
   protected final Mouse mouse;

java/client/src/org/openqa/selenium/interactions/internal/MouseAction.java

@@ -35,6 +35,7 @@
 /**
  * Base class for all mouse-related actions.
  */
+@Deprecated
 public abstract class MouseAction extends BaseAction implements IsInteraction {
 
   public enum Button {

java/client/src/org/openqa/selenium/interactions/internal/SingleKeyAction.java

@@ -26,6 +26,7 @@
  * Used both by KeyDownAction and KeyUpAction
  *
  */
+@Deprecated
 public abstract class SingleKeyAction extends KeysRelatedAction {
   protected final Keys key;
   private static final Keys[] MODIFIER_KEYS = {Keys.SHIFT, Keys.CONTROL, Keys.ALT, Keys.META,