From 3e6513c77390969cd870726690bf89e39fe91e60 Mon Sep 17 00:00:00 2001
From: shenleban tongying <[EMAIL REDACTED]>
Date: Tue, 28 Nov 2023 15:00:04 -0500
Subject: [PATCH] document the purpose of SDL_SetTextInputRect
---
include/SDL3/SDL_keyboard.h | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/include/SDL3/SDL_keyboard.h b/include/SDL3/SDL_keyboard.h
index d51af2921a2e..b56f5e85d9bc 100644
--- a/include/SDL3/SDL_keyboard.h
+++ b/include/SDL3/SDL_keyboard.h
@@ -300,8 +300,10 @@ extern DECLSPEC void SDLCALL SDL_ClearComposition(void);
extern DECLSPEC SDL_bool SDLCALL SDL_TextInputShown(void);
/**
- * Set the rectangle used to type Unicode text inputs.
- *
+ * Set the rectangle used to type Unicode text inputs. Native input methods
+ * will place a window with word suggestions near it, without covering the
+ * text being inputted.
+ *
* To start text input in a given location, this function is intended to be
* called before SDL_StartTextInput, although some platforms support moving
* the rectangle even while text input (and a composition) is active.