~ubuntu-branches/ubuntu/raring/procps/raring-proposed
» Revision
2
: debian/patches/20_top_manpage.dpatch
« back to all changes in this revision
Viewing changes to debian/patches/20_top_manpage.dpatch
- browse files at revision 2
- compare with another revision
- download diff
- download tarball
- view history from revision 2
- Committer: Bazaar Package Importer
- Author(s): Craig Small
- Date: 2004-04-13 07:59:25 UTC
- Revision ID: james.westby@ubuntu.com-20040413075925-p912qrtzn1b8cc3x
Tags: 1:3.2.1-2
* Fix Makefile patch so it works with newer patch packages
Closes: #242574
* Changed the way SHARED is used in Makefiles
* init script looks nicer when setting multiple variables Closes: #241721
Closes: #242574
* Changed the way SHARED is used in Makefiles
* init script looks nicer when setting multiple variables Closes: #241721
- files added:
- debian
- debian/patches
added
removed
debian/patches/20_top_manpage.dpatch
1
#! /bin/sh -e
2
## 20_top_manpage by Randy Hron
3
##
4
## All lines beginning with `## DP:' are a description of the patch.
5
## DP: Fix bold in top manual page
6
## DP: Fix page fault description because storage may not be disk
7
8
[ -f debian/patches/00patch-opts ] && . debian/patches/00patch-opts
9
patch_opts="${patch_opts:--f --no-backup-if-mismatch}"
10
11
if [ $# -ne 1 ]; then
12
echo >&2 "`basename $0`: script expects -patch|-unpatch as argument"
13
exit 1
14
fi
15
case "$1" in
16
-patch) patch $patch_opts -p1 < $0;;
17
-unpatch) patch $patch_opts -p1 -R < $0;;
18
*)
19
echo >&2 "`basename $0`: script expects -patch|-unpatch as argum
20
ent"
21
exit 1;;
22
esac
23
24
exit 0
25
@DPATCH@
26
--- procps/top.1.orig Wed Mar 31 13:17:51 2004
27
+++ procps/top.1 Wed Mar 31 13:19:10 2004
28
@@ -52,7 +52,7 @@
29
.ds CF configuration file
30
.ds CI interactive command
31
.ds CO command\-line option
32
-.ds CW \'current' window
33
+.ds CW 'current' window
34
.ds FM full\-screen mode
35
.ds MP \fBphysical\fR memory
36
.ds MS \fBshared\fR memory
37
@@ -370,7 +370,7 @@
38
The task's share of the elapsed \*(PU time since the last screen update, expressed
39
as a percentage of total \*(PU time.
40
In a true SMP environment, if 'Irix mode' is \*F, \*(Me will operate in
41
-\'Solaris mode' where a task's \*(Pu usage will be divided by the total
42
+'Solaris mode' where a task's \*(Pu usage will be divided by the total
43
number of \*(PUs.
44
You toggle 'Irix/Solaris' modes with the 'I' \*(CI.
45
46
@@ -430,8 +430,8 @@
47
The number of\fB major\fR page faults that have occurred for a task.
48
A page fault occurs when a process attempts to read from or write to a virtual
49
page that is not currently present in its address space.
50
-A major page fault is when disk access is involved in making that
51
-page available.
52
+A major page fault is when backing storage access (such as a disk) is involved
53
+in making that page available.
54
55
.TP 3
56
v:\fB nDRT\fR \*(EM Dirty Pages count
57
@@ -498,7 +498,7 @@
58
.\" ......................................................................
59
.SS 2b. SELECTING and ORDERING Columns
60
.\" ----------------------------------------------------------------------
61
-After pressing the \*(CIs 'f' (Fields select) or \'o' (Order fields) you will
62
+After pressing the \*(CIs 'f' (Fields select) or 'o' (Order fields) you will
63
be shown a screen containing the current \fBfields string\fR followed by names
64
and descriptions for all fields.
65
66
@@ -574,7 +574,7 @@
67
see current status,
68
69
.TP 7
70
-\ \ \'\fB?\fR\' or \'\fBh\fR\' :\fIHelp\fR
71
+\ \ \<\fB?\fR\> or \<\fBh\fR\> :\fIHelp\fR
72
There are two help levels available.
73
The first will provide a reminder of all the basic \*(CIs.
74
If \*(Me is\fI secured\fR, that screen will be abbreviated.
75
@@ -583,7 +583,7 @@
76
applicable to \*(AM.
77
78
.TP 7
79
-\ \ \'\fB=\fR\' :\fIExit_Task_Limits\fR
80
+\ \ \<\fB=\fR\> :\fIExit_Task_Limits\fR
81
Removes restrictions on which tasks are shown.
82
This command will reverse any 'i' (idle tasks) and 'n' (max tasks) commands
83
that might be active.
84
@@ -593,13 +593,13 @@
85
When operating in \*(AM this command has a slightly broader meaning.
86
87
.TP 7
88
-\ \ \'\fBA\fR\' :\fIAlternate_Display_Mode_toggle\fR
89
+\ \ \<\fBA\fR\> :\fIAlternate_Display_Mode_toggle\fR
90
This command will switch between \*(FM and \*(AM.
91
-\*(XT 4. ALTERNATE\-DISPLAY Mode and the 'G' \*(CI for insight into
92
-\*(CWs and field groups.
93
+\*(XT 4. ALTERNATE\-DISPLAY Mode and the 'G' \*(CI for insight
94
+into \*(CWs and field groups.
95
96
.TP 7
97
-\ \ \'\fBB\fR\' :\fIBold_Disable/Enable_toggle\fR
98
+\ \ \<\fBB\fR\> :\fIBold_Disable/Enable_toggle\fR
99
This command will influence use of the 'bold' terminfo capability and
100
alters\fB both\fR the \*(SA and \*(TA for the \*(CW.
101
While it is intended primarily for use with dumb terminals, it can be
102
@@ -611,7 +611,7 @@
103
there will be no visual confirmation that they are even on.
104
105
.TP 7
106
-*\ \'\fBd\fR\' or \'\fBs\fR\' :\fIChange_Delay_Time_interval\fR
107
+*\ \<\fBd\fR\> or \<\fBs\fR\> :\fIChange_Delay_Time_interval\fR
108
You will be prompted to enter the delay time, in seconds, between
109
display updates.
110
111
@@ -625,32 +625,32 @@
112
and view the system summary on the second line.
113
114
.TP 7
115
-\ \ \'\fBG\fR\' :\fIChoose_Another_Window/Field_Group\fR
116
+\ \ \<\fBG\fR\> :\fIChoose_Another_Window/Field_Group\fR
117
You will be prompted to enter a number between 1 and 4 designating the
118
window/field group which should be made the \*(CW.
119
You will soon grow comfortable with these 4 windows, especially after
120
experimenting with \*(AM.
121
122
.TP 7
123
-\ \ \'\fBI\fR\' :\fIIrix/Solaris_Mode_toggle\fR
124
+\ \ \<\fBI\fR\> :\fIIrix/Solaris_Mode_toggle\fR
125
When operating in 'Solaris mode' ('I' toggled \*F), a task's \*(Pu usage
126
will be divided by the total number of \*(PUs.
127
After issuing this command, you'll be informed of the new state of this toggle.
128
129
.TP 7
130
-\ \ \'\fBu\fR\' :\fIselect a user\fR
131
+\ \ \<\fBu\fR\> :\fIselect a user\fR
132
You will be prompted for a UID or username. Only processes
133
belonging to the selected user will be displayed. This option
134
matches on the effective UID.
135
136
.TP 7
137
-\ \ \'\fBU\fR\' :\fIselect a user\fR
138
+\ \ \<\fBU\fR\> :\fIselect a user\fR
139
You will be prompted for a UID or username. Only processes
140
belonging to the selected user will be displayed. This option
141
matches on the real, effective, saved, and filesystem UID.
142
143
.TP 7
144
-*\ \'\fBk\fR\' :\fIKill_a_task\fR
145
+*\ \<\fBk\fR\> :\fIKill_a_task\fR
146
You will be prompted for a PID and then the signal to send.
147
The default signal, as reflected in the prompt, is SIGTERM.
148
However, you can send any signal, via number or name.
149
@@ -661,24 +661,24 @@
150
2) at the signal prompt, type 0
151
152
.TP 7
153
-\ \ \'\fBq\fR\' :\fIQuit\fR
154
+\ \ \<\fBq\fR\> :\fIQuit\fR
155
156
.TP 7
157
-*\ \'\fBr\fR\' :\fIRenice_a_Task\fR
158
+*\ \<\fBr\fR\> :\fIRenice_a_Task\fR
159
You will be prompted for a PID and then the value to nice it to.
160
Entering a positive value will cause a process to lose priority.
161
Conversely, a negative value will cause a process to be viewed more
162
favorably by the kernel.
163
164
.TP 7
165
-\ \ \'\fBW\fR\' :\fIWrite_the_Configuration_File\fR
166
+\ \ \<\fBW\fR\> :\fIWrite_the_Configuration_File\fR
167
This will save all of your options and toggles plus the current
168
display mode and delay time.
169
By issuing this command just before quitting \*(Me, you will be able restart
170
later in exactly that same state.
171
172
.TP 7
173
-\ \ \'\fBZ\fR\' :\fIChange_Color_Mapping
174
+\ \ \<\fBZ\fR\> :\fIChange_Color_Mapping
175
This key will take you to a separate screen where you can change the
176
colors for the \*(CW, or for all windows.
177
For details regarding this \*(CI \*(Xt 3d. COLOR Mapping.
178
@@ -694,25 +694,25 @@
179
of messages and prompts.
180
181
These commands always impact just the \*(CW/field group.
182
-\*(XT 4. ALTERNATE\-DISPLAY Mode and the 'G' \*(CI for insight into
183
-\*(CWs and field groups.
184
+\*(XT 4. ALTERNATE\-DISPLAY Mode and the 'G' \*(CI for insight
185
+into \*(CWs and field groups.
186
187
.TP 7
188
-\ \ \'\fBl\fR\' :\fIToggle_Load_Average/Uptime\fR \*(EM On/Off
189
+\ \ \<\fBl\fR\> :\fIToggle_Load_Average/Uptime\fR \*(EM On/Off
190
This is also the line containing the program name (possibly an alias) when
191
operating in \*(FM or the \*(CW name when operating in \*(AM.
192
193
.TP 7
194
-\ \ \'\fBm\fR\' :\fIToggle_Memory/Swap_Usage\fR \*(EM On/Off
195
+\ \ \<\fBm\fR\> :\fIToggle_Memory/Swap_Usage\fR \*(EM On/Off
196
This command affects two \*(SA lines.
197
198
.TP 7
199
-\ \ \'\fBt\fR\' :\fIToggle_Task/Cpu_States\fR \*(EM On/Off
200
+\ \ \<\fBt\fR\> :\fIToggle_Task/Cpu_States\fR \*(EM On/Off
201
This command affects from 2 to many \*(SA lines, depending on the state
202
of the '1' toggle and whether or not \*(Me is running under true SMP.
203
204
.TP 7
205
-\ \ \'\fB1\fR\' :\fIToggle_Single/Separate_Cpu_States\fR \*(EM On/Off
206
+\ \ \<\fB1\fR\> :\fIToggle_Single/Separate_Cpu_States\fR \*(EM On/Off
207
This command affects how the 't' command's Cpu States portion is shown.
208
Although this toggle exists primarily to serve massively-parallel SMP machines,
209
it is not restricted to solely SMP environments.
210
@@ -744,12 +744,12 @@
211
.in
212
213
.TP 7
214
-\ \ \'\fBb\fR\' :\fIBold/Reverse_toggle\fR
215
+\ \ \<\fBb\fR\> :\fIBold/Reverse_toggle\fR
216
This command will impact how the 'x' and 'y' toggles are displayed.
217
Further, it will only be available when at least one of those toggles is \*O.
218
219
.TP 7
220
-\ \ \'\fBx\fR\' :\fIColumn_Highlight_toggle\fR
221
+\ \ \<\fBx\fR\> :\fIColumn_Highlight_toggle\fR
222
Changes highlighting for the current sort field.
223
You probably don't need a constant visual reminder of the sort field and
224
\*(Me hopes that you always run with 'column highlight' \*F, due to the cost
225
@@ -759,7 +759,7 @@
226
visual reminder.
227
228
.TP 7
229
-\ \ \'\fBy\fR\' :\fIRow_Highlight_toggle\fR
230
+\ \ \<\fBy\fR\> :\fIRow_Highlight_toggle\fR
231
Changes highlighting for "running" tasks.
232
For additional insight into this task state, \*(Xt 2a. DESCRIPTIONS of Fields,
233
Process Status.
234
@@ -768,7 +768,7 @@
235
The only costs will be a few additional tty escape sequences.
236
237
.TP 7
238
-\ \ \'\fBz\fR\' :\fIColor/Monochrome_toggle\fR
239
+\ \ \<\fBz\fR\> :\fIColor/Monochrome_toggle\fR
240
Switches the \*(CW between your last used color scheme and the older form
241
of black-on-white or white-on-black.
242
This command will alter\fB both\fR the \*(SA and \*(TA but does not affect the
243
@@ -779,20 +779,20 @@
244
.B CONTENT\fR of \*(TW
245
.PD 0
246
.TP 7
247
-\ \ \'\fBc\fR\' :\fICommand_Line/Program_Name_toggle\fR
248
+\ \ \<\fBc\fR\> :\fICommand_Line/Program_Name_toggle\fR
249
This command will be honored whether or not the 'Command' column
250
is currently visible.
251
Later, should that field come into view, the change you applied will be seen.
252
253
.TP 7
254
-\ \ \'\fBf\fR\' and \'\fBo\fR\' :\fIFields_select\fR or \fIOrder_fields\fR
255
+\ \ \<\fBf\fR\> and \<\fBo\fR\> :\fIFields_select\fR or \fIOrder_fields\fR
256
These keys display separate screens where you can change which
257
fields are displayed and their order.
258
For additional information on these \*(CIs
259
\*(Xt 2b. SELECTING and ORDERING Columns.
260
261
.TP 7
262
-\ \ \'\fBS\fR\' :\fICumulative_Time_Mode_toggle\fR
263
+\ \ \<\fBS\fR\> :\fICumulative_Time_Mode_toggle\fR
264
When 'Cumulative mode' is \*O, each process is listed with the \*(Pu
265
time that it and its dead children have used.
266
267
@@ -808,7 +808,7 @@
268
effect, simply ask for help and view the window summary on the second line.
269
270
.TP 7
271
-\ \ \'\fBu\fR\' :\fIShow_Specific_User_Only\fR
272
+\ \ \<\fBu\fR\> :\fIShow_Specific_User_Only\fR
273
You will be prompted to enter the name of the user to display.
274
Thereafter, in that \*(TW only matching User ID's will be shown, or possibly
275
no tasks will be shown.
276
@@ -821,7 +821,7 @@
277
.B SIZE\fR of \*(TW
278
.PD 0
279
.TP 7
280
-\ \ \'\fBi\fR\' :\fIIdle_Processes_toggle\fR
281
+\ \ \<\fBi\fR\> :\fIIdle_Processes_toggle\fR
282
Displays all tasks or just active tasks.
283
When this toggle is \*F, idled or zombied processes will not be displayed.
284
285
@@ -829,7 +829,7 @@
286
affect the window's size, as all prior \*(TDs will have already been painted.
287
288
.TP 7
289
-\ \ \'\fBn\fR\' or \'#\' :\fISet_Maximum_Tasks\fR
290
+\ \ \<\fBn\fR\> or \<\fB#\fR\> :\fISet_Maximum_Tasks\fR
291
You will be prompted to enter the number of tasks to display.
292
The lessor of your number and available screen rows will be used.
293
294
@@ -868,12 +868,12 @@
295
.in
296
297
.TP 7
298
-\ \ \'\fB<\fR\' :\fIMove_Sort_Field_Left\fR
299
+\ \ \<\fB<\fR\> :\fIMove_Sort_Field_Left\fR
300
Moves the sort column to the left unless the current sort field is
301
the first field being displayed.
302
303
.TP 7
304
-\ \ \'\fB>\fR\' :\fIMove_Sort_Field_Right\fR
305
+\ \ \<\fB>\fR\> :\fIMove_Sort_Field_Right\fR
306
Moves the sort column to the right unless the current sort field is
307
the last field being displayed.
308
309
@@ -884,7 +884,7 @@
310
.in
311
312
.TP 7
313
-\ \ \'\fBF\fR\' or \'\fBO\fR\' :\fISelect_Sort_Field\fR
314
+\ \ \<\fBF\fR\> or \<\fBO\fR\> :\fISelect_Sort_Field\fR
315
These keys display a separate screen where you can change which field
316
is used as the sort column.
317
318
@@ -897,7 +897,7 @@
319
when running \*(Me with column highlighting turned \*F.
320
321
.TP 7
322
-\ \ \'\fBR\fR\' :\fIReverse/Normal_Sort_Field_toggle\fR
323
+\ \ \<\fBR\fR\> :\fIReverse/Normal_Sort_Field_toggle\fR
324
Using this \*(CI you can alternate between high-to-low and low-to-high sorts.
325
326
.PP
327
@@ -974,7 +974,7 @@
328
.\" ......................................................................
329
.SS 4b. COMMANDS for Windows
330
.TP 7
331
-\ \ \'\fB-\fR\' and \'\fB_\fR\' :\fIShow/Hide_Window(s)_toggles\fR
332
+\ \ \<\fB-\fR\> and \<\fB_\fR\> :\fIShow/Hide_Window(s)_toggles\fR
333
The '-' key turns the \*(CW's \*(TD \*O and \*F.
334
When \*O, that \*(TA will show a minimum of the columns header you've
335
established with the 'f' and 'o' commands.
336
@@ -988,7 +988,7 @@
337
as the only display element.
338
339
.TP 7
340
-*\ \'\fB=\fR\' and \'\fB+\fR\' :\fIEqualize_(re-balance)_Window(s)\fR
341
+*\ \<\fB=\fR\> and \<\fB+\fR\> :\fIEqualize_(re-balance)_Window(s)\fR
342
The '=' key forces the \*(CW's \*(TD to be visible.
343
It also reverses any 'i' (idle tasks) and 'n' (max tasks) commands that might
344
be active.
345
@@ -999,7 +999,7 @@
346
except for the 'i' (idle tasks) and 'n' (max tasks) commands.
347
348
.TP 7
349
-*\ \'\fBA\fR\' :\fIAlternate_Display_Mode_toggle\fR
350
+*\ \<\fBA\fR\> :\fIAlternate_Display_Mode_toggle\fR
351
This command will switch between \*(FM and \*(AM.
352
353
The first time you issue this command, all four \*(TDs will be shown.
354
@@ -1007,7 +1007,7 @@
355
chosen to make visible.
356
357
.TP 7
358
-*\ \'\fBa\fR\' and \'\fBw\fR\' :\fINext_Window_Forward/Backward\fR
359
+*\ \<\fBa\fR\> and \<\fBw\fR\> :\fINext_Window_Forward/Backward\fR
360
This will change the \*(CW, which in turn changes the window to which
361
commands are directed.
362
These keys act in a circular fashion so you can reach any desired \*(CW
363
@@ -1018,7 +1018,7 @@
364
the \*(TD is \*F and many commands will be restricted.
365
366
.TP 7
367
-*\ \'\fBG\fR\' :\fIChoose_Another_Window/Field_Group\fR
368
+*\ \<\fBG\fR\> :\fIChoose_Another_Window/Field_Group\fR
369
You will be prompted to enter a number between 1 and 4 designating the
370
window/field group which should be made the \*(CW.
371
372
@@ -1027,15 +1027,15 @@
373
commands.
374
375
.TP 7
376
-\ \ \'\fBg\fR\' :\fIChange_Window/Field_Group_Name\fR
377
+\ \ \<\fBg\fR\> :\fIChange_Window/Field_Group_Name\fR
378
You will be prompted for a new name to be applied to the \*(CW.
379
It does not require that the window name be visible
380
(the 'l' toggle to be \*O).
381
382
.IP "*" 3
383
The \*(CIs shown with an \*(AS have use beyond \*(AM.
384
- \'=', 'A', 'G' are always available
385
- \'a', 'w' act the same when color mapping
386
+ '=', 'A', 'G' are always available
387
+ 'a', 'w' act the same when color mapping
388
389
390
.\" ----------------------------------------------------------------------
Loggerhead is a web-based interface for Breezy
Version: 2.0.1