nng_aleep_aio

3 files changed, 32 insertions, 53 deletions

diff --git a/docs/man/nng_sleep_aio.3.adoc b/docs/man/nng_sleep_aio.3.adoc
deleted file mode 100644
index 2a3cf4f2..00000000
--- a/docs/man/nng_sleep_aio.3.adoc
+++ /dev/null
@@ -1,53 +0,0 @@
-= nng_sleep_aio(3)
-//
-// Copyright 2020 Staysail Systems, Inc. <info@staysail.tech>
-// Copyright 2018 Capitar IT Group BV <info@capitar.com>
-//
-// This document is supplied under the terms of the MIT License, a
-// copy of which should be located in the distribution where this
-// file was obtained (LICENSE.txt).  A copy of the license may also be
-// found online at https://opensource.org/licenses/MIT.
-//
-
-== NAME
-
-nng_sleep_aio - sleep asynchronously
-
-== SYNOPSIS
-
-[source, c]
-----
-#include <nng/nng.h>
-
-void nng_sleep_aio(nng_duration msec, nng_aio *aio);
-----
-
-== DESCRIPTION
-
-The `nng_sleep_aio()` function provides an asynchronous delay mechanism,
-causing the callback for _aio_ to be executed after _msec_ milliseconds.
-If the sleep finishes completely, the result will always be zero.
-
-NOTE: If a timeout is set on _aio_ using
-xref:nng_aio_set_timeout.3.adoc[`nng_aio_set_timeout()`], and it is shorter
-than _msec_,
-then the sleep will wake up early, with a result code of `NNG_ETIMEDOUT`.
-
-== RETURN VALUES
-
-None.
-
-== ERRORS
-
-None.
-
-== SEE ALSO
-
-[.text-left]
-xref:nng_aio_abort.3.adoc[nng_aio_abort(3)],
-xref:nng_aio_alloc.3.adoc[nng_aio_alloc(3)],
-xref:nng_aio_set_timeout.3.adoc[nng_aio_set_timeout(3)],
-xref:nng_strerror.3.adoc[nng_strerror(3)],
-xref:nng_aio.5.adoc[nng_aio(5)],
-xref:nng_duration.5.adoc[nng_duration(5)],
-xref:nng.7.adoc[nng(7)]
diff --git a/docs/reference/src/SUMMARY.md b/docs/reference/src/SUMMARY.md
index a047101d..0a99d045 100644
--- a/docs/reference/src/SUMMARY.md
+++ b/docs/reference/src/SUMMARY.md
@@ -97,6 +97,7 @@
     - [nng_free](api/util/nng_free.md)
     - [nng_msleep](api/util/nng_msleep.md)
     - [nng_random](api/util/nng_random.md)
+    - [nng_sleep_aio](api/util/nng_sleep_aio.md)
     - [nng_strdup](api/util/nng_strdup.md)
     - [nng_strerror](api/util/nng_strerror.md)
     - [nng_strfree](api/util/nng_strfree.md)
diff --git a/docs/reference/src/api/util/nng_sleep_aio.md b/docs/reference/src/api/util/nng_sleep_aio.md
new file mode 100644
index 00000000..799f512f
--- /dev/null
+++ b/docs/reference/src/api/util/nng_sleep_aio.md
@@ -0,0 +1,31 @@
+# nng_sleep_aio
+
+## NAME
+
+nng_sleep_aio - sleep asynchronously
+
+## SYNOPSIS
+
+```c
+#include <nng/nng.h>
+
+void nng_sleep_aio(nng_duration msec, nng_aio *aio);
+```
+
+## DESCRIPTION
+
+The `nng_sleep_aio()` function provides an asynchronous delay mechanism,
+causing the callback for _aio_ to be executed after _msec_ milliseconds.
+If the sleep finishes completely, the result will always be zero.
+
+> [!NOTE]
+> If a timeout is set on _aio_ using
+> [`nng_aio_set_timeout()`](../aio/nng_aio_set_timeout.md), and it is shorter
+> than _msec_,
+> then the sleep will wake up early, with a result code of `NNG_ETIMEDOUT`.
+
+## SEE ALSO
+
+[nng_clock](nng_clock.md),
+[nng_msleep](nng_msleep.md),
+[Asynchronous I/O](../aio/index.md)