[libc-commits] [libc] [libc][docs] Add sys/stat page to the status of implementations docs (PR #122997)

[Nick Desaulniers via libc-commits]

https://github.com/nickdesaulniers updated https://github.com/llvm/llvm-project/pull/122997

>From a9b32e1050aa48fa80c3fa72288740938cf8f546 Mon Sep 17 00:00:00 2001
From: Prashanth <TheStarOne01 at proton.me>
Date: Wed, 15 Jan 2025 01:56:16 +0000
Subject: [PATCH 1/2] Add sys/stat documentation and include in CMakeLists and
 index

---
 libc/docs/CMakeLists.txt        |   1 +
 libc/docs/headers/index.rst     |   1 +
 libc/utils/docgen/sys/stat.yaml | 108 ++++++++++++++++++++++++++++++++
 3 files changed, 110 insertions(+)
 create mode 100644 libc/utils/docgen/sys/stat.yaml

diff --git a/libc/docs/CMakeLists.txt b/libc/docs/CMakeLists.txt
index 9974769ca7eb33..f88d7c27f9f6b3 100644
--- a/libc/docs/CMakeLists.txt
+++ b/libc/docs/CMakeLists.txt
@@ -55,6 +55,7 @@ if (SPHINX_FOUND)
       strings
       sys/mman
       sys/resource
+      sys/stat
       sys/time
       sys/wait
       termios
diff --git a/libc/docs/headers/index.rst b/libc/docs/headers/index.rst
index 64f84ef09cc354..858b2142defa92 100644
--- a/libc/docs/headers/index.rst
+++ b/libc/docs/headers/index.rst
@@ -28,6 +28,7 @@ Implementation Status
    strings
    sys/mman
    sys/resource
+   sys/stat
    sys/time
    sys/wait
    termios
diff --git a/libc/utils/docgen/sys/stat.yaml b/libc/utils/docgen/sys/stat.yaml
new file mode 100644
index 00000000000000..ab03c5d794b3e8
--- /dev/null
+++ b/libc/utils/docgen/sys/stat.yaml
@@ -0,0 +1,108 @@
+macros:
+  S_IFMT:
+    in-latest-posix: ''
+  S_IFBLK:
+    in-latest-posix: ''
+  S_IFCHR:
+    in-latest-posix: ''
+  S_IFIFO:
+    in-latest-posix: ''
+  S_IFREG:
+    in-latest-posix: ''
+  S_IFDIR:
+    in-latest-posix: ''
+  S_IFLNK:
+    in-latest-posix: ''
+  S_IFSOCK:
+    in-latest-posix: ''
+
+  S_IRWXU:
+    in-latest-posix: ''
+  S_IRUSR:
+    in-latest-posix: ''
+  S_IWUSR:
+    in-latest-posix: ''
+  S_IXUSR:
+    in-latest-posix: ''
+  S_IRWXG:
+    in-latest-posix: ''
+  S_IRGRP:
+    in-latest-posix: ''
+  S_IWGRP:
+    in-latest-posix: ''
+  S_IXGRP:
+    in-latest-posix: ''
+  
+  S_IRWXO:
+    in-latest-posix: ''
+  S_IROTH:
+    in-latest-posix: ''
+  S_IWOTH:
+    in-latest-posix: ''
+  S_IXOTH:
+    in-latest-posix: ''
+  S_ISUID:
+    in-latest-posix: ''
+  S_ISGID:
+    in-latest-posix: ''
+  S_ISVTX:
+    in-latest-posix: ''
+
+  S_ISBLK:
+    in-latest-posix: ''
+  S_ISCHR:
+    in-latest-posix: ''
+  S_ISDIR:
+    in-latest-posix: ''
+  S_ISFIFO:
+    in-latest-posix: ''
+  S_ISREG:
+    in-latest-posix: ''
+  S_ISLNK:
+    in-latest-posix: ''
+  S_ISSOCK:
+    in-latest-posix: ''
+
+  S_TYPEISMQ:
+    in-latest-posix: ''
+  S_TYPEISSEM:
+    in-latest-posix: ''
+  S_TYPEISSHM:
+    in-latest-posix: ''
+
+  S_TYPEISTMO:
+    in-latest-posix: ''
+
+functions:
+  chmod:
+    in-latest-posix: ''
+  fchmod:
+    in-latest-posix: ''
+  fchmodat:
+    in-latest-posix: ''
+  fstat:
+    in-latest-posix: ''
+  fstatat:
+    in-latest-posix: ''
+  futimens:
+    in-latest-posix: ''
+  lstat:
+    in-latest-posix: ''
+  mkdir:
+    in-latest-posix: ''
+  mkdirat:
+    in-latest-posix: ''
+  mkfifo:
+    in-latest-posix: ''
+  mkfifoat:
+    in-latest-posix: ''
+  mknod:
+    in-latest-posix: ''
+  mknodat:
+    in-latest-posix: ''
+  stat:
+    in-latest-posix: ''
+  umask:
+    in-latest-posix: ''
+  utimensat:
+    in-latest-posix: ''
\ No newline at end of file

>From 21c742ed0c727a13da342b63c2bf848a523038e2 Mon Sep 17 00:00:00 2001
From: Prashanth <TheStarOne01 at proton.me>
Date: Thu, 16 Jan 2025 07:52:45 +0530
Subject: [PATCH 2/2] Add macros  st_atime, st_ctime, st_mtime, UTIME_NOW, and
 UTIME_OMIT in sys/stat.yaml

---
 libc/utils/docgen/sys/stat.yaml | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/libc/utils/docgen/sys/stat.yaml b/libc/utils/docgen/sys/stat.yaml
index ab03c5d794b3e8..86dc84a1e06d2e 100644
--- a/libc/utils/docgen/sys/stat.yaml
+++ b/libc/utils/docgen/sys/stat.yaml
@@ -15,6 +15,16 @@ macros:
     in-latest-posix: ''
   S_IFSOCK:
     in-latest-posix: ''
+  st_atime:
+    in-latest-posix: ''
+  st_ctime:
+    in-latest-posix: ''
+  st_mtime:
+    in-latest-posix: ''
+  UTIME_NOW:
+    in-latest-posix: ''
+  UTIME_OMIT:
+    in-latest-posix: ''
 
   S_IRWXU:
     in-latest-posix: ''