Package: procps
Version: 1:3.3.3-3
Severity: minor
Tags: patch
Dear Maintainer,
Output from "groff -b -mandoc -ww -z top.1":
<groff: top.1>:131: warning: macro `Bd' not defined
<groff: top.1>:162: warning: macro `Ed' not defined
Using macros from both man and doc macros packages does not work with
"man".
Changed control character with no break does not work, as the default
(') is used in the groff man macros. "\&" in front of an control
character is used to protect it from been interpreted.
Added a definition for an em-dash in troff
Corrected the word "commamd" to "command"
Changes were only tested with "groff".
Patch:
--- top.1 2013-10-03 23:04:35.000000000 +0000
+++ top.1.new 2013-10-07 01:49:20.000000000 +0000
@@ -22,13 +22,16 @@
.
..
\# Setup ////////////////////////////////////////////////////////////////
+.fam T
\# ** Comment out '.nr' or set to 0 to eliminate WIDTH fiddlin' !
.nr half_xtra 4
.
.ll +(\n[half_xtra] + \n[half_xtra])
.
\# ** we use single quote char (') alot, so change the no-break ctrl char
-.c2 `
+\#.c2 `
+\# May not be used, as ' is used in the groff macros
+\# Use \& in front of ', if it starts a line.
.
\# Our own Bullet style(s) --------------------------
.de jBu
@@ -37,8 +40,13 @@
.
\# Commonly used strings (for consistency) ----------
\# - our em-dashes
+\# Why use <minus><hyphen>?
.ds Em \fR\ \--\ \fR
.ds EM \fB\ \--\ \fR
+.if t \{
+.ds Em \fR\ \(em\ \fR
+.ds EM \fB\ \(em\ \fR
+.\}
\# - our program name (makes great grammer)
.ds We top
.ds WE \fBtop\fR
@@ -128,7 +136,11 @@ display and used when reading and writin
.\" ----------------------------------------------------------------------
The remaining Table of Contents
-.Bd -literal
+\# Both man and mandoc macro packages not possible?
+.\".Bd -literal
+.sp 1v
+.ne 2v
+.fam C
1. COMMAND\-LINE Options
2. SUMMARY Display
a. UPTIME and LOAD Averages
@@ -159,7 +171,9 @@ The remaining Table of Contents
b. Bouncing Windows
c. The Big Bird Window
8. BUGS, 9. HISTORY Former top, 10. AUTHOR, 11. SEE Also
-.Ed
+.fam
+.br
+.\".Ed
.\" ......................................................................
.SS Operation
@@ -173,7 +187,9 @@ Some of \*(We's screens or functions req
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 for compatibility:
-.Bd -literal -compact
+\#.Bd -literal -compact
+.ne 2v
+.fam C
\fI key equivalents \fR
Up alt +\fB \\ \fR or alt +\fB k \fR
Down alt +\fB / \fR or alt +\fB j \fR
@@ -183,7 +199,9 @@ keys are accepted for compatibility:
PgDn alt +\fB Down \fR
Home alt +\fB Left \fR
End alt +\fB Right \fR
-.Ed
+\#.Ed
+.br
+.fam
When you start \*(We for the first time, you'll be presented with these
traditional screen elements: 1) Summary Area; 2) Fields/Columns Header;
@@ -209,7 +227,10 @@ Even so, items shown with an \*(AK could
command-line.
All are explained in detail in the sections that follow.
-.Bd -literal
+\#.Bd -literal
+.sp 1v
+.ne 2v
+.fam C
\fIGlobal-defaults\fR
'A' - Alt display Off (full-screen)
* 'd' - Delay time 3.0 seconds
@@ -234,7 +255,9 @@ All are explained in detail in the secti
'x' - Column hilite Off (no, sort field)
'y' - Row hilite On\ \ (yes, running tasks)
'z' - color/mono Off (no, colors)
-.Ed
+\#.Ed
+.br
+.fam
.\" ----------------------------------------------------------------------
.SH 1. COMMAND-LINE Options
@@ -361,12 +384,16 @@ these provisions.
.SS 2a. UPTIME and LOAD Averages
.\" ----------------------------------------------------------------------
This portion consists of a single line containing:
-.Bd -literal -compact
+\#.Bd -literal -compact
+.ne 2v
+.fam C
\fBprogram\fR or\fB window\fR name, depending on display mode
current time and length of time since last boot
total number of users
system load avg over the last 1, 5 and 15 minutes
-.Ed
+\#.Ed
+.br
+.fam
.\" ......................................................................
.SS 2b. TASK and CPU States
@@ -378,14 +405,20 @@ state percentages.
Line 1 shows total\fB tasks\fR or\fB threads\fR, depending on the state
of the Threads-mode toggle.
That total is further classified as:
-.Bd -literal -compact
+\#.Bd -literal -compact
+.ne 2v
+.fam C
running; sleeping; stopped; zombie
-.Ed
+\#.Ed
+.br
+.fam
Line 2 shows \*(PU state percentages based on the interval since the
last refresh. Where two labels are shown below, those for more recent
kernel versions are shown first.
-.Bd -literal -compact
+\#.Bd -literal -compact
+.ne 2v
+.fam C
\fBus\fR,\fB user\fR : time running un-niced user processes
\fBsy\fR,\fB system\fR : time running kernel processes
\fBni\fR,\fB nice\fR : time running niced user processes
@@ -393,7 +426,9 @@ kernel versions are shown first.
\fBhi\fR : time spent servicing hardware interrupts
\fBsi\fR : time spent servicing software interrupts
\fBst\fR : time stolen from this vm by the hypervisor
-.Ed
+\#.Ed
+.br
+.fam
.\" ......................................................................
.SS 2c. MEMORY Usage
@@ -576,7 +611,7 @@ The process ID (pid) of a task's parent.
19.\fB PR \*(Em Priority \fR
The scheduling priority of the task.
If you see 'rt' in this field, it means the task is running under
-'real time' scheduling priority.
+\&'real time' scheduling priority.
Under linux, real time priority is somewhat misleading since traditionally
the operating itself was not preemptable.
@@ -777,7 +812,10 @@ Listed below is a brief index of command
Some commands appear more than once \*(Em their meaning or scope may vary
depending on the context in which they are issued.
-.Bd -literal
+\#.Bd -literal
+.sp 1v
+.ne 2v
+.fam C
4a.\fI Global-Commands \fR
<Ent/Sp> ?, =, A, B, d, g, h, H, I, k, q, r, s, W, Z
4b.\fI Summary-Area-Commands \fR
@@ -795,7 +833,9 @@ depending on the context in which they a
C, Up, Dn, Left, Right, PgUp, PgDn, Home, End
5d.\fI Searching-in-a-Window \fR
L, &
-.Ed
+\#.Ed
+.br
+.fam
.\" ......................................................................
.SS 4a. GLOBAL Commands
@@ -1072,7 +1112,7 @@ command but just press <Enter> at the pr
In this mode, processes are reordered according to their parents and
the layout of the COMMAND column resembles that of a tree.
In forest view mode it is still possible to toggle between program
-name and commamd line (\*(Xc 'c' \*(CI) or between processes and
+name and command line (\*(Xc 'c' \*(CI) or between processes and
threads (\*(Xc 'H' \*(CI).
\*(NT Typing any key affecting the sort order will exit forest view
@@ -1114,14 +1154,18 @@ simply decrease the size of the \*(TD(s)
For compatibility, this \*(We supports most of the former \*(We sort keys.
Since this is primarily a service to former \*(We users, these commands do
not appear on any help screen.
-.Bd -literal -compact
+\#.Bd -literal -compact
+.ne 2v
+.fam C
\fI command sorted-field supported \fR
A start time (non-display) \fB No \fR
M %MEM Yes
N PID Yes
P %CPU Yes
T TIME+ Yes
-.Ed
+\#.Ed
+.br
+.fam
Before using any of the following sort provisions, \*(We suggests that you
temporarily turn on column highlighting using the 'x' \*(CI.
@@ -1175,7 +1219,9 @@ in all four windows before returning to
.P
The following \*(CIs are available.
-.Bd -literal -compact
+\#.Bd -literal -compact
+.ne 2v
+.fam C
\fB4\fR upper case letters to select a\fB target \fR
\fB8\fR numbers to select a\fB color \fR
normal toggles available \fR
@@ -1186,7 +1232,9 @@ The following \*(CIs are available.
'a'/'w' :apply, then go to next/prior
<Enter> :apply and exit
'q' :abandon current changes and exit
-.Ed
+\#.Ed
+.br
+.fam
If you use 'a' or 'w' to cycle the targeted window, you will
have applied the color scheme that was displayed when you left that window.
@@ -1300,11 +1348,15 @@ It does not require that the window name
.IP "*" 3
The \*(CIs shown with an \*(AK have use beyond \*(AM.
-.Bd -literal -compact
+\#.Bd -literal -compact
+.ne 2v
+.fam C
\'=', 'A', 'g' are always available
\'a', 'w' act the same with color mapping
\ and fields management
-.Ed
+\#.Ed
+.br
+.fam
.\" ......................................................................
.SS 5c. SCROLLING a Window
@@ -1352,13 +1404,18 @@ This is true until a single column and a
display element.
.TP 4
-'\fBC\fR' :\fIShow-scroll-coordinates\fR toggle \fR
+\&'\fBC\fR' :\fIShow-scroll-coordinates\fR toggle \fR
Toggle an informational message which is displayed whenever the message
line is not otherwise being used.
-.Bd -literal
+\#.Bd -literal
+.sp 1v
+.ne 2v
+.fam C
"\fBscroll coordinates: y = n/n (tasks), x = n/n (fields)\fR"
-.Ed
+\#.Ed
+.br
+.fam
The coordinates shown as \fBn\fR/\fBn\fR are relative to the upper left
corner of the \*(CW.
@@ -1388,7 +1445,7 @@ available in \*(AM if the \*(CW's \*(TD
You can use these \*(CIs to locate a task row containing a particular value.
.TP 4
-'\fBL\fR\' :\fILocate-a-string\fR
+\&'\fBL\fR\' :\fILocate-a-string\fR
You will be prompted for the case-sensitive string to locate starting from
the current window coordinates.
There are no restrictions on search string content.
@@ -1401,7 +1458,7 @@ Keying <Enter> with no input will effect
a new search string is entered.
.TP 4
-'\fB&\fR\' :\fILocate-next\fR
+\&'\fB&\fR\' :\fILocate-next\fR
Assuming a search string has been established, \*(We will attempt to locate
the next occurrence.
@@ -1453,11 +1510,15 @@ is shown to an ordinary user.
More importantly, it will limit what ordinary users are allowed
to do when \*(We is running.
They will not be able to issue the following commands.
-.Bd -literal -compact
+\#.Bd -literal -compact
+.ne 2v
+.fam C
k Kill a task
r Renice a task
d or s Change delay/sleep interval
-.Ed
+\#.Ed
+.br
+.fam
The system \*(CF is\fB not\fR created by \*(We.
Rather, you create this file manually and place it in the \fI/etc \fR
@@ -1466,10 +1527,14 @@ Its name must be 'toprc' and must have n
It must have only two lines.
Here is an example of the contents of\fI /etc/toprc\fR:
-.Bd -literal -compact
+\#.Bd -literal -compact
+.ne 2v
+.fam C
s # line 1: 'secure' mode switch
5.0 # line 2: 'delay'\ \ interval in seconds
-.Ed
+.br
+.fam
+\#.Ed
.\" ......................................................................
.SS 6b. PERSONAL Configuration File
@@ -1478,13 +1543,17 @@ This file is written as '$HOME/.your-nam
Use the 'W' \*(CI to create it or update it.
Here is the general layout:
-.Bd -literal -compact
+\#.Bd -literal -compact
+.ne 2v
+.fam C
global # line 1: the program name/alias notation
" # line 2: id,altscr,irixps,delay,curwin
per ea # line a: winname,fieldscur
window # line b: winflags,sortindx,maxtasks
" # line c: summclr,msgsclr,headclr,taskclr
-.Ed
+\#.Ed
+.br
+.fam
If the $HOME variable is not present, \*(We will try to write the
personal \*(CF to the current directory, subject to permissions.
@@ -1512,7 +1581,9 @@ seconds or less.
For this experiment, under x-windows open an xterm and maximize it.
Then do the following:
-.Bd -literal -compact
+\#.Bd -literal -compact
+.ne 2v
+.fam C
. provide a scheduling boost and tiny delay via:
nice -n -10 top -d.09
. keep sorted column highlighting \*F so as to
@@ -1521,7 +1592,9 @@ Then do the following:
. try various sort columns (TIME/MEM work well),
and normal or reverse sorts to bring the most
active processes into view
-.Ed
+\#.Ed
+.br
+.fam
What you'll see is a very busy Linux doing what he's always done for you,
but there was no program available to illustrate this.
-- System Information:
Debian Release: 7.1
APT prefers stable-updates
APT policy: (500, 'stable-updates'), (500, 'proposed-updates'), (500,
'stable')
Architecture: i386 (i586)
Kernel: Linux 3.2.46-1-rt67-1
Locale: LANG=is_IS, LC_CTYPE=is_IS (charmap=ISO-8859-1)
Shell: /bin/sh linked to /bin/dash
Versions of packages procps depends on:
ii initscripts 2.88dsf-41+deb7u1
ii libc6 2.13-38
ii libncurses5 5.9-10
ii libncursesw5 5.9-10
ii libprocps0 1:3.3.3-3
ii libtinfo5 5.9-10
ii lsb-base 4.1+Debian8+deb7u1
Versions of packages procps recommends:
ii psmisc 22.19-1+deb7u1
procps suggests no packages.
-- Configuration Files:
/etc/sysctl.conf changed [not included]
-- no debconf information
--
Bjarni I. Gislason
--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
