diff options
author | Zack Weinberg <zackw@panix.com> | 2019-08-19 10:31:07 -0400 |
---|---|---|
committer | Zack Weinberg <zackw@panix.com> | 2019-08-28 09:02:34 -0400 |
commit | 6a05e8fb3b53ebcf9bc4da0d946d4ab07f8dc910 (patch) | |
tree | 771c161750117b0fa0bb8efa14b2d1ec7742943f /sysdeps/i386/stpcpy.S | |
parent | c50ec7ce062883cbb3d1820b2c1ea262ca5fff5b (diff) | |
download | glibc-zack/y2038-preliminaries.tar.gz |
Revise the documentation of simple calendar time.zack/y2038-preliminaries
This is a thorough revision of all the material relating to the
functions time, stime, gettimeofday, settimeofday, clock_gettime,
clock_getres, clock_settime, and difftime, spilling over into the
discussion of time-related data types (which now get their own
section) and touching the adjtime family as well (which deserves its
own thorough revision, but I'd have to do a bunch of research first).
Substantive changes are:
* Document clock_gettime, clock_getres, and clock_settime. (Only
CLOCK_REALTIME and CLOCK_MONOTONIC are documented; the others are
either a bit too Linux-specific, or have more to do with measuring
CPU/processor time. That section _also_ deserves its own thorough
revision but again I'd have to do a bunch of research first.)
* Present gettimeofday, settimeofday, and struct timeval as obsolete
relative to clock_*.
* Remove the documentation of struct timezone. Matching POSIX,
say that the type of the second argument to gettimeofday and
settimeofday is [const] void *.
* Clarify ISO C and POSIX's requirements on time_t. Clarify the
circumstances under which difftime is equivalent to simple
subtraction.
* Consolidate documentation of most of the time-related data types
into a new section "Time Types," right after "Time Basics." (The
exceptions are struct tm, which stays in "Broken-down Time," and
struct times, which stays in "Processor And CPU Time."
* The "Elapsed Time" section is now called "Calculating Elapsed Time"
and includes only difftime and the discussion of how to compute
timeval differences by hand.
* Fold the "Simple Calendar Time," "High Resolution Calendar," and
"High Accuracy Clock" sections together into two new sections titled
"Getting the Time" and "Setting and Adjusting the Time."
ChangeLog:
* manual/time.texi: Major revision of text related to simple
calendar time. clock_gettime, clock_getres, and clock_settime
are now documented.
* manual/filesys.texi, manual/llio.texi, manual/threads.texi:
Update cross-references to renamed sections in time.texi.
Diffstat (limited to 'sysdeps/i386/stpcpy.S')
0 files changed, 0 insertions, 0 deletions