doc: add variable width data display without scrolling

Signed-off-by: Jim Warner <james.warner@comcast.net>

diff --git a/NEWS b/NEWS
index f1bdf4a76fc0e55e1e8fca44e98ee619aee62a9a..96262bfc2de0c9e77952ba79fe0d10f7406f4859 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -8,6 +8,8 @@ procps-ng-NEXT
   * top: fix 'smaps' bug preventing build under clang      issue #235
   * top: column highlighting allowed under 'L' or 'O'
   * top: can alter autogroup nice value (like 'r' renice)
+  * top: can display the following with no need to scroll
+  *      cmdline, control groups, environment, supp groups
 
 procps-ng-4.0.0
 ---------------

diff --git a/top/top.1 b/top/top.1
index cc12a5fc1e5f574f13a5c5375d4c6ce1c25c4d24..461f39a832678384910cfff1f87ec8123e718eec 100644 (file)
--- a/top/top.1
+++ b/top/top.1
@@ -1262,7 +1262,8 @@ depending on the context in which they are issued.
 .nf
   4a.\fI Global-Commands \fR
         <Ent/Sp> ?, =, 0,
-        A, B, d, E, e, g, H, h, I, k, q, r, s, W, X, Y, Z, ^R
+        A, B, d, E, e, g, H, h, I, k, q, r, s, W, X, Y, Z,
+        ^G, ^K, ^U, ^V
   4b.\fI Summary-Area-Commands \fR
         C, l, t, m, 1, 2, 3, 4, !
   4c.\fI Task-Area-Commands \fR
@@ -1520,6 +1521,39 @@ This key will take you to a separate screen where you can change the
 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')
+.br
+\ \ \ \fB^K\fR\ \ :\fIDisplay-Full-Cmdline \fR              (Ctrl key + `k')
+.br
+\ \ \ \fB^U\fR\ \ :\fIDisplay-Full-Supplementary-Groups \fR (Ctrl key + `u')
+.br
+\ \ \ \fB^V\fR\ \ :\fIDisplay-Full-Environment \fR          (Ctrl key + `v')
+.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.
+
+Keying the same command a second time removes that separate window
+as does the death of the targeted task.
+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.
+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.
+
+.nf
+    pipe ^I Environment ^I cat /proc/%d/environ | tr '\\0' '\\n'
+.fi
+
+\*(XC `Y' \*(CI above and topic 6b. ADDING INSPECT Entries for
+additional information.
+.RS -7
+
 .TP 7
 *\ \ \fB^R\fR\ \ :\fIRenice-an-Autogroup \fR (Ctrl key + `r')
 You will be prompted for a PID and then the value for its