.\" Copyright (c) 2024 DTB <trinity@trinity.moe>
.\"
.\" This work is licensed under CC BY-SA 4.0. To see a copy of this license,
.\" visit <http://creativecommons.org/licenses/by-sa/4.0/>.

.TH SLEEP 1

.SH NAME

sleep \(en wait a moment

.SH SYNOPSIS

sleep
.RB [ seconds ]

.SH DESCRIPTION

Sleep waits the given amount of seconds before exiting.

.SH DIAGNOSTICS

Sleep exits successfully when the time specified has elapsed, or unsuccessfully
if the time fails to elapse or if invoked incorrectly. In the latter scenario
sleep will also print a usage synopsis.

.SH BUGS

User may still be tired after invoking sleep.

.SH EXAMPLES

The following invocation sleeps for five seconds.

.RS
.R sleep 5
.RE

The following sh(1p) command line sleeps for five minutes, or for sixty
seconds, five times, using rpn(1) and xargs(1p).

.RS
.R $ rpn 60 5 '*' | xargs sleep
.RE

.SH COPYRIGHT

Copyright (c) 2024 DTB. License AGPLv3+: GNU AGPL version 3 or later
<https://gnu.org/licenses/gpl.html>.

.SH SEE ALSO

sleep(3)