     The Selector

     Most people who don't have all day to read news will want to enter a
     newsgroup by way of the selector.  This is accomplished by using the '+'
     command at the newsgroup-selection or article/pager levels.  In fact,
     this may be the default command for entering a newsgroup, depending on
     how your version of trn was configured and your use of the -X option.

     The selector displays a list of articles by their subjects and (usually)
     authors.  The articles are grouped into threads by default (which may
     list multiple subjects per selectable item if the subject has changed
     during the discussion) and ordered by the date of their oldest unread
     article.  Thread or subject groups are also shown with a count of the
     number of articles in each group.  Each selectable item is preceded by a
     letter or number that can be typed to toggle its selection.  Items that
     are selected are flagged with a '+' after their letter.  Groups that
     have only some of their articles selected are flagged with a '*'.  You
     can change the selector's mode (to pick each subject separately or pick
     individual articles), order the list by a variety of sort criteria, and
     switch the author display between its long, medium and short styles
     using the commands detailed below.

     The following commands are available in the selector:

     a-z,0-9,A-Z
             Select/deselect the indicated item by its letter or number.
             There are quite a few letters omitted from the alpha characters
             to be typed as commands -- see below.  Also, the variable
             SELECTCHARS is available to customize which characters you want
             to be used as selection letters, overriding their command func-
             tion.

     SP      Perform the default command.  This is usually > for most pages,
             and Z on the last page (although D and X are also quite popu-
             lar).

     CR      Begin reading.  If no articles are selected, the current item is
             selected (unless you've marked it as killed).

     Z,TAB   Begin reading.  If no articles are selected, read all unread
             articles.

     '.'     Toggle the current item's selection (the one under the cursor).

     *       Same as '.' except that it affects all articles with the same
             subject (useful in the article selector).

     #       Make an overriding selection that reads the current item only,
             temporarily ignoring all other selections.

     k, ','  Mark the current item as killed.

     m, \    Unmark the current item.

     -       Set a range, as in a - k.  Repeats the last marking action:
             selection, deselection, killing, or unmarking.

     @       Toggle all visible selections.

     M       Mark the current item's article(s) to return on newsgroup exit
             and kill the item.

     Y       Yank back and select the marked-to-return articles, clearing
             their to-return status.

     E       Exclude all unselected items from the selection list (narrow the
             display).  Press it again to pick from all available items.

     n, ]    Move down to the next item (try the down-arrow keypad key also).

     p, [    Move up to the previous item (try the up-arrow keypad key also).

     <       Go to previous page (try the left-arrow keypad key also).

     >       Go to next page (try the right-arrow keypad key also).

     ^       Go to the first page.

     $       Go to the last page.

     S       Set the items the selector displays: threads, subjects or arti-
             cles.  If the group is unthreaded setting this to threads will
             thread the group.

     =       Switch between the article selector and the subject/thread
             selector.

     O       Pick the order for the items: date, subject, author, item count
             (for thread/subject groups), and a subject-date grouping of
             individual articles.  Typing the selection in lower-case will
             sort the articles in the default direction, while using upper-
             case will reverse the sort.  There is a separate default sort
             order for the subject/thread selector and the article selector.
             See the -O option to set your favorite selector mode and sort
             order as the default.

     R       Reverse the current sort order.

     L       Switch the selector's display between the long, medium and short
             display styles.  See the -x option to set your favorite style as
             the default.

     U       Switch between selecting unread/read articles.

     X       Mark all unselected articles as read and start reading.

     D       Mark unselected articles on the current page as read and begin
             reading if articles are selected, otherwise go to the next page.

     J       Mark all selected articles as read (useful after performing some
             action on them with the ':' command).

     c       Catch up -- marks ALL articles as read without affecting their
             cross-posted counterparts.

     A       Add a subject-search command to the memorized list (a.k.a. a
             KILL file) for this group.  You are prompted to choose selection
             (+), junking (j), selection including all replies (.) or junking
             including all replies (,).  If the thread has more than one sub-
             ject the first subject is the one chosen for the memorized com-
             mand.

     T       Add a thread-oriented command to the memorized list for this
             group.  You are prompted to choose selecting the thread (+),
             junking the thread (j), or clearing the auto-selection/junking
             for the thread (c).  (Note: there are three other options ('.',
             ',', and 'C') on the article-reading level -- look there for an
             explanation of their use.)

     ^K      Edit the local list of memorized commands (a.k.a. a KILL file)
             for this newsgroup.  A detailed description of memorized com-
             mands is found in the Article Selection section.

     :command
             Apply a command to all selected articles.  If nothing is
             selected, nothing is done.

             Applicable commands include '+'/'-' (select/deselect an arti-
             cle), "++"/"--" (select/deselect a thread), "T+" (auto-select
             the entire thread), "Tj" (auto-junk the entire thread), 't'
             (display article tree), "s dest" (save article to a destina-
             tion), "e dir" (extract to directory), 'E' (end partial
             uudecode), as well as: S, |, w, W, m, M, j, = and ','.

     /pattern
             Scan all articles for a subject containing pattern and select
             it.

     /pattern/modifiers:command{:command}
             Apply the commands listed to articles matching the search com-
             mand (possibly with h, a, r, or K modifiers).  The default
             action, if no command is specified, is to select the article's
             item in the selector (e.g. the entire thread ("++") in the
             thread selector).  See the section on Regular Expressions and
             the description of pattern searching in the Article Selection
             section.

             One example: to scan all the unread articles looking for "topic"
             anywhere in the article and then select its group and save the
             articles to the files topic.1, topic.2, etc. use "/topic/a:++:s
             topic.%#".

     N       Go to the next newsgroup with unread news.

     P       Go to the previous newsgroup with unread news.

     &       Display or set the current status of command-line switches.

     &&      Display or set the current macro definitions.

     !command
             Escape to a subshell.

     q       Quit this group.

     ESC,+   Quit the selector to the article level.  Note: ESC won't work if
             trn has mapped your arrow keys with default macros and the first
             character that your arrow keys send is an ESC.

     Q       Quit the current newsgroup and return to the newsgroup-selection
             prompt for this group.

