tin(5)



tin(5)                        A Usenet newsreader                       tin(5)

NAME
       tin, rtin - related files

DESCRIPTION
       This  manpage  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
              replaced  by  the value of the named parameter, if any, from the
              ''Content-Type:'' header. Finally, if the field  contains  "\%",
              those two characters will be replaced by a single "%" character.

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

              compose
                     The "compose" field may be used to specify a program that
                     can be used to compose a new body or  body  part  in  the
                     given format. Its intended use is to support mail 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
                     operating  system  dependent. The result of the composing
                     program may be data that is not  yet  suitable  for  mail
                     transport - that is, a Content-Transfer-Encoding may need
                     to be applied to the data.

              composetyped
                     The "composetyped" field  is  similar  to  the  "compose"
                     field, but is to be used when the composing program needs
                     to specify  the  ''Content-Type:''  header  field  to  be
                     applied to the composed data. The "compose" field is 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
                     arbitrarily complex.

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

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

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

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

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

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

              tin(1) currently only respects the "test", "description", "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 for 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 uncrypted password for reading news!

              nntpserver
                     full qualified domain name of the newsserver.

              password
                     user's uncrypted password for reading news.

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

              Example:
                     # sample .newsauth file
                     news.example.org  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

              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
                     attachment or inline. When  set  to  OFF,  the  forwarded
                     article  will  be included in the body of the mail, while
                     setting this variable to ON will cause the article to  be
                     attached  as  a separate MIME part. Enabling mime_forward
                     is particularly useful for articles consisting of  multi-
                     ple  MIME parts such as PGP/MIME signed messages or being
                     encoded in a different character set than your local one.
                     It is also useful if the receiver should be able to 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
                     option.  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  interac-
                     tive_mailer has to be set to 0 (which is the default).

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

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

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

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

              quick_select_case
                     Identical    to    the    tinrc   variable   default_fil-
                     ter_select_case

              quick_select_header
                     Identical   to   the    tinrc    variable    default_fil-
                     ter_select_header

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

              mm_network_charset
                     Identical to the tinrc variable of the same name

              undeclared_charset
                     Assume (broken) articles without MIME charset declaration
                     have  this  charset - default is US-ASCII. This attribute
                     works only on systems with working iconv(3), others might
                     have      to      compile      tin(1)     with     --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=%s>_
                     x_comment_to=ON

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

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

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

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

              comment
                     Every  entry  (rule)  in the filter file might get a 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  (wildmat-
                     style)  to  which groups the filter rule will be applied.
                     This line is mandatory!

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

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

              subj   Match against ''Subject:''

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

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

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

              msgid_only
                     Match against ''Message-ID:''

              refs_only
                     Match against ''References:''

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

              gnksa  Match against ''From:'' address parser return codes.

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

              time   time_t value when rule expires

              Example:
                     comment=mark all articles about tin, rtin,
                     comment=tind, ktin or cdtin as hot
                     group=*
                     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
              ThreadUndoSel                  ~

              UrlSelect                      ^J   ^M

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

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

              mailgroupname
                     is the name of the newsgroup

              description
                     is a short single-line description of the group

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

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

              nntpserver
                     full qualified domain name of the newsserver.

              newsrc related newsrc.

              shortname
                     nickname(s) for the nntpserver.

              Example:
                     # sample newsrctable file
                     news.tin.org .newsrc-tin.org tinorg
                     news.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
              updated  on  startup  except when using the ''-X''or ''-q'' com-
              mand-line option and an old copy exists. Each  line  consist  of
              two tab-separated fields "group.name                    one-line
              description".

              group.name
                     is the name of the newsgroup

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

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

              File to store $NNTPSERVER and $NNTPPORT related data via a  list
              of  "variable=value"  pairs.  Currently there are only two 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_HOMEDIR:-"$HOME"}/.tin/tinrc is read. The global  file  is
              useful  for  distributing  system-wide defaults to new users who
              have no private tinrc yet (see also /etc/tin/tin.defaults).

              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
                     recent (not older than X  days).  See  also  recent_time.
                     Default is 'o'.

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

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

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

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

              Ask before using MIME viewer (ask_for_metamail)
                     If ON tin(1) will ask before using a MIME  viewer  (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.

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

              col_back
                     Standard background color

              col_from
                     Color of sender (From:)

              col_head
                     Color of header-lines

              col_help
                     Color of help pages

              col_invers_bg
                     Color of background for inverse text

              col_invers_fg
                     Color of foreground for inverse text

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

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

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

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

              col_minihelp
                     Color of mini help menu

              col_newsheaders
                     Color of actual news header fields

              col_normal
                     Standard foreground color

              col_quote
                     Color of quoted lines

              col_quote2
                     Color of twice quoted lines

              col_quote3
                     Color of >=3 times quoted lines

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

              col_signature
                     Color of signatures

              col_urls
                     Color of urls highlight

              col_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.
                     Default is "%a, %d %b %Y %H:%M:%S".

              default_art_search

              default_author_search

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

              default_filter_days
                     Default is 28.

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

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

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

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

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

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

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

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

              default_goto_group

              default_group_search

              default_mail_address

              default_move_group

              default_pattern

              default_pipe_command

              default_post_newsgroups

              default_post_subject

              default_range_group

              default_range_select

              default_range_thread

              default_repost_group

              default_save_file

              default_save_mode

              default_select_pattern

              default_shell_command

              default_subject_search

              draw_arrow
                     Allows groups/articles to be selected by an arrow '->' if
                     set ON or by an highlighted bar if set 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).

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

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

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

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

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

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

              hide_uue
                     If  set  to 'No' then raw uuencoded data is displayed. If
                     set to 'Yes' then sections  of  uuencoded  data  will  be
                     shown  with  a single tag line showing the size and 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
                     usage. 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
                     (default, except on SCO),  MBOXRD  or  MMDF  (default  on
                     SCO).  See  mbox(5) and RFC4155 for more details on MBOXO
                     and MBOXRD and mmdf(5) for more details about MMDF.

              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
                     encoding)    in    mail    and    news    postings.    If
                     MIME_STRICT_CHARSET is defined at the compile time,  text
                     in charset other than the value of this parameter is con-
                     sidered not displayable and represented  as  '?'.  Other-
                     wise,  all character sets are regarded as compatible with
                     the display. If it's not set, the value of  the  environ-
                     ment  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
                     is  depending  on  your  terminal  which  attributes  are
                     usable. See also word_h_display_marks and word_highlight.

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

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

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

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

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

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

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

              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
              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
                     local hierarchy of your interest to determine what to  do
                     with this and post_mime_encoding.

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

              post_process_view
                     If ON, then tin(1) will start an appropriate viewer  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
                     allowed:

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

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

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

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

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

              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.
                     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
                           option  when you are viewing an article in raw mode
                           PageToggleRaw ('^H') and followup or reply  to  it.
                           Signatures  are  never  quoted  regardless  of this
                           option 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
                     default.

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

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

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

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

              reread_active_file_secs
                     The    news     ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_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  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.
                     Default is 2, authors full name.

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

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

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

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

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

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

                        0  None, no information will be displayed.

                        1  Lines,  in  article  listing  the  line count of an
                           article will be displayed and in thread listing the
                           line  count  of first (unread) article will be 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
                     articles. Default is OFF.

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

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

              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
                     directory.  If  the  path starts with a ! the program the
                     path points to will be executed to generate a  signature.
                     tin(1)  will  pass  the  name of the current newsgroup as
                     argument to the program. --none will suppress any  signa-
                     ture.  Default 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
                     ascending 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
                     descending Score (1) is the default. The  following  sort
                     types are allowed:

                        0  Nothing, don't sort threads.

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

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

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

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

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

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

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

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

              strip_bogus
                     Bogus  groups  are  groups  that  are  present  in   your
                     ${TIN_HOMEDIR:-"$HOME"}/.newsrc file that no longer exist
                     on the news server. There are 3 options. 0 means do 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
                     removed from your  ${TIN_HOMEDIR:-"$HOME"}/.newsrc  file.
                     Default is OFF.

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

              tex2iso_conv
                     Decode German style TeX umlaut codes to ISO If  ON,  show
                     "a  as  Umlaut-a,  etc. Default is OFF. This behavior can
                     also be toggled in the  article  viewer  via  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
                     arrow key. Default is ON.

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

                        0  Max, the maximum score in this thread.

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

                        2  Average, the average score in this thread.

              translit
                     If  ON  append  //TRANSLIT  to  the  first  argument   of
                     iconv_open(3)  to enable transliteration. This means that
                     when a character cannot  be  represented  in  the  target
                     character set, it can be approximated through one or 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 treats blank lines in  arti-
                     cle  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 to this. Default is url_handler.pl %s.

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

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

              use_keypad
                     Use scroll keys on keypad. Default is OFF.

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

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

              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
                     default  is 0 and uses the wildmat notation, which is how
                     this has traditionally been handled. Setting  this  to  1
                     allows  you to use perl(1) compatible regular expressions
                     pcre(3).  You will probably want to  update  your  filter
                     file  if you use this regularly. NB: Newsgroup names will
                     always be matched using the wildmat notation.

              word_h_display_marks
                     Should the leading and ending stars, slashes, strokes and
                     dashes also be displayed, even when they are highlighting
                     marks?

                        0  no

                        1  yes, display mark

                        2  print a space instead

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

              wrap_column
                     Sets the column at which a displayed article body  should
                     be  wrapped.  If this value is equal to 0, it defaults to
                     the current screen width.  If this value is greater  than
                     your current screen width the part off-screen is not 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/local/lib/news  or  /news/db.  $TIN_LIBDIR overrides
                     any specified value.

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

              inewsdir
                     Defines  the  directory  containing  of the inews(1) exe-
                     cutable

              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

              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/overview. $TIN_NOVROOTDIR overrides  any  specified
                     value.

              overviewfile
                     Name  of  a  single  overview  file,  common  values  are
                     .overview,  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
                     active, so you only have to change this setting  if  your
                     configuration   differs.  $TIN_ACTIVEFILE  overrides  any
                     specified value.

              activetimesfile
                     Full pathname of  your  newssystem's  active.times  file;
                     usually  the active.times file is newslibdir, so you only
                     have to change this setting if  your  configuration  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 newsserver (e.g.
              innd(8)) whenever a new group is created. Each line  consist  of
              three space-separated fields "name time creator".

              name   is the name of the newsgroup

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

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

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

       ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups

              This  file  provides short descriptions of each newsgroup. It is
              normally updated by the local newsserver (e.g.   innd(8))  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 specifies might hold a default organization to be used
              in the ''Organization:'' header. $ORGANIZATION has a higher pri-
              ority if set.

       ${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt

              This file  specifies  the  organization  of  the  news  overview
              database (see also newsoverview(5)).  The order of lines in this
              file is important; it determines the order in which  the  fields
              will  appear  in the database. See also overview.fmt(5).  tin(1)
              only tries to read the file if you read directly from the  local
              spool,  if  you  read  news  via  NNTP,  tin(1)  uses  the  LIST
              OVERVIEW.FMT (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 newsserver.  tin(1) only tries  to
              read  the file if you read directly from the local spool, if you
              read news via NNTP, tin(1) uses the LIST SUBSCRIPTIONS (RFC6048)
              command instead.

SEE ALSO
       elm(1),  inews(1),  ispell(1),  lp(1),  lpr(1),  metamail(1),  perl(1),
       pgp(1), rn(1), shar(1), slrnface(1),  tin(1),  xterm(1x),  heapsort(3),
       iconv(3),    iconv_open(3),    nl_langinfo(3),    pcre(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, RFC2980, RFC3977, RFC4155, RFC4643, RFC5322, RFC5536,
       RFC5537, RFC6048

2.2.0                         December 24th, 2013                       tin(5)

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