Command
	sleep

Purpose
	Halts execution for the given number of seconds.

Aliases
	sl, sleep

Syntax
	sleep	<time>

Options
	None.

Arguments
	<time>	Time in seconds to sleep for. This argument has the type real. This argument can be
		passed in terms of a constant variable or expression resulting in a real value.

Stream Input	
	Ignored.

Stream Output
	None.

Stream Error
	Any errors are listed here.

Description
	The command halts execution for the specified number of seconds.

	The argument is assumed to be in number of seconds. Fractions of a second can be specified.
		
Restrictions


Valid Examples
	sleep 5.5
	Sleeps for 5.5 seconds.

	var real r
	...
	sleep ($r+5.0)
	Sleeps for the value of $r plus 5 seconds. The value of $r is left unchanged.

Invalid Examples
	sleep -1
	The above will not produce an error, but no sleep will actually take place.
	A negative argument to the command will be treated as 0.00.

	var str s
	set $s="2.3"
	sleep $s
	The above will produce error or erroneous sleep time. $s is not a real variable. It
	is a str variable. It must be converted to real before passing as argument to the
	sleep command. The following will work.

	sleep makereal(str($s))

See Also
set
var