shell_cmds-207.100.1.tar.gz

[apple/shell_cmds.git] / sleep / sleep.1

diff --git a/sleep/sleep.1 b/sleep/sleep.1
index 8815eaabdc763b3b7fde6a8d45e81522670e93c0..f5215be1b4da3ca9dd933afc92d79ccdc918a365 100644 (file)
--- a/sleep/sleep.1
+++ b/sleep/sleep.1
@@ -1,5 +1,4 @@
-.\"    $NetBSD: sleep.1,v 1.11 1997/09/14 07:31:56 lukem Exp $
-.\"
+.\"-
 .\" Copyright (c) 1990, 1993, 1994
 .\"    The Regents of the University of California.  All rights reserved.
 .\"
@@ -14,10 +13,6 @@
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
-.\" 3. All advertising materials mentioning features or use of this software
-.\"    must display the following acknowledgement:
-.\"    This product includes software developed by the University of
-.\"    California, Berkeley and its contributors.
 .\" 4. Neither the name of the University nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
@@ -35,6 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"    @(#)sleep.1     8.3 (Berkeley) 4/18/94
+.\" $FreeBSD: src/bin/sleep/sleep.1,v 1.22 2005/01/16 16:41:59 ru Exp $
 .\"
 .Dd April 18, 1994
 .Dt SLEEP 1
@@ -48,41 +44,41 @@
 .Sh DESCRIPTION
 The
 .Nm
-utility
+command
 suspends execution for a minimum of
 .Ar seconds .
-It is usually used to schedule the execution of other commands (see
-.Sx EXAMPLES
-below).
 .Pp
-The
+If the
 .Nm
-utility exits with one of the following values:
-.Bl -tag -width flag
-.It Li \&0
-On successful completion, or if the signal
+command receives a signal, it takes the standard action.
+.Sh IMPLEMENTATION NOTES
+The
 .Dv SIGALRM
-was received.
-.It Li \&>\&0
-An error occurred.
-.El
+signal is not handled specially by this implementation.
 .Pp
-Note: The
-.Nx
+The
 .Nm
-command will accept and honor a non-integer number of specified
-seconds. This is a non-portable extension, and its use will nearly
-guarantee that a shell script will not execute properly on another
-system.
+command will accept and honor a non-integer number of specified seconds
+(with a
+.Ql .\&
+character as a decimal point).
+.Bf Sy
+This is a non-portable extension, and its use will nearly guarantee that
+a shell script will not execute properly on another system.
+.Ef
+.Sh EXIT STATUS
+.Ex -std
 .Sh EXAMPLES
 To schedule the execution of a command for
 .Va x
-number seconds later:
+number seconds later (with
+.Xr csh 1 ) :
 .Pp
 .Dl (sleep 1800; sh command_file >& errors)&
 .Pp
 This incantation would wait a half hour before
-running the script command_file. (See the
+running the script command_file.
+(See the
 .Xr at 1
 utility.)
 .Pp
@@ -114,11 +110,15 @@ is done courteously by sleeping for 70 seconds in between each
 awk job.
 .Sh SEE ALSO
 .Xr nanosleep 2 ,
-.Xr sleep 3 ,
-.Xr at 1
+.Xr sleep 3
 .Sh STANDARDS
 The
 .Nm
 command is expected to be
 .St -p1003.2
 compatible.
+.Sh HISTORY
+A
+.Nm
+command appeared in
+.At v4 .