[src/trunk]: src/bin/sleep sleep(1): minor markup tweaks

[uwe <uwe%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/56d9e3d3a2bc
branches:  trunk
changeset: 373585:56d9e3d3a2bc
user:      uwe <uwe%NetBSD.org@localhost>
date:      Sun Feb 19 10:54:35 2023 +0000

description:
sleep(1): minor markup tweaks

diffstat:

 bin/sleep/sleep.1 |  55 ++++++++++++++++++++++++++++++++++++-------------------
 1 files changed, 36 insertions(+), 19 deletions(-)

diffs (121 lines):

diff -r ee6cbf393a15 -r 56d9e3d3a2bc bin/sleep/sleep.1
--- a/bin/sleep/sleep.1 Sun Feb 19 10:48:06 2023 +0000
+++ b/bin/sleep/sleep.1 Sun Feb 19 10:54:35 2023 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: sleep.1,v 1.27 2019/01/27 17:42:53 wiz Exp $
+.\"    $NetBSD: sleep.1,v 1.28 2023/02/19 10:54:35 uwe Exp $
 .\"
 .\" Copyright (c) 1990, 1993, 1994
 .\"    The Regents of the University of California.  All rights reserved.
@@ -47,19 +47,24 @@
 utility suspends execution for a minimum of
 .Ar seconds
 seconds, then exits.
-It is usually used to schedule the execution of other commands (see
+It is usually used to schedule the execution of other commands
+.Po
+see
 .Sx EXAMPLES
-below).
+below
+.Pc .
 .Pp
-Note: The
+.Em Note :
+The
 .Nx
 .Nm
 command will accept and honor a non-integer number of specified seconds.
 Note however, that if the request is for much more than 2.5 hours,
 any fractional seconds will be ignored.
-Permitting non-integral delays is a non-portable extension,
-and its use will decrease the probability that
-a shell script will execute properly on another system.
+Permitting non-integral delays is a
+.Em non-portable
+extension, and its use will decrease the probability that a shell
+script will execute properly on another system.
 .Pp
 When the
 .Dv SIGINFO
@@ -74,7 +79,7 @@
 On successful completion, or if the signal
 .Dv SIGALRM
 was received.
-.It Li \&>\&0
+.It Li \&>0
 An error occurred.
 .El
 .Sh EXAMPLES
@@ -84,10 +89,12 @@
 .Pp
 This incantation would wait half an hour before
 running the script
-.Dq command_file .
-(See the
+.Ar command_file .
+.Po
+See the
 .Xr at 1
-utility.)
+utility
+.Pc .
 .Pp
 To repeatedly run a command (using
 .Xr csh 1 ) :
@@ -110,17 +117,27 @@
 running is taking longer than expected to process a series of
 files, and it would be nice to have
 another program start processing the files created by the first
-program as soon as it is finished (when zzz.rawdata is created).
-The script checks every five minutes for the file zzz.rawdata.
-When the file is found, processing the generated files (*.rawdata)
+program as soon as it is finished
+.Po
+when
+.Li zzz.rawdata
+is created
+.Pc .
+The script checks every five minutes for the file
+.Li zzz.rawdata .
+When the file is found, processing the generated files
+.Pq Li *.rawdata
 is done courteously by sleeping for 70 seconds in between each
 awk job.
 .Pp
 To wait until a particular time, the following,
-with some error checking added, might be used (using
+with some error checking added, might be used
+.Po
+using
 .Xr sh 1
 on
-.Nx ) :
+.Nx
+.Pc :
 .Bd -literal -offset indent
 END=$(( $( date -d "$1" +%s ) - START_TIME ))
 while [ "${SECONDS}" -lt "${END}" ]
@@ -130,7 +147,7 @@
 .Ed
 .Pp
 where the argument
-.Sq \&$1
+.Ql $1
 specifies the desired date and time in any format the
 .Fl d
 option to the
@@ -155,11 +172,11 @@
 utility appeared in
 .At v4 .
 Processing fractional seconds, and processing the
-.Ic seconds
+.Ar seconds
 argument respecting the current locale, was added in
 .Nx 1.3 .
 The ability to sleep for extended periods appeared in
-.Nx 9 .
+.Nx 9.0 .
 .Sh BUGS
 This
 .Nm