diff options
author | Zack Weinberg <zackw@panix.com> | 2019-08-19 10:31:07 -0400 |
---|---|---|
committer | Adhemerval Zanella <adhemerval.zanella@linaro.org> | 2019-10-30 17:11:10 -0300 |
commit | 62193c4a3af9c1e15c039b323f45ccd2fddc119f (patch) | |
tree | 67963901b6a5563103951a0306b2354bc21f09d7 /stdlib/mul_n.c | |
parent | 2f2c76e1c8d8c4431c6395afeee420b71a4d772a (diff) | |
download | glibc-62193c4a3af9c1e15c039b323f45ccd2fddc119f.tar.gz glibc-62193c4a3af9c1e15c039b323f45ccd2fddc119f.tar.xz glibc-62193c4a3af9c1e15c039b323f45ccd2fddc119f.zip |
Revise the documentation of simple calendar time.
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."
Diffstat (limited to 'stdlib/mul_n.c')
0 files changed, 0 insertions, 0 deletions