[libc-commits] [libc] [libc][docs] Add nl_types.h POSIX header documentation (#122006) (PR #194373)

[via libc-commits]

llvmbot wrote:


<!--LLVM PR SUMMARY COMMENT-->

@llvm/pr-subscribers-libc

Author: Petter Berntsson (petbernt)

<details>
<summary>Changes</summary>

Add nl_types.h implementation-status docs to llvm-libc.

Depends on PR #<!-- -->194367. That change fixes docgen macro lookup for underscored headers, without it, the macros of nl_types.h implementation status is not reported accurately.

---
Full diff: https://github.com/llvm/llvm-project/pull/194373.diff


3 Files Affected:

- (modified) libc/docs/CMakeLists.txt (+1) 
- (modified) libc/docs/headers/index.rst (+1) 
- (added) libc/utils/docgen/nl_types.yaml (+13) 


``````````diff
diff --git a/libc/docs/CMakeLists.txt b/libc/docs/CMakeLists.txt
index 237a648e7ac1d..c69ecf4103f84 100644
--- a/libc/docs/CMakeLists.txt
+++ b/libc/docs/CMakeLists.txt
@@ -54,6 +54,7 @@ if (SPHINX_FOUND)
       glob
       inttypes
       locale
+      nl_types
       net/if
       netinet/in
       poll
diff --git a/libc/docs/headers/index.rst b/libc/docs/headers/index.rst
index 3902d08b94c3e..7f7d0eca7be49 100644
--- a/libc/docs/headers/index.rst
+++ b/libc/docs/headers/index.rst
@@ -23,6 +23,7 @@ Implementation Status
    math/index.rst
    net/if
    netinet/in
+   nl_types
    poll
    search
    setjmp
diff --git a/libc/utils/docgen/nl_types.yaml b/libc/utils/docgen/nl_types.yaml
new file mode 100644
index 0000000000000..97fbcddfc9948
--- /dev/null
+++ b/libc/utils/docgen/nl_types.yaml
@@ -0,0 +1,13 @@
+functions:
+  catclose:
+    in-latest-posix: ""
+  catgets:
+    in-latest-posix: ""
+  catopen:
+    in-latest-posix: ""
+
+macros:
+  NL_CAT_LOCALE:
+    in-latest-posix: ""
+  NL_SETD:
+    in-latest-posix: ""

``````````

</details>


https://github.com/llvm/llvm-project/pull/194373