--- ray/doc/man/man1/total.1	2013/09/05 17:53:22	1.8
+++ ray/doc/man/man1/total.1	2019/07/20 00:57:43	1.11
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: total.1,v 1.8 2013/09/05 17:53:22 greg Exp $"
+.\" RCSid "$Id: total.1,v 1.11 2019/07/20 00:57:43 greg Exp $"
 .TH TOTAL 1 2/3/95 RADIANCE
 .SH NAME
 total - sum up columns
@@ -19,6 +19,10 @@ total - sum up columns
 ][
 .B \-o{f|d}
 ][
+.B "\-in M"
+][
+.B "\-on M"
+][
 .B \-tC
 ][
 .B \-N
@@ -64,6 +68,9 @@ The
 .I \-m
 option can be used to compute the mean rather than the total.
 For sums, the arithmetic mean is computed.
+If a power is also specified using the
+.I \-s
+option, the inverse power will be applied to the averaged result.
 For products, the geometric mean is computed.
 (A logarithmic sum of absolute values is used to avoid overflow, and 
 zero values are silently ignored.)
@@ -112,12 +119,20 @@ and the calculation is reset before the next file (wit
 option).
 .PP
 The
+.I \-in
+option if present, will limit the number of input records read
+(per input file).
+The
+.I \-on
+option may be used to limit the total number of outut records produced.
+.PP
+The
 .I \-tC
 option can be used to specify the input and output tab character.
 The default tab character is TAB.
 .PP
 If no files are given, the standard input is read.
-.SH EXAMPLE
+.SH EXAMPLES
 To compute the RMS value of colon-separated columns in a file:
 .IP "" .2i
 total \-t: \-m \-s2 input
@@ -135,4 +150,4 @@ the tab character is white.
 .SH AUTHOR
 Greg Ward
 .SH "SEE ALSO"
-cnt(1), neaten(1), rcalc(1), rcollate(1), rlam(1), tabfunc(1)
+cnt(1), neaten(1), rcalc(1), rcollate(1), rlam(1), rsplit(1), tabfunc(1)