NAME
    sleep - suspend operation for a specified time

SYNOPSIS
    sleep([n])

TYPES
    n		non-negative real, defaults to 1

    return	integer or null value

DESCRIPTION
    This uses the C-library sleep (if n is integral) or usleep (for
    non-integral n) to suspend operation for n seconds.  If n is an
    integer and the sleep is stopped by an interruption, the number
    of seconds remaining is returned.

    One kind of use is to slow down output to permit easier reading of
    results, as in:

	> for (i = 0; i < 100; i++) {
		print sqrt(i);
		sleep(1/2);
	}

    The following illustrates what happens if ctrl-C is hit 5 seconds
    after the first command:
	
	> print sleep(20)

	[Abort level 1]
	15
	>

EXAMPLE
    > sleep(1/3);
    > sleep(20);

LIBRARY
    none

SEE ALSO
    none

## Copyright (C) 2000  Ernest Bowen
##
## Calc is open software; you can redistribute it and/or modify it under
## the terms of the version 2.1 of the GNU Lesser General Public License
## as published by the Free Software Foundation.
##
## Calc is distributed in the hope that it will be useful, but WITHOUT
## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
## or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU Lesser General
## Public License for more details.
##
## A copy of version 2.1 of the GNU Lesser General Public License is
## distributed with calc under the filename COPYING-LGPL.  You should have
## received a copy with calc; if not, write to Free Software Foundation, Inc.
## 59 Temple Place, Suite 330, Boston, MA  02111-1307, USA.
##
## @(#) $Revision: 29.1 $
## @(#) $Id: sleep,v 29.1 2000/12/14 10:31:45 chongo Exp $
## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/sleep,v $
##
## Under source code control:	2000/12/14 01:33:00
## File existed as early as:	2000
##
## Share and enjoy!  :-)	http://www.isthe.com/chongo/tech/comp/calc/