Provided by: tin_2.0.0-1_amd64 bug

NAME

       tin, rtin - A Usenet newsreader

SYNOPSIS

       tin [[-h|-H|-V] | [[[-a] [-dlnq|-Q] [-ArzxX]] [[-R|-S] -s News_dir] [-cuvZ] [-4|-6] [-N|-M
       address] [-o|-w]] [-D debug_level] [-G article_limit] [-f  newsrc_file]  [-g  server]  [-m
       Mail_dir] [-p port] [-I index_dir] [newsgroup[,...]]]

DESCRIPTION

       tin  is  a  full-screen  easy  to  use  Usenet newsreader. It can read news locally (e.g.,
       /var/spool/news) or remotely (rtin or tin -r option) via a NNTP  (Network  News  Transport
       Protocol)  server.  It will automatically utilize NOV newsoverview(5) style index files if
       available locally or via the NNTP [X]OVER command (RFC2980, RFC3977).

       tin has four separate levels of operation: Selection level, Group level, Thread level  and
       Article  level.  Use  the Help ('h') command to view a list of the commands available at a
       particular level.

       On   startup    tin    will    show    a    list    of    the    newsgroups    found    in
       ${TIN_HOMEDIR:-"$HOME"}/.newsrc.  An arrow '->' or highlighted bar will point to the first
       newsgroup. Move to a group by using the terminal arrow keys (terminal dependent)  or  Down
       ('j')  and  Up  ('k').  Use  PgUp/PgDn  (terminal dependent) or PageUp ('^U') (CTRL-U) and
       PageDown ('^D') (CTRL-D) to page up/down. Enter a newsgroup by pressing '<CR>'.

       The GroupNextUnreadArtOrGrp ('<TAB>') key enters the next newsgroup with unread articles.

EXIT STATUS

       Interactive mode:

            0      Successful program execution.

            1      Usage, syntax, configuration file or network error.

       Batch mode (''-Z''):

            0      No unread news

            1      Usage, syntax, configuration file or network error.

            2      Unread news

OPTIONS

       -4          Force connecting via IPv4 to the remote NNTP server.

       -6          Force connecting via IPv6 to the remote NNTP server.

       -a          Toggle ANSI color (default is off).

       -A          Force authentication on initial connect.

       -c          Create/update index files for every group  in  ${TIN_HOMEDIR:-"$HOME"}/.newsrc
                   or file specified by the ''-f'' option and mark all articles as read.

       -d          Don't load newsgroup descriptions (interactive mode).

       -D debug-level
                   Enter  debug-level  (1  =  NNTP,  2  = filter, 4 = newsrc, 8 = threading, 16 =
                   memory, 32 = attributes, 64 = misc).

       -f file     Use  the  specified  file  of   subscribed   to   newsgroups   in   place   of
                   ${TIN_HOMEDIR:-"$HOME"}/.newsrc.

       -g server   Use        the        server        and        newsrc       specified       in
                   ${TIN_HOMEDIR:-"$HOME"}/.tin/newsrctable.

       -G article-limit
                   Limit the number of articles/group to retrieve from the server.

       -h          Help listing all command-line options.

       -H          Brief introduction to tin that is also shown the first time it is started.

       -I dir      Directory  in   which   to   store   newsgroup   index   files.   Default   is
                   ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news.   This  option has
                   no effect if tin retrieves its index files via NNTP  and  cache_overview_files
                   is turned off.

       -l          Get       number       of      articles      per      group      from      the
                   ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active}  file.  If  reading  via
                   NNTP  this  is  done  with  the  LIST  command (RFC3977). This might result in
                   incorrect article counts but is usually faster than the default  which  is  to
                   read  the  ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active}  file (either
                   directly or via LIST) and then check the article count via NNTP GROUP  command
                   (RFC3977) ''-ln''.

       -m dir      Mailbox directory to use. Default is ${TIN_HOMEDIR:-"$HOME"}/Mail.

       -M user     Mail unread articles to specified user for later reading. For more information
                   read section "AUTOMATIC MAILING AND SAVING NEW NEWS".

       -n          Only              load              groups              from               the
                   ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active} file that are subscribed
                   to in the user's ${TIN_HOMEDIR:-"$HOME"}/.newsrc.  This  allows  a  noticeable
                   speedup when connecting via a slow line, but tin can not tell which groups are
                   moderated. See also ''-l''.

       -N          Mail unread articles to yourself for later reading. For more information  read
                   section "AUTOMATIC MAILING AND SAVING NEW NEWS".

       -o          Quick  post  all  postponed  articles and exit. In order for this to be really
                   quick, it should be used with ''-n'' if possible.

       -p port     Port to use if reading via NNTP (default is  119).  This  also  overrides  the
                   environment variable $NNTPPORT if set.

       -q          Don't check for new newsgroups.

       -Q          Quick start. Start tin as quickly as possible. Currently this is equivalent to
                   ''-nqd''.

       -r          Read news remotely from the default NNTP server specified in  the  environment
                   variable $NNTPSERVER or contained in the file /etc/news/server.

       -R          Read news saved by the ''-S'' option.

       -s dir      Save/read articles to/in directory. Default is ${TIN_HOMEDIR:-"$HOME"}/News.

       -S          Save  unread  articles  for  later  reading  by  the  ''-R''  option. For more
                   information read section "AUTOMATIC MAILING AND SAVING NEW NEWS".

       -u          Create/update index files for every group  in  ${TIN_HOMEDIR:-"$HOME"}/.newsrc
                   or  file  specified  by  the  ''-f''  option.  This  option is disabled if tin
                   retrieves its index files via a NNTP server and cache_overview_files is turned
                   off.

       -v          Verbose mode for ''-c'', ''-M'', ''-N'', ''-S'', ''-u'' and ''-Z'' options.

       -V          Print version and date information.

       -w          Quick  mode  to  post an article and then exit. In order for this to be really
                   quick, it should be used with ''-n'' if possible.

       -x          No posting mode. You cannot post articles if you use this option.

       -X          No   overwrite   mode.   ${TIN_HOMEDIR:-"$HOME"}/.newsrc    and    files    in
                   ${TIN_HOMEDIR:-"$HOME"}/.tin  will  not  be  overwritten but may be created if
                   they don't exist.

       -z          Only start tin if there is any new/unread news. If  there  is  news  tin  will
                   position  cursor  at first group with unread news. Useful for putting in login
                   file.

       -Z          Check if there is any new/unread news and exit  with  appropriate  status.  If
                   ''-v''  option  is  specified  the  number of unread articles in each group is
                   printed. An exit code 0 indicates no news, 1 that an error occurred and 2 that
                   new/unread news exists. Useful for writing scripts.

       tin  can  also dynamically change its options by the OptionMenu ('M') command. Any changes
       are written  to  ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc.  For  more  information  see  section
       "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES" and tin(5).

       A list of groups can be specified after the other command-line options. This can be useful
       if you wish to yank in or subscribe to a hand-picked subset of the active newsgroups.  See
       the section "NEWSGROUP LISTS & WILDCARDS" for the types of pattern that tin understands.

       If  you  specify  a single group-name, or a wildcard that matches a single group, then you
       will automatically enter that group. Otherwise the  normal  group  selection  screen  will
       appear,  but with all the matching groups present too, as though you had yanked just those
       groups in.

       With the ''-w'' flag a given group-name is used as default group to post to. If more  than
       one  group  or  a  wildcard is specified only the first group respectively the first group
       that matches is used.

       Once   you   use   SelectYankActive   ('y')   to   yank   in   all   active   groups,   or
       SelectToggleReadDisplay  ('r')  to  toggle  the  read/unread status, then the command-line
       groups  will  be  gone.  You  can   use   SelectSyncWithActive   ('Y')   to   reread   the
       ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active} file and get them back.

       NB:  With the ''-n'' flag, only unsubscribed groups in the ${TIN_HOMEDIR:-"$HOME"}/.newsrc
       file  (or  the  newsrc-file   given   by   the   ''-f''   command-line   switch   or   via
       ${TIN_HOMEDIR:-"$HOME"}/.tin/newsrctable) can be matched.

       Command-line  options  have  higher  priority  than  attributes  and tinrc options.  Thus,
       command-line option takes precedence over configured values.

