--- ray/doc/man/man1/total.1	2005/06/02 04:47:26	1.4
+++ ray/doc/man/man1/total.1	2016/03/24 18:48:28	1.9
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: total.1,v 1.4 2005/06/02 04:47:26 greg Exp $"
+.\" RCSid "$Id: total.1,v 1.9 2016/03/24 18:48:28 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
@@ -87,9 +91,16 @@ number of input channels.
 .PP
 A count can be given as the number of lines to read before
 computing a result.
-By default,
+Normally,
 .I total
-reads each file to its end before producing its result, but the
+reads each file to its end before producing its result, 
+but this behavior may be overridden by inserting blank lines in
+the input.
+For each blank input line, total produces a result as if the
+end-of-file had been reached.
+If two blank lines immediately follow each other, total closes
+the file and proceeds to the next one (after reporting the result).
+The
 .I \-N
 option (where N is a decimal integer) tells
 .I total
@@ -98,13 +109,21 @@ every N input lines.
 In addition, the
 .I \-r
 option can be specified to override reinitialization and thus
-give a running total every N lines.
+give a running total every N lines (or every blank line).
 If the end of file is reached, the current total is printed
 and the calculation is reset before the next file (with or without the
 .I \-r
 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.
@@ -113,11 +132,11 @@ If no files are given, the standard input is read.
 .SH EXAMPLE
 To compute the RMS value of colon-separated columns in a file:
 .IP "" .2i
-total -t: -m -s2 input
+total \-t: \-m \-s2 input
 .PP
 To produce a running product of values from a file:
 .IP "" .2i
-total -p -1 -r input
+total \-p \-1 \-r input
 .SH BUGS
 If the input files have varying numbers of columns, mean values
 will certainly be off.
@@ -128,4 +147,4 @@ the tab character is white.
 .SH AUTHOR
 Greg Ward
 .SH "SEE ALSO"
-cnt(1), neaten(1), rcalc(1), rlam(1), tabfunc(1)
+cnt(1), neaten(1), rcalc(1), rcollate(1), rlam(1), tabfunc(1)