From 8138f91e5c9657830a6edf5d9bd1232c0a9f7c00 Mon Sep 17 00:00:00 2001
From: "Ryan C. Gordon" <[EMAIL REDACTED]>
Date: Tue, 16 Jun 2026 13:03:24 -0400
Subject: [PATCH] docs: Clarify the purpose of
SDL_PROP_PROCESS_CREATE_BACKGROUND_BOOLEAN.
Reference Issue #14435.
---
include/SDL3/SDL_process.h | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/include/SDL3/SDL_process.h b/include/SDL3/SDL_process.h
index b797890d8b3bd..c7531d97b031f 100644
--- a/include/SDL3/SDL_process.h
+++ b/include/SDL3/SDL_process.h
@@ -194,7 +194,10 @@ typedef enum SDL_ProcessIO
* - `SDL_PROP_PROCESS_CREATE_BACKGROUND_BOOLEAN`: true if the process should
* run in the background. In this case the default input and output is
* `SDL_PROCESS_STDIO_NULL` and the exitcode of the process is not
- * available, and will always be 0.
+ * available, and will always be 0. This is not required to launch a program
+ * asynchronously, this is for detaching a child process from its parent
+ * completely (a so-called "double fork" on Unix). Created processes run
+ * asynchronously by default, regardless of this property.
* - `SDL_PROP_PROCESS_CREATE_CMDLINE_STRING`: a string containing the program
* to run and any parameters. This string is passed directly to
* `CreateProcess` on Windows, and does nothing on other platforms. This