===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/top/top.1,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- src/usr.bin/top/top.1	2003/09/02 18:50:07	1.22
+++ src/usr.bin/top/top.1	2003/09/19 10:32:24	1.23
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: top.1,v 1.22 2003/09/02 18:50:07 jmc Exp $
+.\"	$OpenBSD: top.1,v 1.23 2003/09/19 10:32:24 jmc Exp $
 .\"
 .\" Copyright (c) 1997, Jason Downs.  All rights reserved.
 .\"
@@ -31,10 +31,10 @@
 .Nd display and update information about the top CPU processes
 .Sh SYNOPSIS
 .Nm top
-.Op Fl SbiInqu
+.Op Fl biInqSu
 .Op Fl d Ar count
-.Op Fl s Ar time
 .Op Fl o Ar field
+.Op Fl s Ar time
 .Op Fl U Ar username
 .Op Ar number
 .Sh DESCRIPTION
@@ -70,10 +70,6 @@
 .Pp
 The options are as follows:
 .Bl -tag -width Ds
-.It Fl S
-Show system processes in the display.
-Normally, system processes such as the pager and the swapper are not shown.
-This option makes them visible.
 .It Fl b
 Use
 .Em batch
@@ -85,6 +81,17 @@
 .Ql ^\e )
 still have an effect.
 This is the default on a dumb terminal, or when the output is not a terminal.
+.It Fl d Ar count
+Show only
+.Ar count
+displays, then exit.
+A display is considered to be one update of the screen.
+This option allows the user to select the number of displays
+to be shown before
+.Nm
+automatically exits.
+For intelligent terminals, no upper limit is set.
+The default is 1 for dumb terminals.
 .It Fl i
 Use
 .Em interactive
@@ -107,6 +114,19 @@
 This is identical to
 .Em batch
 mode.
+.It Fl o Ar field
+Sort the process display area using the specified field as the primary key.
+The field name is the name of the column as seen in the output,
+but in lower case.
+The
+.Ox
+version of top supports
+.Ar cpu ,
+.Ar size ,
+.Ar res ,
+.Ar time ,
+and
+.Ar pri .
 .It Fl q
 Renice
 .Nm
@@ -114,6 +134,16 @@
 This can be used when the system is
 being very sluggish to improve the possibility of discovering the problem.
 This option can only be used by root.
+.It Fl s Ar time
+Set the delay between screen updates to
+.Ar time
+seconds.
+The value may be fractional, to permit delays of less than 1 second.
+The default delay between updates is 5 seconds.
+.It Fl S
+Show system processes in the display.
+Normally, system processes such as the pager and the swapper are not shown.
+This option makes them visible.
 .It Fl u
 Do not take the time to map UID numbers to usernames.
 Normally,
@@ -123,36 +153,6 @@
 This option
 disables all that, while possibly decreasing execution time.
 The UID numbers are displayed instead of the names.
-.It Fl d Ar count
-Show only
-.Ar count
-displays, then exit.
-A display is considered to be one update of the screen.
-This option allows the user to select the number of displays
-to be shown before
-.Nm
-automatically exits.
-For intelligent terminals, no upper limit is set.
-The default is 1 for dumb terminals.
-.It Fl s Ar time
-Set the delay between screen updates to
-.Ar time
-seconds.
-The value may be fractional, to permit delays of less than 1 second.
-The default delay between updates is 5 seconds.
-.It Fl o Ar field
-Sort the process display area using the specified field as the primary key.
-The field name is the name of the column as seen in the output,
-but in lower case.
-The
-.Ox
-version of top supports
-.Ar cpu ,
-.Ar size ,
-.Ar res ,
-.Ar time ,
-and
-.Ar pri .
 .It Fl U Ar username
 Show only those processes owned by
 .Ar username .
@@ -238,6 +238,10 @@
 .It q
 Quit
 .Nm top .
+.El
+.Pp
+The following commands may not be available with overstrike terminals:
+.Bl -tag -width XxXXXX
 .It d
 Change the number of displays to show (prompt for new number).
 Remember that the next display counts as one, so typing
@@ -245,38 +249,44 @@
 will make
 .Nm
 show one final display and then immediately exit.
-.It n or #
-Change the number of processes to display (prompt for new number).
-.It s
-Change the number of seconds to delay between displays
-(prompt for new number).
+.It e
+Display a list of system errors (if any) generated by the last
+.Li kill
+or
+.Li renice
+command.
+.It i or I
+Toggle the display of idle processes.
 .It k
 Send a signal
 .Pf ( Dv TERM
 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 .
+Values are the same as for the
+.Fl o
+flag, as detailed above.
 .It r
 Change the priority (the
 .Em nice )
 of a list of processes.
 This acts similarly to the command
 .Xr renice 8 .
+.It s
+Change the number of seconds to delay between displays
+(prompt for new number).
+.It S
+Toggle the display of system processes.
 .It u
 Display only processes owned by a specific username (prompt for username).
 If the username specified is simply
 .Dq + ,
 then processes belonging to all users will be displayed.
-.It e
-Display a list of system errors (if any) generated by the last
-.Li kill
-or
-.Li renice
-command.
-.It i or I
-Toggle the display of idle processes.
-.It S
-Toggle the display of system processes.
 .El
 .Sh THE DISPLAY
 .\" The actual display varies depending on the specific variant of Unix