emo/procps
1
0
Fork 0
Code Issues Pull Requests Packages Releases Activity

docs: Consistent style across watch.1

Browse Source
This commit is contained in:
ivan tkachenko 2020-12-06 14:17:23 +03:00 committed by Craig Small
parent 90dd80781f
commit 96f8f3532c
1 changed files with 14 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
watch.1
View File

@ -1,4 +1,4 @@
.TH WATCH 1 "2020-10-19" "procps-ng" "User Commands" .TH WATCH 1 "2020-12-06" "procps-ng" "User Commands"
.SH NAME .SH NAME
watch \- execute a program periodically, showing output fullscreen watch \- execute a program periodically, showing output fullscreen
.SH SYNOPSIS .SH SYNOPSIS
@ -13,9 +13,9 @@ allows you to watch the program output change over time. By default,
\fIcommand\fR is run every 2 seconds and \fBwatch\fR will run until interrupted. \fIcommand\fR is run every 2 seconds and \fBwatch\fR will run until interrupted.
.SH OPTIONS .SH OPTIONS
.TP .TP
.BR \-d ", " \-\-differences [ =permanent ] \fB\-d\fR, \fB\-\-differences\fR[=\fIpermanent\fR]
Highlight the differences between successive updates. If the optional Highlight the differences between successive updates. If the optional
\fB=permanent\fR argument is specified then \fIpermanent\fR argument is specified then
.B watch .B watch
will show all changes since the first iteration. will show all changes since the first iteration.
.TP .TP
@ -31,8 +31,9 @@ Make
attempt to run attempt to run
.I command .I command
every every
.I interval .B \-\-interval
seconds. Try it with .IR seconds .
Try it with
.B ntptime .B ntptime
(if present) and notice how the fractional seconds stays (nearly) the same, as opposed to (if present) and notice how the fractional seconds stays (nearly) the same, as opposed to
normal mode where they continuously increase. normal mode where they continuously increase.
@ -136,24 +137,25 @@ last column on the screen may display one column early, or they may not
display at all. display at all.
Combining Characters never count as different in Combining Characters never count as different in
.I \-\-differences .B \-\-differences
mode. Only the base character counts. mode. Only the base character counts.
Blank lines directly after a line which ends in the last column do not Blank lines directly after a line which ends in the last column do not
display. display.
.I \-\-precise .B \-\-precise
mode doesn't yet have advanced temporal distortion technology to compensate mode doesn't yet have advanced temporal distortion technology to compensate
for a for a
.I command .I command
that takes more than that takes more than
.I interval .B \-\-interval
seconds to execute. .I seconds
to execute.
.B watch .B watch
also can get into a state where it rapid-fires as many executions of also can get into a state where it rapid-fires as many executions of
.I command .I command
as it can to catch up from a previous executions running longer than as it can to catch up from a previous executions running longer than
.I interval .B \-\-interval
(for example, (for example,
.B netstat .B netstat
taking ages on a DNS lookup). taking ages on a DNS lookup).
@ -180,7 +182,7 @@ watch echo '$$'
watch echo "'"'$$'"'" watch echo "'"'$$'"'"
.PP .PP
To see the effect of precision time keeping, try adding To see the effect of precision time keeping, try adding
.I \-p .B \-p
to to
.IP .IP
watch \-n 10 sleep 1 watch \-n 10 sleep 1
@ -190,7 +192,7 @@ You can watch for your administrator to install the latest kernel with
watch uname \-r watch uname \-r
.PP .PP
(Note that (Note that
.I \-p .B \-p
isn't guaranteed to work across reboots, especially in the face of isn't guaranteed to work across reboots, especially in the face of
.B ntpdate .B ntpdate
(if present) or other bootup time-changing mechanisms) (if present) or other bootup time-changing mechanisms)