[apple/libc.git] / gen / FreeBSD / usleep.3.patch

--- _SB/Libc/gen/FreeBSD/usleep.3	2004-11-25 11:38:02.000000000 -0800
+++ _SB/Libc/gen/FreeBSD/usleep.3.edit	2006-06-28 16:55:51.000000000 -0700
@@ -37,30 +37,34 @@
 .Os
 .Sh NAME
 .Nm usleep
-.Nd suspend process execution for an interval measured in microseconds
+.Nd suspend thread execution for an interval measured in microseconds
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In unistd.h
 .Ft int
-.Fn usleep "useconds_t microseconds"
+.Fo usleep
+.Fa "useconds_t useconds"
+.Fc
 .Sh DESCRIPTION
 The
 .Fn usleep
-function suspends execution of the calling process until either
-.Fa microseconds
-microseconds have elapsed or a signal is delivered to the process and its
-action is to invoke a signal-catching function or to terminate the
-process.
-System activity may lengthen the sleep by an indeterminate amount.
+function suspends execution of the calling thread until either
+.Fa useconds
+microseconds have elapsed
+or a signal is delivered to the thread whose action
+is to invoke a signal-catching function
+or to terminate the thread or process.
+The actual time slept may be longer, due to system latencies
+and possible limitations in the timer resolution of the hardware.
 .Pp
-This function is implemented using
-.Xr nanosleep 2
+This function is implemented, using
+.Xr nanosleep 2 ,
 by pausing for
-.Fa microseconds
+.Fa useconds
 microseconds or until a signal occurs.
 Consequently, in this implementation,
-sleeping has no effect on the state of process timers,
+sleeping has no effect on the state of process timers
 and there is no special handling for SIGALRM.
 .Sh RETURN VALUES
 .Rv -std usleep
Commit	Line	Data
224c7076 A	1	--- _SB/Libc/gen/FreeBSD/usleep.3 2004-11-25 11:38:02.000000000 -0800
	2	+++ _SB/Libc/gen/FreeBSD/usleep.3.edit 2006-06-28 16:55:51.000000000 -0700
	3	@@ -37,30 +37,34 @@
59e0d9fe A	4	.Os
	5	.Sh NAME
	6	.Nm usleep
	7	-.Nd suspend process execution for an interval measured in microseconds
	8	+.Nd suspend thread execution for an interval measured in microseconds
	9	.Sh LIBRARY
	10	.Lb libc
	11	.Sh SYNOPSIS
224c7076 A	12	.In unistd.h
	13	.Ft int
	14	-.Fn usleep "useconds_t microseconds"
	15	+.Fo usleep
	16	+.Fa "useconds_t useconds"
	17	+.Fc
59e0d9fe A	18	.Sh DESCRIPTION
	19	The
	20	.Fn usleep
	21	-function suspends execution of the calling process until either
224c7076	22	-.Fa microseconds
59e0d9fe	23	-microseconds have elapsed or a signal is delivered to the process and its
224c7076	24	-action is to invoke a signal-catching function or to terminate the
59e0d9fe A	25	-process.
59e0d9fe A	26	-System activity may lengthen the sleep by an indeterminate amount.
224c7076 A	27	+function suspends execution of the calling thread until either
	28	+.Fa useconds
	29	+microseconds have elapsed
	30	+or a signal is delivered to the thread whose action
	31	+is to invoke a signal-catching function
	32	+or to terminate the thread or process.
59e0d9fe A	33	+The actual time slept may be longer, due to system latencies
	34	+and possible limitations in the timer resolution of the hardware.
	35	.Pp
224c7076 A	36	-This function is implemented using
	37	-.Xr nanosleep 2
	38	+This function is implemented, using
	39	+.Xr nanosleep 2 ,
	40	by pausing for
	41	-.Fa microseconds
	42	+.Fa useconds
	43	microseconds or until a signal occurs.
	44	Consequently, in this implementation,
	45	-sleeping has no effect on the state of process timers,
	46	+sleeping has no effect on the state of process timers
	47	and there is no special handling for SIGALRM.
	48	.Sh RETURN VALUES
	49	.Rv -std usleep