From 327c71c8ae52215818567a02c8536c73e6f4e72a Mon Sep 17 00:00:00 2001
From: DTB <trinity@trinity.moe>
Date: Fri, 3 May 2024 21:29:49 -0600
Subject: [PATCH] sleep.1: import from trinity/src

---
 docs/sleep.1 | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 docs/sleep.1

diff --git a/docs/sleep.1 b/docs/sleep.1
new file mode 100644
index 0000000..09cace0
--- /dev/null
+++ b/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)