tin(1)



tin(1)                         Usenet newsreader                        tin(1)

NAME
       tin, rtin - 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  arti-
       cle_limit] [-f newsrc_file] [-g server] [-m Mail_dir] [-p port] [-I in-
       dex_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_HOME-
       DIR:-"$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 (termi-
       nal 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.

            2      NNTP 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.  Only
                   available when build with IPv6 support.

       -6          Force  connecting  via IPv6 to the remote NNTP server. Only
                   available when build with IPv6 support.

       -a          Toggle ANSI color (default is off).

       -A          Force authentication on  initial  connect.  Only  available
                   when reading via NNTP.

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

       -d          Don't  load  newsgroup  descriptions and servers message of
                   the day (interactive mode).

       -D debug-level
                   Enter debug-level (1 = NNTP, 2 = filter, 4 =  newsrc,  8  =
                   threading,  16  = memory, 32 = attributes, 64 = misc, 128 =
                   remove existing debug files).  For NNTP-level  ''-v''  con-
                   trols the verbosity of the output.

       -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_HOME-
                   DIR:-"$HOME"}/.tin/newsrctable. Only available when reading
                   via NNTP.

       -G article-limit
                   Limit the number of articles/group  to  retrieve  from  the
                   server.  If article-limit is > 0 not more than the last ar-
                   ticle-limit articles/group are fetched from the server.  If
                   article-limit  is < 0 tin will start fetching articles from
                   your first unread minus absolute  value  of  article-limit.
                   Default is 0, which means no limit.

       -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_HOME-
                   DIR:-"$HOME"}/.tin"}/.news.  This option has no  effect  if
                   tin  retrieves  its  index  files  via NNTP and cache_over-
                   view_files is turned off.

       -l          Get number  of  articles  per  group  from  the  ${TIN_LIB-
                   DIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active} file. If read-
                   ing via NNTP this is done with the LIST command  (RFC3977).
                   This  might  result in incorrect article counts but is usu-
                   ally  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''. If reading
                   via NNTP and LIST COUNTS (RFC6048)  is  available  that  is
                   used instead as it gives more accurate article counts.

       -m dir      Mailbox   directory   to   use.   Default   is  ${TIN_HOME-
                   DIR:-"$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:-NEWSLIB-
                   DIR}"/"${TIN_ACTIVEFILE:-active}  file  that are subscribed
                   to in the user's ${TIN_HOMEDIR:-"$HOME"}/.newsrc. This  al-
                   lows  a noticeable speedup when connecting via a slow line,
                   but tin may not be able detect 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.  Only
                   available when reading via NNTP.

       -q          Don't check for new newsgroups and skip loading the servers
                   message of the day.

       -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/nntpserver.

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

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

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

       -u          Create/update index files for every  group  in  ${TIN_HOME-
                   DIR:-"$HOME"}/.newsrc  or  file specified by the ''-f'' op-
                   tion. 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 ''-D'', ''-c'',  ''-M'',  ''-N'',  ''-S'',
                   ''-u''  and  ''-Z''  options. Can be used multiple times to
                   increase verbosity.

       -V          Print version and date information.

       -w          Quick mode to post an article and then  exit.  This  option
                   implies  ''-d''.  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 overwrit-
                   ten 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 appro-
                   priate 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 CONFIG-
       URABLE 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 nor-
       mal  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:-ac-
       tive} file and get them back.

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

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

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  admin-
       istrator. The subscriptions file should be created in your news lib di-
       rectory (i.e., ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions) and  should  be
       world  readable.  If you read news via NNTP, then your news server must
       support the LIST SUBSCRIPTIONS command. It is part of the NNTP List Ex-
       tensions (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 news  server
       and)  the number of subscribed groups (containing new unread articles).
       The newsgroups are displayed in the middle of the screen  usually  with
       the  number of unread articles displayed on the same line in front, but
       it can be customized via select_format.

       ->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  fol-
       lows:

       u         This  group  is  unsubscribed.  To  see  only your subscribed
                 groups use the SelectToggleReadDisplay ('r') or SelectYankAc-
                 tive ('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  environ-
                 ment  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  news
                 server 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 abbreviated threading method (thread_arti-
       cles),  the  limit of articles to get (if set; getart_limit), the total
       number of (unread) articles (art_marked_read or art_marked_unread), the
       number  of hot articles art_marked_selected, the number of read hot ar-
       ticles (if any; art_marked_read_selected), the number of  recent  arti-
       cles   (art_marked_recent)   and   the   number   of   killed  articles
       (art_marked_killed). 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 it is marked with art_marked_unread in
       front of the total number of articles in the thread. If there  are  re-
       cent  articles within the thread it might be marked with art_marked_re-
       cent 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. The display can be customized via group_format.

                       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, but can be customized via thread_format:

       ->   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

       The  look  of  the Selection, Group and Thread level can be customized.
       See the section "CUSTOMIZING THE SCREEN FORMAT".

   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(1)  style  editing  package  allows the easy editing of input
       strings.  A 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,  respec-
                 tively.

       ^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 arti-
                 cle (without spawning editor); PostponeAll ('A') =  post  all
                 postponed  articles (without spawning editor); PromptNo ('n')
                 = skip this article; Quit ('q') = quit postponed  menu.  Cur-
                 rently there is no 'simple' way to delete a postponed article
                 from the postponed-file, you have to use the  following  com-
                 mand 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  com-
                 mand. 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  ac-
                 cess any group, even those not currently yanked in.

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

       ToggleInverseVideo 'I'
                 Toggle inverse video.

       LookupMessage 'L'
                 Look  up  article  by  ''Message-ID:''. If none of the groups
                 listed in the ''Newsgroups:''-header of the referenced  arti-
                 cle   is   available,   just  the  contents  of  the  ''News-
                 groups:''-header will be displayed in the last line.  At this
                 level  this  command  only  works if reading via NNTP and the
                 server supports [X]HDR (RFC2980, RFC3977) or XPAT (RFC2980).

       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 dis-
                 played.

       OptionMenu 'M'
                 User configurable options menu (for more information see sec-
                 tion "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 pat-
                 tern that tin understands.

       SelectUnsubscribe 'u'
                 Unsubscribe to current group. This can be used to remove  bo-
                 gus  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_ACTIVE-
                 FILE:-active}  file  and just those that are subscribed to in
                 ${TIN_HOMEDIR:-"$HOME"}/.newsrc.

       SelectSyncWithActive 'Y'
                 Reread the  ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-ac-
                 tive}  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
       All searches in this  level  are  limited  to  unread  articles  if  in
       show_only_unread_arts mode. GroupToggleReadUnread ('r') can be use tog-
       gle the setting right before/after the search.

       4         Select article 4.

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

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

       MarkFeedRead '^X'
                 Mark current article, thread, range, auto-selected (hot)  ar-
                 ticles, 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)  ar-
                 ticles,  articles  matching pattern or tagged articles as un-
                 read. A prompt asks which type should be marked.

       SetRange '#'
                 Choose a range of articles to be affected by  the  next  com-
                 mand. 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 backwards 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 ef-
                 fect of GroupMarkUnselArtRead ('X') command. Thus after first
                 doing a GroupMarkUnselArtRead, one can then  do  GroupUndoSel
                 to reset articles. Thus, one can iteratively whittle down un-
                 interesting 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 confirma-
                 tion]. The defaults used for selection  are  based  upon  the
                 following  four  tinrc  config  variables: default_filter_se-
                 lect_case,  default_filter_select_expire,  default_filter_se-
                 lect_global  and default_filter_select_header.  Read the sec-
                 tion "GLOBAL OPTIONS MENU AND TINRC  CONFIGURABLE  VARIABLES"
                 for  a full explanation of these variables and "FILTERING AR-
                 TICLES" 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,   de-
                 fault_filter_kill_expire,  default_filter_kill_global and de-
                 fault_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 informa-
                 tion 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 spe-
                 cific ''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  op-
                 tions 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 ac-
                 cess 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 ar-
                 ticle/thread. If a range  of  articles/threads  is  set,  the
                 range  will  be  marked  as read instead of the current arti-
                 cle/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 AR-
                 TICLES" for more information.

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

       GroupNextGroup 'n'
                 Go to next group.

       GroupNextUnreadArt '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 AR-
                 TICLES" 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 sec-
                 tion "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') / GroupRe-
                 post ('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 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').

       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 crosspost your own arti-
                 cles.

       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  "FIL-
                 TERING ARTICLES" for more information.

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

       MarkFeedRead '^X'
                 Mark current article, thread, range, auto-selected (hot)  ar-
                 ticles, 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)  ar-
                 ticles,  articles  matching pattern or tagged articles as un-
                 read. A prompt asks which type should be marked.

       SetRange '#'
                 Choose a range of articles to be affected by  the  next  com-
                 mand. 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 backwards for specified subject.

       ThreadSelArt '*'
                 Select 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 spe-
                 cific ''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  op-
                 tions 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 AR-
                 TICLES" 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 AR-
                 TICLES" 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 sec-
                 tion "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 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').

       MarkArtUnread 'z'
                 Mark current article in thread as unread. If a range of arti-
                 cles  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 "FIL-
                 TERING 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 AR-
                 TICLES" 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 ar-
                 ticle 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_head-
                 ers_to_display.

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

       PageToggleUue '('
                 Toggle  the display of uuencoded sections. The default behav-
                 ior 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 arti-
                 cle. 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_fil-
                 ter_select_expire,   default_filter_select_global   and   de-
                 fault_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 informa-
                 tion on filtering.

       QuickFilterKill ']'
                 Kill  article(s)  with  a  single  key. The defaults used for
                 killing are based upon the following four tinrc config  vari-
                 ables:  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  re-
                 turn to the previous menu. Move cursor to next item.

       CatchupNextUnread 'C'
                 Mark  the rest of the current thread as read [after confirma-
                 tion] 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 ar-
                 ticle 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 AR-
                 TICLES" for more information.

       OptionMenu 'M'
                 User configurable options menu (for more information see sec-
                 tion "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 AR-
                 TICLES" 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 with-
                 out including the original article.

       PageSave 's'
                 Save  current article / thread / auto-selected (hot) articles
                 / articles matching pattern / tagged articles. See  the  sec-
                 tion  "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 sec-
                 tion "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 arti-
                 cles.

       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. Be-
       sides 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  ar-
       ticle.  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, /etc/tin/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 dis-
       tributing system-wide defaults to new users who have no  private  tinrc
       yet.

       The   variables   are   user   configurable   by   editing  ${TIN_HOME-
       DIR:-"$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  tog-
       gle  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 ConfigTog-
       gleAttrib 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_HOME-
       DIR:-"$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.  De-
           fault 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 au-
           tomatically 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.

       Hash algorithm for cancel-locks (cancel_lock_algo)
           Use this hash algorithm for cancel-locks. Only available when build
           with cancel-lock support. none disables the generation  of  cancel-
           locks.  Valid values are none, sha1, sha256 and sha512.  Default is
           sha1.

       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 quoted text from external sources (col_extquote)
           Color of quoted text from external sources

       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_dis-
           play_marks and word_highlight.

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

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

       Color of highlighting with -stroke- (col_markstroke)
           Color  of  words  emphasized  like  -this-.  See  also  word_h_dis-
           play_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.

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

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

            o  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  sen-
           sitive, OFF = ignore case. Default is OFF.

       (default_filter_kill_expire)
           Default  for  quick  (1 key) kill filter expire.  ON = limit to de-
           fault_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 a 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 pa-
           rameters.  Default is "%E +%N %F" (e.g., /bin/vi +7 .article).

       Detection of external quotes (extquote_handling)
           If ON quotes from external sources will  be  detected.  Default  is
           OFF.

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

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

       Number of articles to get (getart_limit)
           If getart_limit is > 0 not more than the  last  getart_limit  arti-
           cles/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.

       Format string for the Group level (group_format)
           Format string tin uses for Group level representation. See the sec-
           tion     "CUSTOMIZING    THE    SCREEN    FORMAT".    Default    is
           "%n %m %R %L  %s  %F".

       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.

       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 at-
           tachment).  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 in-
           ews), 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.  De-
           fault is ON.

       Keep failed arts in ~/dead.articles (keep_dead_articles)
           If  ON keep all failed postings in ${TIN_HOMEDIR:-"$HOME"}/dead.ar-
           ticles besides keeping  the  last  failed  posting  in  ${TIN_HOME-
           DIR:-"$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. De-
           fault 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 com-
           pliant 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=Ad-
           dress, %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
           on  SCO),  MBOXRD or MMDF (default on SCO). See mbox(5) and RFC4155
           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  pro-
           gram.  It allows the user to save articles/threads/groups simply by
           giving '=' as the filename to  save  to.   Default  is  ${TIN_HOME-
           DIR:-"$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
              sendmail -oem -t < %F
              elm -s "%S" "%T" < "%F"
              claws-mail --compose "mailto:%T?subject=%S&insert=%F"
           interactive_mailer  must  be  set adequate. The following substitu-
           tions are supported:
              %F              filename
              %M              default_mailer
              %S              subject-field
              %T              to-filed
              %U              username
              %%              %

       '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 func-
           tion 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 in-
           stalled. Leave it blank if you don't want any automatic viewing  of
           non-textual attachments. The 'V' command can always be used to man-
           ually 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 consid-
           ered not displayable and represented as '?'. Otherwise, all charac-
           ter  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 vari-
           able $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_dis-
           play_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_dis-
           play_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_dis-
           play_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_dis-
           play_marks and word_highlight.

       (newnews)
           These  are  internal  timers used by tin to keep track of new news-
           groups.  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  wild-
           card 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_dis-
           play=X- news_headers_to_not_display=X-Alan X-Pape Not defining any-
           thing turns off this option.

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

       NNTP read timeout in seconds (nntp_read_timeout_secs)
           Time  in seconds to wait for a response from the server. Default is
           120.  Setting this to 0 means no timeout.

       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 Compo-
               sition

            2  NFKD: Compatibility Decomposition

            3  NFC: Canonical Decomposition, followed by Canonical Composition

            4  NFD: Canonical Decomposition

            5  NFKC_CF: Compatibility  Decomposition,  followed  by  Canonical
               Composition and Case Folding
       Some  normalization  modes  are only available if they are supported by
       the library tin uses to do the normalization. NFC  should  be  used  if
       possible.

       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_en-
           coding  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(5) file. Default is ON.

       Post process saved articles (post_process_type)
           This specifies whether to perform post processing  on  saved  arti-
           cles.  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_arti-
           cles_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. Other-
           wise 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 arti-
           cles.  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 com-
           pressed  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  oth-
           erwise  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.  De-
           fault 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_HOME-
           DIR:-"$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.

       Format string for the Selection level (select_format)
           Format string tin uses for Selection level representation. See  the
           section    "CUSTOMIZING    THE    SCREEN    FORMAT".   Default   is
           "%f %n %U  %G  %d".

       In group and thread level, 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 over-
           ride 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.

       Function for sorting articles (sort_function)
           Function used for sorting articles. Default is 0.

            0  Use qsort(3) for sorting.

            1  Use heapsort(3) for sorting. This  might  be  faster  in  large
               groups with long threads (somewhat presorted data).

       Show lines/score in listings (show_info)
           Which  information about the thread or article should be shown. De-
           fault 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 (un-
               read) article will be displayed.

            2  Score, in article listing the score of an article will be  dis-
               played  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. De-
           fault 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  direc-
           tory  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 signa-
           ture. In order to pass the group name to the  program,  %G  can  be
           specified.  This  will be replaced by the name of the current news-
           group. --none will suppress any signature.  Default is  ${TIN_HOME-
           DIR:-"$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  de-
               scending.

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

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

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

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

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

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

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

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

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

       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_HOME-
           DIR:-"$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  bo-
           gus 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_HOME-
           DIR:-"$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.

       Format string for the Thread level (thread_format)
           Format string tin uses for Thread  level  representation.  See  the
           section    "CUSTOMIZING    THE    SCREEN    FORMAT".   Default   is
           "%n %m  [%L]  %T  %F".

       Matchingness of a thread (thread_perc)
           How closely the subjects must match for two threads to  be  consid-
           ered  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 max-
           imum 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. De-
           fault 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 be-
               tween 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 URLs (url_handler)
           The program that will be run when launching  URLs  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/dis-
           abled.  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
           a 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  ver-
           batim block.

       Regex for end of a verbatim block (verbatim_end_regex)
           A  regular expression that tin will use to find the end of a verba-
           tim 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 op-
           tion 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, wrap-
           ping at the current screen width.

       Quote line when crossposting (xpost_quote_format)
           Format is the same as for news_quote_format, this is used when  an-
           swering  to  a  crossposting  to  several  groups  with  no  ''Fol-
           lowup-To:'' set.

   ATTRIBUTES MENU AND GROUP ATTRIBUTES
       tin allows certain attributes to be set on a per group basis. If it ex-
       ists,  the global attributes file, ${TIN_LIBDIR:-NEWSLIBDIR}/attributes
       is read.  After  that,  the  user's  own  attributes  file  ${TIN_HOME-
       DIR:-"$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 at-
       tributes are specified for that list. All attributes are set to a  rea-
       sonable 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: Confi-
       gResetAttrib ('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 avail-
       able: 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 cur-
       rent  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 inter-
       ested 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_HOME-
       DIR:-"$HOME"}/.tin/filter (see also tin(5)) is read. Each time a  news-
       group  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_HOME-
       DIR:-"$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  MenuFilterKill
       ('^K')  or  MenuFilterSelect ('^A') 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:''
       line  of an article. The filter 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 new filter, edit the full filter file or save
       filter.

   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  edi-
       tor  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 ''News-
       groups:'' line at the beginning of the article. After saving and  exit-
       ing 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  news-
       group(s).

       Use the DisplayPostHist ('W') command to display a history of the arti-
       cles 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  PageFol-
       lowupQuoteHeaders ('^W') command to post a follow-up article to an  al-
       ready  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  arti-
       cle 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 ed-
       itor. 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 be-
       ginning of the quoted text can contain information about the quoted ar-
       ticle (e.g., Name and the Message-ID of the article). To allow for dif-
       ferent 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 vari-
       able 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 ac-
       cording to the default save parameters defined in tinrc or by  any  at-
       tributes set for the current group.

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

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

       If  a  regular  expression 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 ex-
       pression will be mailed, piped etc. See also the wildcard  tinrc  vari-
       able 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 '+<file-
       name>'.  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'' op-
       tion) 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(8)
       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 struc-
       ture   under   your   savedir   directory   (default   is   ${TIN_HOME-
       DIR:-"$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 cur-
       rent 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 MarkThdUn-
       read ('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]SUB-
       SCRIBE mechanism. The scope= attributes file tag and  the  filter  file
       group= tag also use the same syntax. tin interprets this variable simi-
       larly 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 can-
       cel 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  exam-
       ples.

   SIGNATURES
       tin  will recognize a signature in either ${TIN_HOMEDIR:-"$HOME"}/.sig-
       nature     or     ${TIN_HOMEDIR:-"$HOME"}/.Sig.      If     ${TIN_HOME-
       DIR:-"$HOME"}/.signature exists, then the signature will be pulled into
       the  editor  for  mail  commands  only.  A  signature  in   ${TIN_HOME-
       DIR:-"$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 ed-
       itor 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  direc-
       tory  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.

   CUSTOMIZING THE SCREEN FORMAT
       The look of the Selection, Group and Thread level can be customized via
       format strings. These format strings define the content and  the  posi-
       tion  of each element on the screen. Variables are used within the for-
       mat strings as placeholders. The following variables are available:

          %D    date
          %F    from, name and/or address
          %G    newsgroup name
          %I    initials
          %L    line count
          %M    message-id
          %R    number of responses in thread
          %S    score
          %T    thread tree
          %U    unread count
          %d    newsgroup description
          %f    newsgroup flag
          %m    article marks
          %n    current group/thread/article number
          %s    subject
          %%    %

       Not all variables can be used in each level. The following  table  pro-
       vides an overview:

              select_format group_format thread_format
          %D                      X            X
          %F                      X            X
          %G        X
          %I                      X            X
          %L                      X            X
          %M                      X            X
          %R                      X
          %S                      X            X
          %T                                   X
          %U        X
          %d        X
          %f        X
          %m                      X            X
          %n        X             X            X
          %s                      X
          %%        X             X            X

       Defaults for the format strings:

          select_format: "%f %n %U  %G  %d"
          group_format:  "%n %m %R %L  %s  %F"
          thread_format: "%n %m  [%L]  %T  %F"

       show_description controls whether the newsgroup description is shown or
       not. The description can also be toggled with  SelectToggleDescriptions
       ('d').

       The  information  displayed  with '%F' depends on the value of show_au-
       thor.  GroupToggleSubjDisplay  resp.    ThreadToggleSubjDisplay   ('d')
       switches through all available options.

       For  date representation '%D' uses date_format. It is possible to spec-
       ify a different date  format  in  round  brackets  (e.g.  '%(%d  %b  %y
       %H:%M)D'). See date_format for more details.

       The  length  of  each item (except '%%') can be defined with a positive
       number after the '%'. The following example displays the score  in  the
       thread level 10 characters wide: '%10S'.

       If the newsgroup name is displayed together with the newsgroup descrip-
       tion, the width of the newsgroup name can be controlled via an optional
       comma  separated second value (e.g. '%60,20G'). It is valid to omit the
       first value (e.g. ('%,20G')). If no second value is given, tin  uses  a
       default value of 32.

       Some  variables  do  have a default width which may lead to truncation.
       Truncation for variables which contain only numbers happens by dividing
       the  value with a sufficient power of ten and adding a SI suffix to the
       result, that is the variable holds a value of 54321 and the  width  for
       the  variable  is  4 the result will be "54 k". If that's undesired you
       have to specify a larger width manually, e.g. '%6n'. Here is  an  over-
       view of the defaults:

          Variable  width
          %I         3
          %L         4
          %M        10
          %R         3
          %S         6
          %U         5
          %n         4

       If  no length is given for '%D', the length is determined by the format
       string for the date and the date of the current day. If the date format
       string contains weekdays or months names it may happen that the date is
       longer than determined in the first pass. In this  case,  the  date  is
       truncated  before  display.  This  occurs,  for example, if the current
       month is May and the article to which the date is displayed was  posted
       in  December.  In  such  cases it might useful to determine the maximum
       length manually and specify the length in the format string.

       In case the format string contains '%G' and  '%d'  and  no  length  are
       given,  tin  determines the longest newsgroup name and uses this length
       for '%G'. The remaining space will used for '%d'.

       When the format string contains the specifier '%F' and '%s' resp.  '%T'
       and  no  length  are given, '%F' will use one third and '%s' resp. '%T'
       will use two third of the available space.

       In addition, a minimum screen width can be defined for each  item  (ex-
       cept  '%%').  In  this  case,  the item will only be displayed when the
       screen is wider than specified. This comes in handy to not  overload  a
       small  screen but have maximum information on a large screen. The mini-
       mum screen width has to be specified by a positive number  preceded  by
       an '>'. In the following example tin will display the score only if the
       screen is wider than 100 characters: '%>100S'.

       If both the length and the minimum screen width should be specified for
       an  item, the length must be the first parameter and the minimum screen
       width must be the second one. The following example displays the  score
       with  a  length  of  10 characters only if the screen is wider than 100
       characters: '%10>100S'.

   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 differ-
            ent themes)

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

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

       tin  will  reread the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-ac-
       tive} 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, other-
                 wise pages down.

       Button2 (center)
                 returns to the previous (upper) level if you click on an  ar-
                 ticle, 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  Selec-
                 tReadGrp ('<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 disk space 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 lo-
       cal 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 cre-
       ate  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  sys-
       tem batcher cron(8) with the ''-u'' option:

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

       If  you  are  low  on  local disk space you should consider to 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
       ~/.mailcap
       /etc/mailcap
       /usr/etc/mailcap
       /usr/local/etc/mailcap
       /etc/mail/mailcap

       /etc/nntpserver

       ${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 ef-
              fect.

       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_NOVFILENAME
              Define this variable if you want to override  the  OVERVIEW_FILE
              filename  that  was  compiled  into  the  tin binary, default is
              .overview. 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/ac-
              tive path that was compiled into the tin binary. If tin is  run-
              ning  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  vari-
              able  only  needs to be set if the ''-r'' command-line option is
              specified and the  file  /etc/nntpserver  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 -1 to 6.

            -1     no conversion

            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 RFC1345 codes in brackets

            5      table for printers that allow overstriking with backspace

            6      table for IBM PC character set (code page 437)

       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-field 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 ${VIS-
              UAL:-"${EDITOR:-vi}"}. See environ(5) for more info.

       EDITOR If $VISUAL is unset, then this variable is looked up for  a  de-
              fault  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 ex-
              planation 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.pol-
              itics 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 exam-
              ple, 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  tem-
              porary files.

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

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

       MM_CHARSET
              MIME character set used if not configured via the tinrc variable
              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  conver-
              sion. 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][.code-
              set][@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[_terri-
              tory][.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 lan-
              guage[_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  lan-
              guage[_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 selec-
              tion and produce output unrelated to the  terminal  characteris-
              tics.

       LINES  A decimal integer > 0 used to indicate the user's preferred num-
              ber 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 selec-
              tion.

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

       DISPLAY
              Display name, pointing to the X server; required for xface.

       WINDOWID
              Used for determining terminal's X window id; required for xface.
              Should be set by the terminal emulator.

       SHELL  The pathname  of  the  user's  login  shell.  Used  to  set  de-
              fault_shell_command.

       XDG_RUNTIME_DIR
              The  pathname  of  the  user's dir to put non-essential run time
              files into.

SIGNALS
       tin handles a couple of signals:

       SIGHUP Terminate gracefully.

       SIGTERM
              Terminate gracefully.

       SIGUSR1
              Terminate gracefully but do not restore terminal (tty).

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

SECURITY
       If tin is started in debug mode (''-D n'') it will create  world  read-
       able  files  in  $TMPDIR  which  may contain the users NNTP password in
       cleartext. On multiuser-systems $TMPDIR should be set to a  safe  loca-
       tion 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-2008, 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  bug-report
       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 docu-
              mentation.

       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(8), 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),   heapsort(3),   iconv(3),   iconv_open(3),  nl_langinfo(3),
       pcre(3),   pcrepattern(3),    qsort(3),    snprintf(3),    strftime(3),
       vsnprintf(3),  wildmat(3),  environ(5), locale(5), mailcap(5), mbox(5),
       mmdf(5), newsoverview(5), tin(5), RFC1345, RFC1524,  RFC2045,  RFC2046,
       RFC2047, RFC2048, RFC2231, RFC2980, RFC3977, RFC4155, RFC4643, RFC5322,
       RFC5536, RFC5537, RFC6048

2.4.3                         December 24th, 2018                       tin(1)

Man(1) output converted with man2html
list of all man pages