clean up the interactive commands list, mainly by showing

the arguments these commands take;

based on some improvements from Mark Lumsden

1 files changed, 41 insertions, 34 deletions

diff --git a/usr.bin/top/top.1 b/usr.bin/top/top.1
index c505c915a27..0949eda83e7 100644
--- a/usr.bin/top/top.1
+++ b/usr.bin/top/top.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: top.1,v 1.39 2007/02/06 15:27:25 jmc Exp $
+.\"	$OpenBSD: top.1,v 1.40 2007/02/09 20:11:02 jmc Exp $
 .\"
 .\" Copyright (c) 1997, Jason Downs.  All rights reserved.
 .\"
@@ -252,13 +252,13 @@ are recognized, and a newline terminates the input.
 .Pp
 These commands are currently recognized (^L refers to control-L):
 .Bl -tag -width XxXXXX
-.It h or \&?
+.It h \*(Ba \&?
 Display a summary of the commands (help screen).
 .It ^L
 Redraw the screen.
 .It q
 Quit
-.Nm top .
+.Nm .
 .El
 .Pp
 The following commands may not be available with overstrike terminals:
@@ -273,10 +273,12 @@ interactive commands,
 or their command line equivalents.
 .It C
 Toggle the display of process command line arguments.
-.It d
-Change the number of displays to show (prompt for new number).
+.It d Ar n
+Show number
+.Ar n
+displays.
 Remember that the next display counts as one, so typing
-.Dq d1
+.Sq d1
 will make
 .Nm
 show one final display and then immediately exit.
@@ -286,13 +288,13 @@ Display a list of system errors (if any) generated by the last
 or
 .Li renice
 command.
-.It g
-Display only processes that contain a string in their command name
-(prompt for string).
-If the string specified is simply
-.Sq + ,
-then no process name matching will be done.
-.It I or i
+.It g Ar string
+Display only processes that contain
+.Ar string
+in their command name.
+.Sq g+
+shows all processes.
+.It I \*(Ba i
 Toggle the display of idle processes.
 .It k
 Send a signal
@@ -300,38 +302,43 @@ Send a signal
 by default) to a list of processes.
 This acts similarly to the command
 .Xr kill 1 .
-.It n or #
-Change the number of processes to display (prompt for new number).
-.It o
-Change the sorting order of the processes
-.Pq prompt for order .
+.It n\*(Ba# Ar n
+Show number
+.Ar n
+processes.
+.It o Ar field
+Change the sorting order of the processes, selected by
+.Ar field .
 Values are the same as for the
 .Fl o
 flag, as detailed above.
-.It p
-Display a specific process (prompt for PID).
-If the PID specified is simply
-.Sq + ,
-then processes belonging to all users will be displayed.
-.It r
+.It p Ar pid
+Display a specific process, selected by
+.Ar pid .
+.Sq p+
+shows all processes.
+.It r Ar n pid
 Change the priority (the
 .Em nice )
-of a list of processes (prompt for the new nice value and the list of
-PIDs, all separated by space).
+of a list of processes to number
+.Ar n
+for process
+.Ar pid .
 This acts similarly to the command
 .Xr renice 8 .
 .It S
 Toggle the display of system processes.
-.It s
-Change the number of seconds to delay between displays
-(prompt for new number).
+.It s Ar n
+Change the time of the delay between displays to
+.Ar n
+seconds.
 .It T
 Toggle the display of process threads.
-.It u
-Display only processes owned by a specific username (prompt for username).
-If the username specified is simply
-.Sq + ,
-then processes belonging to all users will be displayed.
+.It u Ar user
+Display only processes owned by a specific
+.Ar user .
+.Sq u+
+shows processes belonging to all users.
 .El
 .Sh THE DISPLAY
 .\" The actual display varies depending on the specific variant of Unix