104 lines
2.9 KiB
Diff
104 lines
2.9 KiB
Diff
Description: Cleanup of manual page and cumulative is a parameter not option
|
|
Author: jidanni@jidanni.org
|
|
Bug-Debian: http://bugs.debian.org/527193
|
|
Reviewed-by: Craig Small <csmall@debian.org>
|
|
Index: b/watch.1
|
|
===================================================================
|
|
--- a/watch.1 2009-11-24 20:53:04.000000000 +1100
|
|
+++ b/watch.1 2009-11-24 21:00:36.000000000 +1100
|
|
@@ -1,45 +1,54 @@
|
|
-.TH WATCH 1 "1999 Apr 3" " " "Linux User's Manual"
|
|
+.TH WATCH 1 "2009 May 11" " " "Linux User's Manual"
|
|
.SH NAME
|
|
watch \- execute a program periodically, showing output fullscreen
|
|
.SH SYNOPSIS
|
|
+.na
|
|
.B watch
|
|
-.I [\-dhvt] [\-n <seconds>] [\-\-differences[=cumulative]] [\-\-help] [\-\-interval=<seconds>] [\-\-no\-title] [\-\-version] <command>
|
|
+.RB [ \-dhvt ]
|
|
+.RB [ \-n
|
|
+.IR seconds ]
|
|
+.RB [ \-\-differences[=\fIcumulative\fP]]
|
|
+.RB [ \-\-help ]
|
|
+.RB [ \-\-interval=\fIseconds\fP]
|
|
+.RB [ \-\-no\-title ]
|
|
+.RB [ \-\-version ]
|
|
+.I command
|
|
.SH DESCRIPTION
|
|
-.BR watch
|
|
+.B watch
|
|
runs
|
|
.I command
|
|
repeatedly, displaying its output (the first screenfull). This allows you to
|
|
watch the program output change over time. By default, the program is run
|
|
every 2 seconds; use
|
|
-.I -n
|
|
+.B \-n
|
|
or
|
|
-.I --interval
|
|
+.B \-\-interval
|
|
to specify a different interval.
|
|
.PP
|
|
The
|
|
-.I -d
|
|
+.B \-d
|
|
or
|
|
-.I --differences
|
|
-flag will highlight the differences between successive updates. The
|
|
-.I --cumulative
|
|
-option makes highlighting "sticky", presenting a running display of all
|
|
+.B \-\-differences
|
|
+flag will highlight the differences between successive updates. Using
|
|
+.B \-\-differences=\fIcumulative\fP
|
|
+makes highlighting "sticky", presenting a running display of all
|
|
positions that have ever changed. The
|
|
-.I -t
|
|
+.B \-t
|
|
or
|
|
-.I --no-title
|
|
+.B \-\-no\-title
|
|
option turns off the header showing the interval, command, and current
|
|
time at the top of the display, as well as the following blank line.
|
|
.PP
|
|
-.BR watch
|
|
+.B watch
|
|
will run until interrupted.
|
|
.SH NOTE
|
|
Note that
|
|
.I command
|
|
-is given to "sh -c"
|
|
+is given to "sh \-c"
|
|
which means that you may need to use extra quoting to get the desired effect.
|
|
.PP
|
|
Note that POSIX option processing is used (i.e., option processing stops at
|
|
-the first non-option argument). This means that flags after
|
|
+the first non\-option argument). This means that flags after
|
|
.I command
|
|
don't get interpreted by
|
|
.BR watch
|
|
@@ -61,20 +70,20 @@
|
|
To see the effects of quoting, try these out
|
|
.IP
|
|
watch echo $$
|
|
-.IP
|
|
+.br
|
|
watch echo '$$'
|
|
-.IP
|
|
+.br
|
|
watch echo "'"'$$'"'"
|
|
.PP
|
|
You can watch for your administrator to install the latest kernel with
|
|
.IP
|
|
-watch uname -r
|
|
+watch uname \-r
|
|
.PP
|
|
(Just kidding.)
|
|
.SH BUGS
|
|
Upon terminal resize, the screen will not be correctly repainted until the
|
|
next scheduled update. All
|
|
-.I --differences
|
|
+.B \-\-differences
|
|
highlighting is lost on that update as well.
|
|
.PP
|
|
Non-printing characters are stripped from program output. Use "cat -v" as
|