NAME

       nngrep - grep for news group names (nn)

SYNOPSIS

       nngrep [ -ainprsu ] [ -l ] [ pattern ]

DESCRIPTION

       nngrep can print various selections of the available news groups.

       Without  options,  nngrep will list all currently subscribed newsgroups whose name matches
       any of the specified patterns.  If no pattern is specified, all subscribed groups will  be
       listed.

       The  selection  of  news  groups  against which the patterns are matches, and subsequently
       printed by nngrep can be limited or expanded using the following command line options  and
       arguments:

       -a     Use both subscribed and unsubscribed groups.  Overrides the -u option.

       -i     Use only ignored groups, i.e. which are not in the presentation sequence.

       -n     Use  only  new  groups.   Notice that nn considers a group to be new until you have
              read at least one article in the group, or you  have  unsubscribed  to  the  group.
              This  means that even reasonable active news groups may remain "new" for quite some
              time if it only contains articles which are  cross-posted  to  other  groups  which
              occur earlier in your presentation sequence.

       -p     Use only groups with unread (pending) articles.

       -r     Use only read groups, i.e. without unread articles.

       -s     Use only groups which are in the presentation sequence.

       -u     Use only unsubscribed groups.

       These options can be combined if they don't logically exclude each other.

       For example, to get the names of all "source" groups, you can use the command
            nngrep source

       You can use this to read a specific subset of news groups with nn; for example
            nn `nngrep -sp source`

LONG LISTING

       A long listing of the matched groups can be requested with the -l option.  It will include
       the following information:

       SUBSCR     Specifies whether the group is subscribed or not (yes/no).
       NEW        Specifies whether the group is new or not (yes/no).
       UNREAD     Shows the number of unread articles in the group (if any).
       SEQUENCE   Shows the group's index in the presentation sequence.
       GROUP      The name of the group.

FILES

       ~/.newsrc    The record of read articles
       ~/.nn/init   The presentation sequence

SEE ALSO

       nn(1), nncheck(1), nngoback(1), nngrab(1), nnpost(1), nntidy(1)
       nnadmin(1M), nnusage(1M), nnmaster(8)

AUTHOR

       Kim F. Storm, Texas Instruments A/S, Denmark
       E-mail: storm@texas.dk