clock_gettime.2: Clarify CLOCK_*

Clarify that CLOCK_* (e.g., CLOCK_REALTIME) do not necessarily default
to CLOCK_*_FAST.

PR:		259642

1 files changed, 12 insertions, 3 deletions

diff --git a/lib/libc/sys/clock_gettime.2 b/lib/libc/sys/clock_gettime.2
index b04732fc993e..21526a98bd40 100644
--- a/lib/libc/sys/clock_gettime.2
+++ b/lib/libc/sys/clock_gettime.2
@@ -96,19 +96,28 @@ Returns the execution time of the calling thread.
 .El
 .Pp
 The clock IDs
+.Fa CLOCK_REALTIME ,
+.Fa CLOCK_MONOTONIC ,
+and
+.Fa CLOCK_UPTIME
+perform a full time counter query.
+The clock IDs with the _FAST suffix, i.e.,
 .Fa CLOCK_REALTIME_FAST ,
 .Fa CLOCK_MONOTONIC_FAST ,
-.Fa CLOCK_UPTIME_FAST
-are analogs of corresponding IDs without _FAST suffix but do not perform
+and
+.Fa CLOCK_UPTIME_FAST ,
+do not perform
 a full time counter query, so their accuracy is one timer tick.
 Similarly,
 .Fa CLOCK_REALTIME_PRECISE ,
 .Fa CLOCK_MONOTONIC_PRECISE ,
+and
 .Fa CLOCK_UPTIME_PRECISE
 are used to get the most exact value as possible, at the expense of
 execution time.
 The clock IDs
-.Fa CLOCK_REALTIME_COARSE ,
+.Fa CLOCK_REALTIME_COARSE
+and
 .Fa CLOCK_MONOTONIC_COARSE
 are aliases of corresponding IDs with _FAST suffix for compatibility with other
 systems.