From: Bernhard Voelker <mail@bernhard-voelker.de>
Date: Sun, 8 Dec 2019 16:29:57 +0000 (+0100)
Subject: doc: add example to demonstrate sub-second sleep times
X-Git-Tag: v8.32~36
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=7490e94aa7ea1ba50492e211fc415a6bda9de9ee;p=thirdparty%2Fcoreutils.git

doc: add example to demonstrate sub-second sleep times

* doc/coreutils.texi (sleep invocation): Add an example to demonstrate
how to use the floating-point and the scientific notation to sleep
for sub-second times, e.g. milli-, micro- and nanoseconds.

Inspired by Stephane Chazelas in:
  https://lists.gnu.org/r/coreutils/2019-12/msg00005.html
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 32ddba5974..c52bb2dade 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -18248,6 +18248,13 @@ non-negative integer argument without a suffix, GNU @command{sleep}
 also accepts two or more arguments, unit suffixes, and floating-point
 numbers in either the current or the C locale.  @xref{Floating point}.
 
+For instance, the following could be used to @command{sleep} for
+1 second, 234 milli-, 567 micro- and 890 nanoseconds:
+
+@example
+sleep 1234e-3 567.89e-6
+@end example
+
 The only options are @option{--help} and @option{--version}.  @xref{Common
 options}.