USAGE

   NEWS ADMINISTRATION
       Maintaining Netnews on large networks of machines can be a pretty time consuming job as  I
       discovered when I was given the job of maintaining our news system and news users.

       A  user  starting  tin  for  the  first  time can be automatically subscribed to a list of
       newsgroups that are deemed appropriate by the news administrator. The  subscriptions  file
       should      be      created      in      your      news      lib      directory     (i.e.,
       ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions) and should have file permissions set to 0644.  If
       you read news via NNTP, then your news server must support the LIST SUBSCRIPTIONS command.
       It is part of the NNTP List Extensions (RFC6048) and all modern servers should  understand
       it.

   SCREEN FORMAT
       tin  has four separate levels of operation: Selection level, Group level, Thread level and
       Article level.

       At the Selection level the title displays (the name of the newsserver and) the  number  of
       subscribed  groups  (containing  new unread articles). The newsgroups are displayed in the
       middle of the screen with the number of unread articles displayed  on  the  same  line  in
       front.

       ->M    1     2  comp.security.announce  Announcements from the CERT abou
         M    2     1  news.admin.announce     Announcements for news adminstra
              3    22  news.software.misc      News-related software other than
              4  1475  news.software.nntp      The Network News Transfer Protoc
         X    5   124  news.software.readers   Discussion of software used to r

       There may also be a character prefixing the line. An explanation follows:

       u         This  group  is  unsubscribed.  To  see  only  your  subscribed  groups  use the
                 SelectToggleReadDisplay ('r') or SelectYankActive ('y') toggle keys.

       M         This is a moderated group. Any posts you make will have to be  approved  by  the
                 group administrator before it will be made public. tin will ask for confirmation
                 before you post to a moderated group.

       N         This is a new newsgroup which has been created since  you  last  used  tin.  New
                 newsgroups  are  not subscribed to by default (However, see the $AUTOSUBSCRIBE /
                 $AUTOUNSUBSCRIBE environment variables).  Subscribe to it in the normal  way  if
                 you  wish  the group to continue to appear in your Selection Menu. Simply ignore
                 new newsgroups and they will be gone the next time you start tin. You will  have
                 to yank in all the groups to find them in a later session.

       D         This  group  no  longer  exists.  If  you  no longer wish to see this group then
                 unsubscribe from it in the normal way. This flag will only appear  if  you  have
                 set strip_bogus to "ask" in the Options Menu.

       X         You  may no longer make posts to this group. Often a group will be superseded by
                 a more appropriately named one.

       =         This group has been renamed and you may no longer post to it. If  you  do,  then
                 you  will receive an error from your newsserver telling you the correct group to
                 post to.

       At the Group level the title contains the name of the group, the  number  of  conversation
       threads, the threading method, the limit of articles to get, the total number of articles,
       the number of hot articles, the number  of  recent  articles  and  the  number  of  killed
       articles. I.e.:

                   alt.sources (5B -50/23+ 0* 3o 0K)

       The  characters  after  the  numbers are depending to the configuration and if your are in
       show_only_unread_arts mode or not. Some numbers could be missing if the specific option is
       not  enabled.  It  might also contain an 'M', 'X' or '=' (see above; doesn't work with the
       ''-n'' command-line switch!) if the group is moderated, set to no posting or  postings  to
       it get redirected.

       If a thread has unread articles in it it's marked with a art_marked_unread in front of the
       total number of articles in the thread. If there are recent articles within the thread  it
       might  be  marked  with  art_marked_recent in front of the total number of articles in the
       thread - this is controlled by the recent_time option. If a thread has hot articles in  it
       (see  also  section "FILTERING ARTICLES") it's marked with art_marked_selected in front of
       the total number of articles in the thread. The number of  lines  of  the  first  (unread)
       article in the thread might also be shown right before the subject - this is controlled by
       the show_info option.

                       de.admin.net-abuse.announce (11B 13+ 1* 1o 0K) M

       ->   1   +   3  108 bincancels in de.talk.sex        Christopher Lueg <l
            2   +       69 EMP/ECP gecancelt. xynx. BI= 10  Henning Weede <hwee
            3   o       93 EMP gecancelt. SouthBeach/Palms  Henning Weede <hwee
            4   *      368 <1997-11-12> Fremdcancel-FAQ     Thomas Roessler <ro

       At the Thread level the screen usually (depends on the threading method used)  looks  like
       this:

       ->   1      [   7]  What is this funny tree in the thr  Robert F. Simmig
            2      [  12]  +->                                 Sephan Wagner <s
            3      [ 230]  | `->Tin thread-level (was: What is Bob Johnson <bob
            4      [  22]  `->tin threading menu               Brian Richardson

       At the Article level the page header has the following format:

       Sun, 28 Dec 1997 21:21:01   de.admin.news.groups      Thread   20 of 86
       Lines 50   Re: EINSPRUCH zu RESULT:de.comm.mobil.ALL   Article  47 of 59
       Urs Janssen <urs@akk.org>        at Arbeitskreis Kultur und Kommunikati

       article-body

   COMMON MOVING KEYS
       This table shows the common keys used for moving around all levels within tin.
                                    ANSI/vt100   Other Terminals
              Beg. of list/article  Home         FirstPage (^)
              End of list/article   End          LastPage ($)
              Page Up               PgUp         PageUp (u, ^U or ^B)
              Page Down             PgDn         PageDown (^D or ^F or <SPACE>)
              Line Up               Up arrow     Up (k or ^P)
              Line Down             Down arrow   Down (j or ^N)

   COMMON EDITING COMMANDS
       An  emacs style editing package allows the easy editing of input strings.  An history list
       allows the easy reuse of previously entered strings.  In addition to the cursor keys,  the
       following commands are available when editing a string:

       ^A, ^E    move to beginning or end of line, respectively.

       ^F, ^B    non-destructive move forward or back one location, respectively.

       ^D        delete the character currently under the cursor, or send EOF if no characters in
                 the buffer.

       ^H, <DEL> delete character left of the cursor.

       ^K        delete from cursor to end of line.

       ^P, ^N    move through history, previous and next, respectively.

       ^L, ^R    redraw the current line.

       <CR>      places line on history list if non-blank, appends newline  and  returns  to  the
                 caller.

       <ESC>     aborts the present editing operation.

   GLOBAL COMMANDS
       The following commands are available at all 4 menu levels and always have the same effect.

       ShellEscape '!'
                 Shell  escape.  ShellEscape by itself will launch a shell, ShellEscape <command>
                 will run an external <command>. This facility may  have  been  disabled  by  the
                 System Administrator.

       ToggleColor '&'
                 Toggle use of ANSI color.

       RedrawScr '^L'
                 Redraw the current screen.

       ScrollUp '<'
                 Scroll screen up by one line.

       ScrollDown '>'
                 Scroll screen down by one line.

       Postponed 'O' '^O'
                 Reload postponed article. If your system blocks the Postponed key you must quote
                 it by pressing '^V' (CTRL-V)  first.  The  postpone-menu  offers  the  following
                 actions:  PromptYes  ('y')  =  reload and spawn editor; PostponeOverride ('Y') =
                 post article (without spawning editor); PostponeAll ('A') = post  all  postponed
                 articles  (without  spawning  editor);  PromptNo ('n') = skip this article; Quit
                 ('q') = quit postponed menu. Currently there is no  'simple'  way  to  delete  a
                 postponed article from the postponed-file, you have to use the following command
                 sequence instead: reload it with Postponed, enter editor  with  PromptYes,  quit
                 editor,  discard  posting  with  Quit ('^O''y''q'). See also ''-o'' command-line
                 switch.

       Help 'h'  Help screen of commands available on the current menu. You can  use  SearchSubjF
                 ('/'),  SearchSubjB  ('?') and SearchRepeat ('\') to search on this screen. Quit
                 ('q') returns to the menu.

       ToggleHelpDisplay 'H'
                 Toggle the display of help mini menu at the bottom of the screen.

       DisplayPostHist 'W'
                 List articles posted by user. The date posted, the newsgroup and the subject are
                 listed.  You can use SearchSubjF ('/'), SearchSubjB ('?') and SearchRepeat ('\')
                 to search on this screen. Quit ('q') returns to the menu.

       Version 'v'
                 Print tin version information.

   NEWSGROUP SELECTION COMMANDS
       4         Select group 4.

       SelectResetNewsrc '^R'
                 Reset ${TIN_HOMEDIR:-"$HOME"}/.newsrc file. This will  destroy  all  records  of
                 which articles have been read, so use this carefully.

       SetRange '#'
                 Choose  a  range of articles to be affected by the next command. See the section
                 "RANGES" for more information.

       SelectSortActive '.'
                 Sort the list of newsgroups.

       SearchRepeat '\'
                 Repeat the previous search.

       SearchSubjF '/'
                 Search for a group by name and description (if displayed).

       SearchSubjB '?'
                 Backward search through the group names and descriptions.

       SelectReadGrp '^J' '<CR>'
                 Read current group.

       SelectEnterNextUnreadGrp '<TAB>' 'n'
                 Enter next group with unread news. Will wrap around  to  the  beginning  of  the
                 group selection list looking for unread groups.

       Catchup 'c'
                 Make  current  group as all read [after confirmation] and move to the next group
                 in the group selection list.

       CatchupNextUnread 'C'
                 Mark current group as all read [after confirmation] and enter  the  next  unread
                 group in the group selection list.

       SelectToggleDescriptions 'd'
                 Toggle  display  to  show  just  the  group name or the group name and the group
                 descriptions.

       EditFilter 'E'
                 Edit the filter file and reload it afterwards.

       SelectGoto 'g'
                 Choose a new group by name. This command can be used to access any  group,  even
                 those not currently yanked in.

       ToggleInfoLastLine 'i'
                 Toggle the display of the description of the current newsgroup in the last line.
                 This will not be available if tin was started with the ''-d'' option.

       ToggleInverseVideo 'I'
                 Toggle inverse video.

       SelectMoveGrp 'm'
                 Move the current group within the group selection  list.  By  entering  '1'  the
                 group  will  become  the  first displayed group in the list, by entering '8' the
                 eighth group in the list etc. By entering '$' the group will be the  last  group
                 displayed.

       OptionMenu 'M'
                 User configurable options menu (for more information see section "GLOBAL OPTIONS
                 MENU AND TINRC CONFIGURABLE VARIABLES").

       SelectNextUnreadGrp 'N'
                 Positions the cursor on the next group with unread articles in it.

       Quit 'q'  Quit tin - ask the user to confirm if confirm_choice is set accordingly.

       QuitTin 'Q'
                 Quit tin - don't ask the user to confirm.

       SelectToggleReadDisplay 'r'
                 Toggle display of all subscribed to groups  and  just  those  groups  containing
                 unread  articles. Command has no effect if groups were specified on the command-
                 line when tin was started.

       BugReport 'R'
                 Mail a bug report or comment to <tin-bugs@tin.org>. This  is  the  best  way  of
                 getting bugs fixed and features added/changed.

       SelectSubscribe 's'
                 Subscribe to current group.

       SelectSubscribePat 'S'
                 Subscribe  to groups matching user specified pattern. See the section "NEWSGROUP
                 LISTS & WILDCARDS" for the types of pattern that tin understands.

       SelectUnsubscribe 'u'
                 Unsubscribe to current group. This can be used  to  remove  bogus  groups.   See
                 strip_bogus  in  the  "GLOBAL  OPTIONS  MENU  AND  TINRC CONFIGURABLE VARIABLES"
                 section.

       SelectUnsubscribePat 'U'
                 Unsubscribe  to  groups  matching  user  specified  pattern.  See  the   section
                 "NEWSGROUP LISTS & WILDCARDS" for the types of pattern that tin understands.

       Post 'w'  Post  an  article to current group. If posting fails for some reason, you'll get
                 the chance to PostEdit ('e') the article again, PostPostpone ('o') it for  later
                 processing (see also ''-o'' command-line switch) or discard it via Quit ('q').

       SelectQuitNoWrite 'X'
                 Quit tin without saving any changes to the configuration.

       SelectYankActive 'y'
                 Yanks  in all groups. Toggles the displayed groups between all the groups in the
                 ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active} file and just  those  that
                 are subscribed to in ${TIN_HOMEDIR:-"$HOME"}/.newsrc.

       SelectSyncWithActive 'Y'
                 Reread  the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active} file to see if
                 any new news has arrived since starting tin.

       SelectMarkGrpUnread 'z' 'Z'
                 Mark all articles in the current group as unread.

   GROUP INDEX COMMANDS
       4         Select article 4.

       MenuFilterSelect '^A'
                 Auto select article(s) using a menu. Read the section "FILTERING  ARTICLES"  for
                 more information.

       MenuFilterKill '^K'
                 Kill  article(s)  using  a  menu. Read the section "FILTERING ARTICLES" for more
                 information.

       MarkFeedRead '^X'
                 Mark current article, thread,  range,  auto-selected  (hot)  articles,  articles
                 matching  pattern or tagged articles as read. A prompt asks which type should be
                 marked.

       MarkFeedUnread '^W'
                 Mark current article, thread,  range,  auto-selected  (hot)  articles,  articles
                 matching  pattern  or tagged articles as unread. A prompt asks which type should
                 be marked.

       SetRange '#'
                 Choose a range of articles to be affected by the next command. See  the  section
                 "RANGES" for more information.

       LastViewed '-'
                 Re-enter the last message that was viewed.

       SearchRepeat '\'
                 Repeat the previous search

       SearchSubjF '/'
                 Search forward for specified subject.

       SearchSubjB '?'
                 Search backward for specified subject.

       GroupSelThd '*'
                 Select current thread for later processing.

       GroupDoAutoSel '+'
                 Selects   all   threads   in  current  group.  It  is  a  shortcut  for  calling
                 GroupSelPattern with a pattern of ''*''.

       GroupToggleThdSel '.'
                 Toggle selection of current thread. If at least one  unread  article,  (but  not
                 every  unread  article)  in  the  current  thread  is  selected, then all unread
                 articles become selected.

       GroupSelThdIfUnreadSelected ';'
                 For each thread in current group, if it at least one unread article is selected,
                 all unread articles become selected. This is useful for auto-selection on author
                 where reader wants to see entire thread.

       GroupSelPattern '='
                 Prompts for a pattern with which to match on. All threads whose  subjects  match
                 the pattern will be marked selected. A pattern of ''*'' will match all subjects.
                 Entering just '<CR>' will re-use the last pattern that was entered.

       GroupReverseSel '@'
                 Reverse all selections on all articles.

       GroupUndoSel '~'
                 Undo  all  selections  on  all  articles.  It  clears  the  toggle   effect   of
                 GroupMarkUnselArtRead    ('X')    command.    Thus    after    first   doing   a
                 GroupMarkUnselArtRead, one can then do GroupUndoSel to reset articles. Thus, one
                 can iteratively whittle down uninteresting threads.

       Pipe '|'  Pipe current article / thread / auto-selected (hot) articles / articles matching
                 pattern / tagged articles into command. See the section "MAILING PIPING PRINTING
                 REPOSTING AND SAVING ARTICLES" for more information.

       QuickFilterSelect '['
                 Auto select article(s) with a single key [after confirmation]. The defaults used
                 for selection  are  based  upon  the  following  four  tinrc  config  variables:
                 default_filter_select_case,                        default_filter_select_expire,
                 default_filter_select_global and default_filter_select_header.  Read the section
                 "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES" for a full explanation of
                 these variables and "FILTERING ARTICLES" for more information on filtering.

       QuickFilterKill ']'
                 Kill article(s) with a single key [after confirmation]. The  defaults  used  for
                 killing   are   based   upon   the   following   four  tinrc  config  variables:
                 default_filter_kill_case, default_filter_kill_expire, default_filter_kill_global
                 and default_filter_kill_header.  Read the section "GLOBAL OPTIONS MENU AND TINRC
                 CONFIGURABLE VARIABLES" for a full explanation of these variables and "FILTERING
                 ARTICLES" for more information on filtering.

       GroupReadBasenote '^J' '<CR>'
                 Read current article.

       GroupNextUnreadArtOrGrp '<TAB>'
                 View next unread article or group.

       SearchAuthF 'a'
                 Author  forward  search.  This  searches  for articles with a specific ''From:''
                 line.

       SearchAuthB 'A'
                 Author backward search. Otherwise, see SearchAuthF ('a') above.

       SearchBody 'B'
                 Search the body of all articles in group (can be slow). You can abort the search
                 using Quit ('q').

       Catchup 'c'
                 Mark  all  articles  as  read  [after  confirmation]  then  return  to the group
                 selection list. Move cursor to next group.

       CatchupNextUnread 'C'
                 Mark all articles as read [after confirmation] and enter  the  next  group  with
                 unread news.

       GroupToggleSubjDisplay 'd'
                 Cycle  the  display of the author through all the possible options for the tinrc
                 variable show_author.

       GroupCancel 'D'
                 Cancel (delete) or supersede (overwrite) the current article. It must have  been
                 posted  by  the  same  user.  The  cancel  message  can be seen in the newsgroup
                 'control' or 'control.cancel'.

       EditFilter 'E'
                 Edit the filter file and reload it afterwards.

       GroupGoto 'g'
                 Choose a new group by name. This command can be used to access any  group,  even
                 those not currently yanked in.

       GroupToggleGetartLimit 'G'
                 Toggle article/group limit.

       ToggleInfoLastLine 'i'
                 Display the subject of the first article in the current thread in the last line.

       ToggleInverseVideo 'I'
                 Toggle inverse video.

       GroupMarkThdRead 'K'
                 Mark  article/thread  as read and move onto the next unread article/thread. If a
                 range of articles/threads is set, the range will be marked as  read  instead  of
                 the  current  article/thread. When tagged articles/threads are present, a prompt
                 asks how to proceed.

       GroupListThd 'l'
                 Open the thread under the current cursor position.

       LookupMessage 'L'
                 Look up article by ''Message-ID:''.

       GroupMail 'm'
                 Mail current article / thread / auto-selected (hot) articles / articles matching
                 pattern  /  tagged articles to someone. See the section "MAILING PIPING PRINTING
                 REPOSTING AND SAVING ARTICLES" for more information.

       OptionMenu 'M'
                 User configurable options menu (for more information see section "GLOBAL OPTIONS
                 MENU AND TINRC CONFIGURABLE VARIABLES").

       GroupNextGroup 'n'
                 Go to next group.

       GroupNextUnreadArt 'N'
                 Go to next unread article.

       Print 'o' Send current article / thread / auto-selected (hot) articles / articles matching
                 pattern / tagged articles to printer. See the section "MAILING  PIPING  PRINTING
                 REPOSTING AND SAVING ARTICLES" for more information.

       GroupPrevGroup 'p'
                 Go to previous group.

       GroupPrevUnreadArt 'P'
                 Go to previous unread article.

       Quit 'q'  Return to previous level.

       QuitTin 'Q'
                 Quit tin - don't ask the user to confirm.

       GroupToggleReadUnread 'r'
                 Toggle the display between all articles and unread articles.

       BugReport 'R'
                 Mail  a  bug  report  or  comment to <tin-bugs@tin.org>. This is the best way of
                 getting bugs fixed and features added/changed.

       GroupSave 's'
                 Save current article / thread / auto-selected (hot) articles / articles matching
                 pattern  /  tagged  articles. See the section "MAILING PIPING PRINTING REPOSTING
                 AND SAVING ARTICLES" for more information.

       GroupAutoSave 'S'
                 Save marked articles automatically without further prompting.

       GroupTag 't'
                 Toggle tag-status of current article / thread for GroupMail ('m') / Pipe ('|') /
                 Print ('o') / GroupSave ('s') / GroupRepost ('x').

       GroupTagParts 'T'
                 Automatically tag in order all the parts of the current multi-part message.

       GroupToggleThreading 'u'
                 Cycle  the  threading mode through no threading, threading by subject, threading
                 by references,  threading  on  both  subject  and  references,  group  multipart
                 articles into a thread (''Subject:'' based).

       GroupUntag 'U'
                 Untag all articles that were tagged.

       Post 'w'  Post  an  article to current group. If posting fails for some reason, you'll get
                 the chance to edit the  article  again  via  PostEdit  ('e'),  postpone  it  via
                 PostPostpone ('o') for later processing (see also ''-o'' command-line switch) or
                 discard it via Quit ('q').

       GroupRepost 'x'
                 Repost an already posted article /  thread  /  auto-selected  (hot)  articles  /
                 articles  matching pattern / tagged articles to another newsgroup(s). Useful for
                 reposting from global to local newsgroups. Do not use this  to  cross-post  your
                 own articles.

       GroupMarkUnselArtRead 'X'
                 Mark  all  unread articles that have not been selected as read, redraw screen to
                 reflect changes and put index at the first thread to  begin  reading.   Pressing
                 GroupMarkUnselArtRead ('X') again will toggle back to the way it was before. See
                 GroupUndoSel ('~') command for clearing the toggle  effect,  leaving  the  group
                 will also clear the toggle effect and make the changes permanent.

       MarkArtUnread 'z'
                 Mark current article as unread.

       MarkThdUnread 'Z'
                 Mark  current  thread as unread. If a range of threads is set, the range will be
                 marked as unread instead of the current thread. When tagged threads are present,
                 a prompt asks how to proceed.

   THREAD LISTING COMMANDS
       4         Select article 4 within thread.

       MenuFilterSelect '^A'
                 Auto  select  article(s) using a menu. Read the section "FILTERING ARTICLES" for
                 more information.

       MenuFilterKill '^K'
                 Kill article(s) using a menu. Read the section  "FILTERING  ARTICLES"  for  more
                 information.

       MarkFeedRead '^X'
                 Mark  current  article,  thread,  range,  auto-selected (hot) articles, articles
                 matching pattern or tagged articles as read. A prompt asks which type should  be
                 marked.

       MarkFeedUnread '^W'
                 Mark  current  article,  thread,  range,  auto-selected (hot) articles, articles
                 matching pattern or tagged articles as unread. A prompt asks which  type  should
                 be marked.

       SetRange '#'
                 Choose  a  range of articles to be affected by the next command. See the section
                 "RANGES" for more information.

       LastViewed '-'
                 Re-enter the last message that was viewed.

       SearchRepeat '\'
                 Repeat the previous search.

       SearchSubjF '/'
                 Search forward for a specified subject.

       SearchSubjB '?'
                 Search backwards for a specified subject.

       ThreadSelArt '*'
                 Select the current thread for later processing.

       ThreadToggleArtSel '.'
                 Toggle selection of current article.

       ThreadReverseSel '@'
                 Reverse article selections.

       ThreadUndoSel '~'
                 Undo all selections on current thread.

       Pipe '|'  Pipe current article / thread / auto-selected (hot) articles / articles matching
                 pattern / tagged articles into command. See the section "MAILING PIPING PRINTING
                 REPOSTING AND SAVING ARTICLES" for more information.

       ThreadReadArt '^J' '<CR>'
                 Read current article within thread.

       ThreadReadNextArtOrThread '<TAB>'
                 View next unread article within thread.

       SearchAuthF 'a'
                 Author forward search. This searches for  articles  with  a  specific  ''From:''
                 line.  The search will wrap over into the next thread if nothing is found in the
                 current one.

       SearchAuthB 'A'
                 Author backward search. Otherwise, see SearchAuthF ('a') above.

       SearchBody 'B'
                 Search the body of all articles in group (can be slow). You can abort the search
                 using Quit ('q').

       Catchup 'c'
                 Mark  thread  as  read  [after confirmation] and return to the group index page.
                 Move cursor to next thread.

       CatchupNextUnread 'C'
                 Mark thread as read [after confirmation] and enter the  next  thread  containing
                 unread news.

       ThreadToggleSubjDisplay 'd'
                 Cycle  the  display of the author through all the possible options for the tinrc
                 variable show_author.

       ThreadCancel 'D'
                 Cancel (delete) or supersede (overwrite) the current article. It must have  been
                 posted  by  the  same  user.  The  cancel  message  can be seen in the newsgroup
                 'control' or 'control.cancel'.

       EditFilter 'E'
                 Edit the filter file and reload it afterwards.

       ToggleInfoLastLine 'i'
                 Display the subject of the current article in the last line.

       ToggleInverseVideo 'I'
                 Toggle inverse video.

       ThreadMarkArtRead 'K'
                 Mark article as read and move onto the  next  unread  article.  If  a  range  of
                 articles  is  set,  the  range  will  be  marked  as read instead of the current
                 article. When tagged articles are present, a prompt asks how to proceed.

       LookupMessage 'L'
                 Look up article by ''Message-ID:''.

       ThreadMail 'm'
                 Mail current article / thread / auto-selected (hot) articles / articles matching
                 pattern  /  tagged articles to someone. See the section "MAILING PIPING PRINTING
                 REPOSTING AND SAVING ARTICLES" for more information.

       Print 'o' Send current article / thread / auto-selected (hot) articles / articles matching
                 pattern  /  tagged articles to printer. See the section "MAILING PIPING PRINTING
                 REPOSTING AND SAVING ARTICLES" for more information.

       Quit 'q'  Return to previous level.

       QuitTin 'Q'
                 Quit tin - don't ask the user to confirm.

       BugReport 'R'
                 Mail a bug report or comment to <tin-bugs@tin.org>. This  is  the  best  way  of
                 getting bugs fixed and features added/changed.

       ThreadSave 's'
                 Save current article / thread / auto-selected (hot) articles / articles matching
                 pattern / tagged articles. See the section "MAILING  PIPING  PRINTING  REPOSTING
                 AND SAVING ARTICLES" for more information.

       ThreadAutoSave 'S'
                 Save marked articles automatically without further prompting.

       ThreadTag 't'
                 Toggle  tag  status  of current article for mailing, piping, printing, saving or
                 reposting.

       ThreadUntag 'U'
                 Untag all tagged threads.

       Post 'w'  Post an article to current group. If posting fails for some reason,  you'll  get
                 the  chance  to edit the article again via PostEdit ('e'), postpone it for later
                 processing via PostPostpone ('o')  (see  also  ''-o''  command-line  switch)  or
                 discard it via Quit ('q').

       MarkArtUnread 'z'
                 Mark  current  article  in  thread as unread. If a range of articles is set, the
                 range will be marked as unread instead  of  the  current  article.  When  tagged
                 articles are present, a prompt asks how to proceed.

       MarkThdUnread 'Z'
                 Mark all articles in thread as unread.

   ARTICLE VIEWER COMMANDS
       0         Read the first (base) article in this thread.

       4         Read response 4 in this thread.

       MenuFilterSelect '^A'
                 Auto  select  article(s) using a menu. Read the section "FILTERING ARTICLES" for
                 more information.

       PageReplyQuoteHeaders '^E'
                 Reply through mail to the author of the current  article  with  a  copy  of  the
                 article with all headers included.

       PagePGPCheckArticle '^G'
                 Perform pgp(1) operations on article.

       PageToggleRaw '^H'
                 Toggles the display mode (raw including all headers vs. cooked).

       MenuFilterKill '^K'
                 Kill  article(s)  using  a  menu. Read the section "FILTERING ARTICLES" for more
                 information.

       PageToggleTabs '^T'
                 Toggle the TAB width between 4 and 8 characters.

       PageFollowupQuoteHeaders '^W'
                 Post a followup to the current article with a  copy  of  the  article  with  all
                 headers included.

       PageToggleTex2iso '"'
                 Toggle  TeX  to  ISO decoding for current article. The default behavior is taken
                 from the tex2iso_conv variable in the tinrc file.

       PageToggleAllHeaders '*'
                 Toggles the display of all headers vs. headers in news_headers_to_display.

       PageToggleRot '%'
                 Toggle ROT-13 decoding for this article.

       PageToggleUue '('
                 Toggle the display of uuencoded sections. The default behavior is taken from the
                 hide_uue variable in the tinrc file.

       PageReveal ')'
                 The formfeed character (^L) is often used to hide 'spoilers' that the reader may
                 not initially wish to see when viewing an article. Any text after a formfeed  is
                 not  displayed.  This key-press acts like a reveal key and turns the hidden text
                 back on. Scrolling down will also reveal the text, scrolling  up  will  hide  it
                 again.

       LastViewed '-'
                 Re-enter the last message that was viewed.

       SearchRepeat '\'
                 Repeat the previous search.

       SearchSubjF '/'
                 Forward search the text of this article.

       SearchSubjB '?'
                 Backward search the text of this article.

       PageSkipIncludedText ':'
                 Skip  to  the  end of the next quoted text-block in this article. Quoted text is
                 everything which matches quote_regex, quote_regex2 or quote_regex3.

       PageTopThd '<'
                 Go to the first article in the current thread.

       PageBotThd '>'
                 Go to the last article in the current thread.

       PageToggleHighlight '_'
                 Toggle word highlighting on/off.

       Pipe '|'  Pipe current article / thread / auto-selected (hot) articles / articles matching
                 pattern / tagged articles into command. See the section "MAILING PIPING PRINTING
                 REPOSTING AND SAVING ARTICLES" for more information.

       QuickFilterSelect '['
                 Auto select article(s) with a single key. The defaults used  for  selection  are
                 set    based    upon    the    following    four    tinrc    config   variables:
                 default_filter_select_case,                        default_filter_select_expire,
                 default_filter_select_global  and  default_filter_select_header Read the section
                 "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES" for a full explanation of
                 these variables and "FILTERING ARTICLES" for more information on filtering.

       QuickFilterKill ']'
                 Kill  article(s) with a single key. The defaults used for killing are based upon
                 the   following   four   tinrc   config   variables:   default_filter_kill_case,
                 default_filter_kill_expire,            default_filter_kill_global            and
                 default_filter_kill_header.  Read the section "GLOBAL  OPTIONS  MENU  AND  TINRC
                 CONFIGURABLE VARIABLES" for a full explanation of these variables and "FILTERING
                 ARTICLES" for more information on filtering.

       PageNextThd '^J' '<CR>'
                 Go to next base article.

       PageNextUnread '<TAB>'
                 Go to next unread  article.  If  the  tinrc  variable  goto_next_unread  doesn't
                 contain  PageNextUnread,  then  this  key  will  first  page through the current
                 article.

       SearchAuthF 'a'
                 Author forward search.

       SearchAuthB 'A'
                 Author backward search.

       SearchBody 'B'
                 Search the body of all articles in group (can be slow). You can abort the search
                 using Quit ('q').

       Catchup 'c'
                 Mark  the current thread as read [after confirmation] and return to the previous
                 menu. Move cursor to next item.

       CatchupNextUnread 'C'
                 Mark the rest of the current thread as read [after confirmation] and  enter  the
                 next thread with unread articles.

       PageCancel 'D'
                 Cancel  (delete) or supersede (overwrite) the current article. It must have been
                 posted by the same user. The  cancel  message  can  be  seen  in  the  newsgroup
                 'control' or 'control.cancel'.

       PageEditArticle 'e'
                 Edit the current article. This is restricted to mailgroups and saved news.

       EditFilter 'E'
                 Edit the filter file and reload it afterwards.

       PageFollowupQuote 'f'
                 Post a followup to the current article with a copy of the article included.

       PageFollowup 'F'
                 Post a followup to the current article without including a copy of the article.

       PageFirstPage 'g'
                 Go to the start of the article.

       PageLastPage 'G'
                 Go to the end of the article.

       ToggleInfoLastLine 'i'
                 Display the subject of the current article in the last line.

       ToggleInverseVideo 'I'
                 Toggle inverse video.

       PageKillThd 'K'
                 Mark rest of thread as read and move onto the next unread thread.

       PageListThd 'l'
                 Show the thread menu that the current article is a part of.

       LookupMessage 'L'
                 Look up article by ''Message-ID:''.

       PageMail 'm'
                 Mail current article / thread / auto-selected (hot) articles / articles matching
                 pattern / tagged articles to someone. See the section "MAILING  PIPING  PRINTING
                 REPOSTING AND SAVING ARTICLES" for more information.

       OptionMenu 'M'
                 User configurable options menu (for more information see section "GLOBAL OPTIONS
                 MENU AND TINRC CONFIGURABLE VARIABLES").

       PageNextArt 'n'
                 Go to the next article.

       PageNextUnreadArt 'N'
                 Go to the next unread article.

       Print 'o' Send current article / thread / auto-selected (hot) articles / articles matching
                 pattern  /  tagged articles to printer. See the section "MAILING PIPING PRINTING
                 REPOSTING AND SAVING ARTICLES" for more information.

       PagePrevArt 'p'
                 Go to the previous article.

       PagePrevUnreadArt 'P'
                 Go to the previous unread article.

       Quit 'q'  Return to the previous level.

       QuitTin 'Q'
                 Quit tin - don't ask the user to confirm.

       PageReplyQuote 'r'
                 Reply through mail to the author of the current  article  with  a  copy  of  the
                 article included.

       PageReply 'R'
                 Reply  through  mail  to the author of the current article without including the
                 original article.

       PageSave 's'
                 Save current article / thread / auto-selected (hot) articles / articles matching
                 pattern  /  tagged  articles. See the section "MAILING PIPING PRINTING REPOSTING
                 AND SAVING ARTICLES" for more information.

       PageAutoSave 'S'
                 Save marked articles automatically without further prompting.

       PageTag 't'
                 Toggle tag status of current article for mailing, piping,  printing,  saving  or
                 reposting.

       PageGroupSel 'T'
                 Return to group selection level.

       PageGotoParent 'u'
                 Go to parent article.

       PageViewUrl 'U'
                 Display a list of URLs in the current article. See the section "URL LISTING" for
                 more information.

       PageViewAttach 'V'
                 Display  a  list  of  attachments  of  the  current  article.  See  the  section
                 "ATTACHMENT LISTING" for more information.

       Post 'w'  Post  an  article to the current group. If posting fails for some reason, you'll
                 get the chance to edit the article again via PostEdit  ('e'),  postpone  it  for
                 later processing via PostPostpone ('o') (see also ''-o'' command-line switch) or
                 discard it via Quit ('q').

       PageRepost 'x'
                 Repost an already posted article /  thread  /  auto-selected  (hot)  articles  /
                 articles  matching pattern / tagged articles to another newsgroup(s). Useful for
                 reposting from global to local newsgroups. Do not use this to crosspost your own
                 articles.

       MarkArtUnread 'z'
                 Mark article as unread.

       MarkThdUnread 'Z'
                 Mark the current thread as unread.

   URL LISTING
       PageViewUrl  ('U')  displays  a  list  of  URLs in the current article. Besides the common
       moving keys, the following commands are available:

           UrlSelect '^J' '<CR>'
                     The current URL will be prompted and opened using the  url_handler.  '<ESC>'
                     or no input will skip the URL.

           SearchSubjF '/'
                     URL forward search.

           SearchSubjB '?'
                     URL backward search.

           SearchRepeat '\'
                     Repeat the previous search.

           ShellEscape '!'
                     Shell escape.

           ToggleInfoLastLine 'i'
                     Toggle the display of the current URL in the last line.

           Help 'h'  Help screen of commands available.

           ToggleHelpDisplay 'H'
                     Toggle the display of help mini menu at the bottom of the screen.

   ATTACHMENT LISTING
       PageViewAttach  ('V')  displays  a list of attachments of the current article. Besides the
       common moving keys, the following commands are available:

           AttachPipe 'p'
                     Pipe attachment into command.

           AttachSave 's'
                     Save current attachment / tagged attachments to disk.

           AttachSelect '^J' '<CR>'
                     View attachment.

           AttachTag 't'
                     Tag one or more attachments for saving.

           AttachTagPattern '='
                     Prompts for a pattern to match. All attachments  whose  name/description  or
                     content type/transfer encoding match the pattern will be tagged.

           AttachToggleTagged '@'
                     Reverse tagging of all attachments.

           AttachUntag 'U'
                     Untag all tagged attachments.

           SearchSubjF '/'
                     Attachment forward search.

           SearchSubjB '?'
                     Attachment backward search.

           SearchRepeat '\'
                     Repeat the previous search.

           GlobalPipe '|'
                     Pipe attachment into command. Uses the raw attachment, no decoding is done.

           ShellEscape '!'
                     Shell escape.

           ToggleInfoLastLine 'i'
                     Toggle  the display of the name/description of the current attachment in the
                     last line.

           Help 'h'  Help screen of commands available.

           ToggleHelpDisplay 'H'
                     Toggle the display of help mini menu at the bottom of the screen.

   GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES
       At startup, tin reads in the configuration files (see also tin(5)).  They contain  a  list
       of  variables  that  can  be used to configure the way tin works. If it exists, the global
       configuration file, ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc is read. After that,  the  user's  own
       configuration  file  is  read  from ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc. The global file is
       useful for distributing system-wide defaults to new users who have no private tinrc yet.

       The  variables  are  user  configurable  by   editing   ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc
       directly.  Most  of  them  can also be set in the GLOBAL OPTIONS MENU which is accessed by
       pressing OptionMenu ('M') at all levels. It allows the user to customize the  behavior  of
       tin.  The  options  are saved to the file ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc when you exit
       tin so don't edit the file directly whilst tin is running.

       In the options menu use the cursor keys in the usual way to move around. Use  ConfigSelect
       ('^J'  or  '<CR>')  to  'open' the option you wish to change. You will need to enter a new
       value or use '<SPACE>' to toggle the available options. ConfigSelect  will  save  the  new
       value, '<ESC>' will abort without saving changes.

       As  with the other menus, RedrawScr ('^L') will redraw the screen. You can use SearchSubjF
       ('/'), SearchSubjB ('?') and SearchRepeat ('\') to search for a specific option. Use  Quit
       ('q')  to  exit  the  option menu and keep your changes. Use QuitTin ('Q') to exit without
       keeping your changes.

       The options menu provides access to the attributes menu  for  the  current  group  by  the
       ConfigToggleAttrib  ('<TAB>')  command.  Pressing ConfigToggleAttrib again toggles back to
       the options menu. For more information see section "ATTRIBUTES MENU AND GROUP ATTRIBUTES".

       The ConfigScopeMenu ('S') command brings up the scopes  menu.  For  more  information  see
       section "SCOPES MENU".

       Here  is a full list of all the available variables. The name in braces is the name of the
       corresponding setting in ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc.

       Abbreviate long newsgroup names (abbreviate_groupname)
           If ON abbreviate long newsgroup names at group selection level and article  level  (if
           necessary)  like  this:  news.software.readers -> n.software.readers -> n.s.readers ->
           n.s.r.  Default is OFF.

       Add posted articles to filter (add_posted_to_filter)
           If ON add posted articles which start a new thread to filter for highlighting  follow-
           ups. Default is ON.

       Insert 'User-Agent:'-header (advertising)
           Turn ON advertising in header (''User-Agent:''). Default is ON.

       Skip multipart/alternative parts (alternative_handling)
           If ON strip multipart/alternative messages automatically. Default is ON.

       Character to show deleted articles (art_marked_deleted)
           The character used to show that an article was deleted. Default is 'D'.

       Character to show inrange articles (art_marked_inrange)
           The character used to show that an article is in a range. Default is '#'.

       Character to show returning arts (art_marked_return)
           The  character  used to show that an article will return as an unread article when the
           group is next entered. Default is '-'.

       Character to show selected articles (art_marked_selected)
           The character used to show that an article/thread is auto-selected (hot).  Default  is
           '*'.

       Character to show recent articles (art_marked_recent)
           The  character  used to show that an article/thread is recent (not older than X days).
           See also recent_time. Default is 'o'.

       Character to show unread articles (art_marked_unread)
           The character used to show that an article has not been read. Default is '+'.

       Character to show read articles (art_marked_read)
           The character used to show that an article was read. Default is ' '.

       Character to show killed articles (art_marked_killed)
           The character used to show that an article was killed.  Default  is  'K'.   kill_level
           must be set accordingly.

       Character to show read selected arts (art_marked_read_selected)
           The  character  used  to  show that an article was hot before it was read.  Default is
           ':'. kill_level must be set accordingly.

       Ask before using MIME viewer (ask_for_metamail)
           If ON tin will ask  before  using  a  MIME  viewer  (metamail_prog)  to  display  MIME
           messages. This only occurs if a MIME viewer is set. Default is OFF.

       Send you a cc and/or bcc automatically (auto_cc_bcc)
           Automatically  put  your  name  in  the  ''Cc:'' and/or ''Bcc:'' field when mailing an
           article. Default is No.

       List thread using right arrow key (auto_list_thread)
           If ON automatically list thread when entering it using right arrow  key.   Default  is
           ON.

       Reconnect to server automatically (auto_reconnect)
           Default is OFF.

       Use Archive-name: header for save (auto_save)
           If  ON  articles/threads  with ''Archive-name:'' in header will be automatically saved
           with the Archive-name & part/patch no and post processed if post_process_type  is  set
           to something other than 'No'.  Default is OFF.

       Save articles in batch mode (batch_save)
           If  set ON articles/threads will be saved in batch mode when save ''-S'' or mail ''-M,
           -N'' is specified on the command line. Default is ON.

       Show mini menu & posting etiquette (beginner_level)
           If set ON a mini menu of the most useful commands will be displayed at the  bottom  of
           the  screen  for  each  level.  Also a short posting etiquette will be displayed after
           composing an article. Default is ON.

       Cache NNTP overview files locally (cache_overview_files)
           If ON, create local copies of NNTP overview files. This can be  used  to  considerably
           speed up accessing large groups when using a slow connection.  See also "INDEX FILES".
           Default is OFF.

       Catchup read groups when quitting (catchup_read_groups)
           If set ON the user is asked when quitting  if  all  groups  read  during  the  current
           session should be marked read. Default is OFF.

       Standard background color (col_back)
           Standard background color

       Color of sender (From:) (col_from)
           Color of sender (From:)

       Color of article header lines (col_head)
           Color of header-lines

       Color of help text (col_help)
           Color of help pages

       Color for inverse text (background) (col_invers_bg)
           Color of background for inverse text

       Color for inverse text (foreground) (col_invers_fg)
           Color of foreground for inverse text

       Color of highlighting with _dash_ (col_markdash)
           Color   of   words   emphasized   like   _this_.  See  also  word_h_display_marks  and
           word_highlight.

       Color of highlighting with /slash/ (col_markslash)
           Color  of  words  emphasized  like   /this/.   See   also   word_h_display_marks   and
           word_highlight.

       Color of highlighting with *stars* (col_markstar)
           Color   of   words   emphasized   like   *this*.  See  also  word_h_display_marks  and
           word_highlight.

       Color of highlighting with -stroke- (col_markstroke)
           Color  of  words  emphasized  like   -this-.   See   also   word_h_display_marks   and
           word_highlight.

       Color of mini help menu (col_minihelp)
           Color of mini help menu

       Color of actual news header fields (col_newsheaders)
           Color of actual news header fields

       Standard foreground color (col_normal)
           Standard foreground color

       Color of quoted lines (col_quote)
           Color of quoted lines

       Color of twice quoted line (col_quote2)
           Color of twice quoted lines

       Color of =>3 times quoted line (col_quote3)
           Color of >=3 times quoted lines

       Color of response counter (col_response)
           Color of response counter. This is the text that says "Response x of y" in the article
           viewer.

       Color of signatures (col_signature)
           Color of signatures

       Color of urls highlight (col_urls)
           Color of urls highlight

       Color of verbatim blocks (col_verbatim)
           Color of verbatim blocks

       Color of article subject lines (col_subject)
           Color of article subject

       Color of text lines (col_text)
           Color of text-lines

       Color of help/mail sign (col_title)
           Color of help/mail sign

       Which actions require confirmation (confirm_choice)
           Ask for manual confirmation to protect the user.

            ·  commands Ask for confirmation before executing certain dangerous  commands  (e.g.,
               Catchup  ('c')). Commands that this affects are marked in this manual with '[after
               confirmation]'. Default is commands & quit.

            ·  quit You'll be asked to confirm that you wish to exit tin when you  use  the  Quit
               ('q') command.

            ·  select   Ask   for   confirmation   before   marking   all   not   selected  (with
               GroupMarkUnselArtRead ('X') command) articles as read.

       Format string for display of dates (date_format)
           Format string tin uses for date representation. A description of the different  format
           options can be found at strftime(3).  tin uses strftime(3) when available and supports
           most format options in his fallback code.  Default is "%a, %d %b %Y %H:%M:%S".

       (default_art_search)

       (default_author_search)

       (default_config_search)
           The last article/author/config option that was searched for.

       (default_filter_days)
           Default is 28.

       (default_filter_kill_case)
           Default for quick (1 key) kill filter case.  ON = filter case sensitive, OFF =  ignore
           case. Default is OFF.

       (default_filter_kill_expire)
           Default  for quick (1 key) kill filter expire.  ON = limit to default_filter_days, OFF
           = don't ever expire. Default is OFF.

       (default_filter_kill_global)
           Default for quick (1 key) kill filter global.  ON=apply to all  groups,  OFF=apply  to
           current group. Default is ON.

       (default_filter_kill_header)
           Default for quick (1 key) kill filter header.

            0
                 ''Subject:'' (case sensitive)

            1
                 ''Subject:'' (ignore case)

            2
                 ''From:'' (case sensitive)

            3
                 ''From:'' (ignore case)

            4
                 ''Message-ID:'' & full ''References:'' line

            5
                 ''Message-ID:'' & last ''References:'' entry only

            6
                 ''Message-ID:'' entry only

            7
                 ''Lines:''

       (default_filter_select_case)
           Default  for  quick  (1  key)  auto-selection  filter  case. ON=filter case sensitive,
           OFF=ignore case. Default is OFF.

       (default_filter_select_expire)
           Default  for  quick  (1  key)  auto-selection  filter   expire.    ON   =   limit   to
           default_filter_days, OFF = don't ever expire.  Default is OFF.

       (default_filter_select_global)
           Default  for  quick  (1  key)  auto-selection  filter  global.  ON=apply to all groups
           OFF=apply to current group. Default is ON.

       (default_filter_select_header)
           Default for quick (1 key) auto-selection filter header.

            0
                 ''Subject:'' (case sensitive)

            1
                 ''Subject:'' (ignore case)

            2
                 ''From:'' (case sensitive)

            3
                 ''From:'' (ignore case)

            4
                 ''Message-ID:'' & full ''References:'' line

            5
                 ''Message-ID:'' & last ''References:'' entry only

            6
                 ''Message-ID:'' entry only

            7
                 ''Lines:''

       (default_goto_group)

       (default_group_search)

       (default_mail_address)

       (default_move_group)

       (default_pattern)

       (default_pipe_command)

       (default_post_newsgroups)

       (default_post_subject)

       (default_range_group)

       (default_range_select)

       (default_range_thread)

       (default_repost_group)

       (default_save_file)

       (default_save_mode)

       (default_select_pattern)

       (default_shell_command)

       (default_subject_search)

       Draw -> instead of highlighted bar (draw_arrow)
           Allows groups/articles to be selected by an arrow '->' if set ON or by an  highlighted
           bar if set OFF. Default is OFF.

       Invocation of your editor (editor_format)
           The format string used to create the editor start command with parameters.  Default is
           "%E +%N %F" (i.e., /bin/vi +7 .article).

       Force redraw after certain commands (force_screen_redraw)
           Specifies whether a screen  redraw  should  always  be  done  after  certain  external
           commands. Default is OFF.

       Number of articles to get (getart_limit)
           If  getart_limit is > 0 not more than getart_limit articles/group are fetched from the
           server. If getart_limit is < 0 tin will start fetching articles from your first unread
           minus absolute value of getart_limit. Default is 0, which means no limit.

       Catchup group using left key (group_catchup_on_exit)
           If ON catchup group when leaving with the left arrow key. Default is ON.

       Go to the next unread article with (goto_next_unread)
           Which  keys  tin  should  accept  to jump to the next unread article.  Possible is any
           combination of PageDown and PageNextUnread.  When PageDown is set  tin  jumps  to  the
           next  article  at  the  end  of  the current one. When PageNextUnread is set tin jumps
           immediately to the next article when PageNextUnread ('<TAB>') is pressed.  Default  is
           PageNextUnread.

       Max. length of group names shown (groupname_max_length)
           Maximum  length  of  the  names  of  newsgroups  to  be  displayed so that more of the
           newsgroup description can be displayed. Default is 32.

       Display uue data as an attachment (hide_uue)
           If set to 'No' then raw uuencoded data is displayed. If set to 'Yes' then sections  of
           uuencoded  data  will  be  shown  with a single tag line showing the size and filename
           (much the same as a MIME attachment). If set to 'Hide all' then any  line  that  looks
           like  uuencoded  data  will  be folded into a tag line.  This is useful when uuencoded
           data is split across more than one article but can also lead to false positives.  This
           setting can also be toggled in the article viewer. Default is 'No'.

       External inews (inews_prog)
           Path,  name and options of external inews(1).  If you are reading via NNTP the default
           value is --internal (use built-in NNTP inews), else it is "inews -h". The  article  is
           passed to inews_prog on STDIN via '< article'.

       (info_in_last_line)
           If  ON, show current group description or article subject in the last line (not in the
           pager and global menu) - ToggleInfoLastLine ('i') toggles setting.  This  facility  is
           useful  as the full width of the screen is available to display long subjects. Default
           is OFF.

       Use interactive mail reader (interactive_mailer)
           Interactive mailreader: if greater than 0 your mailreader will be invoked earlier  for
           reply  so  you  can  use  more  of its features (e.g. MIME, pgp, ...). 1 means include
           headers, 2 means don't include headers (old use_mailreader_i=ON option). 0  turns  off
           usage. This option has to suit mailer_format. Default is 0.

       Use inverse video for page headers (inverse_okay)
           If ON use inverse video for page headers and URL highlighting.  Default is ON.

       Keep failed arts in ~/dead.articles (keep_dead_articles)
           If  ON  keep  all  failed  postings  in  ${TIN_HOMEDIR:-"$HOME"}/dead.articles besides
           keeping the last failed posting in  ${TIN_HOMEDIR:-"$HOME"}/dead.article.  Default  is
           ON.

       Filter which articles (kill_level)
           This  option  controls  the processing and display of articles that are killed.  There
           are 3 options:

            0  Kill only unread arts is the 'traditional' behavior of tin. Only  unread  articles
               are  killed  once  only  by marking them read. As filtering only happens on unread
               articles with kill_level set to 0, art_marked_killed and  art_marked_read_selected
               are only shown once. When you reenter the group the mark will be gone.

            1  Kill  all  arts & show with K will process all articles in the group and therefore
               there is a processing  overhead  when  using  this  option.  Killed  articles  are
               threaded as normal but they will be marked with art_marked_killed.

            2  Kill  all arts and never show will process all articles in the group and therefore
               there is a processing overhead when using this option. Killed articles simply does
               not get displayed at all.
       Default is 0 (Kill only unread arts).

       Use 8bit characters in mail headers (mail_8bit_header)
           Allows  8bit  characters  unencoded  in  the  header  of mail message. Default is OFF.
           Turning it ON is effective only if mail_mime_encoding is also set to 8bit. Leaving  it
           OFF  is  safe  for  most  users  and  compliant to Internet Mail Standard (RFC5322 and
           RFC2047). Default is OFF.

       Mail address (mail_address)
           User's mail address (and full name), if not username@host. This is used when  creating
           articles, sending mail and when pgp(1) signing.

       MIME encoding in mail messages (mail_mime_encoding)
           MIME   encoding   of   the   body   in  mail  message,  if  necessary  (8bit,  base64,
           quoted-printable, 7bit). Default is quoted-printable.

       Quote line when mailing (mail_quote_format)
           Format of quote line when replying (via mail)  to  an  article  (%A=Address,  %D=Date,
           %F=Fullname+Address,    %G=Groupname,    %M=Message-ID,   %N=Fullname,   %C=Firstname,
           %I=Initials). Default is "In article %M you wrote:"

       Format of the mailbox (mailbox_format)
           Select one of the following mailbox-formats: MBOXO (default, except for  SCO),  MBOXRD
           or MMDF (default on SCO). See mbox(5) for more details on MBOXO and MBOXRD and mmdf(5)
           for more details about MMDF.

       Mail directory (maildir)
           The directory where articles/threads are to be saved in mbox(5) format.  This  feature
           is  mainly  for  use  with  the  elm(1)  mail  program.  It  allows  the  user to save
           articles/threads/groups simply by giving '=' as the filename to save to.   Default  is
           ${TIN_HOMEDIR:-"$HOME"}/Mail.

       Invocation of your mail command (mailer_format)
           The  format  string used to create the mailer command with parameters that is used for
           mailing articles to other people. Default is '%M "%T" < %F' (e.g., /bin/mail "iain"  <
           .article).  The  flexible  format  allows  other  mailers  with different command-line
           parameters to be used such as 'elm -s "%S" "%T" < "%F"' (e.g., elm -s "subject" "iain"
           < .article) or 'sendmail -oi -oem -t < %F' (e.g. sendmail -oi -oem -t < .article).

       'Mark as (un)read' ignores tags (mark_ignore_tags)
           When  this  is  ON, the GroupMarkThdRead ('K'), ThreadMarkArtRead ('K'), MarkThdUnread
           ('Z') at Group level and MarkArtUnread ('z') at Thread level functions mark  just  the
           current  article  or  thread,  ignoring other tagged, (un)read articles. When OFF, the
           same function presents a menu with choices of  the  current  thread  or  article,  all
           tagged, unread articles, or nothing.

       Mark saved articles/threads as read (mark_saved_read)
           If ON mark articles that are saved as read. Default is ON.

       Viewer program for MIME articles (metamail_prog)
           Path,  name and options of external metamail(1) program used to view non-textual parts
           of articles.  To use the built-in viewer, set to --internal. This is the default value
           when  metamail(1)  is  not  installed.  Leave it blank if you don't want any automatic
           viewing of non-textual attachments. The 'V' command can always  be  used  to  manually
           view any attachments.  See also ask_for_metamail.

       MM_CHARSET (mm_charset)
           Charset  supported  locally, which is also used for MIME header (charset parameter and
           charset name in header encoding) in mail and news postings. If MIME_STRICT_CHARSET  is
           defined  at  compile  time,  text in charset other than the value of this parameter is
           considered not displayable and represented as '?'. Otherwise, all character  sets  are
           regarded as compatible with the display. If it's not set, the value of the environment
           variable $MM_CHARSET is used. US-ASCII or compile-time default is used in case neither
           of  them is defined. If your system supports iconv(3), this option is disabled and you
           should use mm_network_charset instead.

       MM_NETWORK_CHARSET (mm_network_charset)
           Charset used for posting and MIME headers; replaces  mm_charset.   Conversion  between
           mm_network_charset  and  local  charset  (determined  via  nl_langinfo(3)) is done via
           iconv(3), if this function is not available on your system this option is disabled and
           you  have  to  use  mm_charset  instead.  mm_network_charset  is limited to one of the
           following charsets:
              US-ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16}, KOI8-{R,U,RU} EUC-{CN,JP,KR,TW},
              ISO-2022-{CN,CN-EXT,JP,JP-1,JP-2}, Big5, UTF-8
           Not  all values might work on your system, see iconv_open(3) for more details. If it's
           not set, the value of the  environment  variable  $MM_CHARSET  is  used.  US-ASCII  or
           compile-time default is used in case neither of them is defined.

       Attribute of highlighting with _dash_ (mono_markdash)
           Character attribute of words emphasized like _this_. It depends on your terminal which
           attributes are usable. See also word_h_display_marks and word_highlight.

       Attribute of highlighting with /slash/ (mono_markslash)
           Character attribute of words emphasized like /this/. It depends on your terminal which
           attributes are usable. See also word_h_display_marks and word_highlight.

       Attribute of highlighting with *stars* (mono_markstar)
           Character attribute of words emphasized like *this*. It depends on your terminal which
           attributes are usable. See also word_h_display_marks and word_highlight.

       Attribute of highlighting with -stroke- (mono_markstroke)
           Character attribute of words emphasized like -this-. It depends on your terminal which
           attributes are usable. See also word_h_display_marks and word_highlight.

       (newnews)
           These  are internal timers used by tin to keep track of new newsgroups.  Do not change
           them unless you understand what they are for.

       Display these header fields (or *) (news_headers_to_display)
           Which news headers you wish to see. If you want to see _all_ the headers, place an '*'
           as  this value. This is the only way a wildcard can be used.  If you enter 'X-' as the
           value, you will see all headers beginning with 'X-' (like X-Alan or X-Pape).  You  can
           list  more  than  one  by delimiting with spaces. Not defining anything turns off this
           option.

       Do not display these header fields (news_headers_to_not_display)
           Same as news_headers_to_display except it denotes the opposite. An  example  of  using
           both  options  might  be  if you thought X- headers were A Good Thing(tm), but thought
           Alan and Pape  were  miscreants...  well  then  you  would  do  something  like  this:
           news_headers_to_display=X-  news_headers_to_not_display=X-Alan  X-Pape.   Not defining
           anything turns off this option.

       Quote line when following up (news_quote_format)
           Format of quote line  when  posting/following  up  an  article  (%A=Address,  %D=Date,
           %F=Fullname+Address,    %G=Groupname,    %M=Message-ID,   %N=Fullname,   %C=Firstname,
           %I=Initials). Default is "%F wrote:".

       Unicode normalization form (normalization_form)
           The normalization form tin should use to normalize unicode input.  The possible values
           are:

            0  None: no normalization

            1  NFKC: Compatibility Decomposition, followed by Canonical Composition

            2  NFKD: Compatibility Decomposition

            3  NFC: Canonical Decomposition, followed by Canonical Composition

            4  NFD: Canonical Decomposition
       Some  normalization modes are only available if they are supported by the library tin uses
       to do the normalization. Default is NFKC.

       Go to first unread article in group (pos_first_unread)
           If ON put cursor at first unread article in group otherwise at last  article.  Default
           is ON.

       Use 8bit characters in news headers (post_8bit_header)
           Allows  8bit  characters  unencoded  in the header of a news article, if set this also
           disables the generation of MIME-headers when they are  usually  required.  Default  is
           OFF.  Only  enacted  if  post_mime_encoding  is also set to 8bit. In a number of local
           hierarchies where 8bit characters are used, using unencoded (raw) 8bit  characters  in
           header  is  acceptable  and  sometimes  even recommended so that you need to check the
           convention adopted in the local hierarchy of your interest to  determine  what  to  do
           with this and post_mime_encoding.

       MIME encoding in news messages (post_mime_encoding)
           MIME   encoding   of   the   body  in  news  message,  if  necessary.  (8bit,  base64,
           quoted-printable, 7bit). Default is 8bit, which  leads  to  no  encoding.  base64  and
           quoted-printable are usually undesired on usenet.

       View post-processed files (post_process_view)
           If  ON,  then  tin  will start an appropriate viewer program to display any files that
           were post processed and uudecoded. The program is determined using the  mailcap  file.
           Default is ON.

       Post process saved articles (post_process_type)
           This  specifies  whether  to perform post processing on saved articles.  The following
           values are allowed:

            0  No (default), no post processing is done.

            1  Shell archives, unpacking of multi-part shar(1) files only.

            2  Yes, binary attachments and data will be decoded and saved.

       Filename to be used for storing posted articles (posted_articles_file)
           Keep posted  articles  in  ${TIN_HOMEDIR:-"$HOME"}/Mail/posted_articles_file.   If  no
           filename is set then postings will not be saved.  Default is 'posted'.

       Print all headers when printing (print_header)
           If  ON,  then  the  full  article  header  is  sent to the printer. Otherwise only the
           ''Subject:'' and ''From:'' fields are output. Default is OFF.

       Printer program with options (printer)
           The printer program with options that is to be used to print articles.  The default is
           lpr(1)  for  BSD machines and lp(1) for SysV machines. Printing from tin may have been
           disabled by the System Administrator.

       Process only unread articles (process_only_unread)
           If ON only save/print/pipe/mail unread articles (tagged articles  excepted).   Default
           is OFF.

       Show empty Followup-To in editor (prompt_followupto)
           If ON show empty ''Followup-To:'' header when editing an article. Default is OFF.

       Characters used as quote-marks (quote_chars)
           The character used in quoting included text to article followups and mail replies. The
           '_' character represents a blank character and is replaced with ' ' when read. Default
           is '>_'.

       Quoting behavior (quote_style)
           How  articles  should  be  quoted  when  following up or replying to them. There are a
           number of things that can be done: empty lines can be quoted, signatures can be quoted
           and  quote_chars  can  be compressed when quoting multiple times (for example, '> > >'
           will be turned into '>>>'). The default is to compress  quotes,  and  to  quote  empty
           lines.
           When  you are viewing an article in raw mode ('^H'), and follow up or reply to it, the
           signature will be quoted even if it would otherwise not  be.   If  show_signatures  is
           off, then the signature will never be quoted.

       Regex used to show quoted lines (quote_regex)
           A  regular  expression  that will be applied when reading articles. All matching lines
           are shown in col_quote. If quote_regex is blank, then tin uses a built-in default.

       Regex used to show twice quoted l. (quote_regex2)
           A regular expression that will be applied when reading articles.  All  matching  lines
           are shown in col_quote2. If quote_regex2 is blank, then tin uses a built-in default.

       Regex used to show >= 3 times q.l. (quote_regex3)
           A  regular  expression  that will be applied when reading articles. All matching lines
           are shown in col_quote3. If quote_regex3 is blank, then tin uses a built-in default.

       Article recentness time limit (recent_time)
           If set to 0, this feature is deactivated, otherwise  it  means  the  number  of  days.
           Default is 2.

       Render BiDi (render_bidi)
           If  ON  tin does the rendering of bi-directional text. If OFF tin leaves the rendering
           of bi-directional text to the terminal. Default is OFF.

       Interval in seconds to reread active (reread_active_file_secs)
           The  news  ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active}  file  is  reread  at
           regular  intervals  to show if any new news has arrived. Default is 1200. Setting this
           to 0 will disable this feature.

       Directory to save arts/threads in (savedir)
           Directory where articles/threads are saved. Default is ${TIN_HOMEDIR:-"$HOME"}/News.

       Score limit (kill) (score_limit_kill)
           If the score of an article is below or equal this value the  article  gets  marked  as
           killed.

       Score limit (select) (score_limit_select)
           If  the  score  of  an article is above or equal this value the article gets marked as
           hot.

       Default score to kill articles (score_kill)
           Score of an article which should be killed, this must be <= score_limit_kill.

       Default score to select articles (score_select)
           Score of an article which should be marked hot, this must be >= score_limit_select.

       Number of lines to scroll in pager (scroll_lines)
           The number of lines that will be scrolled up/down in  the  article  pager  when  using
           cursor-up/down. The default is 1 (line-by-line). Set to 0 to get traditional tin page-
           by-page scrolling. Set to -1 to get page-by-page scrolling where the  top/bottom  line
           is    carried    over    onto    the    next    page.     This    setting   supersedes
           show_last_line_prev_page=ON. Set to  -2  to  get  half-page  scrolling.  This  setting
           supersedes full_page_scroll=OFF.

       In group menu, show author by (show_author)
           Which information about the author should be shown. Default is 2, authors full name.

            0  None, only the ''Subject:'' line will be displayed.

            1  Address, ''Subject:'' line & the address part of the ''From:'' line are displayed.

            2  Full  Name,  ''Subject:''  line & the authors full name part of the ''From:'' line
               are displayed (default).

            3  Address and Name, ''Subject:'' line & all of the ''From:'' line are displayed.

       Show description of each newsgroup (show_description)
           If ON show a short group description text after newsgroup name at the group  selection
           level.  The  ''-d''  command-line flag will override the setting and turn descriptions
           off. The text used is taken from the ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups file and  if
           supported   (requires   tin   to   be   build   with  mh-mail-handling  support)  from
           ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups for mailgroups. Default is ON.

       Show lines/score in listings (show_info)
           Which information about the thread or article should be shown. Default is 1, show only
           the line count.

            0  None, no information will be displayed.

            1  Lines,  in  article  listing the line count of an article will be displayed and in
               thread listing the line count of first (unread) article will be displayed.

            2  Score, in article listing the score of an article will be displayed and in  thread
               listing the score of the thread will be displayed - see also thread_score.

            3  Lines & Score, display line count and score.

       Show only unread articles (show_only_unread_arts)
           If ON show only new/unread articles otherwise show all articles.  Default is ON.

       Show only groups with unread arts (show_only_unread_groups)
           If ON show only subscribed groups that contain unread articles. Default is OFF.

       Display signatures (show_signatures)
           If OFF don't show signatures when displaying articles.  Default is ON.

       Prepend signature with '\n-- \n' (sigdashes)
           If ON prepend the signature with sigdashes. Default is ON.

       Create signature from path/command (sigfile)
           The  path  that  specifies  the signature file to use when posting, following up to or
           replying to an article. If the path is a directory then the signature will be randomly
           generated  from files that are in the specified directory. If the path starts with a !
           the program the path points to will be executed to generate a signature. tin will pass
           the name of the current newsgroup as argument to the program. --none will suppress any
           signature.  Default is ${TIN_HOMEDIR:-"$HOME"}/.Sig.

       Add signature when reposting (signature_repost)
           If ON add signature to reposted articles. Default is ON.

       Regex used to highlight /slashes/ (slashes_regex)
           A regular expression that will be applied when reading articles.  All  matching  words
           are shown in col_markslash or mono_markslash. If slashes_regex is blank, then tin uses
           a built-in default.

       Sort articles by (sort_article_type)
           This specifies how articles should be sorted.  Sort  by  ascending  Date  (6)  is  the
           default. The following sort types are allowed:

            0  Nothing, don't sort articles.

            1  Subject: (descending), sort articles by ''Subject:'' field descending.

            2  Subject: (ascending), sort articles by ''Subject:'' field ascending.

            3  From: (descending), sort articles by ''From:'' field descending.

            4  From: (ascending), sort articles by ''From:'' field ascending.

            5  Date: (descending), sort articles by ''Date:'' field descending.

            6  Date: (ascending), sort articles by ''Date:'' field ascending (default).

            7  Score (descending), sort articles by filtering score descending.

            8  Score (ascending), sort articles by filtering score ascending.

            9  Lines: (descending), sort articles by ''Lines:'' field descending.

            10 Lines: (ascending), sort articles by ''Lines:'' field ascending.

       Sort threads by (sort_threads_type)
           This  specifies  how  threads  will  be  sorted.  Sort  by descending Score (1) is the
           default. The following sort types are allowed:

            0  Nothing, don't sort threads.

            1  Score (descending), sort threads by filtering score descending (default).

            2  Score (ascending), sort threads by filtering score ascending.

            3  Last posting date (descending), sort threads by date of last posting descending.

            4  Last posting date (ascending), sort threads by date of last posting ascending.

       Spamtrap warning address parts (spamtrap_warning_addresses)
           Set this option to a list of comma-separated strings to be warned if you are  replying
           to  an  article  by  mail  where the e-mail address contains one of these strings. The
           matching is case-insensitive. Example:

           spam,delete,remove

       Regex used to highlight *stars* (stars_regex)
           A regular expression that will be applied when reading articles.  All  matching  words
           are  shown  in col_markstar or mono_markstar. If stars_regex is blank, then tin uses a
           built-in default.

       Start editor with line offset (start_editor_offset)
           Set ON if the editor used for posting, follow-ups and bug reports has  the  capability
           of  starting  and positioning the cursor at a specified line within a file. Default is
           ON.

       Strip blanks of end of lines (strip_blanks)
           Strips the blanks from the end of each line therefore speeding  up  the  display  when
           reading on a slow terminal or via modem. Default is ON.

       Remove bogus groups from newsrc (strip_bogus)
           Bogus  groups are groups that are present in your ${TIN_HOMEDIR:-"$HOME"}/.newsrc file
           that no longer exist on the news server. There are 3 options. 0  means  do  nothing  &
           always  keep  bogus groups.  1 means bogus groups will be permanently removed. 2 means
           that bogus groups will appear on the Group Selection Menu, prefixed with a  'D'.  This
           allows you to unsubscribe from them as and when you wish. Default is 0 (Always Keep).

       No unsubscribed groups in newsrc (strip_newsrc)
           If   ON,   then   unsubscribed   groups   will   be   permanently  removed  from  your
           ${TIN_HOMEDIR:-"$HOME"}/.newsrc file. Default is OFF.

       Regex used to highlight -strokes- (strokes_regex)
           A regular expression that will be applied when reading articles.  All  matching  words
           are  shown  in col_markstroke or mono_markstroke.  If strokes_regex is blank, then tin
           uses a built-in default.

       Wrap around threads on next unread (wrap_on_next_unread)
           If enabled a search for the next unread article will wrap around all articles to  find
           also  previous  unread articles. If disabled the search stops at the end of the thread
           list. Default is ON.

       Display "a as Umlaut-a (tex2iso_conv)
           If ON, show "a as Umlaut-a, etc. Default is OFF. This behavior can also be toggled  in
           the article viewer via PageToggleTex2iso ('"').

       Thread articles by (thread_articles)
           Defines  which  threading  method to use. It's possible to set the threading type on a
           per group basis by setting the group attribute variable thread_arts to 0 -  4  in  the
           file  ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes.  (See  also  "GROUP  ATTRIBUTES".)  The
           default is Both Subject and References.  The choices are:

            0  None, don't thread.

            1  Subject, thread on ''Subject:'' only.

            2  References, thread on ''References:'' only.

            3  Both  Subject  and  References,  thread  on  ''References:''   then   ''Subject:''
               (default).

            4  Multipart Subject, thread multipart articles on ''Subject:''.

            5  Percentage Match, thread base upon a partial character match on ''Subject:''.

       Catchup thread by using left key (thread_catchup_on_exit)
           If ON catchup group/thread when leaving with the left arrow key. Default is ON.

       Matchingness of a thread (thread_perc)
           How  closely the subjects must match for two threads to be considered part of the same
           thread. This is a percentage and the default if 75%.

       Score of a thread (thread_score)
           How the total score of a thread is computed. Default is 0, the maximum score  in  this
           thread.

            0  Max, the maximum score in this thread.

            1  Sum, the sum of all scores in this thread.

            2  Average, the average score in this thread.

       Transliteration (translit)
           If   ON   append   //TRANSLIT  to  the  first  argument  of  iconv_open(3)  to  enable
           transliteration. This means that when a character cannot be represented in the  target
           character  set,  it  can  be  approximated  through  one  or several similarly looking
           characters. On systems where this extension doesn't exist, this  option  is  disabled.
           Default is OFF.

       How to treat blank lines (trim_article_body)
           Allows you to select how tin treats blank lines in article bodies.  Default is 0. This
           option does not affect lines within verbatim blocks.

            0  Don't trim article body, do nothing.

            1  Skip leading blank lines.

            2  Skip trailing blank lines.

            3  Skip leading and trailing blank l., skip leading and trailing blank lines.

            4  Compact multiple between text, replace multiple  blank  lines  between  textblocks
               with one blank line.

            5  Compact multiple and skip leading, 4 + 1

            6  Compact multiple and skip trailing, 4 + 2

            7  Compact mltpl., skip lead. & trai., 4 + 3

       Regex used to highlight _underline_ (underscores_regex)
           A  regular  expression  that will be applied when reading articles. All matching words
           are shown in col_markdash or mono_markdash. If underscores_regex is  blank,  then  tin
           uses a built-in default.

       Remove ~/.article after posting (unlink_article)
           If ON remove ~/.article after posting. Default is ON.

       Program that opens URL's (url_handler)
           The  program  that  will  be  run  when  launching  URL's  in the article viewer using
           PageViewUrl ('U'). The actual URL will be appended to this.  Default is url_handler.pl
           %s.

       URL highlighting in message body (url_highlight)
           Enable highlighting URLs in message body. Default is ON.

       Use ANSI color (use_color)
           If enabled tin uses ANSI-colors. Default is OFF.

       Use scroll keys on keypad (use_keypad)
           Default is OFF.

       Use mouse in xterm (use_mouse)
           Allows  the  mouse  button  support in a xterm(1x) to be enabled/disabled.  Default is
           OFF.

       Use slrnface to show ''X-Face:''s (use_slrnface)
           If enabled tin uses slrnface(1) to interpret the ''X-Face:'' header. For  this  option
           to  have  any  effect,  tin must be running in an xterm(1x) and slrnface(1) must be in
           your $PATH. Default is OFF.

       Use UTF-8 graphics (utf8_graphics)
           If ON use UTF-8 characters for indicator ('->'), thread/attachment tree  and  ellipsis
           ('...'). Default is OFF.

       Regex for begin of a verbatim block (verbatim_begin_regex)
           A regular expression that tin will use to find the begin of a verbatim block.

       Regex for end of a verbatim block (verbatim_end_regex)
           A regular expression that tin will use to find the end of a verbatim block.

       Detection of verbatim blocks (verbatim_handling)
           If ON verbatim blocks will be detected. Default is ON.

       Wildcard matching (wildcard)
           Allows  you  to  select how tin matches strings. The default is 0 and uses the wildmat
           notation, which is how this has traditionally been handled.  Setting this to 1  allows
           you  to  use  perl(1)  compatible  regular expressions pcre(3) (see also perlre(1) and
           pcrepattern(3)).  You will probably want to update your filter file if  you  use  this
           regularly.  NB: Newsgroup names will always be matched using the wildmat notation.

       What to display instead of mark (word_h_display_marks)
           Should  the  leading  and ending stars, slashes, strokes and dashes also be displayed,
           even when they are highlighting marks?

            0  no

            1  yes, display mark

            2  print a space instead

       Word highlighting in message body (word_highlight)
           Enable word highlighting. See  word_h_display_marks  for  the  options  available.  If
           use_color is enabled the colors specified in col_markdash, col_markslash, col_markstar
           and col_markstroke are used  for  word  highlighting  else  the  character  attributes
           specified  in  mono_markdash,  mono_markslash,  mono_markstar  and mono_markstroke are
           used. Default is ON.

       Page line wrap column (wrap_column)
           Sets the column at which a displayed article body should be wrapped.  If this value is
           equal  to  0,  it defaults to the current screen width.  If this value is greater than
           your current screen width the part off-screen is  not  displayed.  Thus  setting  this
           option to a large value can be used to disable wrapping. If this value is negative the
           wrap margin is the current screen width plus the given value (as long as the result is
           still  positive,  otherwise it will fall back to the current screen width). Default is
           0, wrapping at the current screen width.

       Quote line when cross-posting (xpost_quote_format)
           Format is the same as  for  news_quote_format,  this  is  used  when  answering  to  a
           crossposting to several groups with no ''Followup-To:'' set.

   ATTRIBUTES MENU AND GROUP ATTRIBUTES
       tin  allows  certain  attributes  to be set on a per group basis. If it exists, the global
       attributes file, ${TIN_LIBDIR:-NEWSLIBDIR}/attributes is read. After that, the user's  own
       attributes  file  ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes  is read.  The global attributes
       file is useful for distributing system-wide defaults to new  users  who  have  no  private
       attributes file yet.

       Note  that  the  scope=<grouplist>  line  has  to  be  specified before the attributes are
       specified for that list. All attributes are set to a reasonable default so you  only  have
       to  specify  the  attribute that you want to change (e.g., savedir). All toggle attributes
       are set by specifying ON/OFF. Otherwise, these function exactly the same as  their  global
       equivalents. For more details see tin(5).

       Attributes  can  also  be  changed  from  the  attributes  menu  which  can be accessed by
       ConfigToggleAttrib ('<TAB>') from the options menu or ScopeSelect ('^J'  or  '<CR>')  from
       the  scopes menu.  The attributes menu looks and behaves very similar to the options menu.
       The title shows the current scope. Attributes set in the current scope are marked with '+'
       to the left of the attributes number.

       Besides  the  keys  for  moving around and changing values known from the options menu the
       attributes menu provides the following command: ConfigResetAttrib ('r')  which  resets  an
       attribute to a default value.

   SCOPES MENU
       The  scopes  menu  (accessible from the options menu with ConfigScopeMenu ('S')) shows all
       scopes read from the global and local attributes file.  Scopes from the global  attributes
       file  are  marked  with  '!'  to  the left of the scope number. Delete/rename/move are not
       possible with those scopes.

       In addition to the common moving keys the following commands  are  available:  ScopeSelect
       ('^J'  or '<CR>') enter the attributes menu for the current scope, ScopeEditAttributesFile
       ('E') edit the local attributes file, ScopeAdd ('a') add a new  scope,  ScopeDelete  ('d')
       delete  the  current  scope,  ScopeMove  ('m')  move  the current scope to a new position,
       ScopeRename ('r') rename the current scope. ToggleHelpDisplay ('H') toggles the help  mini
       menu at the bottom of the screen.

   FILTERING ARTICLES
       When  there  is  a  subject  or an author which you are either very interested in, or find
       completely uninteresting, you can easily instruct tin to auto-select or auto-kill articles
       that match rules that you specify. This can be anything from the name of the author to the
       number of lines in an article.

       When tin starts up the  user's  kill-file  ${TIN_HOMEDIR:-"$HOME"}/.tin/filter  (see  also
       tin(5))  is  read.  Each  time  a  newsgroup is entered the rules are applied and articles
       killed or selected when they meet certain criteria.

       The degree to which rules are applied depend on the kill_level tinrc setting.  By  default
       killed  articles  will  only  be  marked  read.  Adjust  kill_level  for  more  aggressive
       processing. Articles that match an auto-selection rule are marked with a ''*''.

       Filtering rules can be  manually  entered  into  ${TIN_HOMEDIR:-"$HOME"}/.tin/filter  (but
       don't do this whilst running tin else you will lose your changes) or by using an on-screen
       menu within tin.

       The filtering capabilities of tin have been significantly enhanced over previous  versions
       to  include  scoring and better pattern matching. It is recommended that you read the file
       filtering in the tin documentation directory.  This  file  can  also  be  read  online  at
       <http://www.tin.org/filtering.txt>.

       The on-screen filtering menu is accessed by pressing '^K' at the Group and Article levels.
       It allows the user to kill or select an article  that  matches  the  current  ''Subject:''
       line,  ''From:''  line  or  a  string  entered by the user. The user entered string can be
       applied to the ''Subject:'' or ''From:'' lines of an article. The kill description can  be
       limited  to the current newsgroup or it can apply to all newsgroups. Once entered the user
       can abort the command and not save the kill description, edit the kill file  or  save  the
       kill description.

   POSTING ARTICLES
       tin  allows  posting of articles, follow-up to already posted articles and replying direct
       through mail to the author of an article.

       Use the Post ('w') command to post an article to a newsgroup.   After  entering  the  post
       subject the default editor (i.e., vi(1)) or the editor specified by the $VISUAL or $EDITOR
       environment variable will be started and the article can be entered. To crosspost articles
       simply add a comma and the name of the newsgroup(s) to the end of the ''Newsgroups:'' line
       at the beginning of the article. After saving and exiting the editor you are asked if  you
       wish  to  a)bort  posting the article, e)dit the article again or p)ost the article to the
       specified newsgroup(s).

       Use the DisplayPostHist ('W') command to display  a  history  of  the  articles  you  have
       posted.  The  date  the article was posted, which newsgroups the article was posted to and
       the articles subject line are displayed.

       Use the PageFollowupQuote ('f'), PageFollowup  ('F')  or  PageFollowupQuoteHeaders  ('^W')
       command  to  post  a follow-up article to an already posted article. The PageFollowupQuote
       command  will  copy  the  text  of   the   original   article   into   the   editor.   The
       PageFollowupQuoteHeaders  command  will  copy  the  text  and  all headers of the original
       article into the editor. The editing procedure is the same as when posting an article with
       the Post ('w') command.

       Use  the  PageReplyQuote ('r'), PageReply ('R') or PageReplyQuoteHeaders ('^E') command to
       reply direct through mail to the author of an already posted article.  The  PageReplyQuote
       command   will   copy   the   text   of   the   original  article  into  the  editor.  The
       PageReplyQuoteHeaders command will copy the text and all headers of the  original  article
       into  the  editor.  The  editing procedure is the same as when posting an article with the
       Post ('w') command. After saving and exiting the editor you are asked if you wish to abort
       sending the article via PostAbort ('a'), edit the article again via PostEdit ('e') or send
       the article to the author via PostSend ('s').

   CUSTOMIZING THE ARTICLE QUOTE STRING
       When posting a followup to an article or replying direct to the author of an  article  via
       email  the text of the article can be quoted. The beginning of the quoted text can contain
       information about the quoted article (e.g., Name and the Message-ID of  the  article).  To
       allow  for  different  situations  certain information from the article can be used in the
       quoted string. The following variables are  expanded  if  found  in  the  tinrc  variables
       mail_quote_format, news_quote_format or xpost_quote_format:
              %A  Address (Email)
              %D  Date (uses date_format)
              %F  Full address (%N <%A>)
              %G  Groupname
              %M  Message-ID
              %N  Fullname of author
              %C  Firstname of author
              %I  Initials of author
       e.g.,
              mail_quote_format=On %D in %G you wrote:
              news_quote_format=In %M, %F wrote:
       would expand to:
              On 21 Sep 1993 09:45:51 -0400 in alt.sources you wrote:
              In <abcINN123@example.org>, Joe Bar <joe@example.org> wrote:
       The  quoted  text  section  of  an  article  is  marked by a preceding quote string at the
       beginning of each quoted line. The default quote string is set to '>_'. The default can be
       changed  by  setting the tinrc variable quote_chars to ones own preference. (Note that '_'
       underline is used to represent a space).

   MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES
       The command interface to GroupMail, PageMail, PostMail or ThreadMail  ('m'),  Pipe  ('|'),
       Print  ('o'),  PageRepost  or GroupRepost ('x') and GroupSave, PageSave or ThreadSave ('s'
       and GroupAutoSave, PageAutoSave or ThreadAutoSave 'S') articles is the same  for  ease  of
       use.

       Auto-saving  with  *AutoSave ('S') is a special case and operates only on marked articles.
       They will processed without any further prompting according to the default save parameters
       defined in tinrc or by any attributes set for the current group.

       Otherwise,  the  initial  prompt  will ask you to select which article, thread, hot (auto-
       selected), regex pattern, tagged articles you wish to mail, pipe etc.

       Tagged articles must have already been tagged  with  a  *Tag  ('t')  command.  All  tagged
       articles can be untagged by a *Untag ('U') untag command.

       If  a  regex  pattern  is  selected  you  are asked to enter a pattern (e.g., to match all
       articles subject lines containing 'net News' you enter  "net  News").  Any  articles  that
       match  the  entered  expression  will  be  mailed,  piped etc. See also the wildcard tinrc
       variable for advanced pattern matching options.

       Various expansion characters are recognized when entering the directory and file  to  save
       to.  Environment  variables (prefixed with '$') and user home directories (prefixed by '~'
       or '~username') can be specified.  Environment  variables  can  themselves  contain  other
       special characters.

       To save articles to a mailbox enter '=<mailbox name>' when asked for the save filename. If
       you enter just '=' then articles will be saved to a mailbox with the name of  the  current
       newsgroup (eg, alt.sources).  See maildir.

       To  save  in savedir/<news.group.name>/<filename> format enter '+<filename>'.  Environment
       variables are allowed within a filename (e.g., $SOURCES/dir/filename). See savedir.

       When saving articles you can specify whether the saved files should be post  processed.  A
       default process type can be set via post_process_type.

   AUTOMATIC MAILING AND SAVING NEW NEWS
       tin  allows  new/unread  news  articles  to  be mailed (''-M'' and ''-N'' option) or saved
       (''-S'' option) in batch mode for later reading. Useful when  going  on  holiday  and  you
       don't  want  to  return  and find that expire has removed a whole load of unread articles.
       Best to run via cron(1) everyday while away, after which you will be mailed  a  report  of
       which  articles  were  mailed/saved from which newsgroups and the total number of articles
       mailed/saved. Articles are  saved  in  a  private  news  structure  under  your  <savedir>
       directory  (default  is  ${TIN_HOMEDIR:-"$HOME"}/News). Be careful of using this option if
       you read a lot of groups because you could overflow your file system.

       When using ''-S'' together with a given directory to save to  (''-s''  option),  the  same
       directory must be specified when reading the articles by ''-R''.

       If  you only want to save some of your groups use the batch_save tinrc variable. Set to ON
       or OFF in tinrc to enable/disable saving  of  all  groups  and  then  use  the  batch_save
       attribute  to  fine  tune which groups you want to have saved. For example, if you want to
       save most of your groups, then set batch_save to ON in tinrc and selectively turn off  the
       ones you don't want using attributes.

       tin -M iain -c -f newsrc.mail
                           (mail  any unread articles in newsgroups specified in file newsrc.mail
                           to the local user iain and mark them as read)

       tin -S -c -f newsrc.save
                           (save any unread articles in newsgroups specified in file  newsrc.save
                           and mark them as read)

       tin -R              (read any articles saved by tin -S)

   RANGES
       A  range  is  simply  a  group  of  items marked using the SetRange ('#') key. Certain tin
       commands will operate on a range if one exists rather than just the current item. A  range
       is an expression of the form <min>-<max>, e.g. 10-15 will highlight items 10 through 15 on
       the current screen. Other than absolute numeric positions, '.' can be used in place of the
       current  cursor  position  and  '$'  can  be  used  to  mean the highest number available.
       Currently  the  only  commands  that  understand  ranges   are   GroupMarkThdRead   ('K'),
       MarkArtUnread ('z') and MarkThdUnread ('Z').

   NEWSGROUP LISTS & WILDCARDS
       Several  places  in  tin allow you to specify a list of newsgroups. These include command-
       line groups, (un)subscribe groups, the AUTO[UN]SUBSCRIBE mechanism. The scope=  attributes
       file  tag  and  the  filter  file group= tag also use the same syntax. tin interprets this
       variable similarly to rn(1).  It contains a list of  patterns,  separated  by  commas  and
       possibly  prefixed  with exclamation points. An exclamation point negates the meaning of a
       match on this pattern, and can be used to cancel certain matches. Some examples:

       alt.config,news.*,!news.test

       Matches alt.config and everything in the 'news' hierarchy except news.test

       See the explanation for the $AUTOSUBSCRIBE variables for further examples.

   SIGNATURES
       tin  will  recognize  a  signature   in   either   ${TIN_HOMEDIR:-"$HOME"}/.signature   or
       ${TIN_HOMEDIR:-"$HOME"}/.Sig.   If  ${TIN_HOMEDIR:-"$HOME"}/.signature  exists,  then  the
       signature will be  pulled  into  the  editor  for  mail  commands  only.  A  signature  in
       ${TIN_HOMEDIR:-"$HOME"}/.signature will not be pulled into the editor for posting commands
       since inews(1) will append the signature itself.

       A signature in ${TIN_HOMEDIR:-"$HOME"}/.Sig will  be  pulled  into  the  editor  for  both
       posting and mailing commands.

       The following is an example of a .Sig file:
              NAMES  Joe Bar <joe@example.org>
              SNAIL  Musterweg 12, 99999 Notreal, Germany

       tin  also  has the capability to generate random signatures on a per newsgroup basis if so
       desired. The way to accomplish this is to specify  the  default  signature  or  the  group
       attribute  sigfile  as a directory. If for example the sigfile path is /usr/iain/.sigs and
       .sigs is a directory then tin will select a random signature from any file that is in  the
       directory  .sigs  (note:  one  signature  per  numbered file). A random signature can also
       consist of a fixed part signature that can contain your name, address etc. followed by the
       random sig. The fixed part of the random sig is read from the file $HOME/.sigfixed.

   TIPS AND TRICKS
       tin  can  be  pretty  much be navigated by using the four cursor keys.  The left arrow key
       goes up a level, the right arrow key goes down a level, the up arrow key goes  up  a  line
       and the down arrow key goes down a line.

       The following newsgroups provide useful information concerning news software:
           —news.software.readers (info. about news user agents tin, rn, nn, slrn etc.)
           —news.software.nntp (info. about NNTP)
           —news.answers (Frequently Asked Questions (FAQ) about many different themes)

       Many  prompts  within  tin  offer  a  default  choice that the cursor is positioned on. By
       pressing '<CR>' the default value is taken.  Most  prompts  can  be  aborted  by  pressing
       '<ESC>'.

       When tin is run in an xterm(1x) it will resize itself each time the xterm(1x) is resized.

       tin  will  reread  the  ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active}  file at set
       intervals (reread_active_file_secs) to show any newly arrived news.

       If  you  find  large  number  of  new  newsgroups  cluttering  up  your  screen,  pressing
       SelectToggleReadDisplay ('r') will make them go away.

   XTERM BUTTONS
       If the environment variable $TERM is set to xterm(1x), then button pressing can be used to
       select groups and articles. In this discussion, the buttons are  assumed  to  be  assigned
       conventionally (i.e., Button1 is the left button).

       In general (i.e., for the group, thread and article menus),

       Button1 (left)
                 enters next (lower) level if you click on an article, otherwise pages down.

       Button2 (center)
                 returns  to  the  previous  (upper)  level if you click on an article, otherwise
                 pages up.

       Button3 (right)
                 positions on the article line under  mouse  cursor,  or  pages  down  if  you've
                 clicked outside the list of articles.

       In the group selection menu, if the mouse is pointing at a group then:

       left button
                 moves to and selects the group pointed at, just like SelectReadGrp ('<CR>').

       center button
                 quits the program, just like Quit ('q').

       right button
                 moves to the group pointed at.

       In the article menu, if the mouse is pointing at an article (or thread) then:

       left button
                 reads  the  article  pointed  at,  just  like GroupReadBasenote ('<CR>'), or the
                 thread, just like GroupListThd ('l').

       center button
                 exits the menu, catching up on the group if you have  group_catchup_on_exit  set
                 in your configuration, just like Quit ('q').

       right button
                 moves to the article (or thread) pointed at.

       In the thread menu, if the mouse is pointing at an article then:

       left button
                 reads article pointed at, just like ThreadReadArt ('<CR>').

       center button
                 exits the menu, catching up on the thread if you have thread_catchup_on_exit set
                 in your configuration, just like Quit ('q').

       right button
                 moves to the article pointed at.

       In other menus and areas button pressing reverts back to usual cut and paste of xterm(1x),
       but after one click of any button.

   INDEX FILES
       If   your  news  server  supports  NOV  index  files  (see  newsoverview(5),  most  modern
       installations will) and you have a fast connection to your news server then  this  section
       can be ignored.

       If  your news server doesn't support NOV index files or you have a very slow connection to
       your news server then tin can cache the index for each newsgroup  if  cache_overview_files
       is  set  to  ON.  Note that this cache can use up large amounts of diskspace if you read a
       lot of groups and/or high traffic groups.

       Each   user   creates/updates   his/her   own   index   files   that   are    stored    in
       ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news/.  If  you are reading via NNTP
       then the news server name will be appended to  keep  the  indexes  for  different  servers
       separate.  If  you  are reading off the local spool and local overview files already exist
       then turning on caching will have no effect. Likewise unless you  see  significant  delays
       entering  a  group  when  reading  via NNTP then turning on caching will have little or no
       effect.

       Entering a group the first time tends to be slow because the index file must be built from
       scratch.  To alleviate the slowness start tin to create all index files for the groups you
       subscribe to with tin -u -v and go for a coffee. Subsequent readings of a group will  only
       need  to  do  incremental  updating  of the index file and will be much faster as only new
       articles will need to be cached.

       As indexing might take some time you may want to run tin form the system  batcher  cron(1)
       with the ''-u'' option:

              30 6 * * * /usr/local/bin/tin -u

       If  you  are  low  on local disk space you should consider using getart_limit to limit the
       size of cached indexes and also manually purge cached data for groups you are not  reading
       anymore with something like:

              find ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news* \
              -type f -name "[0-9]*.[0-9]" -atime +28 | xargs rm -f

