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>

diff --git a/NEWS b/NEWS
index d744fbb1e912893c1c5962f30da53b9744ed8c57..d7721289ca4448bbdec4e05b1425d7ba236e2b1c 100644 (file)
--- 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 071f305a48c515dd204f49524262d440640cc21e..94f3ad8191da68cc7893e7c672b95b991ff74132 100644 (file)
--- 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