--- ray/doc/man/man1/total.1 2003/12/09 15:59:07 1.2 +++ ray/doc/man/man1/total.1 2005/06/21 02:34:22 1.5 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: total.1,v 1.2 2003/12/09 15:59:07 greg Exp $" +.\" RCSid "$Id: total.1,v 1.5 2005/06/21 02:34:22 greg Exp $" .TH TOTAL 1 2/3/95 RADIANCE .SH NAME total - sum up columns @@ -15,6 +15,10 @@ total - sum up columns | .B \-l ][ +.B \-i{f|d}[N] +][ +.B \-o{f|d} +][ .B \-tC ][ .B \-N @@ -64,6 +68,23 @@ For products, the geometric mean is computed. (A logarithmic sum of absolute values is used to avoid overflow, and zero values are silently ignored.) .PP +If the input data is binary, the +.I \-id +or +.I \-if +option may be given for 64-bit double or 32-bit float values, respectively. +Either option may be followed immediately by an optional +count, which defaults to 1, indicating the number of double or float +binary values to read per record on the input file. +(There can be no space between the option and this count.)\0 +Similarly, the +.I \-od +and +.I \-of +options specify binary double or float output, respectively. +These options do not need a count, as this will be determined by the +number of input channels. +.PP A count can be given as the number of lines to read before computing a result. By default, @@ -88,7 +109,11 @@ The option can be used to specify the input and output tab character. The default tab character is TAB. .PP +At least one set of totals is produced for each input file. If no files are given, the standard input is read. +If a file contains any blank lines, then the total is reported +at that point as if it constituted the end of file, and the tallies +are reset. .SH EXAMPLE To compute the RMS value of colon-separated columns in a file: .IP "" .2i @@ -107,4 +132,4 @@ the tab character is white. .SH AUTHOR Greg Ward .SH "SEE ALSO" -cnt(1), lam(1), neat(1), rcalc(1), tabfunc(1) +cnt(1), neaten(1), rcalc(1), rlam(1), tabfunc(1)