SDL: Sync SDL3 wiki -> header (64298)

From 6429806dce949b1e7e555a430f18177942f0697c Mon Sep 17 00:00:00 2001
From: SDL Wiki Bot <[EMAIL REDACTED]>
Date: Wed, 22 May 2024 19:47:56 +0000
Subject: [PATCH] Sync SDL3 wiki -> header

---
 include/SDL3/SDL_render.h | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/include/SDL3/SDL_render.h b/include/SDL3/SDL_render.h
index 1e5dd593f0782..c1ab822280983 100644
--- a/include/SDL3/SDL_render.h
+++ b/include/SDL3/SDL_render.h
@@ -1677,7 +1677,9 @@ extern SDL_DECLSPEC int SDLCALL SDL_GetRenderDrawBlendMode(SDL_Renderer *rendere
  * Clear the current rendering target with the drawing color.
  *
  * This function clears the entire rendering target, ignoring the viewport and
- * the clip rectangle.
+ * the clip rectangle. Note, that clearing will also set/fill all pixels of
+ * the rendering target to current renderer draw color, so make sure to invoke
+ * SDL_SetRenderDrawColor() when needed.
  *
  * \param renderer the rendering context
  * \returns 0 on success or a negative error code on failure; call