[libc-commits] [libc] 7063419 - [libc][docs] Add dirent implementation status doc and include in CMakeLists (#132151)

[via libc-commits]

Author: Prashanth
Date: 2025-03-20T11:08:44-04:00
New Revision: 7063419460d1e8cef9017aa51a61fb95669cf85f

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

LOG: [libc][docs] Add dirent implementation status doc and include in CMakeLists (#132151)

These changes tracks `dirent.h` for the implementation status of
functions and macros, with respect to the issue (
https://github.com/llvm/llvm-project/issues/122006 ).

Added: 
    libc/utils/docgen/dirent.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 ba3751f8df8f5..150ee2085160a 100644
--- a/libc/docs/CMakeLists.txt
+++ b/libc/docs/CMakeLists.txt
@@ -39,6 +39,7 @@ if (SPHINX_FOUND)
       assert
       cpio
       ctype
+      dirent
       endian
       errno
       fenv
@@ -62,12 +63,12 @@ if (SPHINX_FOUND)
       sys/stat
       sys/statvfs
       sys/time
+      sys/utsname
       sys/wait
       termios
       threads
       uchar
       unistd
-      sys/utsname
       wchar
       wctype
     )

diff  --git a/libc/docs/headers/index.rst b/libc/docs/headers/index.rst
index b2f47bda534a6..573c5d185f38a 100644
--- a/libc/docs/headers/index.rst
+++ b/libc/docs/headers/index.rst
@@ -10,6 +10,7 @@ Implementation Status
    complex
    cpio
    ctype
+   dirent
    endian
    errno
    fenv
@@ -34,13 +35,13 @@ Implementation Status
    sys/stat
    sys/statvfs
    sys/time
+   sys/utsname
    sys/wait
    termios
    threads
    time
    uchar
    unistd
-   sys/utsname
    wchar
    wctype
 ..

diff  --git a/libc/utils/docgen/dirent.yaml b/libc/utils/docgen/dirent.yaml
new file mode 100644
index 0000000000000..d1f30e75471fd
--- /dev/null
+++ b/libc/utils/docgen/dirent.yaml
@@ -0,0 +1,51 @@
+macros:
+  DT_BLK:
+    in-latest-posix: ''
+  DT_CHR:
+    in-latest-posix: ''
+  DT_DIR:
+    in-latest-posix: ''
+  DT_FIFO:
+    in-latest-posix: ''
+  DT_LNK:
+    in-latest-posix: ''
+  DT_REG:
+    in-latest-posix: ''
+  DT_SOCK:
+    in-latest-posix: ''
+  DT_UNKNOWN:
+    in-latest-posix: ''
+  DT_MQ:
+    in-latest-posix: ''
+  DT_SEM:
+    in-latest-posix: ''
+  DT_SHM:
+    in-latest-posix: ''
+  DT_TMO:
+    in-latest-posix: ''
+
+functions:
+  alphasort:
+    in-latest-posix: ''
+  closedir:
+    in-latest-posix: ''
+  dirfd:
+    in-latest-posix: ''
+  fdopendir:
+    in-latest-posix: ''
+  opendir:
+    in-latest-posix: ''
+  posix_getdents:
+    in-latest-posix: ''
+  readdir:
+    in-latest-posix: ''
+  readdir_r:
+    in-latest-posix: ''
+  rewinddir:
+    in-latest-posix: ''
+  scandir:
+    in-latest-posix: ''
+  seekdir:
+    in-latest-posix: ''
+  telldir:
+    in-latest-posix: ''