From acbe86399d88cb46bdc83263d6e3bb716b887f09 Mon Sep 17 00:00:00 2001
From: "Ryan C. Gordon" <icculus@icculus.org>
Date: Tue, 29 Jul 2025 23:21:47 -0400
Subject: [PATCH] docs: Note SDL_EVENT_AUDIO_DEVICE_ADDED is sent for all
 devices at startup.

Fixes https://github.com/libsdl-org/sdlwiki/issues/721
---
 include/SDL3/SDL_events.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/include/SDL3/SDL_events.h b/include/SDL3/SDL_events.h
index 353ecd3e59..60155b8103 100644
--- a/include/SDL3/SDL_events.h
+++ b/include/SDL3/SDL_events.h
@@ -705,6 +705,10 @@ typedef struct SDL_GamepadSensorEvent
 /**
  * Audio device event structure (event.adevice.*)
  *
+ * Note that SDL will send a SDL_EVENT_AUDIO_DEVICE_ADDED event for every
+ * device it discovers during initialization. After that, this event will only
+ * arrive when a device is hotplugged during the program's run.
+ *
  * \since This struct is available since SDL 3.2.0.
  */
 typedef struct SDL_AudioDeviceEvent