gettimeofday.2: miscellaneous manpage cleanup
authorcheloha <cheloha@openbsd.org>
Mon, 6 Dec 2021 02:48:55 +0000 (02:48 +0000)
committercheloha <cheloha@openbsd.org>
Mon, 6 Dec 2021 02:48:55 +0000 (02:48 +0000)
commit2e74cb648ecc27f48ed5c4e161884ed978b55b3d
tree8526cd93f18a811a0e7a7cd5a6745bb6d252dbba
parenta9623b445a286e1b6ef196c5d23894724077a2f0
gettimeofday.2: miscellaneous manpage cleanup

Highlights:

- Tweak the one-liner description.
- Better variable names.
- Reorder DESCRIPTION to reflect the importance of each interface.
- Advise against using gettimeofday(2) for measuring elapsed time.
- Isolate discussion of the historical timezone parameter to its
  own paragraph at the end of the DESCRIPTION.
- Update ERRORS.  Mention the securelevel(7) EPERM for settimeofday(2).
- Expand SEE ALSO.
- Note settimeofday(2) in STANDARDS.  It is available on many systems.

Discussed with jmc@, millert@, and deraadt@.  Possibly discussed with
schwarze@, though I can't find the email.

Thread: https://marc.info/?t=162765632800002&r=1&w=2

"reads fine to me" jmc@, ok millert@
lib/libc/sys/gettimeofday.2