>Number:         14465
>Category:       misc
>Synopsis:       [PATCH] csh.1 doesn't explain "set time" variables
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Nov 05 03:46:00 PST 2001
>Closed-Date:
>Last-Modified:
>Originator:     Jonathan Perkin
>Release:        1.5Y
>Organization:
British Broadcasting Corporation
>Environment:
NetBSD trumpton.sketch.org.uk 1.5Y NetBSD 1.5Y (CARDBUS-$Revision: 1.39 $) #1: Fri Nov  2 14:37:47 GMT 2001     sketch@trumpton.sketch.org.uk:/usr/src/sys/arch/i386/compile/TRUMPTON i386
>Description:
The csh(1) manpage doesn't document the "set time" variables used to
define how the output of built-in time command is printed.  Given this
is the standard shell used, having full documentation for it might be
a good idea :)
>How-To-Repeat:

>Fix:
Index: csh.1
===================================================================
RCS file: /home/ncvs/basesrc/bin/csh/csh.1,v
retrieving revision 1.31
diff -b -u -r1.31 csh.1
--- csh.1       2001/10/17 21:50:57     1.31
+++ csh.1       2001/11/03 00:59:05
@@ -2003,10 +2003,51 @@
 all other builtin commands set status to `0'.
 .It Ic time
 Controls automatic timing of commands.
-If set, then any command that takes more than this many cpu seconds
-will cause a line giving user, system, and real times and a utilization
-percentage which is the ratio of user plus system times to real time
-to be printed when it terminates.
+This setting allows two parameters, the first which specifies the CPU time
+threshold at which reporting should be done for a process, and the optional
+second which specifies the output format.  The following format strings are
+available:
+.Pp
+.Bl -tag -width Ds -compact -offset indent
+.It Li \&%D
+Average unshared data size.
+.It Li \&%E
+Elapsed (wall\-clock) time.
+.It Li \&%F
+Page faults.
+.It Li \&%I
+Filesystem blocks in.
+.It Li \&%K
+Average total data memory used.
+.It Li \&%M
+Maximum Resident Set Size.
+.It Li \&%O
+Filesystem blocks out.
+.It Li \&%P
+Total percent time spent running.
+.It Li \&%R
+Page reclaims.
+.It Li \&%S
+Total system CPU time used.
+.It Li \&%U
+Total user CPU time used.
+.It Li \&%W
+Number of swaps.
+.It Li \&%X
+Average shared text size.
+.It Li \&%c
+Number of involuntary context switches.
+.It Li \&%k
+Number of signals received.
+.It Li \&%r
+Socket messages received.
+.It Li \&%s
+Socket messages sent.
+.It Li \&%w
+Number of voluntary context switches (waits).
+.El
+.Pp
+The default summary is "%Uu %Ss %E %P %X+%Dk %I+%Oio %Fpf+%Ww"
 .It Ic verbose
 Set by the
 .Fl v
>Release-Note:
>Audit-Trail:
>Unformatted: