home | help
TIN(5)				Usenet newsreader			  TIN(5)

NAME
     tin, rtin - related files

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

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

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

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

	    The "type" field is simply any valid 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  mes-
	    sage.  Additionally, the type field may specify a subtype or a wild-
	    card 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.   Fi-
	    nally,  if the field contains "\%", those two characters will be re-
	    placed by a single "%" character.

	    Besides the type and command field the  following  "flags"	are  de-
	    fined:

	    compose
		   The "compose" field may be used to specify a program that can
		   be  used to compose a new body or body part in the given for-
		   mat.  Its intended use is to support  mail  composing  agents
		   that  support the composition of multiple types of mail using
		   external composing agents.  As with the view-command, the se-
		   mantics 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-Trans-
		   fer-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  com-
		   posed data.	The "compose" field is simpler, and is preferred
		   for	use  with existing (non-mail-oriented) programs for com-
		   posing data in a given format.  The "composetyped"  field  is
		   necessary when the Content-Type information must include aux-
		   iliary parameters, and the composition program must then know
		   enough about mail formats to produce output that includes the
		   mail type information.

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

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

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

	    needsterminal
		   The "needsterminal" field  indicates  that  the  view-command
		   must  be  run  on an interactive terminal.  This is needed to
		   inform window-oriented user agents that an interactive termi-
		   nal is needed.  (The decision is not left exclusively to  the
		   view-command because in some circumstances it may not be pos-
		   sible  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	require-
		   ment  for  the  environment in which the program will be exe-
		   cuted, and should typically cause the creation of a	terminal
		   window  when not executed on either a real terminal or a ter-
		   minal 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 needster-
		   minal and copiousoutput are both specified.

	    description
		   The "description" field simply provides  a  textual	descrip-
		   tion,  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) for-
		   mat, which points to an appropriate icon to be used to  visu-
		   ally denote the presence of this kind of data.

	    nametemplate
		   The "nametemplate" field gives a filename format, in which %s
		   will be replaced by a short unique string to give the name of
		   the temporary file to be passed to the viewing command.  This
		   is  only  expected to be relevant in environments where file-
		   name 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",  "nametem-
	    plate" and partly the "needsterminal" flags, all other flags are in-
	    ternally 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

     /usr/local/etc/nntpserver

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

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

	    secret to be used for cancel-locks (RFC 8315)  if  tin(1)  is  built
	    with  support  for it. An empty secret file disables the cancel-lock
	    creation in that case. This file should  be  readable  only  by  the
	    user.

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

	    mime type / filename extension pairs

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

	    "nntpserver[:port]	password [user]" pairs for NNTP servers that re-
	    quire authorization. If the password contains a space or  a  tab  it
	    must  be  enclosed	in  double quotes ("). Usernames must not be en-
	    closed in double quotes and thus can't contain spaces or  tabs.  Any
	    line  that	starts	with  "#" is a comment. Blank lines are ignored.
	    This file should be readable only for the user as  it  contains  the
	    user's unencrypted password for reading news!

	    nntpserver
		   full  qualified domain name of the news server. Additionally,
		   a port can be specified by appending :portnumber.

	    password
		   user's unencrypted password for reading news.

	    user   username on the news server if it differs from the local  lo-
		   gin. 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 sepa-
		   rated  by  commas  with sequential numbers collapsed with hy-
		   phens. Empty lines and lines which start with "#" are ignored
		   and not written back.

	    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/.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,  this  will  be  added
	    first

     ${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 ("mailgroupname maxnum minnum mailspool" quadruples sep-
	    arated  by spaces not tabs) of user's mailgroups (requires tin(1) to
	    be built with mh-mail-handling support).

	    mailgroupname
		   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 high-
		   est message in the mailbox

	    minnum
		   put 0 here

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

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

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

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

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

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

	    The group attributes files may be used to override some global  set-
	    tings  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 spec-
	    ify 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_select
		   Automatically perform the GroupMarkUnselArtRead ('X') command
		   after entering the group.

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

	    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,  otherwise  the
		   user  will  be  asked  whether  to  delete the post-processed
		   files. Automatic processing of marked articles using GroupAu-
		   toSave ('S') will suppress prompting.

	    editor_format
		   Identical to the tinrc variable of the same name

	    extquote_handling
		   Identical to the tinrc variable of the same name

	    fcc    Mailbox to save sent mails. The format of the mailbox is con-
		   trolled 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

	    getart_limit
		   Identical to the tinrc variable of the same name

	    group_catchup_on_exit
		   Identical to the tinrc variable of the same name

	    group_format
		   Identical to the tinrc variable of the same name

	    hide_inline_data
		   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 attach-
		   ment or inline. When set to OFF, the forwarded  article  will
		   be included in the body of the mail, while setting this vari-
		   able  to  ON will cause the article to be attached as a sepa-
		   rate MIME part. Enabling mime_forward is particularly  useful
		   for	articles  consisting  of  multiple  MIME  parts  such as
		   PGP/MIME signed messages or	being  encoded	in  a  different
		   character  set  than your local one. It is also useful if the
		   receiver should be able to operate on  the  entire  forwarded
		   article (i.e., view or save it without your comments). On the
		   other hand, if you want to forward only some parts of the ar-
		   ticle  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 interactive_mailer has to
		   be set to 0 (which is the default).

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

	    news_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  ''Organiza-
		   tion:''. It overrides the setting (if any) of organization in
		   /etc/tin/tin.defaults   and	$ORGANIZATION  (or  $NEWSORG  on
		   Apollo DomainOS). If it points to a readable  file  a  random
		   line from that file will be used. Note that some news servers
		   might still overwrite the ''Organization:'' header.

	    pos_first_unread
		   Identical to the tinrc variable of the same name

	    post_8bit_header
		   Identical to the tinrc variable of the same name

	    post_mime_encoding
		   Identical to the tinrc variable of the same name

	    post_process_type
		   Identical to the tinrc variable of the same name

	    post_process_view
		   Identical to the tinrc variable of the same name

	    print_header
		   Identical to the tinrc variable of the same name

	    process_only_unread
		   Identical to the tinrc variable of the same name

	    prompt_followupto
		   Identical to the tinrc variable of the same name

	    quote_chars
		   Identical to the tinrc variable of the same name

	    savedir
		   Identical to the tinrc variable of the same name

	    savefile

	    show_art_score
		   Identical to the tinrc variable of the same name

	    show_author
		   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 of the same name

	    sort_threads_type
		   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

	    suppress_soft_hyphens
		   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 message
		   body. If this string starts with a / or ~ then it is  assumed
		   to  be  the	name of a file containing the text to insert. If
		   the string starts with a ! then what follows is assumed to be
		   the path to a program to be executed to generate the content.
		   %G is expanded to the current news.group.name and %P  is  ex-
		   panded to the news.group.name with all '.' replaced by '/'.

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

	    x_headers
		   A string including header-name and the contents of the header
		   that will be automatically added when posting. If the  string
		   starts  with  a / or ~ then it is assumed to be the name of a
		   file containing the header and its content to be inserted. If
		   the string starts with a ! then what follows is assumed to be
		   the path to a program to be executed to generate  the  header
		   and	 its   content.   %G   is   expanded   to   the  current
		   news.group.name and %P is  expanded	to  the  news.group.name
		   with all '.' replaced by '/'.

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

	    quick_kill_expire
		   Identical to the tinrc variable default_filter_kill_expire

	    quick_kill_case
		   Identical to the tinrc variable default_filter_kill_case

	    quick_kill_header
		   Identical to the tinrc variable default_filter_kill_header

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

	    quick_select_expire
		   Identical to the tinrc variable default_filter_select_expire

	    quick_select_case
		   Identical to the tinrc variable default_filter_select_case

	    quick_select_header
		   Identical to the tinrc variable default_filter_select_header

	    ispell
		   Path and options for ispell(1)-like spell-checker, e.g., "as-
		   pell --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) or ucnv_*(), oth-
		   ers	 might	 have	to   compile	tin(1)	  with	  --dis-
		   able-mime-strict-charset.

	    undeclared_cs_guess
		   Guess charset for (broken) articles without MIME charset dec-
		   laration.   This attribute works only on systems with working
		   iconv(3) or ucnv_*() and ucsdet_getName() from libicui18n. It
		   has no effect if undeclared_charset is also set.

	    Example:
		   # include extra headers
		   # assume ISO-8859-1 as charset if no charset is declared
		   # in all but fido7.* groups
		   scope=*,!fido7.*
		   x_headers=~/.tin/headers
		   undeclared_charset=ISO-8859-1

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

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

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

		   # in fido7.* newsgroups guess charset
		   scope=fido7.*
		   undeclared_cs_guess=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.
	    The tinrc variables score_limit_kill and score_limit_select are  the
	    limits  that  must	be  crossed  to mark an article as killed or se-
	    lected.  Empty lines or lines beginning with a '#' are ignored. Mul-
	    tiple matching-rules in the same scope are all applied  individually
	    and  not  only  when  they	all hit at the same time (logical OR not
	    AND).

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

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

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

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

	    subj   Match against ''Subject:''. The matching type  used	(wildmat
		   or  regex) depends on the setting of the tinrc variable wild-
		   card.

	    from   Match against ''From:''.  tin(1) converts the contents of the
		   ''From:'' header  to  an  old  style  e-mail  address,  e.g.,
		   ''some@body.example	 (John	Doe)''	instead  of  ''John  Doe
		   <some@body.example>'', before trying to match the patterns in
		   the filter rule. The matching type used  (wildmat  or  regex)
		   depends on the setting of the tinrc variable wildcard.

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

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

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

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

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

	    gnksa  Match against ''From:'' address  parser  return  codes.  <num
		   matches  less  than,  >num matches more than the returned nu-
		   meric value. GNKSA_LOCAL_DOMAIN_LITERAL or  GNKSA_INVALID_DO-
		   MAIN  are  only  returned  if  disable_gnksa_domain_check  in
		   /etc/tin/tin.defaults is set to OFF. As the	built-in  domain
		   list  may  be  outdated  this should be considered carefully.
		   GNKSA_ILLEGAL_LABEL_BEGNUM is only  returned  if  tin(1)  was
		   compiled  with  ENFORCE_RFC1034  defined which is usually not
		   the case.
			   internal codes
			0 GNKSA_OK
			1 GNKSA_INTERNAL_ERROR
			   general syntactical errors
		      100 GNKSA_LANGLE_MISSING
		      101 GNKSA_LPAREN_MISSING
		      102 GNKSA_RPAREN_MISSING
		      103 GNKSA_ATSIGN_MISSING
		      104 GNKSA_RANGLE_MISSING
			   FQDN part syntax and semantics errors
		      200 GNKSA_SINGLE_DOMAIN
		      201 GNKSA_INVALID_DOMAIN
		      202 GNKSA_ILLEGAL_DOMAIN
		      203 GNKSA_UNKNOWN_DOMAIN
		      204 GNKSA_INVALID_FQDN_CHAR
		      205 GNKSA_ZERO_LENGTH_LABEL
		      206 GNKSA_ILLEGAL_LABEL_LENGTH
		      207 GNKSA_ILLEGAL_LABEL_HYPHEN
		      208 GNKSA_ILLEGAL_LABEL_BEGNUM
		      209 GNKSA_BAD_DOMAIN_LITERAL
		      210 GNKSA_LOCAL_DOMAIN_LITERAL
		      211 GNKSA_RBRACKET_MISSING
			   localpart syntactical errors
		      300 GNKSA_LOCALPART_MISSING
		      301 GNKSA_INVALID_LOCALPART
		      302 GNKSA_ZERO_LENGTH_LOCAL_WORD
			   realname part syntactical errors
		      400 GNKSA_ILLEGAL_UNQUOTED_CHAR
		      401 GNKSA_ILLEGAL_QUOTED_CHAR
		      402 GNKSA_ILLEGAL_ENCODED_CHAR
		      403 GNKSA_BAD_ENCODE_SYNTAX
		      404 GNKSA_ILLEGAL_PAREN_CHAR
		      405 GNKSA_INVALID_REALNAME
		      406 GNKSA_MISSING_REALNAME

	    xref   Match against ''Xref:'' line. Before any matching is done the
		   line is turned into the same format ''Newsgroups:''	has:  it
		   is  turned  into  a	comma  separated newsgroup list with all
		   other information (i.e., the article  counter)  removed.  The
		   matching  type used (wildmat or regex) depends on the setting
		   of the tinrc variable wildcard.

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

	    time   time_t value when rule expires

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

		   comment=downscore postings in nsr from google based on
		   comment=message-id or path, if both hit they end up with
		   comment=a score of -66 which is enough to mark them killed
		   group=news.software.readers
		   case=1
		   score=-33
		   path=.googlegroups.com!not-for-mail$
		   msgid_only=@googlegroups.com>

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

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

	    Keymap-file,  containing  "keyname value [value]" pairs separated by
	    spaces or  tabs.  If  the  keymap-file  named  with  full  specified
	    locale(5)  is  not found, less specific ones are looked for. Various
	    parts will be stripped off the name, in the following order codeset,
	    normalized codeset, territory and  modifier  when  looking	for  the
	    keymap-file.   Below  is a list of all rebindable keynames and their
	    defaults. If a keyname is bound to NULL it is unassigned.

	    ShellEscape 		   !
	    SetRange			   #
	    LastPage			   $
	    ToggleColor 		   &
	    LastViewed			   -
	    SearchRepeat		   \
	    SearchSubjF 		   /
	    SearchSubjB 		   ?
	    SearchAuthB 		   A
	    SearchBody			   B
	    CatchupNextUnread		   C
	    EditFilter			   E
	    ToggleHelpDisplay		   H
	    ToggleInverseVideo		   I
	    ConnectionInfo		   J
	    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
	    MarkAncientArtRead		   ^E

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

	    ConfigToggleAttrib		   TAB
	    ConfigSelect		   ^J	^M
	    ConfigLastPage		   G
	    ConfigNoSave		   Q
	    ConfigScopeMenu		   S
	    ConfigServerrcMenu		   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	   *
	    PageArticleInfo		   '
	    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 	   _
	    PageToggleVerbatim		   ,
	    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

	    PostedArticlesSelect	   ^J	^M

	    PostponeOverride		   Y
	    PostponeAll 		   A

	    PromptYes			   y	Y
	    PromptNo			   n	N

	    PProcNone			   n
	    PProcShar			   s
	    PProcYes			   y

	    SaveAppendFile		   a
	    SaveOverwriteFile		   o

	    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
	    ThreadFollowup		   F
	    ThreadMarkArtRead		   K
	    ThreadAutoSave		   S
	    ThreadUntag 		   U
	    ThreadToggleSubjDisplay	   d
	    ThreadFollowupQuote 	   f
	    ThreadMail			   m
	    ThreadSave			   s
	    ThreadTag			   t
	    ThreadTagParts		   T
	    ThreadUndoSel		   ~

	    UrlSelect			   ^J	^M

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

	    This file provides short descriptions of each  mailgroup.  (requires
	    tin(1) to be built 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[:port]	newsrc	[shortname [...]]" pairs to use with the
	    ''-g'' command-line switch. The matching is case-insensitive and any
	    line that starts with "#", ";" or " " is treated as a comment.  This
	    is only available if reading via NNTP.

	    nntpserver
		   full qualified domain name of the news server. Plain IPv6 ad-
		   dress  must	be  enclosed in square brackets. Additionally, a
		   port can be specified by appending :portnumber. Be aware that
		   if a port is given it  will	override  any  port  given  with
		   ''-g''  or  ''-p''  or implied by ''-T'' or ''-k'' or set via
		   $NNTPPORT. The string "default" or "*" acts	as  wildcard  to
		   match any name, such a line should be placed last.

	    newsrc
		   related newsrc. A file specified via ''-f'' has a higher pri-
		   ority.

	    shortname
		   nickname(s)	for  the  nntpserver. Nicknames must not contain
		   ":" and must be unique.

	    Example:
		   # sample newsrctable file
		   news.tin.org .newsrc-tin.org tinorg
		   news.example.org /tmp/nrc-ex example ex
		   [::1]:1119 /tmp/localhost6-1119 lh6
		   # catch all rules should go last
		   # with the more specific one on top
		   *:563 ~/.tin/newsrcs/${NNTPSERVER-localhost}:563/newsrc
		   * ~/.tin/newsrcs/${NNTPSERVER-localhost}/newsrc

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

	    Posting history. The file is written by tin(1) and used by	Display-
	    PostHist  ('W') command. It should not be altered manually. Any line
	    that starts with "#" is a comment.	Blank  lines  are  ignored.  All
	    other  lines  shall  consist of at least four pipe-separated fields,
	    starting with a time stamp "dd-mm-yy", a  single  letter  indicating
	    the  action  which initiated the message, a group name or a mail ad-
	    dress the message was sent to, the subject of the  message	and  op-
	    tionally the messages ''Message-ID'' if known.

     ${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/motd

	    This file is a copy of the servers message of the  day  (MOTD)  mes-
	    sage.   It is automatically created on startup except when using the
	    ''-Q'' command-line option and is unlinked on exit.

     ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER/msglog

	    File to store $NNTPSERVER related info- and error-messages. The file
	    is overwritten on startup and meant for debugging.

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

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

	    group.name
		   is the name of the newsgroup

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

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

	    File  to  store  $NNTPSERVER  related  data  via  a  list  of "vari-
	    able=value" pairs. Currently there are only  a  few  variables,  and
	    some are not meant to be changed by the user. See also ConfigServer-
	    rcMenu ('s') in section "SERVERRC MENU" in tin(1).

	    version
		   Internal version number.

	    add_cmd_line_opts
		   Additional  command line options. Acts like $TINRC but server
		   specific.  Be aware that the file is read after  the  command
		   line  options and may override them.  The allowed options are
		   currently limited to ''-4'', ''-6'', ''-A'', ''-C'',  ''-d'',
		   ''-G  limit'',  ''-k'',  ''-n'', ''-p port'', ''-q'', ''-Q'',
		   ''-t timeout'', ''-T'' and ''-x''.  The default is unset.

	    disabled_nntp_cmds
		   A comma separated list  of  NNTP  commands  which  should  be
		   avoided.   This can be used to work around some buggy servers
		   and usually	should	left  blank.  Switching  off  XHDR  also
		   switches  off HDR and vice versa.  The following commands can
		   be disabled:
		      AUTHINFO SASL
		      CAPABILITIES
		      COMPRESS DEFLATE
		      HDR
		      LIST COUNTS
		      LIST DISTRIB.PATS
		      LIST DISTRIBUTIONS
		      LIST HEADERS
		      LIST MOTD
		      LIST NEWSGROUPS
		      LIST OVERVIEW.FMT
		      LIST SUBSCRIPTIONS
		      LISTGROUP
		      NEWGROUPS
		      NEXT
		      OVER
		      XHDR
		      XOVER
		      XPAT

	    nntp_pipeline_limit
		   Number of pipelined NNTP commands to send. Set to 1 if server
		   does not support pipelining. Default is 50.	Allowed  maximum
		   is 256.

	    cache_overview_files
		   Identical  to  the  tinrc variable of the same name but over-
		   rides it.  Be aware that the serverrc variable  will  not  be
		   promoted  to  the  tinrc, but the tinrc variable will be pro-
		   moted to the serverrc if changed in the OptionMenu ('M').

	    compress_overview_files
		   Identical to the tinrc variable of the same	name  but  over-
		   rides  it.	Be  aware that the serverrc variable will not be
		   promoted to the tinrc, but the tinrc variable  will	be  pro-
		   moted to the serverrc if changed in the OptionMenu ('M').

	    motd_hash
		   Internal  hash  of  the servers MOTD, so displaying it can be
		   skipped if it is unchanged.

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

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

	    At	startup, tin(1) reads in the configuration file. This contains a
	    list of "variable=value" pairs that can be used to configure the way
	    tin(1) works. value strings are limited to 1022 chars  and	will  be
	    discarded if exceeding this limit. If it exists, the global configu-
	    ration  file,  ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc  is read first. After
	    that,   the    user's    own    configuration    file    ${TIN_HOME-
	    DIR:-"$HOME"}/.tin/tinrc is read. The global file is useful for dis-
	    tributing  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.soft-
		   ware.readers -> n.software.readers -> n.s.readers  ->  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. De-
		   fault is ON.

	    art_marked_deleted
		   The	character  used to show that an article was deleted. De-
		   fault is 'D'.

	    art_marked_inrange
		   The character used to show that an article is in a range. De-
		   fault 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-se-
		   lected (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. De-
		   fault 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 accord-
		   ingly.

	    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.

	    attachment_format
		   Format string tin(1) uses for  Attachment  level  representa-
		   tion.  Default is "%t%s%e%c%d".

	    auto_cc_bcc
		   Automatically  put  your  name in the ''Cc:'' (1) or ''Bcc:''
		   (2) field or to both (3) fields when mailing an article.  De-
		   fault is 'No' (0).

	    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.

	    batch_save
		   If set ON articles/threads will be saved in batch  mode  when
		   save  ''-S''  or mail ''-M'', ''-N'' is specified on the com-
		   mand 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.

	    compress_overview_files
		   If	  ON,	  locally    cached    NNTP    overview    files
		   (cache_overview_files)   are   saved   in   compressed   form
		   (RFC  1952).  Useful to reduce local disk space used. Default
		   is OFF.

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

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

	    col_back
		   Standard background color

	    col_extquote
		   Color of quoted text from external sources

	    col_from
		   Color of sender (From:)

	    col_head
		   Color of header-lines

	    col_help
		   Color of help pages

	    col_invers_bg
		   Color of background for inverse text

	    col_invers_fg
		   Color of foreground for inverse text

	    col_markdash
		   Color  of  words emphasized like _this_. See also word_h_dis-
		   play_marks and word_highlight.

	    col_markslash
		   Color of words emphasized like /this/. See  also  word_h_dis-
		   play_marks and word_highlight.

	    col_markstar
		   Color  of  words emphasized like *this*. See also word_h_dis-
		   play_marks and word_highlight.

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

	    col_message
		   Color of status messages in last line

	    col_minihelp
		   Color of mini help menu

	    col_newsheaders
		   Color of actual news header fields

	    col_normal
		   Standard foreground color

	    col_quote
		   Color of quoted lines

	    col_quote2
		   Color of twice quoted lines

	    col_quote3
		   Color of >=3 times quoted lines

	    col_response
		   Color  of  response	counter. This is the text that says "Re-
		   sponse x of y" in the article viewer.

	    col_signature
		   Color of signatures

	    col_score_neg
		   Color of negative score

	    col_score_pos
		   Color of positive score

	    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 certain
			dangerous commands (e.g., Catchup ('c')). Commands  that
			this affects are marked in this manual with '[after con-
			firmation]'.

			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  se-
			lected	(with GroupMarkUnselArtRead ('X') command) arti-
			cles 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 for-
		   mat 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=fil-
		   ter 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.  De-
		   fault 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

	    dont_break_words
		   Do not break long lines inside a word. This	applies  to  the
		   body  except  for  verbatim blocks. See also wrap_column. De-
		   fault is OFF.

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

	    editor_format
		   The format string used to create  the  editor  start  command
		   with  parameters.   Default	is  '%E  +%N %F' with %E=Editor,
		   %N=Linenumber and %F=Filename (e.g.,  /bin/vi  +7  .article).
		   See also $VISUAL and $EDITOR under "ENVIRONMENT" in tin(1)

	    extquote_handling
		   If  ON quotes from external sources will be detected. Default
		   is OFF.

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

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

	    getart_limit
		   If getart_limit is > 0 not more than  the  last  getart_limit
		   articles/group  are	fetched from the server. If getart_limit
		   is < 0 tin(1) will start fetching articles  from  your  first
		   unread  minus  absolute value of getart_limit. Note that set-
		   ting   getart_limit	 to   anything	 except    0	disables
		   cache_overview_files. Default is 0, which means no limit.

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

	    group_catchup_on_exit
		   If ON catchup group when leaving with the left arrow key. De-
		   fault is ON.

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

	    hide_inline_data
		   If  set  to 'Nothing' (0) then raw data is displayed.  If set
		   to 'Complete UU/YENC' (1) then sections of uuencoded or  yenc
		   data  will  be  shown with a single tag line showing the size
		   and filename (much the same as a MIME attachment).  If set to
		   'Any UU/YENC' (2) then any line that looks like uuencoded  or
		   yenc data will be folded into a tag line. This is useful when
		   uuencoded  or yenc data is split across more than one article
		   but can also lead to false positives.  If set to 'Inline PGP'
		   (4) then any inline PGP data is hidden.  If set to 'Shar' (8)
		   then shar-archives are hidden, this should be used with  care
		   as it may hide other shell snippets and any following text as
		   well.  This setting can also be toggled in the article viewer
		   via	PageToggleUue ('(').  Default is 'Nothing' (0). The pos-
		   sible values are:
		       0   Nothing
		       1   Complete UU/YENC
		       2   Any UU/YENC
		       4   Inline PGP
		       5   Complete UU/YENC & Inline PGP
		       6   Any UU/YENC & Inline PGP
		       8   Shar
		       9   Complete UU/YENC & Shar
		      10   Any UU/YENC & Shar
		      12   Inline PGP & Shar
		      13   Compl. UU/YENC & PGP & Shar
		      15   Hide all

	    hideline_regex
		   A regular expression to hide matching lines in  pager.  Could
		   be  used to hide excessive quoting, e.g. via '^>\s?>\s?>'. If
		   left blank, no lines will be hidden. This option does not af-
		   fect lines  within  verbatim  blocks  and  is  applied  after
		   trim_article_body and suppress_soft_hyphens.

	    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) -- ToggleIn-
		   foLastLine  ('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 op-
		   tion has to suit mailer_format. Default is 0.

	    inverse_okay
		   If  ON  use inverse video for page headers and URL highlight-
		   ing.  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.

	    keep_expired_filters
		   If  ON  keep  expired filter rules in the file, but no longer
		   evaluate them.  Default is OFF.

	    kill_level
		   This option controls the processing and display  of	articles
		   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 happens on unread
			 articles with kill_level set  to  0,  art_marked_killed
			 and  art_marked_read_selected are only shown once. When
			 you reenter the group the mark will be gone.

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

		      2  Kill all arts and never show will process all	articles
			 in  the group and therefore there is a processing over-
			 head when using this  option.	Killed	articles  simply
			 does not get displayed at all.

	    mail_8bit_header
		   Allows  8-bit characters unencoded in the header of mail mes-
		   sage. 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
		   (RFC 5322 and RFC 2047).

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

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

	    mail_quote_format
		   Format  of  quote line when replying (via mail) to an article
		   (%A=Address,  %D=Date,   %F=Fullname+Address,   %G=Groupname,
		   %M=Message-ID,  %N=Fullname,  %C=Firstname,	%I=Initials). If
		   the article has multiple addresses, only the first is  evalu-
		   ated. 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 RFC 4155 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
		   mutt(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 pa-
		   rameters that is used for mailing articles to  other  people.
		   Default  is '%M "%T" < %F' (e.g., /bin/mail "iain" < ~/.arti-
		   cle). The flexible format allows other mailers with different
		   command line parameters to be used such as
		      sendmail -oem -t < %F
		      mutt -H %F
		      claws-mail --compose "mailto:%T?subject=%S&insert=%F"
		   interactive_mailer must be set adequate. The  following  sub-
		   stitutions 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
		   PageViewAttach ('V') command can always be used  to	manually
		   view any attachments. See also ask_for_metamail.

	    mm_charset
		   Charset supported locally, which is also used for MIME header
		   (charset  parameter	and  charset name in header encoding) in
		   mail and news postings. If MIME_STRICT_CHARSET is defined  at
		   compile  time,  text  in charset other than the value of this
		   parameter is considered not displayable  and  represented  as
		   '?'. Otherwise, all character sets are regarded as compatible
		   with  the display. If it's not set, the value of the 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) or ucnv_*(), 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)
		   or  ucnv_*().   If  none  of these functions are available on
		   your system this option is  disabled  and  you  have  to  use
		   mm_charset  instead.  mm_network_charset is limited to one of
		   the following charsets:
		      US-ASCII, 	ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16},
		      KOI8-{R,U,RU}	 EUC-{CN,JP,KR,TW},	ISO-2022-{CN,CN-
		      EXT,JP,JP-1,JP-2}, Big5, UTF-8
		   Not all values might work on your system,  see  iconv_open(3)
		   for	more details. If it's not set, the value of the environ-
		   ment 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 de-
		   pends 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 de-
		   pends 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 de-
		   pends 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 de-
		   pends 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  oppo-
		   site.  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_head-
		   ers_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).  If
		   the	article has multiple addresses, only the first is evalu-
		   ated. Default is "%F wrote:".

	    nntp_read_timeout_secs
		   Time in seconds to wait for a response from the  server.  De-
		   fault is 120.

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

		      0  None: no normalization

		      1  NFKC:	Compatibility Decomposition, followed by Canoni-
			 cal Composition

		      2  NFKD: Compatibility Decomposition

		      3  NFC: Canonical  Decomposition,  followed  by  Canonical
			 Composition

		      4  NFD: Canonical Decomposition

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

	    page_mime_format
		   Format string tin(1) uses for mime header at Page level.  De-
		   fault is "[-- %T%S%*n%z%*l%!c%!d%*e --]".

	    page_uue_format
		   Format  string tin(1) uses for uue header at Page level.  De-
		   fault is "[-- %T%S%*n%I%!d%*e --]".

	    page_yenc_format
		   Format string tin(1) uses for yenc header at Page level.  De-
		   fault is "[-- %*N%!d%I [%F%G]%V%W%X --]".

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

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

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

	    post_process_view
		   If  ON,  then tin(1) will start an appropriate viewer program
		   to display any files that were post processed and  uudecoded.
		   The	program is determined using the mailcap(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.

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

	    posted_articles_file
		   Keep  posted  articles  in  given file. If the given filename
		   does not contain any expandable strings it will  be	prefixed
		   with  ${TIN_HOMEDIR:-"$HOME"}/Mail/.  If  no  filename is set
		   then postings will not be saved.  See  the  section	"MAILING
		   PIPING  PRINTING  REPOSTING AND SAVING ARTICLES" for more in-
		   formation about the various expansion characters. 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 out-
		   put. 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  dis-
		   abled by the System Administrator.

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

	    prompt_followupto
		   If  ON show empty ''Followup-To:'' header when editing an ar-
		   ticle.  Default is OFF.

	    quote_chars
		   The character used in quoting included text to  article  fol-
		   lowups and mail replies. The '_' character represents a blank
		   character  and is replaced with ' ' when read, %I is replaced
		   by author's initials. If the article has multiple  addresses,
		   only the first is evaluated. 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 fol-
		   lowing options can be combined by adding all relevant values.
		   Default is 5, which means  that  quote  characters  are  com-
		   pressed and empty lines are quoted.

		      0  Nothing special Non 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.  Signa-
			 tures	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_signa-
			 tures is off.

		      4  Quote empty lines This option is on by default.

	    quote_regex
		   A regular expression that will be applied when reading  arti-
		   cles.   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  arti-
		   cles.   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  arti-
		   cles.   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(1)  does the rendering of bi-directional text. If
		   OFF tin(1) leaves the rendering of bi-directional text to the
		   terminal. Default is OFF.

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

	    scope_marked_global
		   The character used to show that a scope  was  read  from  the
		   global attributes file. Default is '!'.

	    scope_marked_global_match
		   The	character  used  to  show that a scope was read from the
		   global attributes file and the current group matches. Default
		   is ':'.

	    scope_marked_local
		   The character used to show that a scope was read from the lo-
		   cal attributes file. Default is ' '.

	    scope_marked_local_match
		   The character used to show that a scope was read from the lo-
		   cal attributes file and the current group matches. Default is
		   '*'.

	    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  ar-
		   ticle  pager  when  using  cursor-up/down.  The  default is 1
		   (line-by-line). Set to 0 to get traditional	tin(1)	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  sup-
		   ported:
		      %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_art_score
		   If  ON  show article score in the lower left corner when dis-
		   playing articles.  Default is OFF. See also col_score_neg and
		   col_score_pos.

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

	    show_help_mail_sign
		   Allows  you to select whether tin(1) shows a help indication,
		   a new mail indication, both, or neither in the various  level
		   titles.  Default is 3.

		      0  Don't show help or mail sign.

		      1  Show only help sign.

		      2  Show  only  mail  sign  if new mail, show only the mail
			 sign, and only if new mail has arrived.

		      3  Show mail if new mail else help s., show mail	sign  if
			 new mail has arrived otherwise show help sign.

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

	    show_only_unread_groups
		   If ON show only subscribed groups that contain  unread  arti-
		   cles. Default is OFF.

	    show_signatures
		   If  OFF  don't  show signatures when displaying articles. De-
		   fault is ON.

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

	    sigfile
		   The path that specifies the signature file to use when  post-
		   ing,  following  up to or replying to an article. If the path
		   is a directory then the signature will be randomly  generated
		   from  files	that  are  in the specified directory. If a file
		   named  .sigfixed  does  exist  in  that  dir  or  ${TIN_HOME-
		   DIR:-"$HOME"}/.sigfixed  does  exist  it will be prepended to
		   the chosen signature (first match counts). If the path starts
		   with a ! the program the path points to will be  executed  to
		   generate  a signature. In order to pass the group name to the
		   program, %G can be specified.  This will be replaced  by  the
		   name  of the current newsgroup. --none will suppress any sig-
		   nature. Default is  ${TIN_HOMEDIR:-"$HOME"}/.Sig.   See  also
		   ${TIN_HOMEDIR:-"$HOME"}/.sigfixed.

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

	    slashes_regex
		   A  regular expression that will be applied when reading arti-
		   cles. 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 ascend-
		   ing Date (6) is the default. The following sort types are al-
		   lowed:

		      0  Nothing, don't sort articles.

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

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

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

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

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

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

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

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

		      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  al-
		   lowed:

		      0  Nothing, don't sort threads.

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

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

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

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

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

		   spam,delete,remove

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

	    strip_blanks
		   Strips the blanks from the end of each line therefore  speed-
		   ing up the display when reading on a slow terminal or via mo-
		   dem. Default is ON.

	    strip_bogus
		   Bogus  groups are groups that are present in your ${TIN_HOME-
		   DIR:-"$HOME"}/.newsrc file that no longer exist on  the  news
		   server. There are 3 options. 0 means do nothing & always keep
		   bogus  groups.   1 means bogus groups will be permanently re-
		   moved. 2 means that bogus groups will appear on the Group Se-
		   lection Menu, prefixed with a 'D'. This allows you to  unsub-
		   scribe  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.

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

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

	    strokes_regex
		   A  regular expression that will be applied when reading arti-
		   cles. 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 tog-
		   gled in the article viewer via PageToggleTex2iso ('"').

	    thread_articles
		   Defines which threading method to use. The choices are:

		      0  Don't thread

		      1  Thread on Subject only

		      2  Thread on References only

		      3  Thread on References then Subject (default)

		      4  Thread multipart articles on Subject

		      5  Thread on Percentage Match of the Subjects
	    It's also possible to set the threading type on a per group basis by
	    setting the group attribute variable thread_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  sup-
		   ported:
		      %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  sin-
		   gle	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.

	    tls_ca_cert_file
		   The name of file containing all trusted CA certificates  used
		   for	NNTPS  (RFC  8143) connections. If left empty the system
		   default will be used.

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

	    trim_article_body
		   Allows you to select how tin(1) treats blank lines in article
		   bodies.  Default is 0. This	option	does  not  affect  lines
		   within verbatim blocks and is applied before hideline_regex.

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

	    suppress_soft_hyphens
		   If  ON  remove soft hyphens (U+00AD) from non verbatim blocks
		   when displaying articles. Default is OFF.

	    underscores_regex
		   A regular expression that will be applied when reading  arti-
		   cles.  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 posting.
		   Default is ON.

	    url_handler
		   The program that will be run when launching URLs in the arti-
		   cle viewer using PageViewUrl ('U'). The actual  URL	will  be
		   appended.  Default is tinurl_handler.pl.

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

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

	    use_keypad
		   Use scroll keys on keypad. Default is OFF.

	    use_mouse
		   Allows  the	mouse  button  support in an xterm(1x) to be en-
		   abled/disabled.  Default is OFF.

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

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

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

	    verbatim_end_regex
		   A  regular expression that tin(1) will use to find the end of
		   a verbatim block. Default is #v-

	    verbatim_handling
		   Allows you to select how tin(1) treats verbatim blocks in ar-
		   ticle bodies.  Default is 1.

		      0  Don't detect verbatim blocks. Do nothing.

		      1  Detect and show verbatim blocks. Detect and show verba-
			 tim blocks, including begin and end marks.

		      2  Detect, hide begin and end marks. Detect and show  ver-
			 batim blocks, hide begin and end marks.

		      3  Don't	show verbatim blocks. Detect verbatim blocks and
			 hide them completely.

	    wildcard
		   Allows you to select how tin(1) matches strings. The  default
		   is  0 and uses the wildmat(3) notation, which is how this has
		   traditionally been handled.	Setting this to 1 allows you  to
		   use	 perl(1)   compatible  regular	expressions  pcre(3)  or
		   pcre2(3).   (see  also  perlre(1)   and   pcrepattern(3)   or
		   pcre2pattern(3)).  You will probably want to update your fil-
		   ter file if you use this regularly.	NB: Newsgroup names will
		   always be matched using the wildmat(3) 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  speci-
		   fied   in   col_markdash,   col_markslash,  col_markstar  and
		   col_markstroke are used for word highlighting else the  char-
		   acter  attributes specified in mono_markdash, mono_markslash,
		   mono_markstar and mono_markstroke are used. Default is ON.

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

	    wrap_on_next_unread
		   If enabled a search for the next  unread  article  will  wrap
		   around all articles to find also previous unread articles. If
		   disabled  the search stops at the end of the thread list. De-
		   fault 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 con-
	    trolled   via   ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc  and/or  ${TIN_HOME-
	    DIR:-"$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 over-
		   rides any specified value.

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

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

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

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

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

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

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

	    disable_sender
		   Don't generate a ''Sender:'' header. This has an effect  only
		   if inews_prog is set to --internal.

	    spooldir
		   Base  of  your  newsspool  (Bnews,  Cnews and INN traditional
		   spool style), common values are  /var/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
		   or over.view. $TIN_NOVFILENAME overrides any specified value.

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

	    activefile
		   Full  pathname  of your newssystem's active file; usually the
		   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 file resides in newslibdir and is named active.times,  so
		   you	only  have  to change this setting if your configuration
		   differs.

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

	    subscriptionsfile
		   Full  pathname  of your newssystem's subscriptions file; usu-
		   ally the file resides in newslibdir and  is	named  subscrip-
		   tions,  so  you only have to change this setting if your con-
		   figuration differs.

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

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

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

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

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

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

	    name   is the name of the newsgroup

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

	    lowmark
		   is the lowest article number in the group; this number is not
		   guaranteed  to  be accurate, and should only be taken to be a
		   hint. Note that because of article cancellations,  there  may
		   be gaps in the numbering sequence. If the lowest article num-
		   ber	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  ap-
			  proved

		   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 lo-
	    cal spool,	if  you  read  news  via  NNTP,  tin(1)  uses  the  LIST
	    (RFC 3977) or LIST COUNTS (RFC 6048) command instead.

     ${TIN_LIBDIR:-NEWSLIBDIR}/active.times

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

	    name   is the name of the newsgroup

	    time   is the time when the group was created, expressed as the num-
		   ber 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 lo-
	    cal spool, if you read news via  NNTP,  tin(1)  uses  the  NEWGROUPS
	    (RFC 3977) command instead.

     ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups

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

	    group.name
		   is the name of the newsgroup

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

	    tin(1) only tries to read the file if you read directly from the lo-
	    cal spool, if you read news via NNTP, tin(1)  uses	the  LIST  NEWS-
	    GROUPS (RFC 3977) command instead.

     ${TIN_LIBDIR:-NEWSLIBDIR}/organization

	    This  file might hold a default organization to be used in the ''Or-
	    ganization:'' header. $ORGANIZATION has a higher priority if set.

     ${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt

	    This file specifies the organization of the news  overview	database
	    (see  also newsoverview(5)).  The order of lines in this file is im-
	    portant; 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 (RFC 3977)  command  in-
	    stead.

     ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions

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

SEE ALSO
     inews(1),	 ispell(1),   lp(1),   lpr(1),	metamail(1),  mutt(1),	perl(1),
     perlre(1),  pgp(1),  rn(1),  shar(1),   slrnface(1),   tin(1),   xterm(1x),
     heapsort(3),  iconv(3),  iconv_open(3),  nl_langinfo(3), pcre(3), pcre2(3),
     pcrepattern(3),   pcre2pattern(3),   qsort(3),   strftime(3),    system(3),
     active(5),  mailcap(5), mbox(5), mmdf(5), newsoverview(5), overview.fmt(5),
     innd(8), RFC 1524, RFC 1952, RFC  2045,  RFC  2046,  RFC  2047,  RFC  2231,
     RFC  2980,  RFC  3977,  RFC  4155,  RFC 4643, RFC 5198, RFC 5322, RFC 5536,
     RFC 5537, RFC 6048, RFC 6838, RFC 8143, RFC 8315

2.6.5				   2025-12-24				  TIN(5)

home | help