SDL: Clarify the lifetime of the shape surface in SDL_SetWindowShape()

From 416803b03b750984a7a038f6f1ea2d2dde98e522 Mon Sep 17 00:00:00 2001
From: Sam Lantinga <[EMAIL REDACTED]>
Date: Sat, 10 Feb 2024 07:08:28 -0800
Subject: [PATCH] Clarify the lifetime of the shape surface in
 SDL_SetWindowShape()

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

diff --git a/include/SDL3/SDL_video.h b/include/SDL3/SDL_video.h
index 57cf51d4760d..37cfb1a735da 100644
--- a/include/SDL3/SDL_video.h
+++ b/include/SDL3/SDL_video.h
@@ -2131,6 +2131,8 @@ extern DECLSPEC int SDLCALL SDL_SetWindowHitTest(SDL_Window *window, SDL_HitTest
  * something besides the SDL render API, then you are responsible for setting
  * the alpha channel of the window yourself.
  *
+ * The shape is copied inside this function, so you can free it afterwards. If your shape surface changes, you should call SDL_SetWindowShape() again to update the window.
+ *
  * The window must have been created with the SDL_WINDOW_TRANSPARENT flag.
  *
  * \param window the window