.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "NUMSUM 1"
.TH NUMSUM 1 "2009-10-31" "perl v5.10.1" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
numsum \- numsum program file
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBnumsum\fR [\-iIcdhrsvxy] <\s-1FILE\s0>
.PP
| \fBnumsum\fR [\-iIcdhrsvxy]   (Input on \s-1STDIN\s0 from pipeline.)
.PP
\&\fBnumsum\fR [\-iIcdhrsvxy]     (Input on \s-1STDIN\s0.  Use Ctrl-D to stop.)
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBnumsum\fR
will take all the numbers on stdin and return the sum of those numbers.  Currently
it only processes the first number on each line.  Besides positive numbers, it also
handles negative numbers and numbers with decimals.
.SH "OPTIONS"
.IX Header "OPTIONS"
.Vb 2
\&    \-i  Only return the integer portion of the final sum.
\&    \-I  Only return the decimal portion of the final sum.
\&
\&    \-c      Print out the sum of each column.
\&    \-r      Print out the sum of each row.
\&
\&    \-x <n>  Specify a comma seperated list of columns to print.
\&    \-y <n>  Specify a comma seperated list of rows to print.
\&
\&    \-s <string> Specify a string to use as a seperator for columns.
\&                This defaults to be consecutive whitespace (\es+).
\&
\&    \-h  Help: You\*(Aqre looking at it.
\&    \-V  Increase verbosity.
\&    \-d  Debug mode.  For developers
\&    \-q  Quiet mode, don\*(Aqt print any warnings.
.Ve
.SH "EXAMPLES"
.IX Header "EXAMPLES"
Simply add up the numbers in a file.
    $ numsum numbers.txt
    4315
.PP
Enter your own numbers on \s-1STDIN\s0. The last number is the answer.
    $ numsum
    4
    21
    98
    100
    223
.PP
Use it in a command pipeline.
    $ ls \-1s | grep .mp3 | numsum \-c \-x 5
    72288
.PP
Add up the total byte count in a http log file.
    $ cat access_log | awk {'print \f(CW$10\fR'} numsum
.PP
.Vb 1
\&    or 
\&
\&    numsum \-c \-x 10 access_log
.Ve
.PP
Add up the columns of numbers of a file.
.PP
.Vb 8
\&    $ cat columns
\&    1 6 11 16 21
\&    2 7 12 17 22
\&    3 8 13 18 23
\&    4 9 14 19 24
\&    5 10 15 20 25
\&    $ numsum \-c columns
\&    15 40 65 90 115
.Ve
.PP
Add up the 1st, 2nd and 5th columns only.
.PP
.Vb 2
\&    $ numsum \-c \-x 1,2,5 columns
\&    15 40 115
.Ve
.PP
Add up the rows of numbers of a file.
.PP
.Vb 6
\&     $ numsum \-r columns
\&     55
\&     60
\&     65
\&     70
\&     75
.Ve
.PP
Add up the 2nd and 4th rows.
.PP
.Vb 3
\&     $ numsum \-r \-y 2,4 columns
\&     60
\&     70
.Ve
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fInumaverage\fR\|(1), \fInumbound\fR\|(1), \fInuminterval\fR\|(1), \fInumnormalize\fR\|(1), \fInumgrep\fR\|(1), \fInumprocess\fR\|(1), \fInumrandom\fR\|(1), \fInumrange\fR\|(1), \fInumround\fR\|(1)
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
numsum is part of the num-utils package, which is copyrighted by
Suso Banderas and released under the \s-1GPL\s0 license.  Please read
the \s-1COPYING\s0 and \s-1LICENSE\s0 files that came with the num-utils package
.PP
.Vb 2
\&  Developers can read the GOALS file and contact me about providing
\&submitions or help for the project.
.Ve
.SH "MORE INFO"
.IX Header "MORE INFO"
More info on numsum can be found at:
.IP "\fBhttp://suso.suso.org/programs/num\-utils/\fR" 1
.IX Item "http://suso.suso.org/programs/num-utils/"