diff --git a/include/SDL_keycode.h b/include/SDL_keycode.h
index 1dccaa832..c41e45ff6 100644
--- a/include/SDL_keycode.h
+++ b/include/SDL_keycode.h
@@ -38,6 +38,9 @@
  *  layout of the keyboard.  These values include Unicode values representing
  *  the unmodified character that would be generated by pressing the key, or
  *  an SDLK_* constant for those keys that do not generate characters.
+ *
+ *  A special exception is the number keys at the top of the keyboard which
+ *  always map to SDLK_0...SDLK_9, regardless of layout.
  */
 typedef Sint32 SDL_Keycode;