diff --git a/include/SDL3/SDL_revision.h b/include/SDL3/SDL_revision.h
index f0f57cd59b..8261addfcd 100644
--- a/include/SDL3/SDL_revision.h
+++ b/include/SDL3/SDL_revision.h
@@ -44,6 +44,9 @@
  * clue in debugging forensics and not something the app will parse in any
  * way.
  *
+ * SDL_revision.h must be included in your program explicitly if you want access
+ * to the SDL_REVISION constant.
+ *
  * \since This macro is available since SDL 3.2.0.
  */
 #define SDL_REVISION "Some arbitrary string decided at SDL build time"
diff --git a/include/SDL3/SDL_version.h b/include/SDL3/SDL_version.h
index 74aa7821d0..64476e2eca 100644
--- a/include/SDL3/SDL_version.h
+++ b/include/SDL3/SDL_version.h
@@ -153,7 +153,7 @@ extern SDL_DECLSPEC int SDLCALL SDL_GetVersion(void);
  *
  * This value is the revision of the code you are linking against and may be
  * different from the code you are compiling with, which is found in the
- * constant SDL_REVISION.
+ * constant SDL_REVISION if you explicitly include SDL_revision.h
  *
  * The revision is an arbitrary string (a hash value) uniquely identifying the
  * exact revision of the SDL library in use, and is only useful in comparing