emo/procps
1
0
Fork 0
Code Issues Pull Requests Packages Releases Activity

top: update man document for current screen & SIGWINCH

Browse Source 
Signed-off-by: Jim Warner <james.warner@comcast.net>
This commit is contained in:
Jim Warner 2013-01-16 00:00:00 -06:00 committed by Craig Small
parent 4f33b6b8c5
commit 3fc8b69c7a
1 changed files with 36 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
top/top.1
View File

@ -175,10 +175,43 @@ key and quit ('q') key.
Alternatively, you could simply use the traditional interrupt key ('^C')
when you're done.
Some of \*(We's screens or functions require the use of cursor motion
keys like the standard \*(KAs plus the Home, End, PgUp and PgDn keys.
When started for the first time, you'll be presented with these traditional
elements on the main \*(We screen: 1) Summary Area; 2) Fields/Columns Header;
3) Task Area.
Each of these will be explored in the sections that follow.
There is also an Input/Message line between the Summary Area and Columns
Header which needs no further explanation.
The main \*(We screen is \fIgenerally\fR quite adaptive to changes in
terminal dimensions under X-Windows.
Other \*(We screens may be less so, especially those with static text.
It ultimately depends, however, on your particular window manager and
terminal emulator.
There may be occasions when their view of terminal size and current contents
differs from \*(We's view, which is always based on operating system calls.
Following any re-size operation, if a \*(We screen is corrupted, appears
incomplete or disordered, simply typing something innocuous like a
punctuation character or cursor motion key will usually restore it.
In extreme cases, the following sequence almost certainly will:
.Bd -literal -compact
\fIkey/cmd objective \fR
^Z \fBsuspend\fR \*(We
fg \fBresume\fR \*(We
<Left> force a screen \fBredraw\fR (if necessary)
.Ed
But if the display is still corrupted, there is one more step you could try.
Insert this command after \*(We has been suspended but before resuming it.
.Bd -literal -compact
\fIkey/cmd objective \fR
reset restore your \fBterminal settings\fR
.Ed
Lastly, some of \*(We's screens or functions require the use of cursor
motion keys like the standard \*(KAs plus the Home, End, PgUp and PgDn keys.
If your terminal or emulator does not provide those keys, the following
keys are accepted as alternatives:
combinations are accepted as alternatives:
.Bd -literal -compact
\fI key equivalent-key-combinations \fR
Up alt +\fB \\\fR or alt +\fB k \fR
@ -191,13 +224,6 @@ keys are accepted as alternatives:
End alt +\fB Right\fR or alt + ctrl +\fB l \fR
.Ed
When you start \*(We for the first time, you'll be presented with these
traditional screen elements: 1) Summary Area; 2) Fields/Columns Header;
3) Task Area.
These areas will be explored in the sections that follow.
There is also an Input/Message line between the Summary Area and Columns
Header which needs no further explanation.
\*(NT the width of \*(We's display will be limited to \*(WX positions.
Displaying all fields requires \*(WF characters.
Remaining screen width is usually allocated to any variable width columns