Provided by: tin_1.9.2+20070201-1_i386 bug

NAME

       tin, rtin - related files

DESCRIPTION

       This  manpage  describes  the  various (config) files and their formats
       used by the tin(1) newsreader.

FILES

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

              mailcap(4) files as defined in RFC1524. The  Mailcap  files  are
              read  by tin(1) to determine how to display non-text messages at
              the local site. Any line that starts  with  "#"  is  a  comment.
              Blank  lines  are ignored. Otherwise, each line defines a single
              mailcap entry for a single  content  type.  Long  lines  may  be
              continued by ending them with a backslash character, "\".

              Each   individual  mailcap  entry  consists  of  a  content-type
              specification, a command to execute, and  (possibly)  a  set  of
              optional "flag" values.

              The  "type"  field  is simply any legal content type name. It is
              the string that  will  be  matched  against  the  "Content-Type"
              header  to  decide if this is the mailcap entry that matches the
              current message. Additionally, the  type  field  may  specify  a
              subtype or a wildcard to match all subtypes.

              The  "command"  field is any UNIX command and is used to specify
              the interpreter for the given type of message. It will be passed
              to the shell via the system(3) facility.

              Semicolons  and backslashes within the command or any flag field
              must be quoted with backslashes. If  the  field  contains  "%s",
              those two characters will be replaced by the name of a file that
              contains the body of the message. If it contains "%t", those two
              characters will be replaced by the content-type field, including
              the subtype, if any. If it contains "%{" followed by a parameter
              name  and  a  closing  "}",  then  all  those characters will be
              replaced by the value of the named parameter, if any,  from  the
              Content-Type  header. Finally, if the field contains "\%", those
              two characters will be replaced by a single "%" character.

              Besides the type and command field  the  following  "flags"  are
              defined:

              compose
                     The "compose" field may be used to specify a program that
                     can be used to compose a new body or  body  part  in  the
                     given  format.  Its  intended  use  is  to  support  mail
                     composing agents that support the composition of multiple
                     types  of  mail  using external composing agents. As with
                     the view-command, the semantics of program execution  are
                     operating  system  dependent. The result of the composing
                     program may be data that is not  yet  suitable  for  mail
                     transport - that is, a Content-Transfer-Encoding may need
                     to be applied to the data.

              composetyped
                     The "composetyped" field  is  similar  to  the  "compose"
                     field, but is to be used when the composing program needs
                     to specify the Content-Type header field to be applied to
                     the composed data. The "compose" field is simpler, and is
                     preferred  for  use  with  existing   (non-mail-oriented)
                     programs  for  composing  data  in  a  given  format. The
                     "composetyped" field is necessary when  the  Content-Type
                     information  must  include  auxiliary parameters, and the
                     composition program must  then  know  enough  about  mail
                     formats  to  produce  output  that includes the mail type
                     information.

              edit   The "edit" field may be used to specify  a  program  that
                     can  be  used  to  edit  a body or body part in the given
                     format. In many cases, it may be identical in content  to
                     the  "compose"  field,  and  shares  the operating-system
                     dependent semantics for program execution.

              print  The "print" field may be used to specify a  program  that
                     can  be used to print a message or body part in the given
                     format.  As  with  the  view-command,  the  semantics  of
                     program execution are operating system dependent.

              test   The  "test"  field  may  be  used  to  test some external
                     condition (e.g., the machine architecture, or the  window
                     system  in  use)  to determine whether or not the mailcap
                     line applies. It specifies a program to be  run  to  test
                     some  condition.  The  semantics  of execution and of the
                     value returned by the test program are  operating  system
                     dependent.  If the test fails, a subsequent mailcap entry
                     should be sought. Multiple test fields are not  permitted
                     -  since  a  test  can  call a program, it can already be
                     arbitrarily complex.

              needsterminal
                     The "needsterminal" field indicates that the view-command
                     must be run on an interactive terminal. This is needed to
                     inform window-oriented user agents  that  an  interactive
                     terminal is needed. (The decision is not left exclusively
                     to the view-command because in some circumstances it  may
                     not  be possible for such programs to tell whether or not
                     they are on  interactive  terminals.)  The  needsterminal
                     command  should  be  assumed  to apply to the compose and
                     edit commands, too, if they exist. Note that this is  NOT
                     a test - it is a requirement for the environment in which
                     the program will be executed, and should typically  cause
                     the  creation  of  a terminal window when not executed on
                     either a real terminal or a terminal window.

              copiousoutput
                     The "copiousoutput" field indicates that the output  from
                     the  view-command  will  be an extended stream of output,
                     and is to be interpreted as advice to the UA (User  Agent
                     mail-reading  program)  that  the output should be either
                     paged or made scroll-able. Note that  it  is  probably  a
                     mistake  if  needsterminal  and  copiousoutput  are  both
                     specified.

              description
                     The  "description"  field  simply  provides   a   textual
                     description,  optionally  quoted, that describes the type
                     of data, to be used optionally by mail readers that  wish
                     to describe the data before offering to display it.

              textualnewlines
                     The  "textualnewlines"  field,  if  set  to  any non-zero
                     value, indicates that this type of data is  line-oriented
                     and  that,  if  encoded in base64, all newlines should be
                     converted to canonical form (CRLF) before  encoding,  and
                     will  be  in  that  form after decoding. In general, this
                     field is needed only if there is  line-oriented  data  of
                     some  type  other  than text/* or non-line- oriented data
                     that is a subtype of text.

              x11-bitmap
                     The "x11-bitmap" field names a file, in X11 bitmap  (xbm)
                     format, which points to an appropriate icon to be used to
                     visually denote the presence of this kind of data.

              nametemplate
                     The "nametemplate" field gives a  file  name  format,  in
                     which  %s  will  be  replaced by a short unique string to
                     give the name of the temporary file to be passed  to  the
                     viewing  command. This is only expected to be relevant in
                     environments where filename  extensions  are  meaningful,
                     e.g., one could specify that a GIF file being passed to a
                     gif viewer should have a name ending in ".gif"  by  using
                     "nametemplate=%s.gif"

              tin(1)   currently  only  respects  the  "test",  "description",
              "nametemplate" and partly the "needsterminal" flags,  all  other
              flags  are internally ignored. It also can’t handle the "%F" and
              "%n" expansions yet.

              Example:
                     # mailcap file example
                     image/*;\
                        xv -8 -geometry +0 ’%s’;\
                        description=%{name} %t-Image;\
                        test=test "$DISPLAY" != "";\
                        nametemplate=%s.IMAGE

                     message/rfc822;\
                        ${PAGER-"more"} ’%s’;\
                        edit=${EDITOR-"vi"} ’%s’;\
                        compose=${EDITOR-"vi"} ’%s’;\
                        print=a2ps ’%s’;\
                        needsterminal

       /etc/news/server

              default NNTP-server to read news from if not  reading  from  the
              local  spool.  ’-g server’, $NNTPSERVER have higher priority (in
              that order), the default server given at compile time has  lower
              priority.

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

              secret to be used for canlocks

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

              mime type / filename extension pairs

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

              "nntpserver password [user]" pairs for NNTP servers that require
              authorization. Any line that  starts  with  "#"  is  a  comment.
              Blank  lines  are ignored. This file should be readable only for
              the user as it contains the users uncrypted password for reading
              news!

              nntpserver
                     full qualified domain name of the newsserver.

              password
                     users uncrypted password for reading news.

              user   username  on  the newsserver if it differs from the local
                     login. this field is optional.

              Example:
                     # sample .newsauth file
                     news.example.org  example
                     news.example.net  news      guest

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

              "newsgroupflag [article[,article | -article]...]" lines.

              newsgroup
                     the name of the newsgroup.

              flag   a flag indicating if the group is subscribed ’:’  or  not
                     ’!’.

              article
                     range  of  already read articles from that group; numbers
                     separated by commas  with  sequential  numbers  collapsed
                     with hyphens.

              Example:
                     # sample .newsrc file
                     news.software.b! 1-666,669
                     news.software.nntp: 1-13245,13247,13249
                     news.software.readers: 1-19567,19571-19597

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

              backup of ${TIN_HOMEDIR-"$HOME"}/.newsrc

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

              signature

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

              fixed part of a randomly generated signature

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

              history of last used strings

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

              mailgroups index files

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

              newsgroups index files

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

              saved newsgroups index files

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

              active file ("mail_group_name maxnum minnum mailspool"-pairs) of
              user’s mailgroups (requires tin(1) to  be  build  with  mh-mail-
              handling support).

              mail_group_name
                     must  be the pathname of the mailbox relative to field #4
                     with / changed to .

              maxnum just put a large number here, something higher  than  the
                     highest message in the mailbox

              minnum put 0 here

              mailspool
                     path  of  mail  spool  directory.  This  must be the full
                     pathname to the root of the mail folder area.

              Example:
                     Mail.inbox  12345 00000 /home/foo
                     Mail.outbox 23456 00000 /home/foo

              This allows access to the ’inbox’ and ’outbox’ folders  of  user
              foo.    They   are   accessed   via   /home/foo/Mail/inbox   and
              /home/foo/Mail/outbox

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

              active file of user’s saved newsgroups, used by tin -R.

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

              The group attributes files may be used to override  some  global
              settings  from  ${TIN_HOMEDIR-"$HOME"}/.tin/tinrc on a per group
              basis. Order is important as last match counts; this  allows  to
              refine   attributes   for   narrowed   scopes.   Note  that  the
              scope=<grouplist> line has to be specified before the attributes
              are  specified  for  that  list.  All  attributes  are  set to a
              reasonable default so you only have  to  specify  the  attribute
              that  you  want  to  change.  All  toggle  attributes are set by
              specifying ON/OFF.  Otherwise, they function  exactly  as  their
              global   equivalents.   The   following   group  attributes  are
              available:

              scope  This changes the list of groups to which  the  attributes
                     that  follow  will  be applied. See the section NEWSGROUP
                     LISTS & WILDCARDS in tin(1) for the types of pattern that
                     can be used here.

              auto_save
                     Identical to the tinrc variable of the same name

              auto_select
                     Automatically  perform  the  GroupMarkUnselArtRead  (’X’)
                     command after entering the group.

              batch_save
                     Can be used to override the global setting in tinrc on  a
                     per  group  basis.  For  more  information  read  section
                     AUTOMATIC MAILING AND SAVING NEW NEWS in tin(1).

              delete_tmp_files
                     If this is set to ON, then saved article files that  have
                     been   post-processed   will  be  automatically  deleted,
                     otherwise the user will be asked whether  to  delete  the
                     post-processed  files.  Automatic  processing  of  marked
                     articles  using   GroupAutoSave   (’S’)   will   suppress
                     prompting.

              fcc    Mailbox  to save sent mails. The format of the mailbox is
                     controlled via the tinrc mailbox_format variable.

              followup_to
                     Set ’’Followup-To:’’-header to the specified group(s).

              from   Identical to the tinrc variable mail_address

              maildir
                     Identical to the tinrc variable default_maildir

              mailing_list
                     Used when a group is a mailing list. All responses to the
                     group will be directed to this email address instead

              mime_forward
                     Determines  whether  usenet  articles  are  forwarded  as
                     attachment or inline. When  set  to  OFF,  the  forwarded
                     article  will  be included in the body of the mail, while
                     setting this variable to ON will cause the article to  be
                     attached  as  a separate MIME part. Enabling mime_forward
                     is  particularly  useful  for  articles   consisting   of
                     multiple  MIME  parts such as PGP/MIME signed messages or
                     being encoded in a  different  character  set  than  your
                     local  one.  It  is also useful if the receiver should be
                     able to operate on the entire  forwarded  article  (i.e.,
                     view  or  save  it  without  your comments). On the other
                     hand, if you want to  forward  only  some  parts  of  the
                     article or to insert ’inline’ annotations, you might want
                     to disable this option.  Please note that for this option
                     to have effect, the tinrc variable interactive_mailer has
                     to be set to 0 (which is the default).

              mime_types_to_save
                     A comma separated list of MIME major/minor  Content-Types
                     that   will   be  saved  when  using  the  view/save  and
                     save/autosave features.   A  single  *  can  be  used  to
                     wildcard the major and/or minor type and a ! as the first
                     character   in   an   entry   will   negate    it,    eg:
                     image/*,!image/bmp,!text/html. Default is */*

              news_quote_format
                     Identical to the tinrc variable of the same name

              organization
                     This  can  be  used  to  set  the  article  header  field
                     ’’Organization:’’. It overrides the setting (if  any)  of
                     organization  in  /etc/tin/tin.defaults and $ORGANIZATION
                     (or  $NEWSORG  on  Apollo  DomainOS).  Note   that   some
                     newsserver       might      still      overwrite      the
                     ’’Organization:’’-header.

              post_proc_type
                     Identical to the tinrc variable post_process_type

              quote_chars
                     Identical to the tinrc variable of the same name

              savedir
                     Identical to the tinrc variable default_savedir

              savefile

              show_author
                     Identical to the tinrc variable of the same name

              show_info
                     Identical to the tinrc variable of the same name

              show_only_unread
                     Identical to the tinrc variable of the same name

              sigfile
                     Identical to the tinrc variable default_sigfile

              sort_art_type
                     Identical to the tinrc variable sort_article_type

              sort_threads_type
                     Identical to the tinrc variable of the same name

              tex2iso_conv
                     Identical to the tinrc variable of the same name

              thread_arts
                     Identical to the tinrc variable thread_articles

              thread_perc
                     Identical to the tinrc variable thread_perc

              x_body A piece of text that will be added  at  the  start  of  a
                     message body. If this string starts with a / or ~ then it
                     is assumed to be the name of a file containing  the  text
                     to insert.

              x_comment_to
                     Insert  ’’X-Comment-To:’’-header,  this is only useful in
                     FIDO groups.

              x_headers
                     A string including header-name and the  contents  of  the
                     header  that will be automatically added when posting. If
                     the string starts with a / or ~ then it is assumed to  be
                     the  name of a file containing the header and its content
                     to be inserted. If the string starts with a !  then  what
                     follows  is  assumed  to  be  the path to a program to be
                     executed to generate the header and its content.

              quick_kill_scope
                     A comma-separated list of  newsgroup  patterns  (wildmat-
                     style)   to   which  groups  the  filter  rule  added  by
                     QuickFilterKill will be applied.  If  unset  the  default
                     from  the  tinrc variable default_filter_kill_global will
                     be used.

              quick_kill_expire
                     Identical       to       the        tinrc        variable
                     default_filter_kill_expire

              quick_kill_case
                     Identical to the tinrc variable default_filter_kill_case

              quick_kill_header
                     Identical        to        the       tinrc       variable
                     default_filter_kill_header

              quick_select_scope
                     A comma-separated list of  newsgroup  patterns  (wildmat-
                     style)   to   which  groups  the  filter  rule  added  by
                     QuickFilterSelect will be applied. If unset  the  default
                     from the tinrc variable default_filter_select_global will
                     be used.

              quick_select_expire
                     Identical       to       the        tinrc        variable
                     default_filter_select_expire

              quick_select_case
                     Identical        to        the       tinrc       variable
                     default_filter_select_case

              quick_select_header
                     Identical       to       the        tinrc        variable
                     default_filter_select_header

              ispell Path  and  options for ispell(1)-like spell-checker, e.g.
                     "aspell --mode=email --dont-backup check"

              mm_network_charset
                     Identical to the tinrc variable of the same name

              undeclared_charset
                     Assume (broken) articles without MIME charset declaration
                     have  this  charset - default is US-ASCII. This attribute
                     works only on systems with working iconv(3), others might
                     have         to         compile        tin(1)        with
                     --disable-mime-strict-charset.

              Example:
                     # include extra headers
                     # assume ISO-8859-1 as charset if no charset is declared
                     scope=*
                     x_headers=~/.tin/headers
                     undeclared_charset=ISO-8859-1

                     # in *sources* set post process type to shar only
                     scope=*sources*
                     post_proc_type=1

                     # in *binaries* turn on full post processing,
                     # remove tmp files and set Followup-To: poster
                     scope=*binaries*
                     post_proc_type=2
                     delete_tmp_files=ON
                     followup_to=poster

                     # in fido.* newsgroups change quote_chars
                     # and add X-Comment-To: line
                     scope=fido.*
                     quote_chars=%s>_
                     x_comment_to=ON

                     # in *.test newsgroups, don’t append signature
                     # and preset Subject
                     scope=*.test
                     sigfile=--none
                     x_headers=Subject: test - ignore - no reply

                     # assume ISO-2022-JP-2 as charset
                     scope=fj.*,japan.*
                     undeclared_charset=ISO-2022-JP-2

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

              The filter file is used to assign scores  to  certain  articles.
              Based  on  the  score an article can be filtered out (hidden) or
              marked hot. Empty lines  or  lines  beginning  with  a  ’#’  are
              ignored.

              comment
                     Every  entry  (rule)  in  the  filter  file  might  get a
                     comment.  Multiple  lines  are  allowed  (but  only   for
                     comments   yet).   Every   line   must   start  with  the
                     "comment="-keyword. Comments must  appear  first  in  the
                     rule.   Comment  lines placed within a rule will be moved
                     to the begin of the next rule. This might be  changed  in
                     the future. Don’t use ’#’ to mark comments as those lines
                     are ignored and your comments will get lost on  the  next
                     write of the file.

              group  A  comma-separated  list  of newsgroup patterns (wildmat-
                     style) to which groups the filter rule will  be  applied.
                     This line is mandatory!

              case   0=case-sensitive, 1=case-insensitive

              score  Score  value  of  the  rule; can also be one of the magic
                     words "kill" or "hot".

              subj   Match against ’’Subject:’’

              from   Match against ’’From:’’.  tin(1) converts the contents of
                     the ’’From:’’-header to an old style e-mail address, e.g.
                     ’’some@body.example (John Doe)’’ instead  of  ’’John  Doe
                     <some@body.example>’’,   before   trying   to  match  the
                     patterns in the filter rule.

              msgid  Match against ’’Message-ID:’’ and full ’’References:’’

              msgid_last
                     Match against ’’Message-ID:’’  and  last  ’’References:’’
                     entry only

              msgid_only
                     Match against ’’Message-ID:’’

              refs_only
                     Match against ’’References:’’

              lines  Match  against  ’’Lines:’’,  <num matches less than, >num
                     matches more than.

              gnksa  Match against ’’From:’’-address parser return codes.

              xref   Match against ’’Xref:’’-line. Before any matching is done
                     the  line  is turned into the same format ’’Newsgroups:’’
                     has that is it is turned into a comma separated  newsgoup
                     list  with  all  other  informations  (i.e.   the article
                     counter) removed.

              time   time_t value when rule expires

              Example:
                     comment=mark all articles about tin, rtin,
                     comment=tind, ktin or cdtin as hot
                     group=*
                     type=1
                     case=1
                     score=hot
                     subj=\b(cd|[rk]?)?tin(d|pre)?[-.0-9]*\b

       /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"}"}"}"}

              Keymap-file, containing "keyname value [value]" pairs  seperated
              by  spaces  or tabs.  Below is a list of all rebindable keynames
              and their defaults. If  a  keynames  is  bound  to  NULL  it  is
              unassigned.

              ShellEscape                    !
              SetRange                       #
              LastPage                       $
              ToggleColor                    &
              LastViewed                     -
              SearchRepeat                   \
              SearchSubjF                    /
              SearchSubjB                    ?
              SearchAuthB                    A
              SearchBody                     B
              CatchupNextUnread              C
              EditFilter   E
              ToggleHelpDisplay              H
              ToggleInverseVideo             I
              LookupMessage                  L
              OptionMenu                     M
              Postponed                      O    ^O
              QuitTin                        Q
              BugReport   R
              DisplayPostHist                W
              MarkThrUnread   Z
              FirstPage                      ^
              SearchAuthF                    a
              Catchup                        c
              Help                           h
              ToggleInfoLastLine             i
              Down                           j    ^N
              Up                             k    ^P
              Print                          o
              Quit                           q
              Version                        v
              Post                           w
              MarkArtUnread      z
              QuickFilterSelect              [
              QuickFilterKill                ]
              Pipe                           |
              ScrollUp                       <
              ScrollDown                     >
              PageUp                         b    ^B   ^U
              PageDown                       ^D   ^F   SPACE
              RedrawScr                      ^L
              Postponed                      ^O
              MenuFilterSelect               ^A
              MenuFilterKill                 ^K

              ConfigSelect                   ^J   ^M
              ConfigLastPage                 G
              ConfigNoSave                   Q
              ConfigFirstPage                g

              FeedTag                        T
              FeedArt                        a
              FeedHot                        h
              FeedPat                        p
              FeedRepost                     r
              FeedSupersede                  s
              FeedThd                        t

              FilterEdit                     e
              FilterSave                     s

              GroupNextUnreadArtOrGrp        TAB
              GroupReadBasenote              ^J   ^M
              GroupSelThd                    *
              GroupDoAutoSel                 +
              GroupToggleThdSel              .
              GroupSelThdIfUnreadSelected    ;
              GroupSelPattern                =
              GroupReverseSel                @
              GroupToggleGetartLimit         G
              GroupMarkThdRead               K
              GroupNextUnreadArt             N
              GroupPrevUnreadArt             P
              GroupAutoSave                  S
              GroupTagParts                  T
              GroupUntag                     U
              GroupMarkUnselArtRead          X
              GroupToggleSubjDisplay         d
              GroupGoto                      g
              GroupListThd                   l
              GroupMail                      m
              GroupNextGroup                 n
              GroupPrevGroup                 p
              GroupToggleReadUnread          r
              GroupSave                      s
              GroupTag                       t
              GroupToggleThreading           u
              GroupRepost                    x
              GroupUndoSel                   ~

              HelpLastPage                   G
              HelpFirstPage                  g

              PageReplyQuoteHeaders          ^E
              PagePGPCheckArticle            ^G
              PageToggleHeaders              ^H
              PageNextUnread                 TAB
              PageNextThd                    ^J   ^M
              PageToggleTabs                 ^T
              PageFollowupQuoteHeaders       ^W
              PageToggleTex2iso              "
              PageToggleRot                  %
              PageToggleUue                  (
              PageReveal                     )
              PageSkipIncludedText           :
              PageTopThd                     <
              PageBotThd                     >
              PageCancel                     D
              PageFollowup                   F
              PageLastPage                   G
              PageKillThd                    K
              PageNextUnreadArt              N
              PagePrevUnreadArt              P
              PageReply                      R
              PageAutoSave                   S
              PageGroupSel                   T
              PageViewUrl                    U
              PageViewAttach                 V
              PageToggleHighlight            _
              PageEditArticle                e
              PageFollowupQuote              f
              PageFirstPage                  g
              PageListThd                    l
              PageMail                       m
              PageNextArt                    n
              PagePrevArt                    p
              PageReplyQuote                 r
              PageSave                       s
              PageTag                        t
              PageGotoParent                 u
              PageRepost                     x

              PgpEncSign                     b
              PgpEncrypt                     e
              PgpIncludekey                  i
              PgpSign                        s

              PostAbort                      a
              PostContinue                   c
              PostCancel                     d
              PostEdit                       e
              PostPGP                        g
              PostIspell                     i
              PostIgnore                     i
              PostMail                       m
              PostPostpone                   o
              PostPost                       p    y
              PostSupersede                  s
              PostSend                       s    y

              PostponeOverride               Y
              PostponeAll                    A

              PromptYes                      y    Y
              PromptNo                       n    N

              SaveAppendFile                 a
              SaveOverwriteFile              o

              PProcNone                      n
              PProcShar                      s
              PProcYes                       y

              SelectEnterNextUnreadGrp       TAB  n
              SelectReadGrp                  ^J   ^M
              SelectResetNewsrc              ^R
              SelectSortActive               .
              SelectNextUnreadGrp            N
              SelectSubscribePat             S
              SelectUnsubscribePat           U
              SelectQuitNoWrite              X
              SelectSyncWithActive           Y
              SelectToggleDescriptions       d
              SelectGoto                     g
              SelectMoveGrp                  m
              SelectToggleReadDisplay        r
              SelectSubscribe                s
              SelectUnsubscribe              u
              SelectYankActive               y
              SelectMarkGrpUnread            z    Z

              ThreadReadNextArtOrThread      TAB
              ThreadReadArt                  ^J   ^M
              ThreadSelArt                   *
              ThreadToggleArtSel             .
              ThreadReverseSel               @
              ThreadMarkArtRead              K
              ThreadAutoSave                 S
              ThreadUntag                    U
              ThreadToggleSubjDisplay        d
              ThreadMail                     m
              ThreadSave                     s
              ThreadTag                      t
              ThreadUndoSel                  ~

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

              This   file  provides  short  descriptions  of  each  mailgroup.
              (requires tin(1) to be  build  with  mh-mail-handling  support).
              Each  line  consist  of  two tab-separated fields "mailgroupname
              one-line description".

              mailgroupname
                     is the name of the newsgroup

              description
                     is a short single-line description of the group

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

              "nntpserver newsrc [shortname [...]]"  pairs  to  use  with  the
              ’’-g’’ command-line switch.

              nntpserver
                     full qualified domain name of the newsserver.

              newsrc related newsrc.

              shortname
                     nickname(s) for the nntpserver.

              Example:
                     # sample newsrctable file
                     news.tin.org .newsrc-tin.org tinorg
                     news.ka.nu /tmp/nrc-nu kanu nu

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

              posting history

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

              Copy  of all posted articles in mbox(5) format. The filename can
              be changed by setting posted_articles_file.

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

              Pool of postponed articles. This file is in mbox(5) format.

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

              This file a copy of the servers newsgroups file  which  provides
              short  descriptions  of  each  newsgroup.  It  is  automatically
              updated  on  startup  except  when  using  the  ’’-X’’or  ’’-q’’
              command-line option and an old copy exists. Each line consist of
              two tab-separated fields "group.name                    one-line
              description".

              group.name
                     is the name of the newsgroup

              one-line description
                     is a short single-line description of the group

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

              File  to store $NNTPSERVER and $NNTPPORT related data via a list
              of  "variable=value"  pairs.  Currently  there  are   only   two
              variables, both are not meant to be changed by the user.

              version
                     Internal version number.

              last_newnews
                     Internal  timestamp  used  by tin(1) to keep track of new
                     newsgroups on the server.

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

              At  startup,  tin(1)  reads  in  the  configuration  file.  This
              contains  a  list  of "variable=value" pairs that can be used to
              configure the  way  tin(1)  works.  If  it  exists,  the  global
              configuration   file,  ${TIN_LIBDIR}-NEWSLIBDIR}/tinrc  is  read
              first.  After   that,   the   users   own   configuration   file
              ${TIN_HOMEDIR-"$HOME"}/.tin/tinrc  is  read.  The global file is
              useful for distributing system-wide defaults to  new  users  who
              have no private tinrc yet (see also /etc/tin/tin.defaults).

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

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

              alternative_handling
                     If ON strip multipart/alternative messages automatically.
                     Default is ON.

              art_marked_deleted
                     The character used to show that an article  was  deleted.
                     Default is ’D’.

              art_marked_inrange
                     The character used to show that an article is in a range.
                     Default is ’#’.

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

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

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

              art_marked_unread
                     The  character  used to show that an article has not been
                     read.  Default is ’+’.

              art_marked_read
                     The character used to show  that  an  article  was  read.
                     Default is ’ ’.

              art_marked_killed
                     The  character  used  to show that an article was killed.
                     Default is ’K’.  kill_level must be set accordingly.

              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(1)  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.

              auto_bcc
                     If ON automatically put your name in the  ’’Bcc:’’  field
                     when mailing an article. Default is OFF.

              auto_cc
                     If  ON  automatically  put your name in the ’’Cc:’’ field
                     when mailing an article. Default is OFF.

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

              auto_reconnect
                     Reconnect to server automatically. Default is OFF.

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

              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.

              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_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.  Default is OFF.

              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.

              col_back
                     Standard background color

              col_from
                     Color of sender (From:)

              col_head
                     Color of header-lines

              col_help
                     Color of help pages

              col_invers_bg
                     Color of background for inverse text

              col_invers_fg
                     Color of foreground for inverse text

              col_markdash
                     Color   of   words   emphasized  like  _this_.  See  also
                     word_h_display_marks and word_highlight.

              col_markslash
                     Color  of  words  emphasized  like   /this/.   See   also
                     word_h_display_marks and word_highlight.

              col_markstar
                     Color   of   words   emphasized  like  *this*.  See  also
                     word_h_display_marks and word_highlight.

              col_markstroke
                     Color  of  words  emphasized  like   -this-.   See   also
                     word_h_display_marks and word_highlight.

              col_minihelp
                     Color of mini help menu

              col_newsheaders
                     Color of actual news header fields

              col_normal
                     Standard foreground color

              col_quote
                     Color of quoted lines

              col_quote2
                     Color of twice quoted lines

              col_quote3
                     Color of >=3 times quoted lines

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

              col_signature
                     Color of signatures

              col_urls
                     Color of urls highlight

              col_subject
                     Color of article subject

              col_text
                     Color of text-lines

              col_title
                     Color of help/main sign

              confirm_choice
                     tin(1) can ask for manual  confirmation  to  protect  the
                     user. Available choices:
                          commands:  Ask  for  confirmation  before  executing
                          certain dangerous commands  (e.g.,  Catchup  (’c’)).
                          Commands that this affects are marked in this manual
                          with ’[after confirmation]’.

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

                          select:  Ask for confirmation before marking all not
                          selected (with GroupMarkUnselArtRead (’X’)  command)
                          articles as read.
                     Default is commands & quit.

              date_format
                     Format string used for date representation. A description
                     of  the  different  format  options  can  be   found   at
                     strftime(3).   tin(1).   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_editor_format
                     The format string used to create the editor start command
                     with  parameters.   Default is ’%E +%N %F’ (e.g., /bin/vi
                     +7 .article).

              default_filter_days
                     Default is 28.

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

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

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

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

                   0,1  ’’Subject:’’

                   2,3  ’’From:’’

                   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,1  ’’Subject:’’

                   2,3  ’’From:’’

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

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

              default_move_group

              default_pattern

              default_pipe_command

              default_post_newsgroups

              default_post_subject

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

              default_range_group

              default_range_select

              default_range_thread

              default_repost_group

              default_save_file

              default_save_mode

              default_savedir
                     Directory  where  articles/threads  are saved. Default is
                     ${TIN_HOMEDIR-"$HOME"}/News.

              default_select_pattern

              default_shell_command

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

              default_subject_search

              draw_arrow
                     Allows groups/articles to be selected by an arrow ’->’ if
                     set ON or by an highlighted bar if set OFF.

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

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

              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.

              group_catchup_on_exit
                     If ON catchup group when leaving with the left arrow key.
                     Default is ON.

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

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

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

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

              interactive_mailer
                     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  default_mailer_format.
                     Default is 0.

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

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

              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(1).   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).

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

              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.

              mail_mime_encoding
                     MIME  encoding  of the body in mail message, if necessary
                     (8bit, base64, quoted-printable, 7bit). Default  is  8bit
                     and  no  encoding  (or  charset  conversion) is performed
                     (i.e., local charset is used as it is).

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

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

              mark_saved_read
                     If ON mark articles that are saved as  read.  Default  is
                     ON.

              mark_ignore_tags
                     When  this is ON, the GroupMarkThdRead, ThreadMarkArtRead
                     functions (’K’) mark just the current article or  thread,
                     ignoring  other  tagged,  unread articles.  When OFF, the
                     same function presents a menu with choices of the current
                     thread  or  article,  all  tagged,  unread  articles,  or
                     nothing.

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

              mm_charset
                     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 the compile time,  text
                     in  charset  other  than  the  value of this parameter is
                     considered  not  displayable  and  represented  as   ’?’.
                     Otherwise,  all character sets are regarded as compatible
                     with the display. If it’s  not  set,  the  value  of  the
                     environment  variable  $MM_CHARSET  is  used. US-ASCII or
                     compile-time default is used in case neither of  them  is
                     defined. If your system supports iconv(3), this option is
                     disabled and you should use mm_network_charset instead.

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

              mono_markdash
                     Character attribute of words emphasized like  _this_.  It
                     is  depending  on  your  terminal  which  attributes  are
                     usable. See also word_h_display_marks and word_highlight.

              mono_markslash
                     Character  attribute  of words emphasized like /this/. It
                     is  depending  on  your  terminal  which  attributes  are
                     usable. See also word_h_display_marks and word_highlight.

              mono_markstar
                     Character attribute of words emphasized like  *this*.  It
                     is  depending  on  your  terminal  which  attributes  are
                     usable. See also word_h_display_marks and word_highlight.

              mono_markstroke
                     Character  attribute  of words emphasized like -this-. It
                     is  depending  on  your  terminal  which  attributes  are
                     usable. See also word_h_display_marks and word_highlight.

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

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

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

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

              normalization_form
                     The  normalization form which should be used to normalize
                     unicode input.  The possible values are:

                   0  None: no normalization

                   1  NFKC: Compatibility Decomposition, followed by Canonical
                      Composition

                   2  NFKD: Compatibility Decomposition

                   3  NFC:  Canonical  Decomposition,  followed  by  Canonical
                      Composition

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

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

              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 usualy required. Default is
                     OFF. Only enacted if post_mime_encoding is  also  set  to
                     8bit.  In  a  number  of  local  hierarchies  where  8bit
                     characters  are  used,   using   unencoded   (raw)   8bit
                     characters  in  header  is  acceptable and sometimes even
                     recommended so that you  need  to  check  the  convention
                     adopted  in  the  local  hierarchy  of  your  interest to
                     determine what to do with this and post_mime_encoding.

              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.

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

              post_process_type
                     This specifies whether  to  perform  post  processing  on
                     saved  articles.   Because  the shell archive may contain
                     commands you may not want to be executed, be careful when
                     extracting  shell  archives.   The  following  values are
                     allowed:

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

                      1  Shell archives, unpacking of multi-part shar(1) files
                         only.  Because the shell archive may contain commands
                         you may not want to be executed, be careful with this
                         option.

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

              posted_articles_file
                     Keep            posted            articles             in
                     ${TIN_HOMEDIR-"$HOME"}/Mail/posted_articles_file.   If no
                     filename is set then postings will not be saved.  Default
                     is ’posted’.

              print_header
                     If  ON,  then  the  full  article  header  is sent to the
                     printer. Otherwise only the  ’’Subject:’’  and  ’’From:’’
                     fields are output. Default is OFF.

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

              prompt_followupto
                     If ON show empty ’’Followup-To:’’ header when editing  an
                     article.  Default is OFF.

              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 ’>_’.

              quote_style
                     This bit coded integer value controls how articles are to
                     be  quoted  when following up or replying to them. Any of
                     the following options  can  be  combined  by  adding  all
                     relevant  values.  Default  is  5, which means that quote
                     characters are compressed and empty lines are quoted.

                   1  Compress quotes Compress quote characters together  when
                      quoting  multiple  times  (for  example, ’> > >’ will be
                      turned into ’>>>’). This option is on by default.

                   2  Quote  Signatures  This  option  is  off   by   default.
                      Signatures  are  always quoted regardless of this option
                      when  you  are  viewing   an   article   in   raw   mode
                      PageToggleHeaders (’^H’) and followup or reply to it.

                   4  Quote empty lines This option is on by default.

              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(1)  uses  a  built-in
                     default.

              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(1)  uses  a  built-in
                     default.

              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(1)  uses  a  built-in
                     default.

              recent_time
                     If set to 0, this feature is  deactivated,  otherwise  it
                     means the number of days. Default is 2.

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

              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.

              score_limit_kill
                     If  the  score of an article is below or equal this value
                     the article gets marked as killed.

              score_limit_select
                     If the score of an article is above or equal  this  value
                     the article gets marked as hot.

              score_kill
                     Score  of an article which should be killed, this must be
                     <= score_limit_kill.

              score_select
                     Score of an article which should be marked hot, this must
                     be >= score_limit_select.

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

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

              show_info
                     Which  information  about the thread or article should be
                     shown. Default is 1, show only the line count.

                   0  None, no information will be displayed.

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

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

                   3  Lines & Score, display line count and score.

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

              show_only_unread_groups
                     If  ON  show  only  subscribed groups that contain unread
                     articles. Default is OFF.

              show_signatures
                     If OFF don’t show signatures  when  displaying  articles.
                     Default is ON.

              sigdashes
                     If  ON  prepend  the signature with sigdashes. Default is
                     ON.

              signature_repost
                     If ON add signature to reposted articles. Default is  ON.

              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(1)
                     uses a built-in default.

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

                   0  Nothing, don’t sort articles.

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

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

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

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

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

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

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

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

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

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

              sort_threads_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_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.

              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(1) uses
                     a built-in default.

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

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

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

              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(1) uses a built-in default.

              tex2iso_conv
                     Decode  German  style TeX umlaut codes to ISO 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
                     Defines which threading method to use. The  choices  are:
                     0)  Don’t  thread, 1) Thread on Subject only 2) Thread on
                     References only, 3) Thread  on  References  then  Subject
                     (default)  4)  Thread  multipart articles on Subject.  5)
                     Thread on Percentage Match  of  the  Subjects  It’s  also
                     possible  to  set the threading type on a per group basis
                     by setting the group attribute variable thread_arts to  0
                     - 5 in the file ${TIN_HOMEDIR-"$HOME"}/.tin/attributes.

              thread_perc
                     Defines how close the subjects must match while threading
                     by Percentage Match for threads to be considered part  of
                     a single thread. This value is in the range 0 to 100. The
                     default is 75.

              thread_catchup_on_exit
                     If ON catchup group/thread when  leaving  with  the  left
                     arrow key. Default is ON.

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

                   0  Max, the maximum score in this thread.

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

                   2  Average, the average score in this thread.

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

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

              unlink_article
                     If   ON   remove   ${TIN_HOMEDIR-"$HOME"}/.article  after
                     posting. Default is ON.

              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.sh %s.

              url_highlight
                     Enable highlighting URLs in message body. Default is  ON.

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

              use_keypad
                     Use scroll keys on keypad. Default is OFF.

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

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

              verbatim_begin_regex
                     A  regular expression that tin will use to find the begin
                     of a verbatim block.  Default is #v+

              verbatim_end_regex
                     A regular expression that tin will use to find the end of

                     a verbatim block.  Default is #v-
              wildcard
                     Allows  you  to  select  how  tin(1) 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).   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.

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

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

              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.

              xpost_quote_format
                     Format is the same as for news_quote_format, this is used
                     when answering to a crossposting to several  groups  with
                     no ’’Followup-To:’’ set.

       /etc/tin/tin.defaults

              Yet  another  global  configuration  file  with "variable=value"
              pairs. This one is for the more general  options  which  usually
              can’t  be  controlled  via ${TIN_LIBDIR-NEWSLIBDIR}/tinrc and/or
              ${TIN_HOMEDIR-"$HOME"}/.tin/tinrc like  resetting  (to  override
              the built-in default) the newslibdir.

              domainname
                     Sets a global domain name used in From lines

              organization
                     Defines  the  name  of  your  organization. $ORGANIZATION
                     overrides any specified value.

              newslibdir
                     Defines the default place for some  configuration  files,
                     common    values    are   /usr/lib/news,   /var/lib/news,
                     /usr/local/lib/news or  /news/db.  $TIN_LIBDIR  overrides
                     any specified value.

              bugaddress
                     Defines  the  email  address  to which users can send bug
                     reports using a built-in function. The default points  to
                     a  developers  mailing list located at tin.org. You might
                     want  to  change  this  address  to  one  of  your  local
                     administration  if  you  want  to  deal  with your lusers
                     problems on your own.

              inewsdir
                     Defines  the  directory  containing   of   the   inews(1)
                     executable

              mm_charset
                     Default charset to be used in MIME’s Content-Type header.
                     $MM_CHARSET overrides any specified value.

              post_mime_encoding
                     Default encoding scheme use in MIME articles. 8bit  might
                     be the best value.

              mail_mime_encoding
                     Default  encoding  scheme  use  in  MIME letters. quoted-
                     printable is a good choice here.

              disable_gnksa_domain_check
                     Allow unregistered top level domains

              disable_sender
                     Don’t generate a ’’Sender:’’-header. This has  no  effect
                     if inews_prog is not set to --internal.

              spooldir
                     Base  of your newsspool (Bnews, Cnews and INN traditional
                     spool  style),   common   values   are   /var/spool/news,
                     /usr/spool/news,  /news/spool.   $TIN_SPOOLDIR  overrides
                     any specified value.

              overviewdir
                     Base of  your  NOV  database  newsoverview(5)  (tradspool
                     style;  might be the same dir as spooldir), common values
                     are       /var/spool/overview,       /usr/spool/overview,
                     /news/overview.  $TIN_NOVROOTDIR  overrides any specified
                     value.

              overviewfile
                     Name  of  a  single  overview  file,  common  values  are
                     .overview, over.view.

              activefile
                     Full  pathname  of your newssystem’s active file; usually
                     the active  file  resides  in  newslibdir  and  is  named
                     active,  so  you only have to change this setting if your
                     configuration  differs.  $TIN_ACTIVEFILE  overrides   any
                     specified value.

              activetimesfile
                     Full  pathname  of  your  newssystem’s active.times file;
                     usually the active.times file is newslibdir, so you  only
                     have   to  change  this  setting  if  your  configuration
                     differs.

              newsgroupsfile
                     Full  pathname  of  your  newssystem’s  newsgroups  file;
                     usually the newsgroups file is in newslibdir, so you only
                     have  to  change  this  setting  if  your   configuration
                     differs.

              subscriptionsfile
                     Full  pathname  of  your newssystem’s subscriptions file;
                     usually the subscriptions file is in newslibdir,  so  you
                     only  have  to  change this setting if your configuration
                     differs.

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

              translation into language specified in $LC_ALL, $LC_MESSAGES  or
              $LANG

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

              This  file  lists  the  newsgroups that the local site receives.
              Each newsgroup should be listed only once. Each  line  specifies
              one  group;  within each newsgroup, articles are assigned unique
              names, which are monotonically increasing numbers.

              If an article is posted to  newsgroups  not  mentioned  in  this
              file,  those newsgroups are ignored.  If no valid newsgroups are
              specified, the article is rejected.

              Each line consists of four space-separated fields "name highmark
              lowmark flags".

              name   is the name of the newsgroup

              highmark
                     is  the highest article number that has been used in that
                     newsgroup

              lowmark
                     is the lowest article number in the group; this number is
                     not  guaranteed  to be accurate, and should only be taken
                     to be a hint. Note that because of article cancellations,
                     there  may  be  gaps  in  the  numbering sequence. If the
                     lowest article number is greater then the highest article
                     number, then there are no articles in the newsgroup.

              flags  can be one of those

                      y      local postings are allowed

                      n      no local postings are allowed, only remote ones

                      m      the  group  is moderated and all postings must be
                             approved

                      j      articles in this group are  not  kept,  but  only
                             passed on

                      x      articles cannot be posted to this newsgroup

                     =foo.bar
                             articles  are  locally filed into the ’’foo.bar’’
                             group

              tin(1) only tries to read the file if you read directly from the
                     local  spool,  if you read news via NNTP, tin(1) uses the
                     LIST (RFC977) command instead.

       ${TIN_LIBDIR-NEWSLIBDIR}/active.times

              This file provides a chronological record of when newsgroups are
              created.  It  is  normally updated by the local newsserver (e.g.
              innd(8)) whenever a new group is created. Each line  consist  of
              three space-separated fields "name time creator".

              name   is the name of the newsgroup

              time   is  the time when the group was created, expressed as the
                     number of seconds since the epoch.

              creator
                     is the electronic mail address of the person who  created
                     the group.

              tin(1) only tries to read the file if you read directly from the
                     local spool, if you read news via NNTP, tin(1)  uses  the
                     NEWGROUPS (RFC977) command instead.

       ${TIN_LIBDIR-NEWSLIBDIR}/newsgroups

              This  file  provides short descriptions of each newsgroup. It is
              normally  updated  by  the  local  newsserver  (e.g.    innd(8))
              whenever  a  new group is created. Each line consist of two tab-
              separated fields "group.name             one-line  description".

              group.name
                     is the name of the newsgroup

              one-line description
                     is a short single-line description of the group

              tin(1) only tries to read the file if you read directly from the
                     local spool, if you read news via NNTP, tin(1)  uses  the
                     LIST NEWSGROUPS (RFC2980) command instead.

       ${TIN_LIBDIR-NEWSLIBDIR}/organization

              This file specifies might hold a default organization to be used
              in the ’’Organization:’’  header.  $ORGANIZATION  has  a  higher
              priority if set.

       ${TIN_LIBDIR-NEWSLIBDIR}/overview.fmt

              This  file  specifies  the  organization  of  the  news overview
              database (see also newsoverview(5)).  The order of lines in this
              file  is  important; it determines the order in which the fields
              will appear in the database.  tin(1) currently only  understands
              the  order  specified  in  RFC2980.  See  also  overview.fmt(5).
              tin(1) only tries to read the file if you read directly from the
              local  spool,  if  you  read news via NNTP, tin(1) uses the LIST
              OVERVIEW.FMT (RFC2980) command instead.

       ${TIN_LIBDIR-NEWSLIBDIR}/subscriptions

              This file contains a list of newsgroups - one per line  -  which
              the   client   should   subscribe   to  when  the  user  has  no
              ${TIN_HOMEDIR-"$HOME"}/.newsrc for the newsserver.  tin(1)  only
              tries  to  read  the  file  if  you read directly from the local
              spool,  if  you  read  news  via  NNTP,  tin(1)  uses  the  LIST
              SUBSCRIPTIONS (RFC2980) command instead.

SEE ALSO

       elm(1),   inews(1),  ispell(1),  lp(1),  lpr(1),  metamail(1)  perl(1),
       pgp(1),  rn(1),  shar(1),  slrnface(1),  tin(1),  xterm(1x),  iconv(3),
       iconv_open(3),   nl_langinfo(3),   pcre(3),   strftime(3),   system(3),
       mailcap(4),    active(5),    mbox(5),     mmdf(5),     newsoverview(5),
       overview.fmt(5),  innd(8), RFC1036, RFC1524, RFC2045, RFC2046, RFC2047,
       RFC2048, RFC2822, RFC2980, RFC3977, RFC4643