Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[libc][docs] add sys/wait to documentation and include related functi… #122598

Merged
merged 4 commits into from
Jan 15, 2025

Conversation

StarOne01
Copy link
Contributor

@StarOne01 StarOne01 commented Jan 11, 2025

These changes ensure that the sys/wait header is documented properly with respect to the issue (#122006 ).

Changes:

  1. wait.yaml: Created a new YAML file for sys/wait with functions (wait, waitid, waitpid) and related macros.
  2. CMakeLists.txt: Added sys/wait to the documentation directories.
  3. index.rst: Included sys/wait in the documentation index.

@llvmbot llvmbot added the libc label Jan 11, 2025
@llvmbot
Copy link
Member

llvmbot commented Jan 11, 2025

@llvm/pr-subscribers-libc

Author: Prashanth (StarOne01)

Changes

Changes:

  1. wait.yaml: Created a new YAML file for sys/wait with functions (wait, waitid, waitpid) and related macros.
  2. CMakeLists.txt: Added sys/wait to the documentation directories.
  3. index.rst: Included sys/wait in the documentation index.

These changes ensure that the sys/wait header is documented properly.


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

3 Files Affected:

  • (modified) libc/docs/CMakeLists.txt (+1)
  • (modified) libc/docs/headers/index.rst (+1)
  • (added) libc/utils/docgen/sys/wait.yaml (+35)
diff --git a/libc/docs/CMakeLists.txt b/libc/docs/CMakeLists.txt
index 4fa621fb2a0510..eabb26b9aa6b13 100644
--- a/libc/docs/CMakeLists.txt
+++ b/libc/docs/CMakeLists.txt
@@ -53,6 +53,7 @@ if (SPHINX_FOUND)
       string
       strings
       sys/mman
+      sys/wait
       threads
       uchar
       wchar
diff --git a/libc/docs/headers/index.rst b/libc/docs/headers/index.rst
index 2295a8cc8853cd..694b4b6f1a6b1c 100644
--- a/libc/docs/headers/index.rst
+++ b/libc/docs/headers/index.rst
@@ -26,6 +26,7 @@ Implementation Status
    string
    strings
    sys/mman
+   sys/wait
    threads
    time
    uchar
diff --git a/libc/utils/docgen/sys/wait.yaml b/libc/utils/docgen/sys/wait.yaml
new file mode 100644
index 00000000000000..bf801073b7b8c8
--- /dev/null
+++ b/libc/utils/docgen/sys/wait.yaml
@@ -0,0 +1,35 @@
+functions:
+  wait:
+    in-latest-posix: ''
+  waitid:
+    in-latest-posix: ''
+  waitpid:
+    in-latest-posix: ''
+
+macros:
+  WCONTINUED:
+    in-latest-posix: ''
+  WEXITED:
+    in-latest-posix: ''
+  WEXITSTATUS:
+    in-latest-posix: ''
+  WIFCONTINUED:
+    in-latest-posix: ''
+  WIFEXITED:
+    in-latest-posix: ''
+  WIFSIGNALED:
+    in-latest-posix: ''
+  WIFSTOPPED:
+    in-latest-posix: ''
+  WNOHANG:
+    in-latest-posix: ''
+  WNOWAIT:
+    in-latest-posix: ''
+  WSTOPPED:
+    in-latest-posix: ''
+  WSTOPSIG:
+    in-latest-posix: ''
+  WTERMSIG:
+    in-latest-posix: ''
+  WUNTRACED:
+    in-latest-posix: ''
\ No newline at end of file

@nickdesaulniers nickdesaulniers self-requested a review January 14, 2025 16:49
Copy link
Member

@nickdesaulniers nickdesaulniers left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's faster to review these if you define things in the order they appear in the posix docs. They will get alphabetically sorted when generating the rst files. You don't need to resort this file, but for future PRs please keep that in mind.

Thanks for the patch!

libc/utils/docgen/sys/wait.yaml Show resolved Hide resolved
@StarOne01
Copy link
Contributor Author

Done! I believe you mentioned it somewhere to

Please keep that list alphabetically sorted, too.

I guess, i misunderstood it for the whole doc instead of just index files.

Copy link
Member

@nickdesaulniers nickdesaulniers left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks for the patch! 🇹🇹 🅱️

@nickdesaulniers nickdesaulniers merged commit fadb0e9 into llvm:main Jan 15, 2025
12 checks passed
@StarOne01 StarOne01 deleted the wait_reference branch January 16, 2025 02:03
paulhuggett pushed a commit to paulhuggett/llvm-project that referenced this pull request Jan 16, 2025
llvm#122598)

These changes ensure that the `sys/wait` header is documented properly
with respect to the issue (llvm#122006 ).

**Changes:**
1. **wait.yaml**: Created a new YAML file for `sys/wait` with functions
(`wait`, `waitid`, `waitpid`) and related macros.
2. **CMakeLists.txt**: Added `sys/wait` to the documentation
directories.
3. **index.rst**: Included `sys/wait` in the documentation index.
DKLoehr pushed a commit to DKLoehr/llvm-project that referenced this pull request Jan 17, 2025
llvm#122598)

These changes ensure that the `sys/wait` header is documented properly
with respect to the issue (llvm#122006 ).

**Changes:**
1. **wait.yaml**: Created a new YAML file for `sys/wait` with functions
(`wait`, `waitid`, `waitpid`) and related macros.
2. **CMakeLists.txt**: Added `sys/wait` to the documentation
directories.
3. **index.rst**: Included `sys/wait` in the documentation index.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants