top: allow collapsible forest view children, documents

Signed-off-by: Jim Warner <james.warner@comcast.net>

top/top.1

@@ -62,7 +62,7 @@
 .
 .\" Document /////////////////////////////////////////////////////////////
 .\" ----------------------------------------------------------------------
-.TH TOP 1 "May 2018" "procps-ng" "User Commands"
+.TH TOP 1 "June 2018" "procps-ng" "User Commands"
 .\" ----------------------------------------------------------------------
 
 .\" ----------------------------------------------------------------------
@@ -1106,7 +1106,7 @@ depending on the context in which they are issued.
         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
+        Content:     c, f, F, o, O, S, u, U, V, ^V
         Size:        #, i, n
         Sorting:     <, >, f, F, R
   4d.\fI Color-Mapping \fR
@@ -1151,20 +1151,13 @@ those \*(CIs applicable to \*(AM.
 .TP 7
 \ \ \ \fB=\fR\ \ :\fIExit-Task-Limits \fR
 Removes restrictions on which tasks are shown.
-This command will reverse any `i' (idle tasks) and `n' (max tasks)
+This command will reverse any `i' (idle tasks), `n' (max tasks)
-commands that might be active.
+and `^V' (hide children) commands that might be active.
 It also provides for an exit from PID monitoring, User filtering,
 Other filtering and Locate processing.
-See the `\-p' \*(CO for a discussion of PID monitoring, the `U' or `u'
-\*(CIs for User filtering the `O' or `o' \*(CIs for Other filtering
-and `L' or `&' \*(CIs for Locate processing.
 
-Additionally, any window that has been scrolled will be reset with
+Additionally, if the window has been scrolled it will be reset with
 this command.
-\*(XT 5c. SCROLLING a Window for additional information regarding
-vertical and horizontal scrolling.
-
-When operating in \*(AM this command has a broader meaning.
 
 .TP 7
 \ \ \ \fB0\fR\ \ :\fIZero-Suppress\fR toggle \fR
@@ -1592,6 +1585,18 @@ threads (\*(Xc `H' \*(CI).
 mode in the \*(CW.
 \*(XT 4c. TASK AREA Commands, SORTING for information on those keys.
 
+.TP 7
+\ \ \fB^V\fR\ \ :\fIHide/Show-Children\fR toggle (Ctrl key + `V') \fR
+When in forest view mode, this key serves as a toggle to collapse or
+expand the children of a parent.
+
+The toggle is applied against the first (topmost) process in the \*(CW.
+\*(XT 5c. SCROLLING a Window for additional information regarding
+vertical scrolling.
+
+If the target process has not forked any children, this key has no effect.
+It also has no effect when not in forest view mode.
+
 .PP
 .\" ..................................................
 .B SIZE\fR of \*(TW
@@ -1761,8 +1766,9 @@ as the only display element.
 .TP 7
 *\ \ \fB=\fR | \fB+\fR\ \ :\fIEqualize-(reinitialize)-Window(s) \fR
 The `=' key forces the \*(CW's \*(TD to be visible.
-It also reverses any `i' (idle tasks), `n' (max tasks), `u/U' (user filter),
+It also reverses any active `i' (idle tasks), `n' (max tasks), `u/U'
-\`o/O' (other filter) and 'L' (locate) commands that might be active.
+(user filter), `o/O' (other filter), `^V' (hide children) and 'L' (locate)
+commands.
 Also, if the window had been scrolled, it will be reset with this command.
 \*(XT 5c. SCROLLING a Window for additional information regarding vertical
 and horizontal scrolling.
@@ -1771,7 +1777,8 @@ The `+' key does the same for all windows.
 The four \*(TDs will reappear, evenly balanced.
 They will also have retained any customizations you had previously
 applied, except for the `i' (idle tasks), `n' (max tasks), `u/U'
-(user filter), `o/O' (other filter), `L' (locate) and scrolling \*(CIs.
+(user filter), `o/O' (other filter), `^V' (hide children), `L' (locate)
+and scrolling \*(CIs.
 
 .TP 7
 *\ \ \fBA\fR\ \ :\fIAlternate-Display-Mode\fR toggle \fR