[libc-commits] [libc] 0419db6 - [libc][docgen] make note of sys/time.h interfaces removed in POSIX.1-2024 (#126612)

[via libc-commits]

Author: Nick Desaulniers
Date: 2025-02-11T14:14:41-08:00
New Revision: 0419db6b95e246fe9dc90b5795beb77c393eb2ce

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

LOG: [libc][docgen] make note of sys/time.h interfaces removed in POSIX.1-2024 (#126612)

One of these days, we'll be able to specify time to a computer...

Also, POSIX can remove stuff all they want. Folks probably will continue to
depend on broken interfaces forever.

Link: #124654
Link: https://austingroupbugs.net/view.php?id=1330

Added: 
    

Modified: 
    libc/utils/docgen/docgen.py
    libc/utils/docgen/sys/time.yaml

Removed: 
    


################################################################################
diff  --git a/libc/utils/docgen/docgen.py b/libc/utils/docgen/docgen.py
index 09db284ef9282..5a57987b3c51e 100755
--- a/libc/utils/docgen/docgen.py
+++ b/libc/utils/docgen/docgen.py
@@ -57,6 +57,7 @@ def check_api(header: Header, api: Dict):
         "c-definition",
         "in-latest-posix",
         "removed-in-posix-2008",
+        "removed-in-posix-2024",
     ]
 
     # Validate macros
@@ -140,6 +141,10 @@ def print_functions_rst(header: Header, functions: Dict):
             print(
                 f"    - `removed in POSIX.1-2008 <https://pubs.opengroup.org/onlinepubs/007904875/functions/{name}.html>`__"
             )
+        elif "removed-in-posix-2024" in functions[name]:
+            print(
+                f"    - `removed in POSIX.1-2024 <https://pubs.opengroup.org/onlinepubs/9699919799.2018edition/functions/{name}.html>`__"
+            )
         else:
             print("    -")
 

diff  --git a/libc/utils/docgen/sys/time.yaml b/libc/utils/docgen/sys/time.yaml
index 1e3909adafea3..b7678f403cdcf 100644
--- a/libc/utils/docgen/sys/time.yaml
+++ b/libc/utils/docgen/sys/time.yaml
@@ -3,3 +3,9 @@ functions:
     in-latest-posix: ''
   utimes:
     in-latest-posix: ''
+  getitimer:
+    removed-in-posix-2024: ''
+  gettimeofday:
+    removed-in-posix-2024: ''
+  setitimer:
+    removed-in-posix-2024: ''