From 3e8d8f81b4097c41a5da18318c21ef6e59213db8 Mon Sep 17 00:00:00 2001
From: SDL Wiki Bot <icculus-sdlwikibot@icculus.org>
Date: Thu, 23 May 2024 17:04:35 +0000
Subject: [PATCH] Sync SDL3 wiki -> header

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

diff --git a/include/SDL3/SDL_video.h b/include/SDL3/SDL_video.h
index 00f799c2cb..d3327ac166 100644
--- a/include/SDL3/SDL_video.h
+++ b/include/SDL3/SDL_video.h
@@ -819,6 +819,10 @@ extern SDL_DECLSPEC Uint32 SDLCALL SDL_GetWindowPixelFormat(SDL_Window *window);
  * If SDL_WINDOW_METAL is specified on an OS that does not support Metal,
  * SDL_CreateWindow() will fail.
  *
+ * If you intend to use this window with an SDL_Renderer, you should use
+ * SDL_CreateWindowAndRenderer() instead of this function, to avoid window
+ * flicker.
+ *
  * On non-Apple devices, SDL requires you to either not link to the Vulkan
  * loader or link to a dynamic library version. This limitation may be removed
  * in a future version of SDL.