History log of /openbsd-current/lib/libc/gen/sleep.3
Revision (<<< Hide revision tags) (Show revision tags >>>) Date Author Comments
# 1.18 31-Mar-2022 naddy

man pages: add missing commas between subordinate and main clauses

jmc@ dislikes a comma before "then" in a conditional, so leave those
untouched.

ok jmc@


# 1.17 07-Dec-2021 cheloha

sleep.3: miscellanous cleanup, rewrites

Highlights:

- Tighten up the NAME.
- "process" -> "thread".
- Tidy up the DESCRIPTION. In particular, omit discussion of the
historial SIGALRM-based implementation.
- Simplify RETURN VALUES.
- Add an ERRORS section, note that sleep(3) can set EINTR.
- Update STANDARDS to POSIX.1-2008.
- Note that setting errno is an extension to the spec.

Discussed with and revised by jmc@, deraadt@, millert@, and schwarze@.
With a history lesson from jsg@.

Thread: https://marc.info/?l=openbsd-tech&m=162718445809428&w=2

"the changes read fine to me" jmc@, ok millert@ schwarze@


Revision tags: OPENBSD_6_7_BASE OPENBSD_6_8_BASE OPENBSD_6_9_BASE OPENBSD_7_0_BASE
# 1.16 08-Feb-2020 jsg

correct Research Unix edition "appeared in" use in HISTORY

Starting from "Combined Table of Contents" in Doug McIlroy's
"A Research UNIX Reader" a table of which edition manuals appeared in.
Checked against manuals from bitsavers/TUHS and source from TUHS where
available.

Ingo points out there are cases where something is included but not
documented until a later release.
bcd(6) v6 v7
printf(3) v2 v4
abort(3) v5 v6
system(3) v6 v7
fmod(3) v5 v6

ok schwarze@


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE OPENBSD_6_1_BASE OPENBSD_6_2_BASE OPENBSD_6_3_BASE OPENBSD_6_4_BASE OPENBSD_6_5_BASE OPENBSD_6_6_BASE
# 1.15 21-Feb-2014 schwarze

remove section 2/3 pointers from section 1,
and do not point programmers at the obsolete usleep(3);
based on a diff from Jan Klemkow <j dot klemkow at wemelug dot de>,
but removing more as suggested by jmc@ and deraadt@


Revision tags: OPENBSD_5_4_BASE
# 1.14 18-Jul-2013 schwarze

HISTORY; tweaks and ok sobrado@ jmc@


# 1.13 05-Jun-2013 tedu

Use the fancy .In macro for includes. From Jan Klemkow. ok jmc schwarze


Revision tags: OPENBSD_5_3_BASE
# 1.12 16-Oct-2012 millert

Make sleep(3) and usleep(3) more consistent and remove extraneous
historic implementation details that get in the way of readability.
Our usleep(3) does not return EINVAL for values >= 1,000,000 but
still mention it in CAVEATS since some do.
Portions adapted from FreeBSD. OK jmc@


Revision tags: OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE
# 1.11 24-Oct-2008 jmc

some SEE ALSO additions from Ingo Schwarze;


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE OPENBSD_4_4_BASE
# 1.10 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_3_4_BASE OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.9 02-Jun-2003 millert

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.


Revision tags: OPENBSD_2_7_BASE OPENBSD_2_8_BASE OPENBSD_2_9_BASE OPENBSD_3_0_BASE OPENBSD_3_1_BASE OPENBSD_3_2_BASE OPENBSD_3_3_BASE
# 1.8 18-Apr-2000 aaron

Repairs, mostly removing hard sentence breaks.


Revision tags: OPENBSD_2_6_BASE
# 1.7 31-Aug-1999 aaron

Consistify naming of RETURN VALUES section.


# 1.6 09-Jul-1999 aaron

- remove all trailing whitespace
* except when it is escaped with a `\' at the end of the line
- fix remaining .Nm usage as well
- this is from a patch I received from kwesterback@home.com, who has been
working on some scripts for fixing formatting errors in mdoc'd man pages

Ok, so there could be a cost/benefit debate with this commit, but since I have
the patch we might as well commit it...


# 1.5 29-May-1999 aaron

repairs


Revision tags: OPENBSD_2_1_BASE OPENBSD_2_2_BASE OPENBSD_2_3_BASE OPENBSD_2_4_BASE OPENBSD_2_5_BASE
# 1.4 25-Apr-1997 kstailey

added select(2) to see also, mostly to test cvs commit


# 1.3 25-Apr-1997 kstailey

less inaccurate


Revision tags: OPENBSD_2_0_BASE
# 1.2 19-Aug-1996 tholo

Fix RCS ids
Make sure everything uses {SYS,}LIBC_SCCS properly


# 1.1 18-Oct-1995 deraadt

branches: 1.1.1;
Initial revision


# 1.17 07-Dec-2021 cheloha

sleep.3: miscellanous cleanup, rewrites

Highlights:

- Tighten up the NAME.
- "process" -> "thread".
- Tidy up the DESCRIPTION. In particular, omit discussion of the
historial SIGALRM-based implementation.
- Simplify RETURN VALUES.
- Add an ERRORS section, note that sleep(3) can set EINTR.
- Update STANDARDS to POSIX.1-2008.
- Note that setting errno is an extension to the spec.

Discussed with and revised by jmc@, deraadt@, millert@, and schwarze@.
With a history lesson from jsg@.

Thread: https://marc.info/?l=openbsd-tech&m=162718445809428&w=2

"the changes read fine to me" jmc@, ok millert@ schwarze@


Revision tags: OPENBSD_6_7_BASE OPENBSD_6_8_BASE OPENBSD_6_9_BASE OPENBSD_7_0_BASE
# 1.16 08-Feb-2020 jsg

correct Research Unix edition "appeared in" use in HISTORY

Starting from "Combined Table of Contents" in Doug McIlroy's
"A Research UNIX Reader" a table of which edition manuals appeared in.
Checked against manuals from bitsavers/TUHS and source from TUHS where
available.

Ingo points out there are cases where something is included but not
documented until a later release.
bcd(6) v6 v7
printf(3) v2 v4
abort(3) v5 v6
system(3) v6 v7
fmod(3) v5 v6

ok schwarze@


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE OPENBSD_6_1_BASE OPENBSD_6_2_BASE OPENBSD_6_3_BASE OPENBSD_6_4_BASE OPENBSD_6_5_BASE OPENBSD_6_6_BASE
# 1.15 21-Feb-2014 schwarze

remove section 2/3 pointers from section 1,
and do not point programmers at the obsolete usleep(3);
based on a diff from Jan Klemkow <j dot klemkow at wemelug dot de>,
but removing more as suggested by jmc@ and deraadt@


Revision tags: OPENBSD_5_4_BASE
# 1.14 18-Jul-2013 schwarze

HISTORY; tweaks and ok sobrado@ jmc@


# 1.13 05-Jun-2013 tedu

Use the fancy .In macro for includes. From Jan Klemkow. ok jmc schwarze


Revision tags: OPENBSD_5_3_BASE
# 1.12 16-Oct-2012 millert

Make sleep(3) and usleep(3) more consistent and remove extraneous
historic implementation details that get in the way of readability.
Our usleep(3) does not return EINVAL for values >= 1,000,000 but
still mention it in CAVEATS since some do.
Portions adapted from FreeBSD. OK jmc@


Revision tags: OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE
# 1.11 24-Oct-2008 jmc

some SEE ALSO additions from Ingo Schwarze;


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE OPENBSD_4_4_BASE
# 1.10 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_3_4_BASE OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.9 02-Jun-2003 millert

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.


Revision tags: OPENBSD_2_7_BASE OPENBSD_2_8_BASE OPENBSD_2_9_BASE OPENBSD_3_0_BASE OPENBSD_3_1_BASE OPENBSD_3_2_BASE OPENBSD_3_3_BASE
# 1.8 18-Apr-2000 aaron

Repairs, mostly removing hard sentence breaks.


Revision tags: OPENBSD_2_6_BASE
# 1.7 31-Aug-1999 aaron

Consistify naming of RETURN VALUES section.


# 1.6 09-Jul-1999 aaron

- remove all trailing whitespace
* except when it is escaped with a `\' at the end of the line
- fix remaining .Nm usage as well
- this is from a patch I received from kwesterback@home.com, who has been
working on some scripts for fixing formatting errors in mdoc'd man pages

