document H option -- thanks Tony Ernst

diff --git a/NEWS b/NEWS
index 4108fa5dd9ca33bbdf00ae2b2d26050a664fd98d..f4c78b29326ce90cf6a05af949a12ac6791e320a 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,6 @@
+procps-3.2.6 --> procps-3.2.7
+top: document H option -- thanks Tony Ernst
+
 procps-3.2.5 --> procps-3.2.6
 
 vmstat: /proc/stat buffer big enough for 1024 CPUs

diff --git a/top.1 b/top.1
index 8d1a83b8615bc2c34e2d2249ee1f8f7f51582c9c..8b99f318b7600546d363dcab1ce3fb32a8783575 100644 (file)
--- a/top.1
+++ b/top.1
@@ -85,7 +85,7 @@ top \- display Linux tasks
 .\" ----------------------------------------------------------------------
 .SH SYNOPSIS
 .\" ----------------------------------------------------------------------
-\*(ME \-\fBhv\fR | \-\fBbcisS\fR \-\fBd\fI delay\fR \-\fBn\fI
+\*(ME \-\fBhv\fR | \-\fBbcHisS\fR \-\fBd\fI delay\fR \-\fBn\fI
 iterations\fR \-\fBp\fI pid\fR [,\fI pid\fR ...]
 
 The traditional switches '-' and whitespace are optional.
@@ -199,6 +199,7 @@ command-line.
     \fITask_Area_defaults\fR
        'b' - Bold hilite      On\ \ (not 'reverse')
      * 'c' - Command line     Off (name, not cmdline)
+     * 'H' - Threads          Off\ (show all threads)
      * 'i' - Idle tasks       On\ \ (show all tasks)
        'R' - Reverse sort     On\ \ (pids high-to-low)
      * 'S' - Cumulative time  Off (no, dead children)
@@ -212,7 +213,7 @@ command-line.
 .\" ----------------------------------------------------------------------
 The command-line syntax for \*(Me consists of:
 
-     \-\fBhv\fR\ |\ -\fBbcisS\fR\ \-\fBd\fI\ delay\fR\ \-\fBn\fI\ iterations\
+     \-\fBhv\fR\ |\ -\fBbcHisS\fR\ \-\fBd\fI\ delay\fR\ \-\fBn\fI\ iterations\
 \fR\ \-\fBp\fI\ pid\fR\ [,\fIpid\fR...]
 
 The typically mandatory switches ('-') and even whitespace are completely
@@ -248,6 +249,11 @@ For additional information on 'Secure mode' \*(Xt 5a. SYSTEM Configuration File.
 \-\fBh\fR :\fB Help\fR
 Show library version and the usage prompt, then quit.
 
+.TP 5
+\-\fBH\fR :\fB Threads\fR toggle
+Starts \*(Me with the last remembered 'H' state reversed.
+When this toggle is \*O, all individual threads will be displayed.  Otherwise, \*(Me displays a summation of all threads in a process.
+
 .TP 5
 \-\fBi\fR :\fB Idle Processes\fR toggle
 Starts \*(Me with the last remembered 'i' state reversed.
@@ -547,7 +553,7 @@ depending on the context in which they are issued.
         l, m, t, 1
   3c.\fI TASK_Area_Commands\fR
         Appearance:  b, x, y, z
-        Content:     c, f, o, S, u
+        Content:     c, f, H, o, S, u
         Size:        #, i, n
         Sorting:     <, >, F, O, R
   3d.\fI COLOR_Mapping\fR
@@ -791,6 +797,10 @@ fields are displayed and their order.
 For additional information on these \*(CIs
 \*(Xt 2b. SELECTING and ORDERING Columns.
 
+.TP 7
+\ \ \'\fBH\fR\' :\fIThreads_toggle\fR
+When this toggle is \*O, all individual threads will be displayed.  Otherwise, \*(Me displays a summation of all threads in a process.
+
 .TP 7
 \ \ \'\fBS\fR\' :\fICumulative_Time_Mode_toggle\fR
 When 'Cumulative mode' is \*O, each process is listed with the \*(Pu