.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.30)
.\"
.\" 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" ''
.    ds C`
.    ds C'
'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.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" 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 "WC 1"
.TH WC 1 "2001-06-06" "perl v5.20.0" "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"
wc \-\- paragraph, line, word, character, and byte counter.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
wc [\-a | [\-p] [\-l] [\-w] [\-m] [\-c] ] file [file1 [file2...]]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fIwc\fR reads one or more input text files and, by default, writes the number of 
lines, words, and bytes contained in each input file to the standard output.
An optional count of paragraphs or characters is also possible in this 
implementation.  If more than one text file is specified, a line of total 
count(s) for all named files is output on a separate line following the 
last file count.
.PP
By default, the standard output contains a line for each input file of
the form:
.PP
.Vb 1
\&     lines     words     bytes file_name
.Ve
.PP
With all options specified the output line for each input file is
of the form:
.PP
.Vb 1
\&     paras     lines     words     chars     bytes file_name
.Ve
.PP
\&\fIwc\fR uses Perl's \f(CW\*(C`use locale\*(C'\fR pragma.
.SS "\s-1OPTIONS\s0"
.IX Subsection "OPTIONS"
.IP "none" 5
.IX Item "none"
No options to \fIwc\fR is equivalent to specifying \fI\-l\fR \fI\-w\fR 
and \fI\-c\fR.
.IP "\fB\-a\fR" 5
.IX Item "-a"
Is equivalent to specifying \fI\-p\fR \fI\-l\fR \fI\-w\fR \fI\-m\fR and \fI\-c\fR.
.IP "\fB\-p\fR" 5
.IX Item "-p"
Tells \fIwc\fR to count paragraphs in the input file(s). 
The algorithm employed counts lumped groups of lines that 
do not contain only zero or more space characters (\f(CW\*(C`/^\es*$/\*(C'\fR).
This regular expression is sensitive to locale settings.
.IP "\fB\-l\fR" 5
.IX Item "-l"
Tells \fIwc\fR to count lines in the input file(s).
.IP "\fB\-w\fR" 5
.IX Item "-w"
Tells \fIwc\fR to count words in the input file(s) as 
determined by perl's \f(CW\*(C`/\ew+/\*(C'\fR regular expression which
is locale sensitive.
.IP "\fB\-m\fR" 5
.IX Item "-m"
Tells \fIwc\fR to count characters in the input file(s).
This is implemented with a multi-byte character counting
regular expression \f(CW\*(C`m/$encoding/gox\*(C'\fR.  The \f(CW$encoding\fR 
defaults to one sensitive to well formed \s-1UTF\-8\s0 encodings 
(one to six byte characters) though this may be altered 
to other encodings by alteration of the program code.
Note that some 8 bit single byte characters will be 
missed by the \s-1UTF\-8\s0 character counter since such characters
fall outside the \s-1UTF\-8\s0 encoding.
.IP "\fB\-c\fR" 5
.IX Item "-c"
Tells \fIwc\fR to count bytes in the input file(s).
This is implemented with perl's \*(L"length\*(R" in perlfunc
built in function.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
The working of \fIwc\fR may be influenced by your locale since it 
uses the \fIlocale\fR pragma and this could have an effect on \fI\-w\fR
(word) and \fI\-p\fR (paragraph) counts.  \fIwc\fR may also be influenced by
\&\f(CW\*(C`PERLLIB\*(C'\fR or \f(CW\*(C`PERL5LIB\*(C'\fR since it uses File::Basename, locale,
and strict internally.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
perllocale.
.SH "BUGS"
.IX Header "BUGS"
\&\fIwc\fR has no known bugs.
.SH "STANDARDS"
.IX Header "STANDARDS"
The \fI\-a\fR and \fI\-p\fR options are peculiarities of this Perl implementation.
.SH "AUTHOR"
.IX Header "AUTHOR"
Peter Prymmer \fIpvhp@best.com\fR.
.SH "COPYRIGHT and LICENSE"
.IX Header "COPYRIGHT and LICENSE"
This program is copyright (c) by Peter Prymmer 1999.
.PP
This program is free and open software.  You may use, copy, modify, distribute
and sell this program (and any modified variants) in any way you wish,
provided you do not restrict others to do the same.