[libc-commits] [libc] e7db558 - [libc][docs] Add spawn.h POSIX header documentation (#186291)

[via libc-commits]

Author: Kit Dallege
Date: 2026-05-01T14:09:18+01:00
New Revision: e7db5584b7450eaa032cbf280f4889afff328a64

URL: https://github.com/llvm/llvm-project/commit/e7db5584b7450eaa032cbf280f4889afff328a64
DIFF: https://github.com/llvm/llvm-project/commit/e7db5584b7450eaa032cbf280f4889afff328a64.diff

LOG: [libc][docs] Add spawn.h POSIX header documentation (#186291)

Add YAML metadata for `spawn.h` listing all POSIX-mandated macros
(`POSIX_SPAWN_RESETIDS`, `POSIX_SPAWN_SETPGROUP`,
`POSIX_SPAWN_SETSCHEDPARAM`,
`POSIX_SPAWN_SETSCHEDULER`, `POSIX_SPAWN_SETSID`,
`POSIX_SPAWN_SETSIGDEF`,
`POSIX_SPAWN_SETSIGMASK`) and all 23 functions (`posix_spawn`,
`posix_spawnp`,
`posix_spawn_file_actions_*`, `posix_spawnattr_*`).

Add `spawn` to `index.rst` and `CMakeLists.txt` `docgen_list`.

Verified with `python3 docgen.py spawn.h` — generates valid RST with
correct POSIX links.

Partial fix for #122006

Added: 
    libc/utils/docgen/spawn.yaml

Modified: 
    libc/docs/CMakeLists.txt
    libc/docs/headers/index.rst

Removed: 
    


################################################################################
diff  --git a/libc/docs/CMakeLists.txt b/libc/docs/CMakeLists.txt
index 9162976d0744d..2db68c84a9e94 100644
--- a/libc/docs/CMakeLists.txt
+++ b/libc/docs/CMakeLists.txt
@@ -61,6 +61,7 @@ if (SPHINX_FOUND)
       pthread
       setjmp
       signal
+      spawn
       stdbit
       stdio
       stdlib

diff  --git a/libc/docs/headers/index.rst b/libc/docs/headers/index.rst
index e7a4f6b701de2..896059ddf33e2 100644
--- a/libc/docs/headers/index.rst
+++ b/libc/docs/headers/index.rst
@@ -28,6 +28,7 @@ Implementation Status
    search
    setjmp
    signal
+   spawn
    stdbit
    stdfix
    stdio

diff  --git a/libc/utils/docgen/spawn.yaml b/libc/utils/docgen/spawn.yaml
new file mode 100644
index 0000000000000..01d71e9e3d7e8
--- /dev/null
+++ b/libc/utils/docgen/spawn.yaml
@@ -0,0 +1,63 @@
+macros:
+  POSIX_SPAWN_RESETIDS:
+    in-latest-posix: ''
+  POSIX_SPAWN_SETPGROUP:
+    in-latest-posix: ''
+  POSIX_SPAWN_SETSCHEDPARAM:
+    in-latest-posix: ''
+  POSIX_SPAWN_SETSCHEDULER:
+    in-latest-posix: ''
+  POSIX_SPAWN_SETSID:
+    in-latest-posix: ''
+  POSIX_SPAWN_SETSIGDEF:
+    in-latest-posix: ''
+  POSIX_SPAWN_SETSIGMASK:
+    in-latest-posix: ''
+
+functions:
+  posix_spawn:
+    in-latest-posix: ''
+  posix_spawn_file_actions_addchdir:
+    in-latest-posix: ''
+  posix_spawn_file_actions_addclose:
+    in-latest-posix: ''
+  posix_spawn_file_actions_adddup2:
+    in-latest-posix: ''
+  posix_spawn_file_actions_addfchdir:
+    in-latest-posix: ''
+  posix_spawn_file_actions_addopen:
+    in-latest-posix: ''
+  posix_spawn_file_actions_destroy:
+    in-latest-posix: ''
+  posix_spawn_file_actions_init:
+    in-latest-posix: ''
+  posix_spawnattr_destroy:
+    in-latest-posix: ''
+  posix_spawnattr_getflags:
+    in-latest-posix: ''
+  posix_spawnattr_getpgroup:
+    in-latest-posix: ''
+  posix_spawnattr_getschedparam:
+    in-latest-posix: ''
+  posix_spawnattr_getschedpolicy:
+    in-latest-posix: ''
+  posix_spawnattr_getsigdefault:
+    in-latest-posix: ''
+  posix_spawnattr_getsigmask:
+    in-latest-posix: ''
+  posix_spawnattr_init:
+    in-latest-posix: ''
+  posix_spawnattr_setflags:
+    in-latest-posix: ''
+  posix_spawnattr_setpgroup:
+    in-latest-posix: ''
+  posix_spawnattr_setschedparam:
+    in-latest-posix: ''
+  posix_spawnattr_setschedpolicy:
+    in-latest-posix: ''
+  posix_spawnattr_setsigdefault:
+    in-latest-posix: ''
+  posix_spawnattr_setsigmask:
+    in-latest-posix: ''
+  posix_spawnp:
+    in-latest-posix: ''