From 0e6af9f4c644e1937e6523404544569820f46327 Mon Sep 17 00:00:00 2001
From: Sam Lantinga <slouken@libsdl.org>
Date: Fri, 21 Aug 2026 07:24:19 -0700
Subject: [PATCH] Clarify that gamepad sensors are disabled by default

---
 include/SDL3/SDL_gamepad.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/include/SDL3/SDL_gamepad.h b/include/SDL3/SDL_gamepad.h
index 363ec7dbe6..0f1ae2c2fe 100644
--- a/include/SDL3/SDL_gamepad.h
+++ b/include/SDL3/SDL_gamepad.h
@@ -1450,6 +1450,8 @@ extern SDL_DECLSPEC bool SDLCALL SDL_GetGamepadTouchpadFinger(SDL_Gamepad *gamep
 /**
  * Return whether a gamepad has a particular sensor.
  *
+ * Sensors are disabled by default and SDL_SetGamepadSensorEnabled() is used to enable them.
+ *
  * \param gamepad the gamepad to query.
  * \param type the type of sensor to query.
  * \returns true if the sensor exists, false otherwise.
@@ -1467,6 +1469,8 @@ extern SDL_DECLSPEC bool SDLCALL SDL_GamepadHasSensor(SDL_Gamepad *gamepad, SDL_
 /**
  * Set whether data reporting for a gamepad sensor is enabled.
  *
+ * Sensors are disabled by default and this function is used to enable them.
+ *
  * \param gamepad the gamepad to update.
  * \param type the type of sensor to enable/disable.
  * \param enabled whether data reporting should be enabled.