POSIX interfacing time retrieval

[pdclib] / includes / time.h

diff --git a/includes/time.h b/includes/time.h
index 00de956bfaf21f665fcbb35f92263c297cf69231..afee4d9d9b13f55273af826054738433bc9b70ea 100644 (file)
--- a/includes/time.h
+++ b/includes/time.h
@@ -19,6 +19,15 @@ typedef _PDCLIB_size_t size_t;
 #define NULL _PDCLIB_NULL
 #endif
 
+/* These are defined to be "real types capable of representing types", with
+   "range and precision of times representable in [them being] implementation-
+   defined".
+   As part of struct timespec (see below), time_t is further defined as "a
+   linear count of seconds", with potentially different semantics from a
+   "normal" time_t.
+   For sake of simplicity, we used just that (common) definition of "seconds
+   since epoch" as integer.
+*/
 typedef _PDCLIB_time_t time_t;
 typedef _PDCLIB_clock_t clock_t;