NNSUB(l)

NAME
nnsub - subscribe to newsgroups

SYNOPSIS
nnsub [ -v[0,1] ] [ group ] ...

DESCRIPTION
nnsub subscribes to the supplied groups by updating your .newsrc file.

The groupnames can be entered either as program arguments or on the standard input (one groupname per line).

If running with terminal control and verbosity 1 (see options) nnsub tries to find all newsgoup names which partially match the supplied name if an exact match is not found. It then prints the count of found matches and gives you the option to subscribe to all, to none or to select groups via a menu in the same way as described below.

If a questionmark (?) is given as groupname nnsub will start to present all (1000+) newsgroups in menu's of one screen. One group per line preceeded by a letter resembling the selection menu from nn. At each menu you are asked to enter a command closed by a NEWLINE. Newgroups can be selected for subscription by including their preceding (lower case) letter in the command. The presenting of the menu's can be quitted by including a capital Q (for Quit) in the commandline. Also recognized are B (=Bye), E (=End), R (=Resume) or X (=eXit). An empty commandline will result in the prsenting of the next menu (or in quiting the presenting of the menu's).

If running without terminal control or verbosity 0 partial name matching is only performed if the supplied name starts andor ends with a dot (.). All found matches will be subscribed to. A questionmark (?) as groupname will be ignored.

OPTIONS

There is one option -v for verbosity with a value 0 or 1.

-v0 No interaction is possible, fuzzy matching only if the name starts andor ends with a dot. No report is written, the program's exitvalue shows the number of requested but not subscribed (BOGUS) newsgroups. Default if running without terminal control.

-v1 The program tries to find newsgroups with partial name matching and enables you to confirm subscriptions if partial matches are found. A report of subscriptions is written. Default if running with a terminal.

FILES
~/.newsrc    The record of read articles

SEE ALSO
nn(1), nncheck(1), nngoback(1), nngrab(1), nngrep(1), nnpost(1), nntidy(1)

AUTHOR
Rudi van Houten, Academisch Computer Centrum Utrecht
E-mail: Rudi@cc.ruu.nl