[wpilib] Add explanation for HID GetBumper/Touchpad deprecations (wpi…

…libsuite#7304)

wpilibc/src/generate/main/native/include/frc/hid.h.jinja

@@ -122,6 +122,9 @@ class {{ ConsoleName }}Controller : public GenericHID,
    * Read the value of the left bumper (LB) button on the controller.
    *
    * @return the state of the button
+   * @deprecated Use GetLeftBumperButton instead. This function is deprecated
+   * for removal to make function names consistent to allow the HID classes to
+   * be automatically generated.
    */
   [[deprecated("Use GetLeftBumperButton instead")]]
   bool GetLeftBumper() const;
@@ -130,6 +133,9 @@ class {{ ConsoleName }}Controller : public GenericHID,
    * Read the value of the right bumper (RB) button on the controller.
    *
    * @return the state of the button
+   * @deprecated Use GetRightBumperButton instead. This function is deprecated
+   * for removal to make function names consistent to allow the HID classes to
+   * be automatically generated.
    */
   [[deprecated("Use GetRightBumperButton instead")]]
   bool GetRightBumper() const;
@@ -138,6 +144,9 @@ class {{ ConsoleName }}Controller : public GenericHID,
    * Whether the left bumper (LB) was pressed since the last check.
    *
    * @return Whether the button was pressed since the last check
+   * @deprecated Use GetLeftBumperButtonPressed instead. This function is
+   * deprecated for removal to make function names consistent to allow the HID
+   * classes to be automatically generated.
    */
   [[deprecated("Use GetLeftBumperButtonPressed instead")]]
   bool GetLeftBumperPressed();
@@ -146,6 +155,9 @@ class {{ ConsoleName }}Controller : public GenericHID,
    * Whether the right bumper (RB) was pressed since the last check.
    *
    * @return Whether the button was pressed since the last check
+   * @deprecated Use GetRightBumperButtonPressed instead. This function is
+   * deprecated for removal to make function names consistent to allow the HID
+   * classes to be automatically generated.
    */
   [[deprecated("Use GetRightBumperButtonPressed instead")]]
   bool GetRightBumperPressed();
@@ -154,6 +166,9 @@ class {{ ConsoleName }}Controller : public GenericHID,
    * Whether the left bumper (LB) was released since the last check.
    *
    * @return Whether the button was released since the last check.
+   * @deprecated Use GetLeftBumperButtonReleased instead. This function is
+   * deprecated for removal to make function names consistent to allow the HID
+   * classes to be automatically generated.
    */
   [[deprecated("Use GetLeftBumperButtonReleased instead")]]
   bool GetLeftBumperReleased();
@@ -162,6 +177,9 @@ class {{ ConsoleName }}Controller : public GenericHID,
    * Whether the right bumper (RB) was released since the last check.
    *
    * @return Whether the button was released since the last check.
+   * @deprecated Use GetRightBumperButtonReleased instead. This function is
+   * deprecated for removal to make function names consistent to allow the HID
+   * classes to be automatically generated.
    */
   [[deprecated("Use GetRightBumperButtonReleased instead")]]
   bool GetRightBumperReleased();
@@ -170,13 +188,19 @@ class {{ ConsoleName }}Controller : public GenericHID,
    * Read the value of the touchpad button on the controller.
    *
    * @return The state of the button.
+   * @deprecated Use GetTouchpadButton instead. This function is deprecated for
+   * removal to make function names consistent to allow the HID classes to be
+   * automatically generated.
    */
   [[deprecated("Use GetTouchpadButton instead")]]
   bool GetTouchpad() const;
   /**
    * Whether the touchpad was pressed since the last check.
    *
    * @return Whether the touchpad was pressed since the last check.
+   * @deprecated Use GetTouchpadButtonPressed instead. This function is
+   * deprecated for removal to make function names consistent to allow the HID
+   * classes to be automatically generated.
    */
   [[deprecated("Use GetTouchpadButtonPressed instead")]]
   bool GetTouchpadPressed();
@@ -185,6 +209,9 @@ class {{ ConsoleName }}Controller : public GenericHID,
    * Whether the touchpad was released since the last check.
    *
    * @return Whether the touchpad was released since the last check.
+   * @deprecated Use GetLeftBumperButton instead. This function is deprecated
+   * for removal to make function names consistent to allow the HID classes to
+   * be automatically generated.
    */
   [[deprecated("Use GetTouchpadButtonReleased instead")]]
   bool GetTouchpadReleased();

wpilibc/src/generate/main/native/include/frc/simulation/hidsim.h.jinja

@@ -63,6 +63,9 @@ class {{ ConsoleName }}ControllerSim : public GenericHIDSim {
    * Change the left bumper value of the joystick.
    *
    * @param value the new value
+   * @deprecated Use SetLeftBumperButton instead. This function is deprecated
+   * for removal to make function names consistent to allow the HID classes to
+   * be automatically generated.
    */
   [[deprecated("Use SetLeftBumperButton instead")]]
   void SetLeftBumper(bool value);
@@ -71,6 +74,9 @@ class {{ ConsoleName }}ControllerSim : public GenericHIDSim {
    * Change the right bumper value of the joystick.
    *
    * @param value the new value
+   * @deprecated Use SetRightBumperButton instead. This function is deprecated
+   * for removal to make function names consistent to allow the HID classes to
+   * be automatically generated.
    */
   [[deprecated("Use SetRightBumperButton instead")]]
   void SetRightBumper(bool value);
@@ -79,6 +85,9 @@ class {{ ConsoleName }}ControllerSim : public GenericHIDSim {
    * Change the value of the touchpad button on the controller.
    *
    * @param value the new value
+   * @deprecated Use SetTouchpadButton instead. This function is deprecated for
+   * removal to make function names consistent to allow the HID classes to be
+   * automatically generated.
    */
   [[deprecated("Use SetTouchpadButton instead")]]
   void SetTouchpad(bool value);