doc: add variable width data display without scrolling

Signed-off-by: Jim Warner <james.warner@comcast.net>
This commit is contained in:
Jim Warner 2022-04-30 00:00:00 -05:00 committed by Craig Small
parent fb32021eeb
commit 6b24d11b07
2 changed files with 37 additions and 1 deletions

2
NEWS
View File

@ -8,6 +8,8 @@ procps-ng-NEXT
* top: fix 'smaps' bug preventing build under clang issue #235 * top: fix 'smaps' bug preventing build under clang issue #235
* top: column highlighting allowed under 'L' or 'O' * top: column highlighting allowed under 'L' or 'O'
* top: can alter autogroup nice value (like 'r' renice) * 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 procps-ng-4.0.0
--------------- ---------------

View File

@ -1262,7 +1262,8 @@ depending on the context in which they are issued.
.nf .nf
4a.\fI Global-Commands \fR 4a.\fI Global-Commands \fR
<Ent/Sp> ?, =, 0, <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 4b.\fI Summary-Area-Commands \fR
C, l, t, m, 1, 2, 3, 4, ! C, l, t, m, 1, 2, 3, 4, !
4c.\fI Task-Area-Commands \fR 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. 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
\ \ \ \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 .TP 7
*\ \ \fB^R\fR\ \ :\fIRenice-an-Autogroup \fR (Ctrl key + `r') *\ \ \fB^R\fR\ \ :\fIRenice-an-Autogroup \fR (Ctrl key + `r')
You will be prompted for a PID and then the value for its You will be prompted for a PID and then the value for its