Ok, so there could be a cost/benefit debate with this commit, but since I have
the patch we might as well commit it...


# 1.5 29-May-1999 aaron

repairs


Revision tags: OPENBSD_2_1_BASE OPENBSD_2_2_BASE OPENBSD_2_3_BASE OPENBSD_2_4_BASE OPENBSD_2_5_BASE
# 1.4 25-Apr-1997 kstailey

added select(2) to see also, mostly to test cvs commit


# 1.3 25-Apr-1997 kstailey

less inaccurate


Revision tags: OPENBSD_2_0_BASE
# 1.2 19-Aug-1996 tholo

Fix RCS ids
Make sure everything uses {SYS,}LIBC_SCCS properly


# 1.1 18-Oct-1995 deraadt

branches: 1.1.1;
Initial revision


# 1.16 08-Feb-2020 jsg

correct Research Unix edition "appeared in" use in HISTORY

Starting from "Combined Table of Contents" in Doug McIlroy's
"A Research UNIX Reader" a table of which edition manuals appeared in.
Checked against manuals from bitsavers/TUHS and source from TUHS where
available.

Ingo points out there are cases where something is included but not
documented until a later release.
bcd(6) v6 v7
printf(3) v2 v4
abort(3) v5 v6
system(3) v6 v7
fmod(3) v5 v6

ok schwarze@


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE OPENBSD_6_1_BASE OPENBSD_6_2_BASE OPENBSD_6_3_BASE OPENBSD_6_4_BASE OPENBSD_6_5_BASE OPENBSD_6_6_BASE
# 1.15 21-Feb-2014 schwarze

remove section 2/3 pointers from section 1,
and do not point programmers at the obsolete usleep(3);
based on a diff from Jan Klemkow <j dot klemkow at wemelug dot de>,
but removing more as suggested by jmc@ and deraadt@


Revision tags: OPENBSD_5_4_BASE
# 1.14 18-Jul-2013 schwarze

HISTORY; tweaks and ok sobrado@ jmc@


# 1.13 05-Jun-2013 tedu

Use the fancy .In macro for includes. From Jan Klemkow. ok jmc schwarze


Revision tags: OPENBSD_5_3_BASE
# 1.12 16-Oct-2012 millert

Make sleep(3) and usleep(3) more consistent and remove extraneous
historic implementation details that get in the way of readability.
Our usleep(3) does not return EINVAL for values >= 1,000,000 but
still mention it in CAVEATS since some do.
Portions adapted from FreeBSD. OK jmc@


Revision tags: OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE
# 1.11 24-Oct-2008 jmc

some SEE ALSO additions from Ingo Schwarze;


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE OPENBSD_4_4_BASE
# 1.10 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_3_4_BASE OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.9 02-Jun-2003 millert

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.


Revision tags: OPENBSD_2_7_BASE OPENBSD_2_8_BASE OPENBSD_2_9_BASE OPENBSD_3_0_BASE OPENBSD_3_1_BASE OPENBSD_3_2_BASE OPENBSD_3_3_BASE
# 1.8 18-Apr-2000 aaron

Repairs, mostly removing hard sentence breaks.


Revision tags: OPENBSD_2_6_BASE
# 1.7 31-Aug-1999 aaron

Consistify naming of RETURN VALUES section.


# 1.6 09-Jul-1999 aaron

