tin(5)



tin(5)                         Usenet newsreader                        tin(5)

NAME
       tin, rtin - related files

DESCRIPTION
       This  man  page  describes the various (config) files and their formats
       used by the tin(1) newsreader. All files  are  expected  to  have  unix
       style ('\n' aka LF) line endings.

FILES
       $MAILCAPS
       ~/.mailcap
       /etc/mailcap
       /usr/etc/mailcap
       /usr/local/etc/mailcap
       /etc/mail/mailcap

              mailcap(5)  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 con-
              tinued by ending them with a backslash character, "\".

              Each individual mailcap entry consists of a content-type  speci-
              fication, 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 sub-
              type 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  re-
              placed  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 de-
              fined:

              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 compos-
                     ing 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 op-
                     erating 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 ap-
                     plied to the composed data. The "compose" field  is  sim-
                     pler,  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 Con-
                     tent-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 for-
                     mat. In many cases, it may be identical in content to the
                     "compose" field, and shares the  operating-system  depen-
                     dent 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 pro-
                     gram execution are operating system dependent.

              test   The "test" field may be used to test some external condi-
                     tion  (e.g., the machine architecture, or the window sys-
                     tem 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 depen-
                     dent. 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 ar-
                     bitrarily 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 spec-
                     ified.

              description
                     The  "description"  field  simply  provides a textual de-
                     scription, 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  filename 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", "name-
              template"  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/nntpserver

              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 cancel-locks if tin(1) is build with  sup-
              port  for it. An empty secret file disables the cancel-lock cre-
              ation in that case. This file should be  readable  only  by  the
              user.

       ${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. If the password contains a space or a tab it must
              be enclosed in double quotes ("). Usernames must not be enclosed
              in double quotes and thus can't contain spaces or tabs. 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
              user's unencrypted password for reading news!

              nntpserver
                     full qualified domain name of the news server.

              password
                     user's unencrypted password for reading news.

              user   username  on the news server if it differs from the local
                     login. This field is optional.

              Example:
                     # sample .newsauth file
                     news.example.org  secret
                     news.example.net  arcane  guest
                     news.example.com  "top secret"  james.bond@example.com

       ${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" quadru-
              ples) 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 path-
                     name 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  one
              to   refine  attributes  for  narrowed  scopes.  Note  that  the
              scope=<grouplist> line has to be specified before the attributes
              are  specified  for that list and each attribute can only be set
              once per scope section. 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.

              add_posted_to_filter
                     Identical to the tinrc variable of the same name

              advertising
                     Identical to the tinrc variable of the same name

              alternative_handling
                     Identical to the tinrc variable of the same name

              ask_for_metamail
                     Identical to the tinrc variable of the same name

              auto_cc_bcc
                     Identical to the tinrc variable of the same name

              auto_list_thread
                     Identical to the tinrc variable of the same name

              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 AUTO-
                     MATIC MAILING AND SAVING NEW NEWS in tin(1).

              date_format
                     Identical to the tinrc variable of the same name

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

              editor_format
                     Identical to the tinrc variable of the same name

              extquote_handling
                     Identical to the tinrc variable of the same name

              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

              group_catchup_on_exit
                     Identical to the tinrc variable of the same name

              group_format
                     Identical to the tinrc variable of the same name

              mail_8bit_header
                     Identical to the tinrc variable of the same name

              mail_mime_encoding
                     Identical to the tinrc variable of the same name

              maildir
                     Identical to the tinrc variable of the same name

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

              mark_ignore_tags
                     Identical to the tinrc variable of the same name

              mark_saved_read
                     Identical to the tinrc variable of the same name

              mime_forward
                     Determines whether usenet articles are forwarded  as  at-
                     tachment  or inline. When set to OFF, the forwarded arti-
                     cle will be included in the body of the mail, while  set-
                     ting this variable to ON will cause the article to be at-
                     tached 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  en-
                     coded  in  a different character set than your local one.
                     It is also useful if the receiver should be able to oper-
                     ate  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  op-
                     tion.  Currently mime_forward is forced if the article to
                     be attached is a multipart MIME article, this may  change
                     in a future version.  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/au-
                     tosave  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/*,!im-
                     age/bmp,!text/html. Default is */*

              news_headers_to_display
                     Identical to the tinrc variable of the same name

              news_headers_to_not_display
                     Identical to the tinrc variable of the same name

              news_quote_format
                     Identical to the tinrc variable of the same name

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

              pos_first_unread
                     Identical to the tinrc variable of the same name

              post_8bit_header
                     Identical to the tinrc variable of the same name

              post_mime_encoding
                     Identical to the tinrc variable of the same name

              post_process_type
                     Identical to the tinrc variable of the same name

              post_process_view
                     Identical to the tinrc variable of the same name

              print_header
                     Identical to the tinrc variable of the same name

              process_only_unread
                     Identical to the tinrc variable of the same name

              prompt_followupto
                     Identical to the tinrc variable of the same name

              quote_chars
                     Identical to the tinrc variable of the same name

              savedir
                     Identical to the tinrc variable of the same name

              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_arts
                     Identical to the tinrc variable of the same name

              show_signatures
                     Identical to the tinrc variable of the same name

              sigdashes
                     Identical to the tinrc variable of the same name

              sigfile
                     Identical to the tinrc variable of the same name

              signature_repost
                     Identical to the tinrc variable of the same name

              sort_article_type
                     Identical to the tinrc variable sort_article_type

              sort_threads_type
                     Identical to the tinrc variable of the same name

              start_editor_offset
                     Identical to the tinrc variable of the same name

              tex2iso_conv
                     Identical to the tinrc variable of the same name

              thread_articles
                     Identical to the tinrc variable of the same name

              thread_catchup_on_exit
                     Identical to the tinrc variable of the same name

              thread_format
                     Identical to the tinrc variable of the same name

              thread_perc
                     Identical to the tinrc variable of the same name

              trim_article_body
                     Identical to the tinrc variable of the same name

              verbatim_handling
                     Identical to the tinrc variable of the same name

              wrap_on_next_unread
                     Identical to the tinrc variable of the same name

              x_body A piece of text that will be added at the start of a mes-
                     sage 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 exe-
                     cuted to generate the header and its content. %G  is  ex-
                     panded  to the current news.group.name and %P is expanded
                     to the news.group.name with all '.' replaced by '/'.

              quick_kill_scope
                     A comma-separated list of  newsgroup  patterns  (wildmat-
                     style) to which groups the filter rule added by QuickFil-
                     terKill 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_ex-
                     pire

              quick_kill_case
                     Identical to the tinrc variable default_filter_kill_case

              quick_kill_header
                     Identical   to   the    tinrc    variable    default_fil-
                     ter_kill_header

              quick_select_scope
                     A  comma-separated  list  of newsgroup patterns (wildmat-
                     style) to which groups the filter rule added by QuickFil-
                     terSelect  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_ex-
                     pire

              quick_select_case
                     Identical   to   the  tinrc  variable  default_filter_se-
                     lect_case

              quick_select_header
                     Identical  to  the  tinrc   variable   default_filter_se-
                     lect_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     --dis-
                     able-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_process_type=1

                     # in *binaries* turn on full post processing,
                     # remove tmp files and set Followup-To: poster
                     scope=*binaries*
                     post_process_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=%I>_
                     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  ig-
              nored.

              comment
                     Every  entry  (rule)  in the filter file might get a com-
                     ment. 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 in  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:''. The matching type used (wild-
                     mat or regex) depends on the setting of the  tinrc  vari-
                     able wildcard.

              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  pat-
                     terns in the filter rule. The matching type used (wildmat
                     or regex) depends on the setting of  the  tinrc  variable
                     wildcard.

              msgid  Match  against  ''Message-ID:'' and full ''References:''.
                     The matching type used (wildmat or regex) depends on  the
                     setting of the tinrc variable wildcard.

              msgid_last
                     Match  against  ''Message-ID:''  and last ''References:''
                     entry only. The matching type used (wildmat or regex) de-
                     pends on the setting of the tinrc variable wildcard.

              msgid_only
                     Match  against  ''Message-ID:''.  The  matching type used
                     (wildmat or regex) depends on the setting  of  the  tinrc
                     variable wildcard.

              refs_only
                     Match  against  ''References:''.  The  matching type used
                     (wildmat or regex) depends on the setting  of  the  tinrc
                     variable wildcard.

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

              gnksa  Match against ''From:'' address parser return codes. <num
                     matches  less  than,  >num matches more than the returned
                     numeric value.  GNKSA_LOCAL_DOMAIN_LITERAL  or  GNKSA_IN-
                     VALID_DOMAIN   are  only  returned  if  disable_gnksa_do-
                     main_check is set to false. As the built in  domain  list
                     is outdated this should be considered carefully.
                          0  GNKSA_OK
                          1  GNKSA_INTERNAL_ERROR
                        100  GNKSA_LANGLE_MISSING
                        101  GNKSA_LPAREN_MISSING
                        102  GNKSA_RPAREN_MISSING
                        103  GNKSA_ATSIGN_MISSING
                        104  GNKSA_RANGLE_MISSING
                        200  GNKSA_SINGLE_DOMAIN
                        201  GNKSA_INVALID_DOMAIN
                        202  GNKSA_ILLEGAL_DOMAIN
                        203  GNKSA_UNKNOWN_DOMAIN
                        204  GNKSA_INVALID_FQDN_CHAR
                        205  GNKSA_ZERO_LENGTH_LABEL
                        206  GNKSA_ILLEGAL_LABEL_LENGTH
                        207  GNKSA_ILLEGAL_LABEL_HYPHEN
                        208  GNKSA_ILLEGAL_LABEL_BEGNUM
                        209  GNKSA_BAD_DOMAIN_LITERAL
                        210  GNKSA_LOCAL_DOMAIN_LITERAL
                        211  GNKSA_RBRACKET_MISSING
                        300  GNKSA_LOCALPART_MISSING
                        301  GNKSA_INVALID_LOCALPART
                        302  GNKSA_ZERO_LENGTH_LOCAL_WORD
                        400  GNKSA_ILLEGAL_UNQUOTED_CHAR
                        401  GNKSA_ILLEGAL_QUOTED_CHAR
                        402  GNKSA_ILLEGAL_ENCODED_CHAR
                        403  GNKSA_BAD_ENCODE_SYNTAX
                        404  GNKSA_ILLEGAL_PAREN_CHAR
                        405  GNKSA_INVALID_REALNAME
                        406  GNKSA_MISSING_REALNAME

              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 newsgroup
                     list  with  all  other  information  (i.e.   the  article
                     counter)  removed.  The  matching  type  used (wildmat or
                     regex) depends on the setting of the tinrc variable wild-
                     card.

              path   Match  against  ''Path:'' line. This may not work on some
                     servers. The matching type used (wildmat  or  regex)  de-
                     pends on the setting of the tinrc variable wildcard.

              time   time_t value when rule expires

              Example:
                     comment=mark all articles about tin, rtin,
                     comment=tind, ktin or cdtin as hot
                     group=*
                     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 separated
              by spaces or tabs. Below is a list of  all  rebindable  keynames
              and  their  defaults.  If a keyname is bound to NULL it is unas-
              signed.

              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
              MarkFeedRead                   ^X
              MarkFeedUnread                 ^W

              AttachSelect                   ^J   ^M
              AttachPipe                     p
              AttachSave                     s
              AttachTag                      t
              AttachUntag                    U
              AttachTagPattern               =
              AttachToggleTagged             @

              ConfigToggleAttrib             TAB
              ConfigSelect                   ^J   ^M
              ConfigLastPage                 G
              ConfigNoSave                   Q
              ConfigScopeMenu                S
              ConfigFirstPage                g
              ConfigResetAttrib              r

              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                @
              GroupCancel                    D
              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
              PageToggleRaw                  ^H
              PageNextUnread                 TAB
              PageNextThd                    ^J   ^M
              PageToggleTabs                 ^T
              PageFollowupQuoteHeaders       ^W
              PageToggleTex2iso              "
              PageToggleAllHeaders           *
              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

              ScopeSelect                    ^J   ^M
              ScopeEditAttributesFile        E
              ScopeAdd                       a
              ScopeDelete                    d
              ScopeMove                      m
              ScopeRename                    r

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

              UrlSelect                      ^J   ^M

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

              This file provides short descriptions of  each  mailgroup.  (re-
              quires  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 news server.

              newsrc related newsrc.

              shortname
                     nickname(s) for the nntpserver.

              Example:
                     # sample newsrctable file
                     news.tin.org .newsrc-tin.org tinorg
                     news.example.org /tmp/nrc-ex example ex

       ${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  up-
              dated  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 de-
              scription".

              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 vari-
              ables, 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 con-
              tains a list of "variable=value" pairs that can be used to  con-
              figure the way tin(1) works. If it exists, the global configura-
              tion file, ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc is read first.  After
              that,    the   user's   own   configuration   file   ${TIN_HOME-
              DIR:-"$HOME"}/.tin/tinrc is read. The global file is useful  for
              distributing  system-wide defaults to new users who have no pri-
              vate tinrc yet (see also /etc/tin/tin.defaults).

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

              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 re-
                     cent (not older than X days). See also  recent_time.  De-
                     fault 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.  De-
                     fault 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 ac-
                     cordingly.

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

              auto_cc_bcc
                     Automatically  put  your  name  in  the  ''Cc:''   and/or
                     ''Bcc:'' field when mailing an article. Default is No.

              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.

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

              catchup_read_groups
                     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_extquote
                     Color of quoted text from external sources

              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_message
                     Color of status messages in last line

              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_verbatim
                     Color of verbatim blocks

              col_subject
                     Color of article subject

              col_text
                     Color of text-lines

              col_title
                     Color of help/mail sign

              confirm_choice
                     tin(1) can ask for manual  confirmation  to  protect  the
                     user. Available choices:
                          commands: Ask for confirmation before executing cer-
                          tain dangerous commands (e.g., Catchup ('c')).  Com-
                          mands  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.   De-
                     fault is "%a, %d %b %Y %H:%M:%S".

              default_art_search

              default_author_search

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

              default_filter_days
                     Default is 28.

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

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

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

              default_filter_kill_header
                     Default for quick (1 key) kill filter header.
                        0     ''Subject:'' (case sensitive)
                        1     ''Subject:'' (ignore case)
                        2     ''From:'' (case sensitive)
                        3     ''From:'' (ignore case)
                        4     ''Message-ID:'' & full ''References:'' line
                        5     ''Message-ID:'' & last ''References:'' entry only
                        6     ''Message-ID:'' entry only
                        7     ''Lines:''

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

              default_filter_select_expire
                     Default for quick (1 key) auto-selection  filter  expire.
                     ON  =  limit to default_filter_days, OFF = don't ever ex-
                     pire.  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. De-
                     fault is ON.

              default_filter_select_header
                     Default for quick (1 key) auto-selection filter header.
                        0     ''Subject:'' (case sensitive)
                        1     ''Subject:'' (ignore case)
                        2     ''From:'' (case sensitive)
                        3     ''From:'' (ignore case)
                        4     ''Message-ID:'' & full ''References:'' line
                        5     ''Message-ID:'' & last ''References:'' entry only
                        6     ''Message-ID:'' entry only
                        7     ''Lines:''

              default_goto_group

              default_group_search

              default_mail_address

              default_move_group

              default_pattern

              default_pipe_command

              default_post_newsgroups

              default_post_subject

              default_range_group

              default_range_select

              default_range_thread

              default_repost_group

              default_save_file

              default_save_mode

              default_select_pattern

              default_shell_command

              default_subject_search

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

              editor_format
                     The format string used to create the editor start command
                     with  parameters.  Default is '%E +%N %F' with %E=Editor,
                     %N=Linenumber and %F=Filename (e.g.,  /bin/vi  +7  .arti-
                     cle).

              extquote_handling
                     If  ON quotes from external sources will be detected. De-
                     fault is OFF.

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

              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   the   last
                     getart_limit  articles/group are fetched from the server.
                     If getart_limit is < 0 tin(1) will start  fetching  arti-
                     cles  from  your  first  unread  minus  absolute value of
                     getart_limit. Default is 0, which means no limit.

              goto_next_unread
                     Which keys tin(1) should accept to jump to the  next  un-
                     read  article.   Possible  is any combination of PageDown
                     and PageNextUnread.  When PageDown is set tin(1) jumps to
                     the  next article at the end of the current one. When Pa-
                     geNextUnread is set tin(1) 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.

              group_format
                     The  format  string  used for the Group level. Default is
                     "%n %m %R %L  %s  %F". The  following  substitutions  are
                     supported:
                        %D    date
                        %F    from, name and/or address
                        %I    initials
                        %L    line count
                        %M    message-id
                        %R    number of responses in thread
                        %S    score
                        %m    article marks
                        %n    current thread number
                        %s    subject
                        %%    %

              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 file-
                     name (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 uuen-
                     coded  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 us-
                     age. This option has to suit mailer_format. Default is 0.

              inverse_okay
                     If ON use inverse video for page headers  and  URL  high-
                     lighting.  Default is ON.

              keep_dead_articles
                     If   ON   keep   all   failed   postings  in  ${TIN_HOME-
                     DIR:-"$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  arti-
                     cles  that  are killed. There are 3 options, default is 0
                     (Kill only unread arts).

                        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  hap-
                           pens  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  arti-
                           cles in the group and therefore there is a process-
                           ing overhead when using this option.  Killed  arti-
                           cles are threaded as normal but they will be marked
                           with art_marked_killed.

                        2  Kill all arts and never show will process all arti-
                           cles in the group and therefore there is a process-
                           ing overhead when using this option.  Killed  arti-
                           cles simply does not get displayed at all.

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

              mail_address
                     User's  mail  address  (and  full  name),  if  not  user-
                     name@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
                     quoted-printable.

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

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

              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 arti-
                     cles/threads/groups simply by giving '=' as the  filename
                     to save to.  Default is ${TIN_HOMEDIR:-"$HOME"}/Mail.

              mailer_format
                     The  format string used to create the mailer command with
                     parameters that is used for  mailing  articles  to  other
                     people. Default is '%M "%T" < %F' (e.g., /bin/mail "iain"
                     < .article). The flexible  format  allows  other  mailers
                     with different command line parameters to be used such as
                        sendmail -oem -t < %F
                        elm -s "%S" "%T" < "%F"
                        claws-mail --compose "mailto:%T?subject=%S&insert=%F"
                     interactive_mailer  must  be  set adequate. The following
                     substitutions are supported:
                        %F              filename
                        %M              default_mailer
                        %S              subject-field
                        %T              to-filed
                        %U              username
                        %%              %

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

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

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

              mm_network_charset
                     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 sys-
                     tem  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
                     depends 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
                     depends 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
                     depends 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
                     depends on your terminal which attributes are usable. See
                     also word_h_display_marks and word_highlight.

              newnews
                     These are internal timers used by tin(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 op-
                     posite.  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:".

              nntp_read_timeout_secs
                     Time  in  seconds to wait for a response from the server.
                     Default is 120.

              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

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

              pos_first_unread
                     If ON put cursor at first unread article in group  other-
                     wise 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 usually required. Default is
                     OFF. Only enacted if post_mime_encoding is  also  set  to
                     8bit. In a number of local hierarchies where 8bit charac-
                     ters 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  lo-
                     cal  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 pro-
                     gram to display any files that were  post  processed  and
                     uudecoded. The program is determined using the mailcap(5)
                     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 al-
                     lowed:

                        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  care-
                           ful with this option.

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

              posted_articles_file
                     Keep posted articles in given file. If the given filename
                     does  not  contain any expandable strings it will be pre-
                     fixed with ${TIN_HOMEDIR:-"$HOME"}/Mail/. If no  filename
                     is  set  then postings will not be saved. See the section
                     "MAILING PIPING PRINTING REPOSTING AND  SAVING  ARTICLES"
                     for  more information about the various expansion charac-
                     ters. 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.

              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.

              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, %I
                     is replaced by author's initials. 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 rele-
                     vant values. Default is 5, which means that quote charac-
                     ters 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 op-
                           tion  when  you  are viewing an article in raw mode
                           PageToggleRaw ('^H') and followup or reply  to  it.
                           Signatures  are never quoted regardless of this op-
                           tion when show_signatures is off.

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

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

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

              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(1) does the rendering of  bi-directional  text.
                     If OFF tin(1) leaves the rendering of bi-directional text
                     to the terminal. Default is OFF.

              reread_active_file_secs
                     The    news     ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE-
                     FILE:-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.

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

              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 tin  page-by-
                     page  scrolling.  Set to -1 to get page-by-page scrolling
                     where the top/bottom line is carried over onto  the  next
                     page.           This          setting          supersedes
                     show_last_line_prev_page=ON. Set to -2 to  get  half-page
                     scrolling. This setting supersedes full_page_scroll=OFF.

              select_format
                     The  format  string used for the Selection level. Default
                     is "%f %n %U  %G  %d". The  following  substitutions  are
                     supported:
                        %G    group name
                        %U    unread count
                        %d    description
                        %f    group flag
                        %n    current group number
                        %%    %

              sort_function
                     Function used for sorting articles. Default is 0.

                   0  Use qsort(3) for sorting.

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

              show_author
                     Which  information  about the author should be shown. De-
                     fault 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  (de-
                           fault).

                        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_LIB-
                     DIR:-NEWSLIBDIR}/newsgroups file and  if  supported  (re-
                     quires  tin(1) to be build with mh-mail-handling support)
                     from  ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups  for  mail-
                     groups. 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  ar-
                           ticle  will  be displayed and in thread listing the
                           line count of first (unread) article will  be  dis-
                           played.

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

              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  ran-
                     domly  generated from files that are in the specified di-
                     rectory. If the path starts with a ! the program the path
                     points  to  will  be executed to generate a signature. In
                     order to pass the group name to the program,  %G  can  be
                     specified.  This will be replaced by the name of the cur-
                     rent newsgroup. --none will suppress any signature.   De-
                     fault is ${TIN_HOMEDIR:-"$HOME"}/.Sig.

              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 as-
                     cending Date (6) is the default. The following sort types
                     are allowed:

                        0  Nothing, don't sort articles.

                        1  Subject:  (descending),  sort  articles  by  ''Sub-
                           ject:'' 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  de-
                     scending  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. Example:

                     spam,delete,remove

              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 noth-
                     ing & 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  re-
                     moved from your ${TIN_HOMEDIR:-"$HOME"}/.newsrc file. De-
                     fault is OFF.

              strip_re_regex
                     A regular expression to find Subject prefixes like  "Re:"
                     to  remove If strip_re_regex is blank, then tin(1) uses a
                     built-in default.

              strip_was_regex
                     A  regular  expression  to  find  Subject  suffixes  like
                     "(was:"  to  remove.   If  strip_was_regex is blank, then
                     tin(1) uses a built-in default.

              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 PageToggle-
                     Tex2iso ('"').

              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 pos-
                     sible  to  set the threading type on a per group basis by
                     setting the group attribute variable thread_articles to 0
                     - 5 in the file ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes.

              thread_format
                     The  format  string used for the Thread level. Default is
                     "%n %m  [%L]  %T  %F". The  following  substitutions  are
                     supported:
                        %D    date
                        %F    from, name and/or address
                        %I    initials
                        %L    line count
                        %M    message-id
                        %S    score
                        %T    thread tree
                        %m    article marks
                        %n    current article number
                        %%    %

              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 ar-
                     row 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 sev-
                     eral similarly looking characters. On systems where  this
                     extension doesn't exist, this option is disabled. Default
                     is OFF.

              trim_article_body
                     Allows you to select how tin(1) treats blank lines in ar-
                     ticle  bodies.  Default is 0. This option does not affect
                     lines within verbatim blocks.

                        0  Don't trim article body, do nothing.

                        1  Skip leading blank lines.

                        2  Skip trailing blank lines.

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

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

                        5  Compact multiple and skip leading, 4 + 1

                        6  Compact multiple and skip trailing, 4 + 2

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

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

              unlink_article
                     If ON remove ${TIN_HOMEDIR:-"$HOME"}/.article after post-
                     ing. 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.  Default is url_handler.pl.

              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 an xterm(1x) to be en-
                     abled/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.

              utf8_graphics
                     If  ON  use  UTF-8  characters  for   indicator   ('->'),
                     thread/attachment  tree  and ellipsis ('...'). 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-

              verbatim_handling
                     If ON verbatim blocks will be detected. Default is ON.

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

              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. Default is ON.

              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 dis-
                     played.  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 arti-
                     cles. 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/lo-
                     cal/lib/news or /news/db. $TIN_LIBDIR overrides any spec-
                     ified value.

              bugaddress
                     Defines the email address to which users can send bug re-
                     ports 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 adminis-
                     tration  if you want to deal with your lusers problems on
                     your own.

              inewsdir
                     Defines the directory containing 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 used in MIME articles. 8bit might
                     be the best value.

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

              disable_gnksa_domain_check
                     Allow  unregistered  top  level  domains.  As the list of
                     valid TLDs is no longer actively maintained  the  default
                     was changed to ON starting with tin(1) version 2.1.5

              disable_sender
                     Don't  generate  a ''Sender:'' header. This has an effect
                     only if inews_prog is 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/over-
                     view. $TIN_NOVROOTDIR overrides any specified value.

              overviewfile
                     Name of a single overview file, common values are  .over-
                     view, over.view. $TIN_NOVFILENAME overrides any specified
                     value.

              overviewfmtfile
                     Full pathname of  your  newssystem's  overview.fmt  file;
                     usually  the  overview.fmt  file is in newslibdir, so you
                     only have to change this setting  if  your  configuration
                     differs.

              activefile
                     Full  pathname  of your newssystem's active file; usually
                     the active file resides in newslibdir and  is  named  ac-
                     tive,  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 dif-
                     fers.

              newsgroupsfile
                     Full pathname of your newssystem's newsgroups file;  usu-
                     ally  the  newsgroups  file is in newslibdir, so you only
                     have to change this setting if  your  configuration  dif-
                     fers.

              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 low-
                     est article number is greater than  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 (RFC3977) or LIST COUNTS (RFC6048) 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 news server (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 (RFC3977) command instead.

       ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups

              This  file  provides short descriptions of each newsgroup. It is
              normally updated by the local news server (e.g.  innd(8))  when-
              ever  a new group is created. Each line consist of two tab-sepa-
              rated 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 (RFC3977) command instead.

       ${TIN_LIBDIR:-NEWSLIBDIR}/organization

              This file 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  data-
              base  (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. 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 OVER-
              VIEW.FMT (RFC3977) 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_HOME-
              DIR:-"$HOME"}/.newsrc for the news server.  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 (RFC6048)
              command instead.

SEE ALSO
       elm(1),  inews(1),  ispell(1),  lp(1),  lpr(1),  metamail(1),  perl(1),
       perlre(1), pgp(1),  rn(1),  shar(1),  slrnface(1),  tin(1),  xterm(1x),
       heapsort(3),    iconv(3),   iconv_open(3),   nl_langinfo(3),   pcre(3),
       pcrepattern(3),   qsort(3),    strftime(3),    system(3),    active(5),
       mailcap(5),   mbox(5),   mmdf(5),   newsoverview(5),   overview.fmt(5),
       innd(8), RFC1524, RFC2045, RFC2046, RFC2047, RFC2048, RFC2231, RFC2980,
       RFC3977, RFC4155, RFC4643, RFC5322, RFC5536, RFC5537, RFC6048

2.4.5                         December 24th, 2020                       tin(5)

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