From f63ee9777b9d41f960760015dd965c12f872638f Mon Sep 17 00:00:00 2001
From: SDL Wiki Bot <[EMAIL REDACTED]>
Date: Tue, 10 Mar 2026 01:47:34 +0000
Subject: [PATCH] Sync SDL3_mixer wiki -> header
[ci skip]
---
include/SDL3_mixer/SDL_mixer.h | 8 ++++++--
1 file changed, 6 insertions(+), 2 deletions(-)
diff --git a/include/SDL3_mixer/SDL_mixer.h b/include/SDL3_mixer/SDL_mixer.h
index 3d2dba22..faa9e229 100644
--- a/include/SDL3_mixer/SDL_mixer.h
+++ b/include/SDL3_mixer/SDL_mixer.h
@@ -2037,8 +2037,12 @@ extern SDL_DECLSPEC bool SDLCALL MIX_StopTrack(MIX_Track *track, Sint64 fade_out
*
* Once a track has completed any fadeout and come to a stop, it will call its
* MIX_TrackStoppedCallback, if any. It is legal to assign the track a new
- * input and/or restart it during this callback. This function does not
- * prevent new play requests from being made.
+ * input and/or restart it during this callback.
+ *
+ * This function does not prevent new play requests from being made; it’s
+ * legal to use this function to begin fading all playing tracks but then
+ * start other tracks playing normally while those fade-outs are still in
+ * progress.
*
* \param mixer the mixer on which to stop all tracks.
* \param fade_out_ms the number of milliseconds to spend fading out to