FILES

       For a detailed description see tin(5).

       $MAILCAPS
       ${TIN_HOMEDIR:-"$HOME"}/.mailcap
       /etc/mailcap
       /usr/etc/mailcap
       /usr/local/etc/mailcap
       /etc/mail/mailcap

       /etc/news/server

       ${TIN_HOMEDIR:-"$HOME"}/.cancelsecret

       ${TIN_HOMEDIR:-"$HOME"}/.mime.types
       /etc/mime.types
       /etc/tin/mime.types

       ${TIN_HOMEDIR:-"$HOME"}/.newsauth

       ${TIN_HOMEDIR:-"$HOME"}/.newsrc

       ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/.oldnewsrc

       ${TIN_HOMEDIR:-"$HOME"}/.signature
       ${TIN_HOMEDIR:-"$HOME"}/.Sig

       ${TIN_HOMEDIR:-"$HOME"}/.sigfixed

       ${TIN_HOMEDIR:-"$HOME"}/.tin/.inputhistory

       ${TIN_INDEX_MAILDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.mail/

       ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news${NNTPSERVER:+"-$NNTPSERVER"}/

       ${TIN_INDEX_SAVEDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.save/

       ${TIN_HOMEDIR:-"$HOME"}/.tin/active.mail

       ${TIN_HOMEDIR:-"$HOME"}/.tin/active.save

       /etc/tin/attributes
       ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes

       ${TIN_HOMEDIR:-"$HOME"}/.tin/filter

       /etc/tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
       ${TIN_HOMEDIR:-"$HOME"}/.tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}

       ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups

       ${TIN_HOMEDIR:-"$HOME"}/.tin/newsrctable

       ${TIN_HOMEDIR:-"$HOME"}/.tin/posted

       ${TIN_HOMEDIR:-"$HOME"}/Mail/posted

       ${TIN_HOMEDIR:-"$HOME"}/.tin/postponed.articles

       ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER:${NNTPPORT:+":$NNTPPORT"}/newsgroups

       ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER:${NNTPPORT:+":$NNTPPORT"}/serverrc

       /etc/tin/tinrc
       ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc

       /etc/tin/tin.defaults

       /usr/local/share/locale/${LC_MESSAGES}/LC_MESSAGES/tin.mo

       ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active}

       ${TIN_LIBDIR:-NEWSLIBDIR}/active.times

       ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups

       ${TIN_LIBDIR:-NEWSLIBDIR}/organization

       ${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt

       ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions

ENVIRONMENT

       TINRC  Define this variable if you want to specify command-line options that tin should be
              started with to save typing them each time it  is  started.  The  contents  of  the
              environment  variable  are added to the front of the command-line options before it
              is parsed therefore allowing an option specified on the  command-line  to  override
              the same option specified in the environment.

       TIN_HOMEDIR
              Define  this variable if you do not want the .tin directory in $HOME/. E.g., if you
              want all tin's private files in /tmp/.tin you would set $TIN_HOMEDIR to /tmp.

       TIN_INDEX_NEWSDIR
              Define  this   variable   if   you   do   not   want   the   .news   directory   in
              ${TIN_HOMEDIR:-"$HOME"}/.tin/.  E.g.,  if  you  want  all tin's news index files in
              /tmp/.news you would set $TIN_INDEX_NEWSDIR to /tmp.

       TIN_INDEX_MAILDIR
              Define  this   variable   if   you   do   not   want   the   .mail   directory   in
              ${TIN_HOMEDIR:-"$HOME"}/.tin/.  E.g.,  if  you  want  all tin's mail index files in
              /tmp/.mail you would set $TIN_INDEX_MAILDIR to /tmp.

       TIN_INDEX_SAVEDIR
              Define  this   variable   if   you   do   not   want   the   .save   directory   in
              ${TIN_HOMEDIR:-"$HOME"}/.tin/.  E.g.,  if  you  want  all tin's save index files in
              /tmp/.save you would set $TIN_INDEX_SAVEDIR to /tmp.

       TIN_LIBDIR
              Define this variable if you want to override the NEWSLIBDIR path that was  compiled
              into  the  tin  binary,  default  is /usr/lib/news.  If tin is running in NNTP mode
              setting this variable has no effect.

       TIN_SPOOLDIR
              Define this variable if you want to override the SPOOLDIR path  that  was  compiled
              into  the  tin  binary, default is /var/spool/news.  If tin is running in NNTP mode
              setting this variable has no effect.

       TIN_NOVROOTDIR
              Define this variable if you want to override the NOVROOTDIR path that was  compiled
              into  the  tin  binary,  default is SPOOLDIR (see above). If tin is running in NNTP
              mode setting this variable has no effect.

       TIN_ACTIVEFILE
              Define this variable if you want to override the NEWSLIBDIR/active  path  that  was
              compiled  into the tin binary. If tin is running in NNTP mode setting this variable
              has no effect. If $TIN_LIBDIR is set it is prepended to $TIN_ACTIVEFILE.

       NNTPSERVER
              The default NNTP server to remotely read news from. This variable only needs to  be
              set  if  the  ''-r'' command-line option is specified and the file /etc/news/server
              does not exist. The ''-g'' command line option overrides $NNTPSERVER.

       NNTPPORT
              The NNTP TCP-port to read news from. This variable only needs to be set if the TCP-
              port is not 119 (the default).  The ''-p'' command-line option overrides $NNTPPORT.

       DISTRIBUTION
              Set  the  article  header  field  ''Distribution:'' to the contents of the variable
              instead of the system default.

       ISO2ASC
              Set the ISO to ASCII charset decoding table character to use in decoding an article
              text. Values can range from 0 to 6.

            0      universal table for many languages

            1      single-spacing universal table

            2      table for Danish, Dutch, German, Norwegian and Swedish

            3      table for Danish, Finnish, Norwegian and Swedish using the appropriate ISO 646
                   variant

            4      table with RFC 1345 codes in brackets

            5      table for printers that allow overstriking with backspace

       ORGANIZATION
              Set the article header field ''Organization:'' to  the  contents  of  the  variable
              instead  of  the  system default. If reading news on an Apollo DomainOS machine the
              environment variable $NEWSORG has to be used instead of $ORGANIZATION.

       NEWSORG (DomainOS)
              DomainOS specific, same as $ORGANIZATION on other OSs (see above).

       REPLYTO
              Set the article header field ''Reply-To:'' to the return address specified  by  the
              variable. This is useful if you wish to receive replies at a different address.

       NAME   Overrides  the  full  name  given  in  the  gecos-files  in  /etc/passwd,  see also
              mail_address.

       REALNAME
              Same as $NAME.

       HOME   Pathname of the user's home directory. See environ(5) for more info.

       MAILER This variable has precedence over the default mailer that is used  in  all  mailing
              operations within tin.

       MAIL   Full path to the user's mailbox.

       VISUAL This  variable has precedence over the default editor (i.e., vi(1)) that is used in
              all editing operations within  tin  (e.g.,  posting,  replying,  follow-ups,  ...).
              Evaluation order is ${VISUAL:-"${EDITOR:-vi}"}. See environ(5) for more info.

       EDITOR If  $VISUAL  is  unset,  then  this  variable is looked up for a default editor. If
              $EDITOR and $VISUAL are both unset, tin  uses  the  systems  default  editor  (i.e.
              vi(1)) on UNIX-systems). See environ(5) for more info.

       AUTOSUBSCRIBE
              A  new group is checked against the list of patterns; if it matches, tin subscribes
              the user to the group without further query.  See the section  "NEWSGROUP  LISTS  &
              WILDCARDS" for an explanation of the valid syntax. For example, setting

              AUTOSUBSCRIBE=comp.os.unix.*,talk.*,!talk.politics.*

              will  automatically  subscribe  the  user  to  all  new  groups in the comp.os.unix
              hierarchy, and all talk groups other  than  talk.politics  groups  (which  will  be
              queried  for  as  usual).  Of  course this does not work if tin is started with the
              ''-X'' command-line switch.

       AUTOUNSUBSCRIBE
              Is handled like the $AUTOSUBSCRIBE variable,  but  groups  matching  the  list  are
              unsubscribed from without further query. For example, setting

              AUTOUNSUBSCRIBE=alt.flame.*,u*,!uk.*

              will  automatically  unsubscribe  the  user  from  all new alt.flame groups and all
              groups starting with u (university groups) other than  UK  groups  (which  will  be
              queried for as usual).

       TMPDIR A pathname of a directory made available for tin to create temporary files.

       MAILCAPS
              This  variable  can  be used to override the default path search for mailcap files.
              See also tin(5).

       NOMETAMAIL
              Set this variable to  disable  the  use  of  metamail(1)  or  a  replacement  (e.g.
              metamutt).

       MM_CHARSET

       ISPELL Set this variable to point to ispell(1) or a replacement and its cmd-line options.

       PGPOPTS
              Define  any  additional  options  that  you  wish  to pass to your pgp(1) or gpg(1)
              program.

       PGPPATH
              Override the name of the pgp(1) directory in $HOME that holds your keys etc..

       GNUPGHOME
              Override the name of the gpg(1) directory in $HOME that holds your keys etc..

       LC_CTYPE
              This variable determines the locale(5) category for character  handling  functions.
              Usually  it  determines  the  character  classes  for  pattern  matching  character
              classification and case conversion. Currently this  is  not  true  for  tin  (which
              temporary  unsets  $LC_CTYPE  right  before  any match is done to avoid confusion).
              It's value should be of  the  form  language[_territory][.codeset][@modifier].  See
              environ(5) for more information.

       LC_MESSAGES
              Formats  of  informative  and  diagnostic messages and interactive responses.  It's
              value  should  be  of  the  form   language[_territory][.codeset][@modifier].   See
              locale(5) and environ(5) for more information.

       LC_TIME
              Date    and    time    formats.    It's    value    should    be    of   the   form
              language[_territory][.codeset][@modifier]. See locale(5) and  environ(5)  for  more
              information.

       LC_ALL This  variable  overrides  the  value  of  the  $LANG  variable  and any other $LC_
              variable. It's value should be  of  the  form  language[_territory][.codeset].  See
              locale(5) and environ(5) for more information.

       LANG   This  variable  determines the locale(5) category for any category not specifically
              selected with a variable starting with $LC_. It's  value  should  be  of  the  form
              language[_territory][.codeset]. See environ(5) for more information.

       LANGUAGE
              This  variable  defines a priority list for translations. Whenever a translation is
              not available in the language selected via $LC_ALL or $LANG the next language  from
              the  list  is tried. It's value should be of the form language:language[:language].
              See environ(5) for more information.

       COLUMNS
              A decimal integer > 0 used  to  indicate  the  user's  preferred  width  in  column
              positions for the terminal screen or window. If this variable is unset or null, the
              implementation determines the number of columns, appropriate for  the  terminal  or
              window.  When $COLUMNS is set, any terminal-width information implied by $TERM will
              be overridden. Users and portable applications should not set $COLUMNS unless  they
              wish  to override the system selection and produce output unrelated to the terminal
              characteristics.

       LINES  A decimal integer > 0 used to indicate the user's preferred number of  lines  on  a
              page  or  the  vertical  screen  or  window size in lines. A line in this case is a
              vertical measure large enough to hold the tallest character in  the  character  set
              being  displayed.  If this variable is unset or null, the implementation determines
              the number of lines, appropriate for the terminal or window. When  $LINES  is  set,
              any  terminal-height  information  implied  by  $TERM will be overridden. Users and
              portable applications should not set $LINES unless they wish to override the system
              selection.

       TERM   The  type  of terminal in use. This is used when looking up termcap sequences.  See
              environ(5) for more information.