- remove all trailing whitespace
* except when it is escaped with a `\' at the end of the line
- fix remaining .Nm usage as well
- this is from a patch I received from kwesterback@home.com, who has been
working on some scripts for fixing formatting errors in mdoc'd man pages

Ok, so there could be a cost/benefit debate with this commit, but since I have
the patch we might as well commit it...


# 1.5 29-May-1999 aaron

repairs


Revision tags: OPENBSD_2_1_BASE OPENBSD_2_2_BASE OPENBSD_2_3_BASE OPENBSD_2_4_BASE OPENBSD_2_5_BASE
# 1.4 25-Apr-1997 kstailey

added select(2) to see also, mostly to test cvs commit


# 1.3 25-Apr-1997 kstailey

less inaccurate


Revision tags: OPENBSD_2_0_BASE
# 1.2 19-Aug-1996 tholo

Fix RCS ids
Make sure everything uses {SYS,}LIBC_SCCS properly


# 1.1 18-Oct-1995 deraadt

branches: 1.1.1;
Initial revision


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE OPENBSD_6_1_BASE OPENBSD_6_2_BASE
# 1.15 21-Feb-2014 schwarze

remove section 2/3 pointers from section 1,
and do not point programmers at the obsolete usleep(3);
based on a diff from Jan Klemkow <j dot klemkow at wemelug dot de>,
but removing more as suggested by jmc@ and deraadt@


Revision tags: OPENBSD_5_4_BASE
# 1.14 18-Jul-2013 schwarze

HISTORY; tweaks and ok sobrado@ jmc@


# 1.13 05-Jun-2013 tedu

Use the fancy .In macro for includes. From Jan Klemkow. ok jmc schwarze


Revision tags: OPENBSD_5_3_BASE
# 1.12 16-Oct-2012 millert

Make sleep(3) and usleep(3) more consistent and remove extraneous
historic implementation details that get in the way of readability.
Our usleep(3) does not return EINVAL for values >= 1,000,000 but
still mention it in CAVEATS since some do.
Portions adapted from FreeBSD. OK jmc@


Revision tags: OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE
# 1.11 24-Oct-2008 jmc

some SEE ALSO additions from Ingo Schwarze;


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE OPENBSD_4_4_BASE
# 1.10 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_3_4_BASE OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.9 02-Jun-2003 millert

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.


Revision tags: OPENBSD_2_7_BASE OPENBSD_2_8_BASE OPENBSD_2_9_BASE OPENBSD_3_0_BASE OPENBSD_3_1_BASE OPENBSD_3_2_BASE OPENBSD_3_3_BASE
# 1.8 18-Apr-2000 aaron

Repairs, mostly removing hard sentence breaks.


Revision tags: OPENBSD_2_6_BASE
# 1.7 31-Aug-1999 aaron

Consistify naming of RETURN VALUES section.


# 1.6 09-Jul-1999 aaron

- remove all trailing whitespace
* except when it is escaped with a `\' at the end of the line
- fix remaining .Nm usage as well
- this is from a patch I received from kwesterback@home.com, who has been
working on some scripts for fixing formatting errors in mdoc'd man pages

Ok, so there could be a cost/benefit debate with this commit, but since I have
the patch we might as well commit it...


# 1.5 29-May-1999 aaron

repairs


Revision tags: OPENBSD_2_1_BASE OPENBSD_2_2_BASE OPENBSD_2_3_BASE OPENBSD_2_4_BASE OPENBSD_2_5_BASE
# 1.4 25-Apr-1997 kstailey

added select(2) to see also, mostly to test cvs commit


# 1.3 25-Apr-1997 kstailey

less inaccurate


Revision tags: OPENBSD_2_0_BASE
# 1.2 19-Aug-1996 tholo

Fix RCS ids
Make sure everything uses {SYS,}LIBC_SCCS properly


# 1.1 18-Oct-1995 deraadt

branches: 1.1.1;
Initial revision