.TH subtotal "" "" "/rdb Command"
.PC "Output subtotals of columns in a table
\fBsubtotal [ \-l ] [ \fIbreak-column column ... \fB]  < \fItable\fR
.PP
.II column^subtotal
.II "column^compute subtotal"
The command
.B subtotal
computes subtotals in each numeric
.I column
within
.IR table .
.PP
.B subtotal
uses
.I break-column
to mark where computation should begin and end:
as long as a value in
.I break-column
remains the same, the values in the other columns are accumulated.
When the value in the
.I break-column
changes,
.B subtotal
prints the value or values accumulated since the last break.
.PP
If no columns are specified on the command line,
.B splittable
uses the first, or leftmost, column of the table as the
break column, and computes subtotals for all other columns.
.PP
The option
.B \-l
prints whole table, not just the subtotals.
.SH Example
There are two forms of output.
One produces only the subtotals.
If you wanted to see the daily subtotals of table
.BR journal ,
type:
.DM
	subtotal Date Debit Credit < journal
.DE
.PP
This produces something like the following:
.DM
Date    Account Debit   Credit  Description                       
------  ------- -----   ------  ----------------------------------
891222          25000    25000                                    
891223          10000    10000                                    
891224          30000    30000                                    
.DE
.PP
Note that columns
.B Description
and
.B Account
are blank, because they contain non-numeric data.
.PP
The
.B \-l
prints the entire table, as well as the subtotals.
For example, the command
.DM
	subtotal -l Date Debit Credit < journal
.DE
.PP
produces:
.DM
Date    Account Debit   Credit  Description                       
------  ------- -----   ------  ----------------------------------
891222  101     25000           cash from loan
891222  211.1            25000  loan number #378-14 Bank Amerigold
------  ------- -----   ------  ----------------------------------
891222          25000    25000                                    
.DE
.DM
891223  150.1   10000           test equipment from Zarkoff
891223  101               5000  cash payment
891223  211.2             5000  note payable to Zarkoff Equipment
------  ------- -----   ------  ----------------------------------
891223          10000    10000                                    
.DE
.DM
891224  130     30000           inventory - parts from CCPSC
891224  201.1            15000  accounts payable to CCPSC
891224  101              15000  cash payment to CCPSC for parts
------  ------- -----   ------  ----------------------------------
891224          30000    30000                                    
.DE
.PP
This lets you see each row as well as the subtotals.
This could help you find out when you got out of balance.
.SH "See Also"
.B
compute,
maximum,
mean,
minimum
.R
.SO subtotal