From 0e6af9f4c644e1937e6523404544569820f46327 Mon Sep 17 00:00:00 2001
From: Sam Lantinga <[EMAIL REDACTED]>
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 363ec7dbe6942..0f1ae2c2fef68 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.