SIGNALS

       tin handles a couple of signals:

       SIGHUP Terminate gracefully.

       SIGTERM
              Terminate gracefully.

       SIGUSR1
              Terminate gracefully but do not restore tty.

       SIGUSR2
              Write out ${TIN_HOMEDIR:-"$HOME"}/.newsrc-file.

SECURITY

       When tin is started in debug mode (''-D n'')  it  will  create  world  readable  files  in
       $TMPDIR  which  may  contain  the  users  NNTP password in cleartext. On multiuser-systems
       $TMPDIR should be set to  a  safe  location  before  starting  tin  in  debug  mode  (e.g.
       TMPDIR=$HOME tin -D 1).

CONFORMING TO

       tin  does  conform  to  the  Base  Definitions volume of IEEE Std 1003.1-2001, Section 12,
       Utility Conventions (Utility Argument Syntax, Utility Syntax Guidelines).

NOTES

       Regular expression support is provided by the PCRE library package pcre(3), which is  open
       source  software,  written  by Philip Hazel, and copyright by the University of Cambridge,
       England.
       ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/

BUGS

       CNews NNTPd, noffle(1) (<= V1.0-pre5) and NewsCache (<= V1.1.91)  can't  handle  pipelined
       GROUP  commands.  If  you  run  into  trouble  with  any  of  the mentioned servers define
       DISABLE_PIPELINING in include/autoconf.h and recompile.
       Before mailing a bug-report to <tin-bugs@tin.org> please check if you are using the latest
       (stable)  release,  and if not, please upgrade first! Have a look at the doc/TODO file for
       known bugs. If you still think you've found a bug, please use the BugReport ('R') function
       and write in English. Please do NOT enclose a core-file in your bugreport until we request
       it.

