."\ Master source for sleep manual : /usr/src/local/man/src/sleepv.rof
."\ stored as sleepv rather than sleep to allow for stupid Symmetric Unix man command
.TH SLEEP P "Manual V1.1 for Program V1.5"
.\" A4 the cludgy way.
.pl 29.6c
.UC 4
.SH NAME
sleep \- suspend execution for some time

.SH SYNTAX
.B sleep
[-vVerbose] [-b[interval]] [-lLunar_month] [-wWeek] [-dDays] [-hHours] [-mMinutes] [[-sSeconds] [Seconds]

.SH SUMMARY
.I Sleep
is a rewrite of the standard Unix like command, but with added flags.

.SH DESCRIPTION

.I Sleep
Is used to suspend execution of an invoking process,
typically while a human makes some change elsewhere,
or in a shell / batch script periodic `for' or `while' loop.

Flags must precede Seconds parameter if Seconds parameter is given.
Seconds may be specified as the last argument, or by use of -s,
(to allow backward invocation syntax compatibility with Unix
.I sleep(1).
Flags may be used in any order.
Flags available include :-

.TP
.B \-l
lunar month (4 weeks)
.TP
.B \-w
week
.TP
.B \-d
days
.TP
.B \-h
hours
.TP
.B \-m
minutes
.TP
.B \-s
seconds
.TP
.B \-v
verbose
.br
Announces time now, time when it will finish,
then keeps updating time on screen until finished.
.TP
.B \-b
bells
.br
Output one bell periodically forever (until user interrupts program with
operating system dependent break character), default periodic interval is
one second.
.TP
.B \-V
Volume.
.br
Set volume (actually number of adjacent bell characters sent between intervals),
note a bell character output direct from a program on Msdos appears louder/longer than one sent from a Unix, heard via an Msdos running a kermit terminal emulator.

.SH RESTRICTIONS
Int/long size of system.

.SH EXAMPLES

On Unix:
.in +5
sleep -h2 -m30 ; lpr *.doc
.br
.I Sleep
until a convenient time before commencing noisy printout of documents.
.in -5

On Msdos:
.in +5
.I sleep
-h8 -b
.br
Sleep for 7 hours 30 minutes.
Useful on a laptop computer, if you dont have a travelling alarm clock!.
.in -5

.SH EXIT CODE

0 if no error has occurred, else 1;
also 1 after a user interrupt occurs during -b looping.

.SH BUGS
If -b0 is used, the output stream gets clogged with bells,
an interrupt character stops the process, but it is not immediately
apparent it has stopped as bells keep coming.
If accessing a Unix via an Msdos terminal emulator, bells
can be shed by terminating the emulator & reinvoking emulator.

When used to delay a wakeup call, running on a portable dos laptop
in a hotel room, the battery exhaustion bell may wake you before 
.I sleep
finishes.

.SH HOST OP SYSTEM

This utility runs on both Msdos 3.2 & Unix.

.SH COPYRIGHT

Program and Document Copyright Julian H. Stacey May 1989.
.so author.jhs

.SH ENHANCEMENTS LATER
Flags y,e,M will be used later for year, easter, month.
Flag @ will be used to `sleep until'.

.SH FILES
None

.SH SEE ALSO
sleep(1), kermit(l), easter(p).
.\ End of file