doc: detail 'Ctrl' bottom window namespaces plus focus <=== port of newlib 381af1af

______________________________ original newlib message

[ 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-06-15 00:00:00 -05:00 committed by Craig Small
parent a103b364f3
commit 27c8671ba3
2 changed files with 15 additions and 9 deletions

3
NEWS
View File

@ -11,7 +11,8 @@ procps-ng-NEXT
* top: added a 'start time' field (STARTED) * top: added a 'start time' field (STARTED)
* top: column highlighting allowed under 'L' or 'O' * top: column highlighting allowed under 'L' or 'O'
* 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-3.3.17 procps-ng-3.3.17

View File

@ -57,7 +57,7 @@
. .
.\" Document ///////////////////////////////////////////////////////////// .\" Document /////////////////////////////////////////////////////////////
.\" ---------------------------------------------------------------------- .\" ----------------------------------------------------------------------
.TH TOP 1 "March 2022" "procps-ng" "User Commands" .TH TOP 1 "May 2022" "procps-ng" "User Commands"
.\" ---------------------------------------------------------------------- .\" ----------------------------------------------------------------------
.nh .nh
@ -1399,27 +1399,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.
@ -1430,6 +1431,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
.IP "*" 3 .IP "*" 3