[libc-commits] [libc] bcaaf61 - [libc][docs] Add pwd.h POSIX header documentation (#186292)

[via libc-commits]

Author: Kit Dallege
Date: 2026-05-01T13:38:40Z
New Revision: bcaaf61f7a8b2044c92f2c248a201d68d595d96f

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

LOG: [libc][docs] Add pwd.h POSIX header documentation (#186292)

Add YAML metadata for `pwd.h` listing all POSIX-mandated functions
(`endpwent`, `getpwent`, `getpwnam`, `getpwnam_r`, `getpwuid`,
`getpwuid_r`, `setpwent`). This header defines no macros per POSIX.

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

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

Partial fix for #122006

Co-authored-by: Jeff Bailey <jbailey at raspberryginger.com>

Added: 
    libc/utils/docgen/pwd.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 eab900cebf51a..0a9135114ff53 100644
--- a/libc/docs/CMakeLists.txt
+++ b/libc/docs/CMakeLists.txt
@@ -59,6 +59,7 @@ if (SPHINX_FOUND)
       netinet/in
       poll
       pthread
+      pwd
       sched
       setjmp
       signal

diff  --git a/libc/docs/headers/index.rst b/libc/docs/headers/index.rst
index 9f557cd827c38..528f995cc8147 100644
--- a/libc/docs/headers/index.rst
+++ b/libc/docs/headers/index.rst
@@ -25,6 +25,7 @@ Implementation Status
    netinet/in
    nl_types
    poll
+   pwd
    sched
    search
    setjmp

diff  --git a/libc/utils/docgen/pwd.yaml b/libc/utils/docgen/pwd.yaml
new file mode 100644
index 0000000000000..156a663c8c5e8
--- /dev/null
+++ b/libc/utils/docgen/pwd.yaml
@@ -0,0 +1,15 @@
+functions:
+  endpwent:
+    in-latest-posix: ''
+  getpwent:
+    in-latest-posix: ''
+  getpwnam:
+    in-latest-posix: ''
+  getpwnam_r:
+    in-latest-posix: ''
+  getpwuid:
+    in-latest-posix: ''
+  getpwuid_r:
+    in-latest-posix: ''
+  setpwent:
+    in-latest-posix: ''