doc: add variable width data display without scrolling <=== port of newlib 6b24d11b

______________________________ original newlib message
--------------------------------------------- ( none )

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

diff --git a/NEWS b/NEWS
index f35755bd7e22bbe1f1a6dd71234eff57eb2fae94..d744fbb1e912893c1c5962f30da53b9744ed8c57 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -10,6 +10,8 @@ procps-ng-NEXT
   * top: the time related fields can now be user scaled
   * 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
 
 
 procps-ng-3.3.17

diff --git a/top/top.1 b/top/top.1
index d78e9bcc50165024b8f14658170ad07d451228f8..58e3f9bd63df065d4221b583049dab20979b8731 100644 (file)
--- a/top/top.1
+++ b/top/top.1
@@ -1139,7 +1139,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
+        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
@@ -1397,6 +1398,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
+
 .IP "*" 3
 The commands shown with an \*(AK are not available in Secure mode,
 nor will they be shown on the level-1 help screen.