From 27c8671ba3e26e078bf32c1fe97dfe97bd148583 Mon Sep 17 00:00:00 2001 From: Jim Warner Date: Wed, 15 Jun 2022 00:00:00 -0500 Subject: [PATCH] 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 --- NEWS | 3 ++- top/top.1 | 21 +++++++++++++-------- 2 files changed, 15 insertions(+), 9 deletions(-) diff --git a/NEWS b/NEWS index d744fbb1..d7721289 100644 --- a/NEWS +++ b/NEWS @@ -11,7 +11,8 @@ procps-ng-NEXT * top: added a 'start time' field (STARTED) * top: column highlighting allowed under 'L' or 'O' * 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 diff --git a/top/top.1 b/top/top.1 index 071f305a..94f3ad81 100644 --- a/top/top.1 +++ b/top/top.1 @@ -57,7 +57,7 @@ . .\" Document ///////////////////////////////////////////////////////////// .\" ---------------------------------------------------------------------- -.TH TOP 1 "March 2022" "procps-ng" "User Commands" +.TH TOP 1 "May 2022" "procps-ng" "User Commands" .\" ---------------------------------------------------------------------- .nh @@ -1399,27 +1399,28 @@ colors for the \*(CW, or for all windows. For details regarding this \*(CI \*(Xt 4d. COLOR Mapping. .P -\ \ \ \fB^G\fR\ \ :\fIDisplay-Full-Control-Groups \fR (Ctrl key + `g') +\ \ \ \fB^G\fR\ \ :\fIDisplay-Control-Groups \fR (Ctrl key + `g') .br -\ \ \ \fB^K\fR\ \ :\fIDisplay-Full-Cmdline \fR (Ctrl key + `k') +\ \ \ \fB^K\fR\ \ :\fIDisplay-Cmdline \fR (Ctrl key + `k') .br -\ \ \ \fB^N\fR\ \ :\fIDisplay-Full-Environment \fR (Ctrl key + `n') +\ \ \ \fB^N\fR\ \ :\fIDisplay-Environment \fR (Ctrl key + `n') .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 .RS +7 Applied to the first process displayed, these commands will show that task's full (potentially wrapped) information. 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 separate window as does the `=' command. - Keying a different `Ctrl' combination, while one is already active, 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. A more readable version can be achieved with an `Inspect' entry 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 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 .IP "*" 3 -- 2.40.0