top: documentation update, enable NUMA/Node extensions

This commit provides the NEWS and man document changes
supporting the new NUMA/Node top program enhancements.

For providing the initial impetus for this enhancement
I wish to thank Lance Shelton <LShelton@fusionio.com>.

(everything is perfectly justified plus right margins)
(are completely filled, but of course it must be luck)

Signed-off-by: Jim Warner <james.warner@comcast.net>
Signed-off-by: Lance Shelton <LShelton@fusionio.com>

diff --git a/NEWS b/NEWS
index 302ce08f111f123b4113d37fb1af165b639ad5a9..225d7f8275e6d9d9caa08e039749a85a0f7ad94b 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,8 @@
+procps-ng-3.3.8
+---------------
+  * top adds extensions for linux NUMA/Node capability
+
+
 procps-ng-3.3.7
 ---------------
 

diff --git a/top/top.1 b/top/top.1
index 1a7a64ff321802d53e26ab356e7b51a792a3d481..c9382cad2b91fd8cb49cedd1baca25ef47902359 100644 (file)
--- a/top/top.1
+++ b/top/top.1
@@ -912,7 +912,7 @@ depending on the context in which they are issued.
         <Ent/Sp> ?, =, 0,
         A, B, d, E, e, g, h, H, I, k, q, r, s, W, X, Y, Z
   4b.\fI Summary-Area-Commands \fR
-        C, l, t, 1, m
+        C, l, t, m, 1, 2, 3
   4c.\fI Task-Area-Commands \fR
         Appearance:  b, J, j, x, y, z
         Content:     c, f, F, o, O, S, u, U, V
@@ -1183,6 +1183,12 @@ These commands always impact just the \*(CG.
 \*(XT 5. ALTERNATE\-DISPLAY Provisions and the 'g' \*(CI for insight into
 \*(CWs and \*(FGs.
 
+.TP 7
+\ \ \'\fBC\fR' :\fIShow-scroll-coordinates\fR toggle \fR
+Toggle an informational message which is displayed whenever the message
+line is not otherwise being used.
+For additional information \*(Xt 5c. SCROLLING a Window.
+
 .TP 7
 \ \ \'\fBl\fR\' :\fILoad-Average/Uptime\fR toggle \fR
 This is also the line containing the program name (possibly an alias)
@@ -1191,11 +1197,17 @@ when operating in \*(FM or the \*(CW name when operating in \*(AM.
 .TP 7
 \ \ \'\fBt\fR\' :\fITask/Cpu-States\fR toggle \fR
 This command affects from 2 to many \*(SA lines, depending on the state
-of the '1' toggle and whether or not \*(We is running under true SMP.
+of the '1', '2' or '3' \*(CTs and whether or not \*(We is running under
+true SMP.
 
 This portion of the \*(SA is also influenced by the 'H' \*(CI toggle,
 as reflected in the total label which shows either 'Tasks' or 'Threads'.
 
+.TP 7
+\ \ \'\fBm\fR\' :\fIMemory/Swap-Usage\fR toggle \fR
+This command affects the two \*(SA lines dealing with physical
+and virtual memory.
+
 .TP 7
 \ \ \'\fB1\fR\' :\fISingle/Separate-Cpu-States\fR toggle \fR
 This command affects how the 't' command's Cpu States portion is shown.
@@ -1208,9 +1220,17 @@ Otherwise, each \*(Pu is displayed separately as: '%Cpu0, %Cpu1, ...'
 up to available screen height.
 
 .TP 7
-\ \ \'\fBm\fR\' :\fIMemory/Swap-Usage\fR toggle \fR
-This command affects the two \*(SA lines dealing with physical
-and virtual memory.
+\ \ \'\fB2\fR\' :\fINUMA-Nodes/Cpu-Summary\fR toggle \fR
+This command toggles between the '1' command cpu summary display (only)
+or a summary display plus the cpu usage statistics for each NUMA Node.
+It is only available if a system has the requisite NUMA support.
+
+.TP 7
+\ \ \'\fB3\fR\' :\fIExpand-NUMA-Node \fR
+You will be invited to enter a number representing a NUMA Node.
+Thereafter, a node summary plus the statistics for each cpu in that
+node will be shown until either the '1' or '2' \*(CT is pressed.
+This \*(CI is only available if a system has the requisite NUMA support.
 
 .PP
 \*(NT If the entire \*(SA has been toggled \*F for any window, you would