HISTORY

       tin is based on the tass(1) newsreader that was developed by Rich Skrenta  and  posted  to
       alt.sources  in  March  1991; its first version was released on August 23rd 1991.  tass(1)
       itself was heavily influenced by notesfiles a public domain UNIX version of  PLATO  Notes,
       developed  at  the  University  of  Illinois  by Ray Essick and Rob Kolstad in 1982. For a
       version overview see <http://www.tin.org/history.html>.

CREDITS

       Rich Skrenta
              author of tass(1) v3.2 which this newsreader used as its base.

       Bill Davidsen
              author of envarg.c environment variable reading routine.

       Mike Gleason
              author of sigfile.c random signature generation routines.

       Markus Kuhn <Markus.Kuhn@cl.cam.ac.uk>
              author of langinfo.c, charset.c and iso2asc.txt ISO-8859-1 documentation.

       Arnold Robbins
              author of strftime.c date formatting routine.

       Rich Salz
              author of wildmat.c pattern matching and parsdate.y date parsing routines.

       Dave Taylor
              author of curses.c from the elm(1) mailreader.

       Chris Thewalt
              author of getline.c emacs(1) style editing routine.

       Steven Madsen
              for adding pgp(1) (Pretty Good Privacy) support.

       Philip Hazel <ph10@cam.ac.uk>
              for pcre(3) (Perl-compatible regular expression library).

       Patrick Powell <papowell@astart.com>
              for snprintf(3) and vsnprintf(3) fallbacks.

AUTHOR

       Iain Lea <iain@bricbrac.de>

MAINTAINER

       Urs Janssen <urs@tin.org>

SEE ALSO

       cron(1), elm(1),  emacs(1),  gpg(1),  inews(1),  ispell(1),  lp(1),  lpr(1),  metamail(1),
       noffle(1),  perl(1), perlre(1), pgp(1), rn(1), sendmail(1), shar(1), slrnface(1), tass(1),
       unshar(1),  uudecode(1),  vi(1),  xterm(1x),  iconv(3),   iconv_open(3),   nl_langinfo(3),
       pcre(3),  pcrepattern(3),  snprintf(3), strftime(3), vsnprintf(3), wildmat(3), environ(5),
       locale(5), mbox(5), mmdf(5), newsoverview(5), tin(5), RFC1524, RFC2045, RFC2046,  RFC2047,
       RFC2048, RFC2980, RFC3977, RFC4643, RFC5322, RFC5536, RFC5537, RFC6048