1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
From 61e92daf921b7a85ac8693341f8890658c61f047 Mon Sep 17 00:00:00 2001
From: http://ftp.de.debian.org/debian/pool/main/p/procps/procps_3.2.8-8.debian.tar.gz <info@debian.org>
Date: Fri, 19 Mar 2010 21:58:45 +0100
Subject: [PATCH 18/70] watch.1
===================================================================
---
watch.1 | 47 ++++++++++++++++++++++++++++-------------------
1 files changed, 28 insertions(+), 19 deletions(-)
diff --git a/watch.1 b/watch.1
index 41323f4..1616794 100644
--- a/watch.1
+++ b/watch.1
@@ -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 @@ watch \-d 'ls \-l | fgrep joe'
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
--
1.7.0
|