From 8138f91e5c9657830a6edf5d9bd1232c0a9f7c00 Mon Sep 17 00:00:00 2001 From: "Ryan C. Gordon" 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 b797890d8b..c7531d97b0 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