From d8760aae6c7624d25f971e9eecf1527bca1db866 Mon Sep 17 00:00:00 2001
From: albert <>
Date: Tue, 27 Dec 2005 04:25:32 +0000
Subject: [PATCH] document H option -- thanks Tony Ernst

---
 NEWS  |  3 +++
 top.1 | 16 +++++++++++++---
 2 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/NEWS b/NEWS
index 4108fa5d..f4c78b29 100644
--- 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 8d1a83b8..8b99f318 100644
--- 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