ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/Development/ray/doc/man/man1/total.1
(Generate patch)

Comparing ray/doc/man/man1/total.1 (file contents):
Revision 1.5 by greg, Tue Jun 21 02:34:22 2005 UTC vs.
Revision 1.8 by greg, Thu Sep 5 17:53:22 2013 UTC

# Line 87 | Line 87 | number of input channels.
87   .PP
88   A count can be given as the number of lines to read before
89   computing a result.
90 < By default,
90 > Normally,
91   .I total
92 < reads each file to its end before producing its result, but the
92 > reads each file to its end before producing its result,
93 > but this behavior may be overridden by inserting blank lines in
94 > the input.
95 > For each blank input line, total produces a result as if the
96 > end-of-file had been reached.
97 > If two blank lines immediately follow each other, total closes
98 > the file and proceeds to the next one (after reporting the result).
99 > The
100   .I \-N
101   option (where N is a decimal integer) tells
102   .I total
# Line 98 | Line 105 | every N input lines.
105   In addition, the
106   .I \-r
107   option can be specified to override reinitialization and thus
108 < give a running total every N lines.
108 > give a running total every N lines (or every blank line).
109   If the end of file is reached, the current total is printed
110   and the calculation is reset before the next file (with or without the
111   .I \-r
# Line 109 | Line 116 | The
116   option can be used to specify the input and output tab character.
117   The default tab character is TAB.
118   .PP
112 – At least one set of totals is produced for each input file.
119   If no files are given, the standard input is read.
114 – If a file contains any blank lines, then the total is reported
115 – at that point as if it constituted the end of file, and the tallies
116 – are reset.
120   .SH EXAMPLE
121   To compute the RMS value of colon-separated columns in a file:
122   .IP "" .2i
123 < total -t: -m -s2 input
123 > total \-t: \-m \-s2 input
124   .PP
125   To produce a running product of values from a file:
126   .IP "" .2i
127 < total -p -1 -r input
127 > total \-p \-1 \-r input
128   .SH BUGS
129   If the input files have varying numbers of columns, mean values
130   will certainly be off.
# Line 132 | Line 135 | the tab character is white.
135   .SH AUTHOR
136   Greg Ward
137   .SH "SEE ALSO"
138 < cnt(1), neaten(1), rcalc(1), rlam(1), tabfunc(1)
138 > cnt(1), neaten(1), rcalc(1), rcollate(1), rlam(1), tabfunc(1)

Diff Legend

– Removed lines
+ Added lines
< Changed lines (old)
> Changed lines (new)