Re: RFC: Sorting in top -m io

On 2004-07-08 12:07, Dan Nelson <dnelson_at_allantgroup.com> wrote:
> docs are still missing: manpage, top Usage string, and "?" help all
> need to describe the -m flag and 'm' key.  Since there's room,
> context-switch info would also be neat to display.

Hi,

I don't like writing in nroff -man which is a bit too `primitive' when
compared with mdoc, but here is the patch I mentioned earlier:

Does this look ok?  Should I add more details?  If yes, what about?

%%
Index: top.X
===================================================================
RCS file: /home/ncvs/src/contrib/top/top.X,v
retrieving revision 1.10
diff -u -r1.10 top.X
--- top.X	1 Jul 2004 09:12:38 -0000	1.10
+++ top.X	8 Jul 2004 20:50:23 -0000
_at__at_ -90,7 +90,7 _at__at_
 process.
 .TP
 .BI \-m display
-Display either 'cpu' or 'io' statistics.  Default is 'cpu'.
+Display either 'cpu' or 'io' statistics.  The default display mode is 'cpu'.
 .TP
 .B \-n
 Use \*(lqnon-interactive\*(rq mode.  This is identical to \*(lqbatch\*(rq
_at__at_ -221,6 +221,8 _at__at_
 .TP
 .B m
 Toggle the display between 'cpu' and 'io' modes.
+Note that this affects the sort order of the displayed processes,
+as different sort keys are available in each mode.
 .TP
 .B n or #
 Change the number of processes to display (prompt for new number).
_at__at_ -247,8 +249,16 _at__at_
 .B o
 Change the order in which the display is sorted.  This command is not
 available on all systems.  The sort key names vary fron system to system
-but usually include:  \*(lqcpu\*(rq, \*(lqres\*(rq, \*(lqsize\*(rq,
-\*(lqtime\*(rq.  The default is cpu.
+and depend on the current display mode of
+.IR top .
+.IP
+The available sort keys usually include:
+\*(lqcpu\*(rq, \*(lqres\*(rq, \*(lqsize\*(rq, and  \*(lqtime\*(rq.
+These are the same sort keys that are available when the 'cpu' mode is
+used.  The default sort key of this mode is \*(lqcpu\*(rq.
+.IP
+The sort keys that can be used in the 'io' display mode are:
+\*(lqtotal\*(rq, \*(lqread\*(rq, \*(lqwrite\*(rq, and  \*(lqfault\*(rq.
 .TP
 .B e
 Display a list of system errors (if any) generated by the last
%%