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