sleep.1: import from trinity/src

docs/sleep.1

@@ -0,0 +1,48 @@
+.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)