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

top: eliminate troublesome apostrophes in man document

Browse Source 
Some versions of man have had trouble with the leading
apostrophe employed with interactive commands/toggles.
Instead, a '?' would be displayed in their place. With
this patch all such conventions have now been removed.

Signed-off-by: Jim Warner <james.warner@comcast.net>
This commit is contained in:
Jim Warner 2013-05-13 00:00:00 -05:00 committed by Craig Small
parent ae102f359f
commit 3993fb0c8e
1 changed files with 84 additions and 84 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

168
top/top.1
View File

@ -297,25 +297,25 @@ The typically mandatory switches ('\-') and even whitespace are completely
optional. optional.
.TP 5 .TP 5
\-\fBh\fR | \-\fBv\fR :\fI Help/Version \fR \-\fBh\fR | \-\fBv\fR\ \ :\fIHelp/Version \fR
Show library version and the usage prompt, then quit. Show library version and the usage prompt, then quit.
.TP 5 .TP 5
\-\fBb\fR :\fI Batch-mode\fR operation \fR \-\fBb\fR\ \ :\fIBatch-mode\fR operation \fR
Starts \*(We in 'Batch' mode, which could be useful for sending output Starts \*(We in 'Batch' mode, which could be useful for sending output
from \*(We to other programs or to a file. from \*(We to other programs or to a file.
In this mode, \*(We will not accept input and runs until the iterations In this mode, \*(We will not accept input and runs until the iterations
limit you've set with the '\-n' \*(CO or until killed. limit you've set with the '\-n' \*(CO or until killed.
.TP 5 .TP 5
\-\fBc\fR :\fI Command-line/Program-name\fR toggle \fR \-\fBc\fR\ \ :\fICommand-line/Program-name\fR toggle \fR
Starts \*(We with the last remembered 'c' state reversed. Starts \*(We with the last remembered 'c' state reversed.
Thus, if \*(We was displaying command lines, now that field will show program Thus, if \*(We was displaying command lines, now that field will show program
names, and visa versa. names, and visa versa.
\*(XC 'c' \*(CI for additional information. \*(XC 'c' \*(CI for additional information.
.TP 5 .TP 5
\-\fBd\fR :\fI Delay-time\fR interval as:\ \ \fB-d ss.t\fR (\fIsecs\fR.\fItenths\fR) \fR \-\fBd\fR\ \ :\fIDelay-time\fR interval as:\ \ \fB-d ss.t\fR (\fIsecs\fR.\fItenths\fR) \fR
Specifies the delay between screen updates, and overrides the corresponding Specifies the delay between screen updates, and overrides the corresponding
value in one's personal \*(CF or the startup default. value in one's personal \*(CF or the startup default.
Later this can be changed with the 'd' or 's' \*(CIs. Later this can be changed with the 'd' or 's' \*(CIs.
@ -326,13 +326,13 @@ in 'Secure mode', except for root (unless the 's' \*(CO was used).
For additional information on 'Secure mode' \*(Xt 6a. SYSTEM Configuration File. For additional information on 'Secure mode' \*(Xt 6a. SYSTEM Configuration File.
.TP 5 .TP 5
\-\fBH\fR :\fI Threads-mode\fR operation \fR \-\fBH\fR\ \ :\fIThreads-mode\fR operation \fR
Instructs \*(We to display individual threads. Instructs \*(We to display individual threads.
Without this \*(CO a summation of all threads in each process is shown. Without this \*(CO a summation of all threads in each process is shown.
Later this can be changed with the 'H' \*(CI. Later this can be changed with the 'H' \*(CI.
.TP 5 .TP 5
\-\fBi\fR :\fI Idle-process\fR toggle \fR \-\fBi\fR\ \ :\fIIdle-process\fR toggle \fR
Starts \*(We with the last remembered 'i' state reversed. Starts \*(We with the last remembered 'i' state reversed.
When this toggle is \*F, tasks that have not used any \*(PU since the When this toggle is \*F, tasks that have not used any \*(PU since the
last update will not be displayed. last update will not be displayed.
@ -340,12 +340,12 @@ For additional information regarding this toggle
\*(Xt 4c. TASK AREA Commands, SIZE. \*(Xt 4c. TASK AREA Commands, SIZE.
.TP 5 .TP 5
\-\fBn\fR :\fI Number-of-iterations\fR limit as:\fB\ \ \-n number \fR \-\fBn\fR\ \ :\fINumber-of-iterations\fR limit as:\fB\ \ \-n number \fR
Specifies the maximum number of iterations, or frames, \*(We should Specifies the maximum number of iterations, or frames, \*(We should
produce before ending. produce before ending.
.TP 5 .TP 5
\-\fBo\fR :\fI Override-sort-field\fR as:\fB\ \ \-o fieldname \fR \-\fBo\fR\ \ :\fIOverride-sort-field\fR as:\fB\ \ \-o fieldname \fR
Specifies the name of the field on which tasks will be sorted, independent Specifies the name of the field on which tasks will be sorted, independent
of what is reflected in the configuration file. of what is reflected in the configuration file.
You can prepend a '+' or '\-' to the field name to also override the sort direction. You can prepend a '+' or '\-' to the field name to also override the sort direction.
@ -356,14 +356,14 @@ This option exists primarily to support automated/scripted batch mode
operation. operation.
.TP 5 .TP 5
\-\fBO\fR :\fI Output-field-names \fR \-\fBO\fR\ \ :\fIOutput-field-names \fR
This option acts as a form of help for the above \-o option. This option acts as a form of help for the above \-o option.
It will cause \*(We to print each of the available field names on a It will cause \*(We to print each of the available field names on a
separate line, then quit. separate line, then quit.
Such names are subject to nls translation. Such names are subject to nls translation.
.TP 5 .TP 5
\-\fBp\fR :\fI Monitor-PIDs\fR mode as:\fB\ \ \-pN1 -pN2 ...\fR\ \ or\fB\ \ \-pN1,N2,N3 ... \fR \-\fBp\fR\ \ :\fIMonitor-PIDs\fR mode as:\fB\ \ \-pN1 -pN2 ...\fR\ \ or\fB\ \ \-pN1,N2,N3 ... \fR
Monitor only processes with specified process IDs. Monitor only processes with specified process IDs.
This option can be given up to \*(WP times, or you can provide a comma delimited This option can be given up to \*(WP times, or you can provide a comma delimited
list with up to \*(WP pids. list with up to \*(WP pids.
@ -379,20 +379,20 @@ of these \*(CIs: '=', 'u' or 'U'.
The 'p', 'u' and 'U' \*(COs are mutually exclusive. The 'p', 'u' and 'U' \*(COs are mutually exclusive.
.TP 5 .TP 5
\-\fBs\fR :\fI Secure-mode\fR operation \fR \-\fBs\fR\ \ :\fISecure-mode\fR operation \fR
Starts \*(We with secure mode forced, even for root. Starts \*(We with secure mode forced, even for root.
This mode is far better controlled through the system \*(CF This mode is far better controlled through the system \*(CF
(\*(Xt 6. FILES). (\*(Xt 6. FILES).
.TP 5 .TP 5
\-\fBS\fR :\fI Cumulative-time\fR toggle \fR \-\fBS\fR\ \ :\fICumulative-time\fR toggle \fR
Starts \*(We with the last remembered 'S' state reversed. Starts \*(We with the last remembered 'S' state reversed.
When 'Cumulative time' mode is \*O, each process is listed with the \*(Pu When 'Cumulative time' mode is \*O, each process is listed with the \*(Pu
time that it and its dead children have used. time that it and its dead children have used.
\*(XC 'S' \*(CI for additional information regarding this mode. \*(XC 'S' \*(CI for additional information regarding this mode.
.TP 5 .TP 5
\-\fBu\fR | \-\fBU\fR :\fI User-filter-mode\fR as:\ \ \fB-u\fR | \fB-U number\fR or\fB name \fR \-\fBu\fR | \-\fBU\fR\ \ :\fIUser-filter-mode\fR as:\ \ \fB-u\fR | \fB-U number\fR or\fB name \fR
Display only processes with a user id or user name matching that given. Display only processes with a user id or user name matching that given.
The '\-u' option matches on \fI effective\fR user whereas the '\-U' option The '\-u' option matches on \fI effective\fR user whereas the '\-U' option
matches on\fI any\fR user (real, effective, saved, or filesystem). matches on\fI any\fR user (real, effective, saved, or filesystem).
@ -403,7 +403,7 @@ display only processes with users not matching the one provided.
The 'p', 'u' and 'U' \*(COs are mutually exclusive. The 'p', 'u' and 'U' \*(COs are mutually exclusive.
.TP 5 .TP 5
\-\fBw\fR :\fI Output-width-override\fR as:\ \ \fB-w\fR [\fB number\fR ] \fR \-\fBw\fR\ \ :\fIOutput-width-override\fR as:\ \ \fB-w\fR [\fB number\fR ] \fR
In 'Batch' mode, when used without an argument \*(We will format In 'Batch' mode, when used without an argument \*(We will format
output using the COLUMNS= and LINES= environment variables, if set. output using the COLUMNS= and LINES= environment variables, if set.
Otherwise, width will be fixed at the maximum \*(WX columns. Otherwise, width will be fixed at the maximum \*(WX columns.
@ -682,11 +682,11 @@ The\fI real\fR user name.
.TP 4 .TP 4
20.\fB S \*(Em Process Status \fR 20.\fB S \*(Em Process Status \fR
The status of the task which can be one of: The status of the task which can be one of:
'\fBD\fR' = uninterruptible sleep \fBD\fR = uninterruptible sleep
'\fBR\fR' = running \fBR\fR = running
'\fBS\fR' = sleeping \fBS\fR = sleeping
'\fBT\fR' = traced or stopped \fBT\fR = traced or stopped
'\fBZ\fR' = zombie \fBZ\fR = zombie
Tasks shown as running should be more properly thought of as 'ready to run' Tasks shown as running should be more properly thought of as 'ready to run'
\*(Em their task_struct is simply represented on the Linux run-queue. \*(Em their task_struct is simply represented on the Linux run-queue.
@ -940,7 +940,7 @@ secured, simply ask for help and view the system summary on the second
line. line.
.TP 7 .TP 7
\ \ <\fBEnter\fR> or <\fBSpace\fR> :\fIRefresh-Display \fR \ \ <\fBEnter\fR> or <\fBSpace\fR>\ \ :\fIRefresh-Display \fR
These commands awaken \*(We and following receipt of any input These commands awaken \*(We and following receipt of any input
the entire display will be repainted. the entire display will be repainted.
They also force an update of any hotplugged \*(Pu or \*(MP changes. They also force an update of any hotplugged \*(Pu or \*(MP changes.
@ -949,7 +949,7 @@ Use either of these keys if you have a large delay interval and wish
to see current status, to see current status,
.TP 7 .TP 7
\ \ \'\fB?\fR\' | \'\fBh\fR\' :\fIHelp \fR \ \ \ \fB?\fR | \fBh\fR\ \ :\fIHelp \fR
There are two help levels available. There are two help levels available.
The first will provide a reminder of all the basic \*(CIs. The first will provide a reminder of all the basic \*(CIs.
If \*(We is\fI secured\fR, that screen will be abbreviated. If \*(We is\fI secured\fR, that screen will be abbreviated.
@ -958,7 +958,7 @@ Typing 'h' or '?' on that help screen will take you to help for
those \*(CIs applicable to \*(AM. those \*(CIs applicable to \*(AM.
.TP 7 .TP 7
\ \ \'\fB=\fR\' :\fIExit-Task-Limits \fR \ \ \ \fB=\fR\ \ :\fIExit-Task-Limits \fR
Removes restrictions on which tasks are shown. Removes restrictions on which tasks are shown.
This command will reverse any 'i' (idle tasks) and 'n' (max tasks) This command will reverse any 'i' (idle tasks) and 'n' (max tasks)
commands that might be active. commands that might be active.
@ -975,19 +975,19 @@ vertical and horizontal scrolling.
When operating in \*(AM this command has a broader meaning. When operating in \*(AM this command has a broader meaning.
.TP 7 .TP 7
\ \ \'\fB0\fR\' :\fIZero-Suppress\fR toggle \fR \ \ \ \fB0\fR\ \ :\fIZero-Suppress\fR toggle \fR
This command determines whether zeros are shown or suppressed for many This command determines whether zeros are shown or suppressed for many
of the fields in a \*(TW. of the fields in a \*(TW.
Fields like UID, GID, NI, PR or P are not affected by this toggle. Fields like UID, GID, NI, PR or P are not affected by this toggle.
.TP 7 .TP 7
\ \ \'\fBA\fR\' :\fIAlternate-Display-Mode\fR toggle \fR \ \ \ \fBA\fR\ \ :\fIAlternate-Display-Mode\fR toggle \fR
This command will switch between \*(FM and \*(AM. This command will switch between \*(FM and \*(AM.
\*(XT 5. ALTERNATE\-DISPLAY Provisions and the 'g' \*(CI for insight \*(XT 5. ALTERNATE\-DISPLAY Provisions and the 'g' \*(CI for insight
into \*(CWs and \*(FGs. into \*(CWs and \*(FGs.
.TP 7 .TP 7
\ \ \'\fBB\fR\' :\fIBold-Disable/Enable\fR toggle \fR \ \ \ \fBB\fR\ \ :\fIBold-Disable/Enable\fR toggle \fR
This command will influence use of the 'bold' terminfo capability and This command will influence use of the 'bold' terminfo capability and
alters\fB both\fR the \*(SA and \*(TA for the \*(CW. alters\fB both\fR the \*(SA and \*(TA for the \*(CW.
While it is intended primarily for use with dumb terminals, it can be While it is intended primarily for use with dumb terminals, it can be
@ -999,7 +999,7 @@ Thus, unless the 'x' and/or 'y' toggles are using reverse for emphasis,
there will be no visual confirmation that they are even on. there will be no visual confirmation that they are even on.
.TP 7 .TP 7
*\ \'\fBd\fR\' | \'\fBs\fR\' :\fIChange-Delay-Time-interval \fR *\ \ \fBd\fR | \fBs\fR\ \ :\fIChange-Delay-Time-interval \fR
You will be prompted to enter the delay time, in seconds, between You will be prompted to enter the delay time, in seconds, between
display updates. display updates.
@ -1013,7 +1013,7 @@ If at any time you wish to know the current delay time, simply ask for
help and view the system summary on the second line. help and view the system summary on the second line.
.TP 7 .TP 7
\ \ \'\fBE\fR\' :\fIExtend-Memory-Scale\fR in Summary Area \ \ \ \fBE\fR\ \ :\fIExtend-Memory-Scale\fR in Summary Area
With this command you can cycle through the available \*(SA memory scaling With this command you can cycle through the available \*(SA memory scaling
which ranges from KiB (kibibytes or 1,024 bytes) through EiB (exbibytes or which ranges from KiB (kibibytes or 1,024 bytes) through EiB (exbibytes or
1,152,921,504,606,846,976 bytes). 1,152,921,504,606,846,976 bytes).
@ -1023,7 +1023,7 @@ means that \*(We was forced to truncate some portion of that number.
By raising the scaling factor, such truncation can be avoided. By raising the scaling factor, such truncation can be avoided.
.TP 7 .TP 7
\ \ \'\fBe\fR\' :\fIExtend-Memory-Scale\fR in Task Windows \ \ \ \fBe\fR\ \ :\fIExtend-Memory-Scale\fR in Task Windows
With this command you can cycle through the available \*(TW memory scaling With this command you can cycle through the available \*(TW memory scaling
which ranges from KiB (kibibytes or 1,024 bytes) through PiB (pebibytes or which ranges from KiB (kibibytes or 1,024 bytes) through PiB (pebibytes or
1,125,899,906,842,624 bytes). 1,125,899,906,842,624 bytes).
@ -1036,26 +1036,26 @@ Raising it too high, however, is likely to produce an all zero result
which cannot be suppressed with the '0' \*(CI. which cannot be suppressed with the '0' \*(CI.
.TP 7 .TP 7
\ \ \'\fBg\fR\' :\fIChoose-Another-Window/Field-Group \fR \ \ \ \fBg\fR\ \ :\fIChoose-Another-Window/Field-Group \fR
You will be prompted to enter a number between 1 and 4 designating the You will be prompted to enter a number between 1 and 4 designating the
\*(FG which should be made the \*(CW. \*(FG which should be made the \*(CW.
You will soon grow comfortable with these 4 windows, especially after You will soon grow comfortable with these 4 windows, especially after
experimenting with \*(AM. experimenting with \*(AM.
.TP 7 .TP 7
\ \ \'\fBH\fR\' :\fIThreads-mode\fR toggle \fR \ \ \ \fBH\fR\ \ :\fIThreads-mode\fR toggle \fR
When this toggle is \*O, individual threads will be displayed for all When this toggle is \*O, individual threads will be displayed for all
processes in all visible \*(TWs. processes in all visible \*(TWs.
Otherwise, \*(We displays a summation of all threads in each process. Otherwise, \*(We displays a summation of all threads in each process.
.TP 7 .TP 7
\ \ \'\fBI\fR\' :\fIIrix/Solaris-Mode\fR toggle \fR \ \ \ \fBI\fR\ \ :\fIIrix/Solaris-Mode\fR toggle \fR
When operating in 'Solaris mode' ('I' toggled \*F), a task's \*(Pu usage When operating in 'Solaris mode' ('I' toggled \*F), a task's \*(Pu usage
will be divided by the total number of \*(PUs. will be divided by the total number of \*(PUs.
After issuing this command, you'll be told the new state of this toggle. After issuing this command, you'll be told the new state of this toggle.
.TP 7 .TP 7
*\ \'\fBk\fR\' :\fIKill-a-task \fR *\ \ \fBk\fR\ \ :\fIKill-a-task \fR
You will be prompted for a PID and then the signal to send. You will be prompted for a PID and then the signal to send.
Entering no PID or a negative number will be interpreted as Entering no PID or a negative number will be interpreted as
@ -1073,10 +1073,10 @@ depending on your progress:
.Ed .Ed
.TP 7 .TP 7
\ \ \'\fBq\fR\' :\fIQuit \fR \ \ \ \fBq\fR\ \ :\fIQuit \fR
.TP 7 .TP 7
*\ \'\fBr\fR\' :\fIRenice-a-Task \fR *\ \ \fBr\fR\ \ :\fIRenice-a-Task \fR
You will be prompted for a PID and then the value to nice it to. You will be prompted for a PID and then the value to nice it to.
Entering no PID or a negative number will be interpreted as Entering no PID or a negative number will be interpreted as
@ -1097,14 +1097,14 @@ depending on your progress:
.Ed .Ed
.TP 7 .TP 7
\ \ \'\fBW\fR\' :\fIWrite-the-Configuration-File \fR \ \ \ \fBW\fR\ \ :\fIWrite-the-Configuration-File \fR
This will save all of your options and toggles plus the current This will save all of your options and toggles plus the current
display mode and delay time. display mode and delay time.
By issuing this command just before quitting \*(We, you will be able By issuing this command just before quitting \*(We, you will be able
restart later in exactly that same state. restart later in exactly that same state.
.TP 7 .TP 7
\ \ \'\fBX\fR\' :\fIExtra-Fixed-Width \fR \ \ \ \fBX\fR\ \ :\fIExtra-Fixed-Width \fR
Some fields are fixed width and not scalable. Some fields are fixed width and not scalable.
As such, they are subject to truncation which would be indicated As such, they are subject to truncation which would be indicated
by a '+' in the last position. by a '+' in the last position.
@ -1134,7 +1134,7 @@ these fields are never decreased by \*(We.
To narrow them you must specify a smaller number or restore the defaults. To narrow them you must specify a smaller number or restore the defaults.
.TP 7 .TP 7
\ \ \'\fBY\fR\' :\fIInspect-Other-Output \fR \ \ \ \fBY\fR\ \ :\fIInspect-Other-Output \fR
After issuing the 'Y' \*(CI, you will be prompted for a target PID. After issuing the 'Y' \*(CI, you will be prompted for a target PID.
Typing a value or accepting the default results in a separate screen. Typing a value or accepting the default results in a separate screen.
That screen can be used to view a variety of files or piped command output That screen can be used to view a variety of files or piped command output
@ -1163,7 +1163,7 @@ summarized here for future reference.
.Ed .Ed
.TP 7 .TP 7
\ \ \'\fBZ\fR\' :\fIChange-Color-Mapping \fR \ \ \ \fBZ\fR\ \ :\fIChange-Color-Mapping \fR
This key will take you to a separate screen where you can change the This key will take you to a separate screen where you can change the
colors for the \*(CW, or for all windows. colors for the \*(CW, or for all windows.
For details regarding this \*(CI \*(Xt 4d. COLOR Mapping. For details regarding this \*(CI \*(Xt 4d. COLOR Mapping.
@ -1184,18 +1184,18 @@ These commands always impact just the \*(CG.
\*(CWs and \*(FGs. \*(CWs and \*(FGs.
.TP 7 .TP 7
\ \ \'\fBC\fR' :\fIShow-scroll-coordinates\fR toggle \fR \ \ \ \fBC\fR\ \ :\fIShow-scroll-coordinates\fR toggle \fR
Toggle an informational message which is displayed whenever the message Toggle an informational message which is displayed whenever the message
line is not otherwise being used. line is not otherwise being used.
For additional information \*(Xt 5c. SCROLLING a Window. For additional information \*(Xt 5c. SCROLLING a Window.
.TP 7 .TP 7
\ \ \'\fBl\fR\' :\fILoad-Average/Uptime\fR toggle \fR \ \ \ \fBl\fR\ \ :\fILoad-Average/Uptime\fR toggle \fR
This is also the line containing the program name (possibly an alias) This is also the line containing the program name (possibly an alias)
when operating in \*(FM or the \*(CW name when operating in \*(AM. when operating in \*(FM or the \*(CW name when operating in \*(AM.
.TP 7 .TP 7
\ \ \'\fBt\fR\' :\fITask/Cpu-States\fR toggle \fR \ \ \ \fBt\fR\ \ :\fITask/Cpu-States\fR toggle \fR
This command affects from 2 to many \*(SA lines, depending on the state This command affects from 2 to many \*(SA lines, depending on the state
of the '1', '2' or '3' \*(CTs and whether or not \*(We is running under of the '1', '2' or '3' \*(CTs and whether or not \*(We is running under
true SMP. true SMP.
@ -1204,12 +1204,12 @@ This portion of the \*(SA is also influenced by the 'H' \*(CI toggle,
as reflected in the total label which shows either 'Tasks' or 'Threads'. as reflected in the total label which shows either 'Tasks' or 'Threads'.
.TP 7 .TP 7
\ \ \'\fBm\fR\' :\fIMemory/Swap-Usage\fR toggle \fR \ \ \ \fBm\fR\ \ :\fIMemory/Swap-Usage\fR toggle \fR
This command affects the two \*(SA lines dealing with physical This command affects the two \*(SA lines dealing with physical
and virtual memory. and virtual memory.
.TP 7 .TP 7
\ \ \'\fB1\fR\' :\fISingle/Separate-Cpu-States\fR toggle \fR \ \ \ \fB1\fR\ \ :\fISingle/Separate-Cpu-States\fR toggle \fR
This command affects how the 't' command's Cpu States portion is shown. This command affects how the 't' command's Cpu States portion is shown.
Although this toggle exists primarily to serve massively-parallel SMP Although this toggle exists primarily to serve massively-parallel SMP
machines, it is not restricted to solely SMP environments. machines, it is not restricted to solely SMP environments.
@ -1220,13 +1220,13 @@ Otherwise, each \*(Pu is displayed separately as: '%Cpu0, %Cpu1, ...'
up to available screen height. up to available screen height.
.TP 7 .TP 7
\ \ \'\fB2\fR\' :\fINUMA-Nodes/Cpu-Summary\fR toggle \fR \ \ \ \fB2\fR\ \ :\fINUMA-Nodes/Cpu-Summary\fR toggle \fR
This command toggles between the '1' command cpu summary display (only) This command toggles between the '1' command cpu summary display (only)
or a summary display plus the cpu usage statistics for each NUMA Node. or a summary display plus the cpu usage statistics for each NUMA Node.
It is only available if a system has the requisite NUMA support. It is only available if a system has the requisite NUMA support.
.TP 7 .TP 7
\ \ \'\fB3\fR\' :\fIExpand-NUMA-Node \fR \ \ \ \fB3\fR\ \ :\fIExpand-NUMA-Node \fR
You will be invited to enter a number representing a NUMA Node. You will be invited to enter a number representing a NUMA Node.
Thereafter, a node summary plus the statistics for each cpu in that Thereafter, a node summary plus the statistics for each cpu in that
node will be shown until either the '1' or '2' \*(CT is pressed. node will be shown until either the '1' or '2' \*(CT is pressed.
@ -1251,14 +1251,14 @@ The \*(TA \*(CIs are\fB never available\fR in \*(AM\fI if\fR the \*(CW's
.B APPEARANCE\fR of \*(TW .B APPEARANCE\fR of \*(TW
.PD 0 .PD 0
.TP 7 .TP 7
\ \ \'\fBJ\fR\' :\fIJustify-Numeric-Columns\fR toggle \fR \ \ \ \fBJ\fR\ \ :\fIJustify-Numeric-Columns\fR toggle \fR
Alternates between right-justified (the default) and Alternates between right-justified (the default) and
left-justified numeric data. left-justified numeric data.
If the numeric data completely fills the available column, this If the numeric data completely fills the available column, this
\*(CT may impact the column header only. \*(CT may impact the column header only.
.TP 7 .TP 7
\ \ \'\fBj\fR\' :\fIJustify-Character-Columns\fR toggle \fR \ \ \ \fBj\fR\ \ :\fIJustify-Character-Columns\fR toggle \fR
Alternates between left-justified (the default) and Alternates between left-justified (the default) and
right-justified character data. right-justified character data.
If the character data completely fills the available column, this If the character data completely fills the available column, this
@ -1271,12 +1271,12 @@ global 'B' (bold enable) toggle.
.RS -2 .RS -2
.TP 7 .TP 7
\ \ \'\fBb\fR\' :\fIBold/Reverse\fR toggle \fR \ \ \ \fBb\fR\ \ :\fIBold/Reverse\fR toggle \fR
This command will impact how the 'x' and 'y' toggles are displayed. This command will impact how the 'x' and 'y' toggles are displayed.
Further, it will only be available when at least one of those toggles is \*O. Further, it will only be available when at least one of those toggles is \*O.
.TP 7 .TP 7
\ \ \'\fBx\fR\' :\fIColumn-Highlight\fR toggle \fR \ \ \ \fBx\fR\ \ :\fIColumn-Highlight\fR toggle \fR
Changes highlighting for the current sort field. Changes highlighting for the current sort field.
If you forget which field is being sorted this command can serve as a quick If you forget which field is being sorted this command can serve as a quick
visual reminder, providing the sort field is being displayed. visual reminder, providing the sort field is being displayed.
@ -1285,7 +1285,7 @@ The sort field might\fI not\fR be visible because:
2) the 'f' \*(CI turned it \*F 2) the 'f' \*(CI turned it \*F
.TP 7 .TP 7
\ \ \'\fBy\fR\' :\fIRow-Highlight\fR toggle \fR \ \ \ \fBy\fR\ \ :\fIRow-Highlight\fR toggle \fR
Changes highlighting for "running" tasks. Changes highlighting for "running" tasks.
For additional insight into this task state, For additional insight into this task state,
\*(Xt 3a. DESCRIPTIONS of Fields, the 'S' field (Process Status). \*(Xt 3a. DESCRIPTIONS of Fields, the 'S' field (Process Status).
@ -1294,7 +1294,7 @@ Use of this provision provides important insight into your system's health.
The only costs will be a few additional tty escape sequences. The only costs will be a few additional tty escape sequences.
.TP 7 .TP 7
\ \ \'\fBz\fR\' :\fIColor/Monochrome\fR toggle \fR \ \ \ \fBz\fR\ \ :\fIColor/Monochrome\fR toggle \fR
Switches the \*(CW between your last used color scheme and the older form Switches the \*(CW between your last used color scheme and the older form
of black-on-white or white-on-black. of black-on-white or white-on-black.
This command will alter\fB both\fR the \*(SA and \*(TA but does not affect This command will alter\fB both\fR the \*(SA and \*(TA but does not affect
@ -1305,20 +1305,20 @@ the state of the 'x', 'y' or 'b' toggles.
.B CONTENT\fR of \*(TW .B CONTENT\fR of \*(TW
.PD 0 .PD 0
.TP 7 .TP 7
\ \ \'\fBc\fR\' :\fICommand-Line/Program-Name\fR toggle \fR \ \ \ \fBc\fR\ \ :\fICommand-Line/Program-Name\fR toggle \fR
This command will be honored whether or not the 'COMMAND' column This command will be honored whether or not the 'COMMAND' column
is currently visible. is currently visible.
Later, should that field come into view, the change you applied will be seen. Later, should that field come into view, the change you applied will be seen.
.TP 7 .TP 7
\ \ \'\fBf\fR\' | \'\fBF\fR\' :\fIFields-Management \fR \ \ \ \fBf\fR | \fBF\fR\ \ :\fIFields-Management \fR
These keys display a separate screen where you can change which fields are These keys display a separate screen where you can change which fields are
displayed, their order and also designate the sort field. displayed, their order and also designate the sort field.
For additional information on these \*(CIs For additional information on these \*(CIs
\*(Xt 3b. MANAGING Fields. \*(Xt 3b. MANAGING Fields.
.TP 7 .TP 7
\ \ \'\fBo\fR' | '\fBO\fR' :\fIOther-Filtering \fR \ \ \ \fBo\fR | \fBO\fR\ \ :\fIOther-Filtering \fR
You will be prompted for the selection criteria which then determines You will be prompted for the selection criteria which then determines
which tasks will be shown in the \*(CW. which tasks will be shown in the \*(CW.
Your criteria can be made case sensitive or case can be ignored. Your criteria can be made case sensitive or case can be ignored.
@ -1328,7 +1328,7 @@ And you determine if \*(We should include or exclude matching tasks.
related \*(CIs. related \*(CIs.
.TP 7 .TP 7
\ \ \'\fBS\fR\' :\fICumulative-Time-Mode\fR toggle \fR \ \ \ \fBS\fR\ \ :\fICumulative-Time-Mode\fR toggle \fR
When 'Cumulative mode' is \*O, each process is listed with the \*(Pu When 'Cumulative mode' is \*O, each process is listed with the \*(Pu
time that it and its dead children have used. time that it and its dead children have used.
@ -1344,7 +1344,7 @@ If you wish to know in advance whether or not 'Cumulative mode' is in
effect, simply ask for help and view the window summary on the second line. effect, simply ask for help and view the window summary on the second line.
.TP 7 .TP 7
\ \ \'\fBu\fR' | '\fBU\fR' :\fIShow-Specific-User-Only \fR \ \ \ \fBu\fR | \fBU\fR\ \ :\fIShow-Specific-User-Only \fR
You will be prompted for the\fB uid\fR or\fB name\fR of the user to display. You will be prompted for the\fB uid\fR or\fB name\fR of the user to display.
The '\-u' option matches on \fB effective\fR user whereas the '\-U' option The '\-u' option matches on \fB effective\fR user whereas the '\-U' option
matches on\fB any\fR user (real, effective, saved, or filesystem). matches on\fB any\fR user (real, effective, saved, or filesystem).
@ -1359,7 +1359,7 @@ Later, if you wish to monitor all users again in the \*(CW, re-issue this
command but just press <Enter> at the prompt. command but just press <Enter> at the prompt.
.TP 7 .TP 7
\ \ \'\fBV\fR' :\fIForest-View-Mode\fR toggle \fR \ \ \ \fBV\fR\ \ :\fIForest-View-Mode\fR toggle \fR
In this mode, processes are reordered according to their parents and In this mode, processes are reordered according to their parents and
the layout of the COMMAND column resembles that of a tree. the layout of the COMMAND column resembles that of a tree.
In forest view mode it is still possible to toggle between program In forest view mode it is still possible to toggle between program
@ -1375,7 +1375,7 @@ mode in the \*(CW.
.B SIZE\fR of \*(TW .B SIZE\fR of \*(TW
.PD 0 .PD 0
.TP 7 .TP 7
\ \ \'\fBi\fR\' :\fIIdle-Process\fR toggle \fR \ \ \ \fBi\fR\ \ :\fIIdle-Process\fR toggle \fR
Displays all tasks or just active tasks. Displays all tasks or just active tasks.
When this toggle is \*F, tasks that have not used any \*(PU since the When this toggle is \*F, tasks that have not used any \*(PU since the
last update will not be displayed. last update will not be displayed.
@ -1387,7 +1387,7 @@ If this command is applied to the last \*(TD when in \*(AM, then it will not
affect the window's size, as all prior \*(TDs will have already been painted. affect the window's size, as all prior \*(TDs will have already been painted.
.TP 7 .TP 7
\ \ \'\fBn\fR\' | \'\fB#\fR\' :\fISet-Maximum-Tasks \fR \ \ \ \fBn\fR | \fB#\fR\ \ :\fISet-Maximum-Tasks \fR
You will be prompted to enter the number of tasks to display. You will be prompted to enter the number of tasks to display.
The lessor of your number and available screen rows will be used. The lessor of your number and available screen rows will be used.
@ -1425,12 +1425,12 @@ The sort field might\fI not\fR be visible because:
2) the 'f' \*(CI turned it \*F 2) the 'f' \*(CI turned it \*F
.TP 7 .TP 7
\ \ \'\fB<\fR\' :\fIMove-Sort-Field-Left \fR \ \ \ \fB<\fR\ \ :\fIMove-Sort-Field-Left \fR
Moves the sort column to the left unless the current sort field is Moves the sort column to the left unless the current sort field is
the first field being displayed. the first field being displayed.
.TP 7 .TP 7
\ \ \'\fB>\fR\' :\fIMove-Sort-Field-Right \fR \ \ \ \fB>\fR\ \ :\fIMove-Sort-Field-Right \fR
Moves the sort column to the right unless the current sort field is Moves the sort column to the right unless the current sort field is
the last field being displayed. the last field being displayed.
@ -1441,14 +1441,14 @@ the current sort field is visible.
.in .in
.TP 7 .TP 7
\ \ \'\fBf\fR\' | \'\fBF\fR\' :\fIFields-Management \fR \ \ \ \fBf\fR | \fBF\fR\ \ :\fIFields-Management \fR
These keys display a separate screen where you can change which field These keys display a separate screen where you can change which field
is used as the sort column, among other functions. is used as the sort column, among other functions.
This can be a convenient way to simply verify the current sort field, This can be a convenient way to simply verify the current sort field,
when running \*(We with column highlighting turned \*F. when running \*(We with column highlighting turned \*F.
.TP 7 .TP 7
\ \ \'\fBR\fR\' :\fIReverse/Normal-Sort-Field\fR toggle \fR \ \ \ \fBR\fR\ \ :\fIReverse/Normal-Sort-Field\fR toggle \fR
Using this \*(CI you can alternate between high-to-low and low-to-high sorts. Using this \*(CI you can alternate between high-to-low and low-to-high sorts.
.PP .PP
@ -1527,7 +1527,7 @@ know what window is the \*(CW.
.SS 5b. COMMANDS for Windows .SS 5b. COMMANDS for Windows
.\" ---------------------------------------------------------------------- .\" ----------------------------------------------------------------------
.TP 7 .TP 7
\ \ \'\fB-\fR\' | \'\fB_\fR\' :\fIShow/Hide-Window(s)\fR toggles \fR \ \ \ \fB-\fR | \fB_\fR\ \ :\fIShow/Hide-Window(s)\fR toggles \fR
The '\-' key turns the \*(CW's \*(TD \*O and \*F. The '\-' key turns the \*(CW's \*(TD \*O and \*F.
When \*O, that \*(TA will show a minimum of the columns header you've When \*O, that \*(TA will show a minimum of the columns header you've
established with the 'f' \*(CI. established with the 'f' \*(CI.
@ -1541,7 +1541,7 @@ If all 4 \*(TDs are currently visible, this \*(CI will leave the \*(SA
as the only display element. as the only display element.
.TP 7 .TP 7
*\ \'\fB=\fR\' | \'\fB+\fR\' :\fIEqualize-(reinitialize)-Window(s) \fR *\ \ \fB=\fR | \fB+\fR\ \ :\fIEqualize-(reinitialize)-Window(s) \fR
The '=' key forces the \*(CW's \*(TD to be visible. The '=' key forces the \*(CW's \*(TD to be visible.
It also reverses any 'i' (idle tasks), 'n' (max tasks), 'u'/'U' (user filter) It also reverses any 'i' (idle tasks), 'n' (max tasks), 'u'/'U' (user filter)
and 'o'/'O' (other filter) commands that might be active. and 'o'/'O' (other filter) commands that might be active.
@ -1556,7 +1556,7 @@ except for the 'i' (idle tasks), 'n' (max tasks), 'u'/'U' (user filter),
'o'/'O' (other filter) and scrolling \*(CIs. 'o'/'O' (other filter) and scrolling \*(CIs.
.TP 7 .TP 7
*\ \'\fBA\fR\' :\fIAlternate-Display-Mode\fR toggle \fR *\ \ \fBA\fR\ \ :\fIAlternate-Display-Mode\fR toggle \fR
This command will switch between \*(FM and \*(AM. This command will switch between \*(FM and \*(AM.
The first time you issue this command, all four \*(TDs will be shown. The first time you issue this command, all four \*(TDs will be shown.
@ -1564,7 +1564,7 @@ Thereafter when you switch modes, you will see only the \*(TD(s) you've
chosen to make visible. chosen to make visible.
.TP 7 .TP 7
*\ \'\fBa\fR\' | \'\fBw\fR\' :\fINext-Window-Forward/Backward \fR *\ \ \fBa\fR | \fBw\fR\ \ :\fINext-Window-Forward/Backward \fR
This will change the \*(CW, which in turn changes the window to which This will change the \*(CW, which in turn changes the window to which
commands are directed. commands are directed.
These keys act in a circular fashion so you can reach any desired \*(CW These keys act in a circular fashion so you can reach any desired \*(CW
@ -1575,7 +1575,7 @@ whenever the \*(CW name loses its emphasis/color, that's a reminder
the \*(TD is \*F and many commands will be restricted. the \*(TD is \*F and many commands will be restricted.
.TP 7 .TP 7
*\ \'\fBg\fR\' :\fIChoose-Another-Window/Field-Group \fR *\ \ \fBg\fR\ \ :\fIChoose-Another-Window/Field-Group \fR
You will be prompted to enter a number between 1 and 4 designating the You will be prompted to enter a number between 1 and 4 designating the
\*(FG which should be made the \*(CW. \*(FG which should be made the \*(CW.
@ -1584,7 +1584,7 @@ In \*(AM, it is simply a less convenient alternative to the 'a' and 'w'
commands. commands.
.TP 7 .TP 7
\ \ \'\fBG\fR\' :\fIChange-Window/Field-Group-Name \fR \ \ \ \fBG\fR\ \ :\fIChange-Window/Field-Group-Name \fR
You will be prompted for a new name to be applied to the \*(CW. You will be prompted for a new name to be applied to the \*(CW.
It does not require that the window name be visible It does not require that the window name be visible
(the 'l' toggle to be \*O). (the 'l' toggle to be \*O).
@ -1606,21 +1606,21 @@ With these \*(KSs, you can move that view vertically or horizontally to
reveal any desired task or column. reveal any desired task or column.
.TP 4 .TP 4
\fBUp\fR,\fBPgUp\fR :\fIScroll-Tasks \fR \fBUp\fR,\fBPgUp\fR\ \ :\fIScroll-Tasks \fR
Move the view up toward the first task row, until the first task is Move the view up toward the first task row, until the first task is
displayed at the top of the \*(CW. displayed at the top of the \*(CW.
The \fIUp\fR \*(KA moves a single line while \fIPgUp\fR scrolls the The \fIUp\fR \*(KA moves a single line while \fIPgUp\fR scrolls the
entire window. entire window.
.TP 4 .TP 4
\fBDown\fR,\fBPgDn\fR :\fIScroll-Tasks \fR \fBDown\fR,\fBPgDn\fR\ \ :\fIScroll-Tasks \fR
Move the view down toward the last task row, until the last task is Move the view down toward the last task row, until the last task is
the only task displayed at the top of the \*(CW. the only task displayed at the top of the \*(CW.
The \fIDown\fR \*(KA moves a single line while \fIPgDn\fR scrolls the The \fIDown\fR \*(KA moves a single line while \fIPgDn\fR scrolls the
entire window. entire window.
.TP 4 .TP 4
\fBLeft\fR,\fBRight\fR :\fIScroll-Columns \fR \fBLeft\fR,\fBRight\fR\ \ :\fIScroll-Columns \fR
Move the view of displayable fields horizontally one column at a time. Move the view of displayable fields horizontally one column at a time.
\*(NT As a reminder, some fields/columns are not fixed-width but \*(NT As a reminder, some fields/columns are not fixed-width but
@ -1635,11 +1635,11 @@ column shown, you can continue scrolling horizontally within such a field.
\*(XC 'C' \*(CI below for additional information. \*(XC 'C' \*(CI below for additional information.
.TP 4 .TP 4
\fBHome\fR :\fIJump-to-Home-Position \fR \fBHome\fR\ \ :\fIJump-to-Home-Position \fR
Reposition the display to the un-scrolled coordinates. Reposition the display to the un-scrolled coordinates.
.TP 4 .TP 4
\fBEnd\fR :\fIJump-to-End-Position \fR \fBEnd\fR\ \ :\fIJump-to-End-Position \fR
Reposition the display so that the rightmost column reflects the last Reposition the display so that the rightmost column reflects the last
displayable field and the bottom task row represents the last task. displayable field and the bottom task row represents the last task.
@ -1649,7 +1649,7 @@ This is true until a single column and a single task is left as the only
display element. display element.
.TP 4 .TP 4
'\fBC\fR' :\fIShow-scroll-coordinates\fR toggle \fR \fBC\fR\ \ :\fIShow-scroll-coordinates\fR toggle \fR
Toggle an informational message which is displayed whenever the message Toggle an informational message which is displayed whenever the message
line is not otherwise being used. line is not otherwise being used.
That message will take one of two forms depending on whether or not a That message will take one of two forms depending on whether or not a
@ -1696,7 +1696,7 @@ This is paticularly apparent when using the Up/Down \*(KAs.
You can use these \*(CIs to locate a task row containing a particular value. You can use these \*(CIs to locate a task row containing a particular value.
.TP 4 .TP 4
'\fBL\fR\' :\fILocate-a-string\fR \fBL\fR\ \ :\fILocate-a-string\fR
You will be prompted for the case-sensitive string to locate starting from You will be prompted for the case-sensitive string to locate starting from
the current window coordinates. the current window coordinates.
There are no restrictions on search string content. There are no restrictions on search string content.
@ -1709,7 +1709,7 @@ Keying <Enter> with no input will effectively disable the '&' key until
a new search string is entered. a new search string is entered.
.TP 4 .TP 4
'\fB&\fR\' :\fILocate-next\fR \fB&\fR\ \ :\fILocate-next\fR
Assuming a search string has been established, \*(We will attempt to locate Assuming a search string has been established, \*(We will attempt to locate
the next occurrence. the next occurrence.
@ -1788,26 +1788,26 @@ then be applied.
.B Keyboard Summary .B Keyboard Summary
.TP 6 .TP 6
\ \ '\fBo\fR' :\fIOther-Filter\fR (lower case) \ \ \fBo\fR\ \ :\fIOther-Filter\fR (lower case)
You will be prompted to establish a filter that \fBignores case\fR when You will be prompted to establish a filter that \fBignores case\fR when
matching. matching.
.TP 6 .TP 6
\ \ '\fBO\fR' :\fIOther-Filter\fR (upper case) \ \ \fBO\fR\ \ :\fIOther-Filter\fR (upper case)
You will be prompted to establish a \fBcase sensitive\fR filter. You will be prompted to establish a \fBcase sensitive\fR filter.
.TP 6 .TP 6
\ \ \fB^O\fR\ \ :\fIShow-Active-Filters\fR (Ctrl key + 'o') \ \fB^O\fR\ \ :\fIShow-Active-Filters\fR (Ctrl key + 'o')
This can serve as a reminder of which filters are active in the \*(CW. This can serve as a reminder of which filters are active in the \*(CW.
A summary will be shown on the message line until you press the <Enter> key. A summary will be shown on the message line until you press the <Enter> key.
.TP 6 .TP 6
\ \ '\fB=\fR' :\fIReset-Filtering\fR in current window \ \ \fB=\fR\ \ :\fIReset-Filtering\fR in current window
This clears all of your selection criteria in the \*(CW. This clears all of your selection criteria in the \*(CW.
It also has additional impact so please \*(Xt 4a. GLOBAL Commands. It also has additional impact so please \*(Xt 4a. GLOBAL Commands.
.TP 6 .TP 6
\ \ '\fB+\fR' :\fIReset-Filtering\fR in all windows \ \ \fB+\fR\ \ :\fIReset-Filtering\fR in all windows
This clears the selection criteria in all windows, assuming you are in \*(AM. This clears the selection criteria in all windows, assuming you are in \*(AM.
As with the '=' \*(CI, it too has additional consequences so you might wish to As with the '=' \*(CI, it too has additional consequences so you might wish to
\*(Xt 5b. COMMANDS for Windows. \*(Xt 5b. COMMANDS for Windows.
@ -2007,8 +2007,8 @@ Entries specifying '\fBpipe\fR' will employ popen, their '.fmts' element
could contain many pipelined commands and, none can be interactive. could contain many pipelined commands and, none can be interactive.
If the file or pipeline represented in your '.fmts' deals with the specific PID If the file or pipeline represented in your '.fmts' deals with the specific PID
input or accepted when prompted, then the format string must also contain the input or accepted when prompted, then the format string must also contain
'\fB%d\fR' specifier, as these examples illustrate. the '\fB%d\fR' specifier, as these examples illustrate.
.Bd -literal -compact .Bd -literal -compact
.fmts= /proc/\fI%d\fR/numa_maps .fmts= /proc/\fI%d\fR/numa_maps