doc: detail 'Ctrl' bottom window namespaces plus focus

[ along the way we will restore '^R' to keys summary ]
[ plus correct a leftover reference to 'Ctrl-V' too. ]

Signed-off-by: Jim Warner <james.warner@comcast.net>
This commit is contained in:
Jim Warner 2022-05-12 00:00:00 -05:00 committed by Craig Small
parent 659590b068
commit 381af1af81
2 changed files with 16 additions and 10 deletions

3
NEWS
View File

@ -9,7 +9,8 @@ procps-ng-NEXT
* top: column highlighting allowed under 'L' or 'O' * top: column highlighting allowed under 'L' or 'O'
* top: can alter autogroup nice value (like 'r' renice) * top: can alter autogroup nice value (like 'r' renice)
* top: can display the following with no need to scroll * top: can display the following with no need to scroll
* cmdline, control groups, environment, supp groups * cmdline, control groups, environment,
supplimentary groups, namespaces
procps-ng-4.0.0 procps-ng-4.0.0
--------------- ---------------

View File

@ -59,7 +59,7 @@ memory statistics and data for other users requires root privileges
. .
.\" Document ///////////////////////////////////////////////////////////// .\" Document /////////////////////////////////////////////////////////////
.\" ---------------------------------------------------------------------- .\" ----------------------------------------------------------------------
.TH TOP 1 "March 2022" "procps-ng" "User Commands" .TH TOP 1 "May 2022" "procps-ng" "User Commands"
.\" ---------------------------------------------------------------------- .\" ----------------------------------------------------------------------
.nh .nh
@ -1273,7 +1273,7 @@ depending on the context in which they are issued.
4a.\fI Global-Commands \fR 4a.\fI Global-Commands \fR
<Ent/Sp> ?, =, 0, <Ent/Sp> ?, =, 0,
A, B, d, E, e, g, H, h, I, k, q, r, s, W, X, Y, Z, A, B, d, E, e, g, H, h, I, k, q, r, s, W, X, Y, Z,
^G, ^K, ^U, ^V ^G, ^K, ^U, ^V, ^R
4b.\fI Summary-Area-Commands \fR 4b.\fI Summary-Area-Commands \fR
C, l, t, m, 1, 2, 3, 4, ! C, l, t, m, 1, 2, 3, 4, !
4c.\fI Task-Area-Commands \fR 4c.\fI Task-Area-Commands \fR
@ -1532,27 +1532,28 @@ 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.
.P .P
\ \ \ \fB^G\fR\ \ :\fIDisplay-Full-Control-Groups \fR (Ctrl key + `g') \ \ \ \fB^G\fR\ \ :\fIDisplay-Control-Groups \fR (Ctrl key + `g')
.br .br
\ \ \ \fB^K\fR\ \ :\fIDisplay-Full-Cmdline \fR (Ctrl key + `k') \ \ \ \fB^K\fR\ \ :\fIDisplay-Cmdline \fR (Ctrl key + `k')
.br .br
\ \ \ \fB^N\fR\ \ :\fIDisplay-Full-Environment \fR (Ctrl key + `n') \ \ \ \fB^N\fR\ \ :\fIDisplay-Environment \fR (Ctrl key + `n')
.br .br
\ \ \ \fB^U\fR\ \ :\fIDisplay-Full-Supplementary-Groups \fR (Ctrl key + `u') \ \ \ \fB^P\fR\ \ :\fIDisplay-Namesspaces \fR (Ctrl key + `p')
.br
\ \ \ \fB^U\fR\ \ :\fIDisplay-Supplementary-Groups \fR (Ctrl key + `u')
.br .br
.RS +7 .RS +7
Applied to the first process displayed, these commands will show Applied to the first process displayed, these commands will show
that task's full (potentially wrapped) information. that task's full (potentially wrapped) information.
Such data will be displayed in a separate window at the bottom of Such data will be displayed in a separate window at the bottom of
the screen. the screen while normal \*(We monitoring continues.
Keying the\fI same\fR `Ctrl' command a second time removes that Keying the\fI same\fR `Ctrl' command a second time removes that
separate window as does the `=' command. separate window as does the `=' command.
Keying a different `Ctrl' combination, while one is already active, Keying a different `Ctrl' combination, while one is already active,
immediately transitions to the new information. immediately transitions to the new information.
Notable among these provisions is the Ctrl+V (environment) command. Notable among these provisions is the Ctrl+N (environment) command.
Its output can be extensive and not easily read when line wrapped. Its output can be extensive and not easily read when line wrapped.
A more readable version can be achieved with an `Inspect' entry A more readable version can be achieved with an `Inspect' entry
in the rcfile like the following. in the rcfile like the following.
@ -1563,6 +1564,10 @@ in the rcfile like the following.
\*(XC `Y' \*(CI above and topic 6b. ADDING INSPECT Entries for \*(XC `Y' \*(CI above and topic 6b. ADDING INSPECT Entries for
additional information. additional information.
As an alternative to `Inspect', and available to all of these `Ctrl'
commands, the tab key can be used to highlight individual elements
in the bottom window.
.RS -7 .RS -7
.TP 7 .TP 7