[PATCH v3 3/3] clock_nanosleep.2: Use 't' rather than 'request'

Alejandro Colomar
2024-03-05T01:26:18Z

[-- Attachment #1: Type: text/plain, Size: 2269 bytes --]

It seems much more clear.

Cc: Elliott Hughes <enh@google.com>
Cc: Stefan Puiu <stefan.puiu@gmail.com>
Cc: Bruno Haible <bruno@clisp.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
---

v3:

- Add new patch for clock_nanosleep(2).

- Patches 1 and 2 are still the same as in older revisions; not
resending.

man2/clock_nanosleep.2 | 16 ++++++++--------
1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/man2/clock_nanosleep.2 b/man2/clock_nanosleep.2
index 5bda50e18..7715ec385 100644
--- a/man2/clock_nanosleep.2
+++ b/man2/clock_nanosleep.2
@@ -19,7 +19,7 @@ .SH SYNOPSIS
.nf
.P
.BI "int clock_nanosleep(clockid_t " clockid ", int " flags ,
-.BI " const struct timespec *" request ,
+.BI " const struct timespec *" t ,
.BI " struct timespec *_Nullable " remain );
.fi
.P
@@ -94,7 +94,7 @@ .SH DESCRIPTION
If
.I flags
is 0, then the value specified in
-.I request
+.I t
is interpreted as an interval relative to the current
value of the clock specified by
.IR clockid .
@@ -104,11 +104,11 @@ .SH DESCRIPTION
is
.BR TIMER_ABSTIME ,
then
-.I request
+.I t
is interpreted as an absolute time as measured by the clock,
.IR clockid .
If
-.I request
+.I t
is less than or equal to the current value of the clock,
then
.BR clock_nanosleep ()
@@ -117,7 +117,7 @@ .SH DESCRIPTION
.BR clock_nanosleep ()
suspends the execution of the calling thread
until either at least the time specified by
-.I request
+.I t
has elapsed,
or a signal is delivered that causes a signal handler to be called or
that terminates the process.
@@ -146,7 +146,7 @@ .SH RETURN VALUE
.SH ERRORS
.TP
.B EFAULT
-.I request
+.I t
or
.I remain
specified an invalid address.
@@ -180,7 +180,7 @@ .SH HISTORY
glibc 2.1.
.SH NOTES
If the interval specified in
-.I request
+.I t
is not an exact multiple of the granularity underlying clock (see
.BR time (7)),
then the interval will be rounded up to the next multiple.
@@ -216,7 +216,7 @@ .SH NOTES
is
.BR TIMER_ABSTIME .
(An absolute sleep can be restarted using the same
-.I request
+.I t
argument.)
.P
POSIX.1 specifies that
--
2.43.0