NAME¶
nncheck - check for unread articles
SYNOPSIS¶
nncheck [ -Q -r -t ] [ -f format ]
DESCRIPTION¶
nncheck will report if there are some articles on the system which you
have not read.
Without options,
nncheck will simply print a message reporting the number
of unread articles with the following format:
There are 327 unread articles in 25 groups
and when there are no unread articles, the following message will be printed:
No News (is good news)
nncheck will exit with a value of 0 if there are unread articles, and 99
if there is no news (see the exception for the -r option.)
It is important to notice that even though unread articles have been reported by
nncheck, the actual number of unread articles may be much lower (or
even zero) when
nn is invoked to read the articles. This is because the
calculation of the number of unread articles is only based on recorded article
number intervals. Invoking
nn to read the articles may reveal that the
articles have previously been read in another news group, have been expired,
or are
killed using the
auto-kill facility.
The following options are used to modify the amount and format of the output
from
nncheck:
- -Q
- Quiet operation. No output is produced, only the exit status indicate
whether there is unread news.
- -t
- Print the name of each group with unread articles, and how many unread
articles there are (not counting split digests!).
- -r
- Output a single integer value specifying the number of unread articles,
and exit with a 0 status (somebody told me this would be useful).
- -f format
- Output the number of unread articles using the specified format. The
format is a text that may contain the following %-escapes:
%-code resulting output
%u " uuu unread articles"
%g " ggg groups"
%i "is" if 1 unread article, else "are"
%U " uuu"
%G " ggg"
where uuu is the number of unread articles, and ggg is the
number of groups with unread articles.
For example, the default output format is
"There %i %u in %g"
which I prefer to the following less perfect format:
"There are %U unread article(s) in %G group(s)"
FILES¶
~/.newsrc The record of read articles
$db/MASTER The database master index
SEE ALSO¶
nn(1),
nngoback(1),
nngrab(1),
nngrep(1),
nnpost(1),
nntidy(1)
nnadmin(1M), nnusage(1M), nnmaster(1M)
AUTHOR¶
Kim F. Storm, Texas Instruments A/S, Denmark
E-mail: storm@texas.dk