From cb230db38b26e3c027ed21ab1fed5fa2621db3c1 Mon Sep 17 00:00:00 2001
From: Evan Hemsley <2342303+thatcosmonaut@users.noreply.github.com>
Date: Tue, 18 Jun 2024 14:19:18 -0700
Subject: [PATCH] include: Command buffer and swapchain usage clarification
 (#41)

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

diff --git a/include/SDL3/SDL_gpu.h b/include/SDL3/SDL_gpu.h
index 565680f34c5dca..673ccbe92b2553 100644
--- a/include/SDL3/SDL_gpu.h
+++ b/include/SDL3/SDL_gpu.h
@@ -1935,7 +1935,8 @@ extern SDL_DECLSPEC SDL_GpuTextureFormat SDLCALL SDL_GpuGetSwapchainTextureForma
 /**
  * Acquire a command buffer.
  * This command buffer is managed by the implementation and should not be freed by the user.
- * A command buffer may only be used on the thread it was acquired on.
+ * The command buffer may only be used on the thread it was acquired on.
+ * The command buffer should be submitted on the thread it was acquired on.
  *
  * \param device a GPU context
  * \returns a command buffer
@@ -1952,6 +1953,7 @@ extern SDL_DECLSPEC SDL_GpuCommandBuffer *SDLCALL SDL_GpuAcquireCommandBuffer(
  * Acquire a texture to use in presentation.
  * When a swapchain texture is acquired on a command buffer,
  * it will automatically be submitted for presentation when the command buffer is submitted.
+ * The swapchain texture should only be referenced by the command buffer used to acquire it.
  * May return NULL under certain conditions. This is not necessarily an error.
  * This texture is managed by the implementation and must not be freed by the user.
  * You MUST NOT call this function from any thread other than the one that created the window.