[PATCH v3] manual: Document clock_nanosleep

Arjun Shankar arjun@redhat.com
Tue May 27 13:25:05 GMT 2025


> > +The argument @var{clock} is used to specify the clock to be used.  The
> > +@code{clockid_t} type and possible values of @var{clock} defined by POSIX
> > +are described in @ref{Getting the Time}.
>
> Not all of the clock ids on that page are defined by POSIX and not all
> are supported by clock_nanosleep.  For example CLOCK_REALTIME_COARSE
> is not defined by POSIX and is not supported by clock_nanosleep,
> CLOCK_THREAD_CPUTIME_ID is defined by POSIX but is not supported by
> clock_nanosleep, and CLOCK_BOOTTIME is not defined by POSIX and is
> supported by clock_nanosleep.  Perhaps "defined by POSIX" should be
> moved between "type" and "and"?  Since not all of the referenced clock
> ids are supported by clock_nanosleep I would expect the supported
> clock ids to be listed.

Thanks Mark. I'll remove the bit about "defined by POSIX" entirely,
and write a sentence about the types of clocks that are not supported
while continuing to point to the other section for the clockid_t value
list. I'll CC you on my v3.

Cheers!
-- 
Arjun Shankar
he/him/his



More information about the Libc-alpha mailing list