From 0901657278dbc8a2d50807443b6c18b8970ecb3c Mon Sep 17 00:00:00 2001
From: Sam Lantinga <[EMAIL REDACTED]>
Date: Wed, 4 Jan 2023 15:41:35 -0800
Subject: [PATCH] Document renamed API functions in SDL_keyboard.h
---
docs/README-migration.md | 7 +++++++
include/SDL3/SDL_oldnames.h | 10 ++++++++++
2 files changed, 17 insertions(+)
diff --git a/docs/README-migration.md b/docs/README-migration.md
index ddd78abb2d59..2a36287536f3 100644
--- a/docs/README-migration.md
+++ b/docs/README-migration.md
@@ -361,6 +361,13 @@ The following functions have been removed:
* SDL_JoystickPathForIndex() - replaced with SDL_GetJoystickInstancePath()
* SDL_NumJoysticks - replaced with SDL_GetJoysticks()
+## SDL_keyboard.h
+
+The following functions have been renamed:
+* SDL_IsScreenKeyboardShown() => SDL_ScreenKeyboardShown()
+* SDL_IsTextInputActive() => SDL_TextInputActive()
+* SDL_IsTextInputShown() => SDL_TextInputShown()
+
## SDL_keycode.h
The following symbols have been renamed:
diff --git a/include/SDL3/SDL_oldnames.h b/include/SDL3/SDL_oldnames.h
index c507a7118867..9807a28e2f94 100644
--- a/include/SDL3/SDL_oldnames.h
+++ b/include/SDL3/SDL_oldnames.h
@@ -219,6 +219,11 @@
#define SDL_JoystickUpdate SDL_UpdateJoysticks
#define SDL_NumJoysticks SDL_GetNumJoysticks
+/* ##SDL_keyboard.h */
+#define SDL_IsScreenKeyboardShown SDL_ScreenKeyboardShown
+#define SDL_IsTextInputActive SDL_TextInputActive
+#define SDL_IsTextInputShown SDL_TextInputShown
+
/* ##SDL_keycode.h */
#define KMOD_ALT SDL_KMOD_ALT
#define KMOD_CAPS SDL_KMOD_CAPS
@@ -526,6 +531,11 @@
#define SDL_JoystickSetVirtualHat SDL_JoystickSetVirtualHat_renamed_SDL_SetJoystickVirtualHat
#define SDL_JoystickUpdate SDL_JoystickUpdate_renamed_SDL_UpdateJoysticks
+/* ##SDL_keyboard.h */
+#define SDL_IsScreenKeyboardShown SDL_IsScreenKeyboardShown_renamed_SDL_ScreenKeyboardShown
+#define SDL_IsTextInputActive SDL_IsTextInputActive_renamed_SDL_TextInputActive
+#define SDL_IsTextInputShown SDL_IsTextInputShown_renamed_SDL_TextInputShown
+
/* ##SDL_keycode.h */
#define KMOD_ALT KMOD_ALT_renamed_SDL_KMOD_ALT
#define KMOD_CAPS KMOD_CAPS_renamed_SDL_KMOD_CAPS