Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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	RFC1524. The mailcap files are
	      read by tin(1) to	determine how to display non-text messages  at
	      the  local  site.	 Any  line  that starts	with "#" is a comment.
	      Blank lines are ignored. Otherwise, each line defines  a	single
	      mailcap  entry for a single content type.	Long lines may be con-
	      tinued by	ending them with a backslash character,	"\".

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

       /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  order), the	default	server given at	compile	time has lower
	      priority.

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

	      secret to	be used	for cancel-locks if tin(1) is build with  sup-
	      port  for	it. An empty secret file disables the cancel-lock cre-
	      ation in that case. This file should be  readable	 only  by  the
	      user.

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

	      mime type	/ filename extension pairs

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

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

	      nntpserver
		     full qualified domain name	of the news server.

	      password
		     user's unencrypted	password for reading news.

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

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

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

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

	      newsgroup
		     the name of the newsgroup.

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

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

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

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

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

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

	      signature

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

	      fixed part of a randomly generated signature

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

	      history of last used strings

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

	      mailgroups index files

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

	      newsgroups index files

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

	      saved newsgroups index files

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

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

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

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

	      minnum put 0 here

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

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

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

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

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

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

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

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

	      add_posted_to_filter
		     Identical to the tinrc variable of	the same name

	      advertising
		     Identical to the tinrc variable of	the same name

	      alternative_handling
		     Identical to the tinrc variable of	the same name

	      ask_for_metamail
		     Identical to the tinrc variable of	the same name

	      auto_cc_bcc
		     Identical to the tinrc variable of	the same name

	      auto_list_thread
		     Identical to the tinrc variable of	the same name

	      auto_save
		     Identical to the tinrc variable of	the same name

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

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

	      date_format
		     Identical to the tinrc variable of	the same name

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

	      editor_format
		     Identical to the tinrc variable of	the same name

	      extquote_handling
		     Identical to the tinrc variable of	the same name

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

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

	      from   Identical to the tinrc variable mail_address

	      group_catchup_on_exit
		     Identical to the tinrc variable of	the same name

	      group_format
		     Identical to the tinrc variable of	the same name

	      mail_8bit_header
		     Identical to the tinrc variable of	the same name

	      mail_mime_encoding
		     Identical to the tinrc variable of	the same name

	      maildir
		     Identical to the tinrc variable of	the same name

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

	      mark_ignore_tags
		     Identical to the tinrc variable of	the same name

	      mark_saved_read
		     Identical to the tinrc variable of	the same name

	      mime_forward
		     Determines	whether	usenet articles	are forwarded  as  at-
		     tachment  or inline. When set to OFF, the forwarded arti-
		     cle will be included in the body of the mail, while  set-
		     ting this variable	to ON will cause the article to	be at-
		     tached as a separate MIME part. Enabling mime_forward  is
		     particularly  useful  for articles	consisting of multiple
		     MIME parts	such as	PGP/MIME signed	messages or being  en-
		     coded  in	a different character set than your local one.
		     It	is also	useful if the receiver should be able to oper-
		     ate  on  the entire forwarded article (i.e., view or save
		     it	without	your comments).	On the other hand, if you want
		     to	 forward  only	some parts of the article or to	insert
		     'inline' annotations, you might want to disable this  op-
		     tion.  Currently mime_forward is forced if	the article to
		     be	attached is a multipart	MIME article, this may	change
		     in	a future version.  Please note that for	this option to
		     have effect, the tinrc variable interactive_mailer	has to
		     be	set to 0 (which	is the default).

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

	      news_headers_to_display
		     Identical to the tinrc variable of	the same name

	      news_headers_to_not_display
		     Identical to the tinrc variable of	the same name

	      news_quote_format
		     Identical to the tinrc variable of	the same name

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

	      pos_first_unread
		     Identical to the tinrc variable of	the same name

	      post_8bit_header
		     Identical to the tinrc variable of	the same name

	      post_mime_encoding
		     Identical to the tinrc variable of	the same name

	      post_process_type
		     Identical to the tinrc variable of	the same name

	      post_process_view
		     Identical to the tinrc variable of	the same name

	      print_header
		     Identical to the tinrc variable of	the same name

	      process_only_unread
		     Identical to the tinrc variable of	the same name

	      prompt_followupto
		     Identical to the tinrc variable of	the same name

	      quote_chars
		     Identical to the tinrc variable of	the same name

	      savedir
		     Identical to the tinrc variable of	the same name

	      savefile

	      show_author
		     Identical to the tinrc variable of	the same name

	      show_info
		     Identical to the tinrc variable of	the same name

	      show_only_unread_arts
		     Identical to the tinrc variable of	the same name

	      show_signatures
		     Identical to the tinrc variable of	the same name

	      sigdashes
		     Identical to the tinrc variable of	the same name

	      sigfile
		     Identical to the tinrc variable of	the same name

	      signature_repost
		     Identical to the tinrc variable of	the same name

	      sort_article_type
		     Identical to the tinrc variable sort_article_type

	      sort_threads_type
		     Identical to the tinrc variable of	the same name

	      start_editor_offset
		     Identical to the tinrc variable of	the same name

	      tex2iso_conv
		     Identical to the tinrc variable of	the same name

	      thread_articles
		     Identical to the tinrc variable of	the same name

	      thread_catchup_on_exit
		     Identical to the tinrc variable of	the same name

	      thread_format
		     Identical to the tinrc variable of	the same name

	      thread_perc
		     Identical to the tinrc variable of	the same name

	      trim_article_body
		     Identical to the tinrc variable of	the same name

	      verbatim_handling
		     Identical to the tinrc variable of	the same name

	      wrap_on_next_unread
		     Identical to the tinrc variable of	the same name

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

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

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

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

	      quick_kill_expire
		     Identical	to  the	tinrc variable default_filter_kill_ex-
		     pire

	      quick_kill_case
		     Identical to the tinrc variable default_filter_kill_case

	      quick_kill_header
		     Identical	 to   the    tinrc    variable	  default_fil-
		     ter_kill_header

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

	      quick_select_expire
		     Identical to the tinrc variable default_filter_select_ex-
		     pire

	      quick_select_case
		     Identical	 to   the  tinrc  variable  default_filter_se-
		     lect_case

	      quick_select_header
		     Identical	to  the	 tinrc	 variable   default_filter_se-
		     lect_header

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

	      mm_network_charset
		     Identical to the tinrc variable of	the same name

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

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

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

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

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

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

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

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

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

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

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

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

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

	      subj   Match against ''Subject:''. The matching type used	(wild-
		     mat or regex) depends on the setting of the  tinrc	 vari-
		     able wildcard.

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

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

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

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

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

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

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

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

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

	      time   time_t value when rule expires

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

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

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

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

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

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

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

	      FilterEdit		     e
	      FilterSave		     s

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

	      HelpLastPage		     G
	      HelpFirstPage		     g

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

	      PgpEncSign		     b
	      PgpEncrypt		     e
	      PgpIncludekey		     i
	      PgpSign			     s

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

	      PostponeOverride		     Y
	      PostponeAll		     A

	      PromptYes			     y	  Y
	      PromptNo			     n	  N

	      SaveAppendFile		     a
	      SaveOverwriteFile		     o

	      PProcNone			     n
	      PProcShar			     s
	      PProcYes			     y

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

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

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

	      UrlSelect			     ^J	  ^M

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

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

	      mailgroupname
		     is	the name of the	newsgroup

	      description
		     is	a short	single-line description	of the group

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

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

	      nntpserver
		     full qualified domain name	of the news server.

	      newsrc related newsrc.

	      shortname
		     nickname(s) for the nntpserver.

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

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

	      posting history

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

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

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

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

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

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

	      group.name
		     is	the name of the	newsgroup

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

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

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

	      version
		     Internal version number.

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

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

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

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

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

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

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

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

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

	      art_marked_return
		     The character used	to show	that an	article	will return as
		     an	unread article when the	group is next entered. Default
		     is	'-'.

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

	      art_marked_recent
		     The  character used to show that an article/thread	is re-
		     cent (not older than X days). See also  recent_time.  De-
		     fault is 'o'.

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

	      art_marked_read
		     The character used	to show	that an	article	was read.  De-
		     fault is '	'.

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

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

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

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

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

	      auto_reconnect
		     Reconnect to server automatically.	Default	is OFF.

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

	      batch_save
		     If	 set  ON  articles/threads will	be saved in batch mode
		     when save ''-S'' or mail ''-M, -N'' is specified  on  the
		     command line. Default is ON.

	      beginner_level
		     If	set ON a mini menu of the most useful commands will be
		     displayed at the bottom of	the  screen  for  each	level.
		     Also  a  short  posting etiquette will be displayed after
		     composing an article. Default is ON.

	      cache_overview_files
		     If	ON, create local copies	of NNTP	overview  files.  This
		     can  be  used  to	considerably  speed up accessing large
		     groups when using a slow connection.  Default is OFF.

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

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

	      col_back
		     Standard background color

	      col_extquote
		     Color of quoted text from external	sources

	      col_from
		     Color of sender (From:)

	      col_head
		     Color of header-lines

	      col_help
		     Color of help pages

	      col_invers_bg
		     Color of background for inverse text

	      col_invers_fg
		     Color of foreground for inverse text

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

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

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

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

	      col_message
		     Color of status messages in last line

	      col_minihelp
		     Color of mini help	menu

	      col_newsheaders
		     Color of actual news header fields

	      col_normal
		     Standard foreground color

	      col_quote
		     Color of quoted lines

	      col_quote2
		     Color of twice quoted lines

	      col_quote3
		     Color of >=3 times	quoted lines

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

	      col_signature
		     Color of signatures

	      col_urls
		     Color of urls highlight

	      col_verbatim
		     Color of verbatim blocks

	      col_subject
		     Color of article subject

	      col_text
		     Color of text-lines

	      col_title
		     Color of help/mail	sign

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

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

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

	      date_format
		     Format string used	for date representation. A description
		     of	 the  different	 format	 options  can  be   found   at
		     strftime(3).   tin(1) uses	strftime(3) when available and
		     supports most format options in his fallback  code.   De-
		     fault is "%a, %d %b %Y %H:%M:%S".

	      default_art_search

	      default_author_search

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

	      default_filter_days
		     Default is	28.

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

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

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

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

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

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

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

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

	      default_goto_group

	      default_group_search

	      default_mail_address

	      default_move_group

	      default_pattern

	      default_pipe_command

	      default_post_newsgroups

	      default_post_subject

	      default_range_group

	      default_range_select

	      default_range_thread

	      default_repost_group

	      default_save_file

	      default_save_mode

	      default_select_pattern

	      default_shell_command

	      default_subject_search

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

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

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

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

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

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

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

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

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

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

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

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

	      interactive_mailer
		     If	greater	than 0 your mailreader will be invoked earlier
		     for reply so you can use more of its features (e.g. MIME,
		     pgp, ...).	1 means	include	headers, 2 means don't include
		     headers (old use_mailreader_i=ON option). 0 turns off us-
		     age. This option has to suit mailer_format. Default is 0.

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

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

	      kill_level
		     This option controls the processing and display of	 arti-
		     cles  that	 are killed. There are 3 options, default is 0
		     (Kill only	unread arts).

			0  Kill	only unread arts is the	'traditional' behavior
			   of  tin(1).	 Only  unread articles are killed once
			   only	by marking them	read. As filtering  only  hap-
			   pens	 on  unread articles with kill_level set to 0,
			   art_marked_killed and art_marked_read_selected  are
			   only	 shown	once.  When  you reenter the group the
			   mark	will be	gone.

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

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

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

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

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

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

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

	      maildir
		     The  directory  where articles/threads are	to be saved in
		     mbox(5) format. This feature is mainly for	use  with  the
		     elm(1)  mail  program.  It	 allows	the user to save arti-
		     cles/threads/groups simply	by giving '=' as the  filename
		     to	save to.  Default is ${TIN_HOMEDIR:-"$HOME"}/Mail.

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

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

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

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

	      mm_charset
		     Charset  supported	 locally,  which is also used for MIME
		     header (charset parameter and charset name	in header  en-
		     coding) in	mail and news postings.	If MIME_STRICT_CHARSET
		     is	defined	at compile time, text in  charset  other  than
		     the value of this parameter is considered not displayable
		     and represented as	'?'. Otherwise,	all character sets are
		     regarded as compatible with the display. If it's not set,
		     the value of  the	environment  variable  $MM_CHARSET  is
		     used.  US-ASCII  or  compile-time default is used in case
		     neither of	them  is  defined.  If	your  system  supports
		     iconv(3),	this  option  is  disabled  and	you should use
		     mm_network_charset	instead.

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

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

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

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

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

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

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

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

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

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

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

			0  None: no normalization

			1  NFKC:   Compatibility  Decomposition,  followed  by
			   Canonical Composition

			2  NFKD: Compatibility Decomposition

			3  NFC:	Canonical Decomposition, followed by Canonical
			   Composition

			4  NFD:	Canonical Decomposition

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

	      pos_first_unread
		     If	ON put cursor at first unread article in group	other-
		     wise at last article. Default is ON.

	      post_8bit_header
		     Allows  8bit characters unencoded in the header of	a news
		     article, if set this  also	 disables  the	generation  of
		     MIME-headers  when	 they are usually required. Default is
		     OFF. Only enacted if post_mime_encoding is	 also  set  to
		     8bit. In a	number of local	hierarchies where 8bit charac-
		     ters are used, using unencoded (raw) 8bit	characters  in
		     header  is	 acceptable  and sometimes even	recommended so
		     that you need to check the	convention adopted in the  lo-
		     cal  hierarchy  of	 your interest to determine what to do
		     with this and post_mime_encoding.

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

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

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

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

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

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

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

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

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

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

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

	      quote_chars
		     The  character  used  in quoting included text to article
		     followups and mail	replies. The '_' character  represents
		     a	blank character	and is replaced	with ' ' when read, %I
		     is	replaced by author's initials. Default is '>_'.

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

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

			2  Quote  Signatures  This  option  is off by default.
			   Signatures are always quoted	regardless of this op-
			   tion	 when  you  are	viewing	an article in raw mode
			   PageToggleRaw ('^H')	and followup or	reply  to  it.
			   Signatures  are never quoted	regardless of this op-
			   tion	when show_signatures is	off.

			4  Quote empty lines This option is on by default.

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

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

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

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

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

	      reread_active_file_secs
		     The    news     ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE-
		     FILE:-active} file	is reread at regular intervals to show
		     if	any new	news has arrived.  Default  is	1200.  Setting
		     this to 0 will disable this feature.

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

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

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

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

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

	      scroll_lines
		     The number	of lines that will be scrolled up/down in  the
		     article pager when	using cursor-up/down. The default is 1
		     (line-by-line). Set to 0 to get traditional tin  page-by-
		     page  scrolling.  Set to -1 to get	page-by-page scrolling
		     where the top/bottom line is carried over onto  the  next
		     page.	     This	   setting	    supersedes
		     show_last_line_prev_page=ON. Set to -2 to	get  half-page
		     scrolling.	This setting supersedes	full_page_scroll=OFF.

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

	      sort_function
		     Function used for sorting articles. Default is 0.

		   0  Use qsort(3) for sorting.

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

	      show_author
		     Which  information	 about the author should be shown. De-
		     fault is 2, authors full name.

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

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

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

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

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

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

			0  None, no information	will be	displayed.

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

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

			3  Lines & Score, display line count and score.

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

	      show_only_unread_groups
		     If	ON show	only subscribed	groups that contain unread ar-
		     ticles. Default is	OFF.

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

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

	      sigfile
		     The path that specifies the signature file	 to  use  when
		     posting,  following  up  to or replying to	an article. If
		     the path is a directory then the signature	will  be  ran-
		     domly  generated from files that are in the specified di-
		     rectory. If the path starts with a	! the program the path
		     points  to	 will  be executed to generate a signature. In
		     order to pass the group name to the program,  %G  can  be
		     specified.	 This will be replaced by the name of the cur-
		     rent newsgroup. --none will suppress any signature.   De-
		     fault is ${TIN_HOMEDIR:-"$HOME"}/.Sig.

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

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

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

			0  Nothing, don't sort articles.

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

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

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

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

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

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

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

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

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

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

	      sort_threads_type
		     This specifies how	threads	will be	sorted.	 Sort  by  de-
		     scending  Score  (1)  is  the default. The	following sort
		     types are allowed:

			0  Nothing, don't sort threads.

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

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

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

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

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

		     spam,delete,remove

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

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

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

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

	      strip_newsrc
		     If	ON, then unsubscribed groups will be  permanently  re-
		     moved from	your ${TIN_HOMEDIR:-"$HOME"}/.newsrc file. De-
		     fault is OFF.

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

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

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

	      tex2iso_conv
		     Decode  German  style TeX umlaut codes to ISO If ON, show
		     "a	as Umlaut-a, etc. Default is OFF.  This	 behavior  can
		     also  be  toggled	in  the	article	viewer via PageToggle-
		     Tex2iso ('"').

	      thread_articles
		     Defines which threading method to use. The	 choices  are:
		     0)	 Don't	thread,	1) Thread on Subject only 2) Thread on
		     References	only, 3) Thread	 on  References	 then  Subject
		     (default)	4)  Thread  multipart articles on Subject.  5)
		     Thread on Percentage Match	of the Subjects	It's also pos-
		     sible  to	set the	threading type on a per	group basis by
		     setting the group attribute variable thread_articles to 0
		     - 5 in the	file ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes.

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

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

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

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

			0  Max,	the maximum score in this thread.

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

			2  Average, the	average	score in this thread.

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

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

			0  Don't trim article body, do nothing.

			1  Skip	leading	blank lines.

			2  Skip	trailing blank lines.

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

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

			5  Compact multiple and	skip leading, 4	+ 1

			6  Compact multiple and	skip trailing, 4 + 2

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

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

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

	      url_handler
		     The program that will be run when launching URLs  in  the
		     article  viewer  using  PageViewUrl ('U').	The actual URL
		     will be appended.	Default	is 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/attachment	tree  and ellipsis ('...'). Default is
		     OFF.

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

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

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

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

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

			0  no

			1  yes,	display	mark

			2  print a space instead

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

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

	      wrap_on_next_unread
		     If	enabled	a search for the next unread article will wrap
		     around  all  articles  to find also previous unread arti-
		     cles. If disabled the search stops	 at  the  end  of  the
		     thread list. Default is ON.

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

       /etc/tin/tin.defaults

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

	      domainname
		     Sets a global domain name used in From lines

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

	      name   is	the name of the	newsgroup

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

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

	      flags  can be one	of those

		     y	    local postings are allowed

		     n	    no local postings are allowed, only	remote ones

		     m	    the	 group	is  moderated and all postings must be
			    approved

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

		     x	    articles cannot be posted to this newsgroup

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

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

       ${TIN_LIBDIR:-NEWSLIBDIR}/active.times

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

	      name   is	the name of the	newsgroup

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

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

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

       ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups

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

	      group.name
		     is	the name of the	newsgroup

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

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

       ${TIN_LIBDIR:-NEWSLIBDIR}/organization

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

       ${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt

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

       ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions

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

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

2.4.5			      December 24th, 2020			tin(5)

NAME | DESCRIPTION | FILES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=tin&sektion=5&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help