     Newsgroup Selection Level

     In this section the words "next" and "previous" refer to the ordering of
     the newsgroups in your .newsrc file.  On the newsgroup-selection level,
     the prompt looks like this:

     ====== 17 unread articles in talk.blurfl -- read now? [ynq]

     unless the group is set for unthreaded reading, in which case the first
     six characters are "******".  The following commands may be given at
     this level:

     +       Enter this newsgroup through the selector.

     y       Begin reading this newsgroup now.

     SP      Enter the newsgroup by executing the default command listed in
             []'s.

     .command
             Do this newsgroup now, but execute command before displaying
             anything.  The command will be interpreted as if typed on the
             article selection level.

     =       Start this newsgroup, but list subjects before displaying arti-
             cles.

     U       Enter this newsgroup through the "Set unread" prompt.

     t       Toggle the newsgroup between threaded and unthreaded reading.
             The default is threaded, and the current setting is stored in
             your .newsrc.

     n       Go to the next newsgroup with unread news.

     N       Go to the next newsgroup.

     p       Go to the previous newsgroup with unread news.  If there is
             none, stay at the current newsgroup.

     P       Go to the previous newsgroup.

     -       Go to the previously displayed newsgroup (regardless of whether
             it is before or after the current one in the list).

     1       Go to the first newsgroup.

     ^       Go to the first newsgroup with unread news.

     $       Go to the end of the newsgroups list.

     g newsgroup
             Go to newsgroup, which can be the group's name or a zero-
             relative number of the groups in your .newsrc (see the 'L' com-
             mand to list your .newsrc).  If it isn't currently subscribed
             to, you will be asked if you want to subscribe.

     /pattern
             Scan forward for a newsgroup matching pattern.  Patterns do
             globbing like filenames, i.e., use ? to match a single charac-
             ter, * to match any sequence of characters, and [] to specify a
             list of characters to match.  ("all" may be used as a synonym
             for "*".) Unlike normal filename globbing, newsgroup-searching
             is not anchored to the front and back of the filename, i.e.
             "/ski" will find rec.skiing.  You may use ^ or $ to anchor the
             front or back of the search: "/^test$" will find newsgroup test
             and nothing else If you want to include newsgroups with 0 unread
             articles, append /r.  If the newsgroup is not found between the
             current newsgroup and the last newsgroup, the search will wrap
             around to the beginning.

     ?pattern
             Same as /, but search backwards.

     u       Unsubscribe from the current newsgroup.

     l string
             List newsgroups not subscribed to which contain the string
             specified.

     L       Lists the current state of the .newsrc, along with status infor-
             mation.

                  Status         Meaning
                  <number>       Count of unread articles in newsgroup.
                  READ           No unread articles in newsgroup.
                  UNSUB          Unsubscribed newsgroup.
                  BOGUS          Bogus newsgroup.
                  JUNK           Ignored line in .newsrc
                                 (e.g. readnews "options" line).

             (A bogus newsgroup is one that is not in the list of active
             newsgroups in the active file, which on most systems is
             /usr/lib/news/active unless you use NNTP.)

     m {name}
             Move the named newsgroup somewhere else in the .newsrc.  If no
             name is given, the current newsgroup is moved.  There are a
             number of ways to specify where you want the newsgroup -- type h
             for help when it asks where you want to put it.

     c       Catch up -- mark all unread articles in this newsgroup as read.

     A       Abandon the changes made to the current newsgroup since trn was
             started.  Useful when you accidentally mark a group as read.

     o {pattern}

     O {pattern}
             Only display those newsgroups whose name matches pattern.  Pat-
             terns are the same as for the '/' command.  Multiple patterns
             may be separated by spaces, just as on the command line.  The
             restriction will remain in effect either until there are no
             articles left in the restricted set of newsgroups, or another
             restriction command is given.  Since pattern is optional, 'o' by
             itself will remove the restriction.  Using 'O' will omit empty
             groups from the cycle.

     a pattern
             Add unsubscribed newsgroups matching pattern.  If any matching
             newsgroups are found, you will be asked for each one whether you
             would like to add it.  If you want to add all the newsgroups,
             you can type 'Y' and they will be added the the end of the
             .newsrc file.  If you don't want to subscribe, all the remaining
             groups can be ignored by typing 'N'.  After any new newsgroups
             have been added, the 'a' command also restricts the current set
             of newsgroups just like the 'o' command does.

     &       Print out the current status of command-line switches and any
             newsgroup restrictions.

     &switch {switch}
             Set additional command-line switches.

     &&      Print out the current macro definitions.

     &&keys commands
             Define additional macros.

     !command
             Escape to a subshell.  One exclamation mark (!) leaves you in
             your own news directory.  A double exclamation mark (!!) leaves
             you in the spool directory for news, which is usually
             /usr/spool/news unless you're using NNTP to read news.  The
             environment variable SHELL will be used if defined.  If command
             is null, an interactive shell is started.

     v       Print the current version number and information on where to
             send bug reports.

     q       Quit.

     x       Quit, restoring .newsrc to its state at startup of trn.  The
             .newsrc you would have had if you had exited with 'q' will be
             called .newnewsrc, in case you didn't really want to type 'x'.

     ^K      Edit the global list of memorized commands (in the global KILL
             file) that you wish to be performed in every newsgroup as it is
             started up (that is, when it is selected at the newsgroup-
             selection level).  This file contains commands (one per line)
             such as /subject/:j or /author/f:+ to kill or select articles
             based on the indicated search criteria.  There is also a local
             list of commands for each newsgroup that can contain
             kill/selection commands tailored for each specific group.
             Because of the overhead involved in searching for articles to
             kill, it is better if possible to use a local list rather than
             the global one.  Local memorized commands are usually maintained
             by using the 'A' or 'T' commands from the article/pager level or
             in the selector.  There is also a K search modifier that appends
             any search command you desire to add.  It is also possible to
             manually edit the file with the '^K' command from anywhere
             inside a newsgroup.  If either of the environment variables
             VISUAL or EDITOR is set, the specified editor will be invoked;
             otherwise a default editor is invoked on the KILL file.

     An 'n' typed at either the "Last newsgroup" prompt or a "Last article"
     prompt will cycle back to the top of the newsgroup or article list,
     whereas a 'q' will quit the level.  (Note that 'n' does not mean "no",
     but rather "next".) A space will of course do whatever is shown as the
     default, which will vary depending on whether trn thinks you have more
     articles or newsgroups to read.
