From 1139d059c00c47ff1c7f3037ea76816379a03f3c Mon Sep 17 00:00:00 2001 From: Prashanth Date: Thu, 9 Jan 2025 05:21:20 +0000 Subject: [PATCH 1/3] [docs][libc] Add AIO documentation refering POSIX and include in build --- libc/docs/CMakeLists.txt | 1 + libc/docs/headers/index.rst | 1 + libc/utils/docgen/aio.yaml | 49 +++++++++++++++++++++++++++++++++++++ 3 files changed, 51 insertions(+) create mode 100644 libc/utils/docgen/aio.yaml diff --git a/libc/docs/CMakeLists.txt b/libc/docs/CMakeLists.txt index 5a3f8275bb932..f48005f303436 100644 --- a/libc/docs/CMakeLists.txt +++ b/libc/docs/CMakeLists.txt @@ -32,6 +32,7 @@ if (SPHINX_FOUND) # math.h), those should be omitted and exist statically in # libc/docs/headers/. list(APPEND docgen_list + aio arpa/inet assert ctype diff --git a/libc/docs/headers/index.rst b/libc/docs/headers/index.rst index 07ab6dd9b2674..70fb04089d9a2 100644 --- a/libc/docs/headers/index.rst +++ b/libc/docs/headers/index.rst @@ -4,6 +4,7 @@ Implementation Status .. toctree:: :maxdepth: 1 + aio arpa/inet assert complex diff --git a/libc/utils/docgen/aio.yaml b/libc/utils/docgen/aio.yaml new file mode 100644 index 0000000000000..d3d9418f54b13 --- /dev/null +++ b/libc/utils/docgen/aio.yaml @@ -0,0 +1,49 @@ +macros: + AIO_ALLDONE: + in-latest-posix: '' + AIO_CANCELED: + in-latest-posix: '' + AIO_NOTCANCELED: + in-latest-posix: '' + LIO_NOP: + in-latest-posix: '' + LIO_NOWAIT: + in-latest-posix: '' + LIO_READ: + in-latest-posix: '' + LIO_WAIT: + in-latest-posix: '' + LIO_WRITE: + in-latest-posix: '' + +functions: + aio_fildes: + in-latest-posix: '' + aio_offset: + in-latest-posix: '' + aio_buf: + in-latest-posix: '' + aio_nbytes: + in-latest-posix: '' + aio_reqprio: + in-latest-posix: '' + aio_sigevent: + in-latest-posix: '' + aio_lio_opcode: + in-latest-posix: '' + aio_cancel: + in-latest-posix: '' + aio_error: + in-latest-posix: '' + aio_fsync: + in-latest-posix: '' + aio_read: + in-latest-posix: '' + aio_return: + in-latest-posix: '' + aio_suspend: + in-latest-posix: '' + aio_write: + in-latest-posix: '' + lio_listio: + in-latest-posix: '' From 5509b350ac4676203e0afc7e6fb2bdd1ad08db49 Mon Sep 17 00:00:00 2001 From: Prashanth Date: Thu, 9 Jan 2025 16:20:34 +0000 Subject: [PATCH 2/3] Update aio.yaml to reorder functions and ensure consistency in POSIX documentation --- libc/utils/docgen/aio.yaml | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/libc/utils/docgen/aio.yaml b/libc/utils/docgen/aio.yaml index d3d9418f54b13..1b877639e0fcb 100644 --- a/libc/utils/docgen/aio.yaml +++ b/libc/utils/docgen/aio.yaml @@ -17,30 +17,30 @@ macros: in-latest-posix: '' functions: - aio_fildes: - in-latest-posix: '' - aio_offset: - in-latest-posix: '' aio_buf: in-latest-posix: '' - aio_nbytes: + aio_cancel: in-latest-posix: '' - aio_reqprio: + aio_error: in-latest-posix: '' - aio_sigevent: + aio_fildes: in-latest-posix: '' - aio_lio_opcode: + aio_fsync: in-latest-posix: '' - aio_cancel: + aio_lio_opcode: in-latest-posix: '' - aio_error: + aio_nbytes: in-latest-posix: '' - aio_fsync: + aio_offset: in-latest-posix: '' aio_read: in-latest-posix: '' + aio_reqprio: + in-latest-posix: '' aio_return: in-latest-posix: '' + aio_sigevent: + in-latest-posix: '' aio_suspend: in-latest-posix: '' aio_write: From 64dd418e1e1fc91eb2e6abd2ca5d5fb3e89814de Mon Sep 17 00:00:00 2001 From: Prashanth Date: Fri, 10 Jan 2025 01:23:13 +0000 Subject: [PATCH 3/3] Update aio.yaml to remove struct field entries --- libc/utils/docgen/aio.yaml | 14 -------------- 1 file changed, 14 deletions(-) diff --git a/libc/utils/docgen/aio.yaml b/libc/utils/docgen/aio.yaml index 1b877639e0fcb..2c381558676a1 100644 --- a/libc/utils/docgen/aio.yaml +++ b/libc/utils/docgen/aio.yaml @@ -17,30 +17,16 @@ macros: in-latest-posix: '' functions: - aio_buf: - in-latest-posix: '' aio_cancel: in-latest-posix: '' aio_error: in-latest-posix: '' - aio_fildes: - in-latest-posix: '' aio_fsync: in-latest-posix: '' - aio_lio_opcode: - in-latest-posix: '' - aio_nbytes: - in-latest-posix: '' - aio_offset: - in-latest-posix: '' aio_read: in-latest-posix: '' - aio_reqprio: - in-latest-posix: '' aio_return: in-latest-posix: '' - aio_sigevent: - in-latest-posix: '' aio_suspend: in-latest-posix: '' aio_write: