.\" 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 "STATNEWS 1"
.TH STATNEWS 1 "2011-12-25" "Debian Project" "Debian GNU/Linux Manual"
.\" 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"
statnews \- generate some useful statistics out of a newsgroup
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
statnews [\s-1OPTIONS\s0] \fI\s-1NEWSGROUP\s0\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The \fBstatnews\fR command get some useful statistics out of a newsgroup.
It displays things like how many articles each author posted, how many
characters was written, how many lines were quoted, how many articles
belong to each thread, the number of messages/characters per day, the
average message length, and so on.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-\-capitalize\fR(*)" 4
.IX Item "--capitalize(*)"
Whether to capitalize the name of both the sender and the receiver of
each message (default is \f(CW\*(C`\-\-capitalize\*(C'\fR: yes).  This option is useful
to collect \f(CW"AUTHOR"\fR together with \f(CW"author"\fR, \f(CW"Author"\fR, and
\&\f(CW"AuThor"\fR.
.IP "\fB\-\-dotted\fR(*)" 4
.IX Item "--dotted(*)"
Whether to translate \f(CW"."\fR to \f(CW"/"\fR in \fI\s-1NEWSGROUP\s0\fR (default is
\&\f(CW\*(C`\-\-nodotted\*(C'\fR: does translate).  This option may be useful if your
system stores each newsgroup in a dedicate directory (e.g.,
\&\fInews.useless.group\fR) instead that by hierarchy (e.g.,
\&\fInews/useless/group\fR), or if your system has a news archive stored
this way.
.IP "\fB\-\-from=\fR\fI\s-1DATE\s0\fR" 4
.IX Item "--from=DATE"
Set the date statistics start from (\fI\s-1DATE\s0\fR format is \f(CW\*(C`dd/mm/yyyy\*(C'\fR, \s-1GMT\s0).
.IP "\fB\-\-help\fR" 4
.IX Item "--help"
Display the help summary.
.IP "\fB\-\-spooldir=\fR\fI\s-1SPOOLDIR\s0\fR" 4
.IX Item "--spooldir=SPOOLDIR"
Search \fI\s-1NEWSGROUP\s0\fR in \fI\s-1SPOOLDIR\s0\fR (default is \fI/var/spool/news/articles/\fR).
.IP "\fB\-\-to=\fR\fI\s-1DATE\s0\fR" 4
.IX Item "--to=DATE"
Set the date statistics end by (\fI\s-1DATE\s0\fR format is \f(CW\*(C`dd/mm/yyyy\*(C'\fR, \s-1GMT\s0).
.IP "\fB\-\-width=\fR\fI\s-1WIDTH\s0\fR" 4
.IX Item "--width=WIDTH"
Set the terminal width to \fI\s-1WIDTH\s0\fR columns (default is 80, with a
minimum of 70).
.PP
Options may be conveniently abbreviated and prefixed by \*(L"\-\*(R" instead of
\&\*(L"\-\-\*(R"; the \*(L"=\*(R" may be omitted or substituted with one or more blanks.
.PP
Options listed with (*) may be negated by adding the prefix \f(CW"no"\fR in
front of them (e.g., \f(CW\*(C`\-\-dotted\*(C'\fR => \f(CW\*(C`\-\-nodotted\*(C'\fR).
.SH "RETURN VALUE"
.IX Header "RETURN VALUE"
The \fBstatnews\fR command returns 0 on success and a positive integer on
errors.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
The environment variable \fI\s-1STATNEWS\s0\fR can hold a set of default options for
\&\fBstatnews\fR.
.PP
These options are interpreted first by the program and can be
overridden by explicit command line parameters.  For example:
.IP "\fBsh:\fR" 4
.IX Item "sh:"
\&\f(CW\*(C`STATNEWS="\-\-nocapital \-\-width=132"; export STATNEWS\*(C'\fR
.IP "\fBcsh:\fR" 4
.IX Item "csh:"
\&\f(CW\*(C`setenv STATNEWS "\-\-nocapital \-\-width=132"\*(C'\fR
.SH "FILES"
.IX Header "FILES"
The default spool directory is \fI/var/spool/news/articles/\fR.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIrn\fR\|(1), \fIreadnews\fR\|(1).
.SH "BUGS"
.IX Header "BUGS"
There are no known bugs.
.SH "UNRESTRICTIONS"
.IX Header "UNRESTRICTIONS"
This program is copylefted.  Refer to the \s-1GNU\s0 General Public License
for conditions of use.
.SH "AUTHOR"
.IX Header "AUTHOR"
This program has been written and is actively maintained by Davide\ Giovanni\ Maria Salvetti <salve@debian.org>.
.SH "HISTORY"
.IX Header "HISTORY"
This program was originally aimed for use with FidoNet style echo areas under
Debian GNU/Linux.  It can be successfully used with Usenet newsgroups as well.
More precisely, it can be used with every message base that stores one message
per file in some directory in traditional mbox format.