about summary refs log tree commit diff
path: root/stdlib/mul_n.c
diff options
context:
space:
mode:
authorZack Weinberg <zackw@panix.com>2019-08-19 10:31:07 -0400
committerAdhemerval Zanella <adhemerval.zanella@linaro.org>2019-10-30 17:11:10 -0300
commit62193c4a3af9c1e15c039b323f45ccd2fddc119f (patch)
tree67963901b6a5563103951a0306b2354bc21f09d7 /stdlib/mul_n.c
parent2f2c76e1c8d8c4431c6395afeee420b71a4d772a (diff)
downloadglibc-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