tin(5) Usenet newsreader tin(5)
NAME
tin, rtin - related files
DESCRIPTION
This man page describes the various (config) files and their formats
used by the tin(1) newsreader. All files are expected to have unix
style ('\n' aka LF) line endings.
FILES
$MAILCAPS
~/.mailcap
/etc/mailcap
/usr/etc/mailcap
/usr/local/etc/mailcap
/etc/mail/mailcap
mailcap(5) files as defined in RFC1524. The mailcap files are
read by tin(1) to determine how to display non-text messages at
the local site. Any line that starts with "#" is a comment.
Blank lines are ignored. Otherwise, each line defines a single
mailcap entry for a single content type. Long lines may be con-
tinued by ending them with a backslash character, "\".
Each individual mailcap entry consists of a content-type speci-
fication, a command to execute, and (possibly) a set of optional
"flag" values.
The "type" field is simply any legal content type name. It is
the string that will be matched against the ''Content-Type:''
header to decide if this is the mailcap entry that matches the
current message. Additionally, the type field may specify a sub-
type or a wildcard to match all subtypes.
The "command" field is any UNIX command and is used to specify
the interpreter for the given type of message. It will be passed
to the shell via the system(3) facility.
Semicolons and backslashes within the command or any flag field
must be quoted with backslashes. If the field contains "%s",
those two characters will be replaced by the name of a file that
contains the body of the message. If it contains "%t", those two
characters will be replaced by the content-type field, including
the subtype, if any. If it contains "%{" followed by a parameter
name and a closing "}", then all those characters will be re-
placed by the value of the named parameter, if any, from the
''Content-Type:'' header. Finally, if the field contains "\%",
those two characters will be replaced by a single "%" character.
Besides the type and command field the following "flags" are de-
fined:
compose
The "compose" field may be used to specify a program that
can be used to compose a new body or body part in the
given format. Its intended use is to support mail compos-
ing agents that support the composition of multiple types
of mail using external composing agents. As with the
view-command, the semantics of program execution are op-
erating system dependent. The result of the composing
program may be data that is not yet suitable for mail
transport -- that is, a Content-Transfer-Encoding may
need to be applied to the data.
composetyped
The "composetyped" field is similar to the "compose"
field, but is to be used when the composing program needs
to specify the ''Content-Type:'' header field to be ap-
plied to the composed data. The "compose" field is sim-
pler, and is preferred for use with existing (non-mail-
oriented) programs for composing data in a given format.
The "composetyped" field is necessary when the Con-
tent-Type information must include auxiliary parameters,
and the composition program must then know enough about
mail formats to produce output that includes the mail
type information.
edit The "edit" field may be used to specify a program that
can be used to edit a body or body part in the given for-
mat. In many cases, it may be identical in content to the
"compose" field, and shares the operating-system depen-
dent semantics for program execution.
print The "print" field may be used to specify a program that
can be used to print a message or body part in the given
format. As with the view-command, the semantics of pro-
gram execution are operating system dependent.
test The "test" field may be used to test some external condi-
tion (e.g., the machine architecture, or the window sys-
tem in use) to determine whether or not the mailcap line
applies. It specifies a program to be run to test some
condition. The semantics of execution and of the value
returned by the test program are operating system depen-
dent. If the test fails, a subsequent mailcap entry
should be sought. Multiple test fields are not permitted
-- since a test can call a program, it can already be ar-
bitrarily complex.
needsterminal
The "needsterminal" field indicates that the view-command
must be run on an interactive terminal. This is needed to
inform window-oriented user agents that an interactive
terminal is needed. (The decision is not left exclusively
to the view-command because in some circumstances it may
not be possible for such programs to tell whether or not
they are on interactive terminals.) The needsterminal
command should be assumed to apply to the compose and
edit commands, too, if they exist. Note that this is NOT
a test - it is a requirement for the environment in which
the program will be executed, and should typically cause
the creation of a terminal window when not executed on
either a real terminal or a terminal window.
copiousoutput
The "copiousoutput" field indicates that the output from
the view-command will be an extended stream of output,
and is to be interpreted as advice to the UA (User Agent
mail-reading program) that the output should be either
paged or made scroll-able. Note that it is probably a
mistake if needsterminal and copiousoutput are both spec-
ified.
description
The "description" field simply provides a textual de-
scription, optionally quoted, that describes the type of
data, to be used optionally by mail readers that wish to
describe the data before offering to display it.
textualnewlines
The "textualnewlines" field, if set to any non-zero
value, indicates that this type of data is line-oriented
and that, if encoded in base64, all newlines should be
converted to canonical form (CRLF) before encoding, and
will be in that form after decoding. In general, this
field is needed only if there is line-oriented data of
some type other than text/* or non-line- oriented data
that is a subtype of text.
x11-bitmap
The "x11-bitmap" field names a file, in X11 bitmap (xbm)
format, which points to an appropriate icon to be used to
visually denote the presence of this kind of data.
nametemplate
The "nametemplate" field gives a filename format, in
which %s will be replaced by a short unique string to
give the name of the temporary file to be passed to the
viewing command. This is only expected to be relevant in
environments where filename extensions are meaningful,
e.g., one could specify that a GIF file being passed to a
gif viewer should have a name ending in ".gif" by using
"nametemplate=%s.gif"
tin(1) currently only respects the "test", "description", "name-
template" and partly the "needsterminal" flags, all other flags
are internally ignored. It also can't handle the "%F" and "%n"
expansions yet.
Example:
# mailcap file example
image/*;\
xv -8 -geometry +0 '%s';\
description=%{name} %t-Image;\
test=test "$DISPLAY" != "";\
nametemplate=%s.IMAGE
message/rfc822;\
${PAGER:-"more"} '%s';\
edit=${EDITOR:-"vi"} '%s';\
compose=${EDITOR:-"vi"} '%s';\
print=a2ps '%s';\
needsterminal
/etc/nntpserver
default NNTP-server to read news from if not reading from the
local spool. '-g server', $NNTPSERVER have higher priority (in
that order), the default server given at compile time has lower
priority.
${TIN_HOMEDIR:-"$HOME"}/.cancelsecret
secret to be used for cancel-locks if tin(1) is built with sup-
port for it. An empty secret file disables the cancel-lock cre-
ation in that case. This file should be readable only by the
user.
${TIN_HOMEDIR:-"$HOME"}/.mime.types
/etc/mime.types
/etc/tin/mime.types
mime type / filename extension pairs
${TIN_HOMEDIR:-"$HOME"}/.newsauth
"nntpserver password [user]" pairs for NNTP servers that require
authorization. If the password contains a space or a tab it must
be enclosed in double quotes ("). Usernames must not be enclosed
in double quotes and thus can't contain spaces or tabs. Any line
that starts with "#" is a comment. Blank lines are ignored. This
file should be readable only for the user as it contains the
user's unencrypted password for reading news!
nntpserver
full qualified domain name of the news server.
password
user's unencrypted password for reading news.
user username on the news server if it differs from the local
login. This field is optional.
Example:
# sample .newsauth file
news.example.org secret
news.example.net arcane guest
news.example.com "top secret" james.bond@example.com
${TIN_HOMEDIR:-"$HOME"}/.newsrc
"newsgroupflag [article[,article | -article]...]" lines.
newsgroup
the name of the newsgroup.
flag a flag indicating if the group is subscribed ':' or not
'!'.
article
range of already read articles from that group; numbers
separated by commas with sequential numbers collapsed
with hyphens. 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${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 ("mailgroupname maxnum minnum mailspool" quadruples)
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
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_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
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 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
${TIN_HOMEDIR:-"$HOME"}/.tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
/etc/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. If the keymap-file named with full specified
locale(5) is not found, less specific ones are looked for. Vari-
ous 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 unas-
signed.
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
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
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
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 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 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 com-
ment.
nntpserver
full qualified domain name of the news server. The string
"default" or "*" acts as wildcard to match any name, such
a line should be placed last.
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/newsrcs/${NNTPSERVER-localhost}
${TIN_HOMEDIR:-"$HOME"}/.tin/posted
Posting history. The file is written by tin(1) and used by Dis-
playPostHist ('W') command. It should not be altered manually.
Any line that starts with "#" is a comment. Blank lines are ig-
nored. All other lines shall consist of at least four pipe-sepa-
rated 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 address the message was sent to, the sub-
ject of the message and optionally 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${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.
${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/msglog
File to store $NNTPSERVER and $NNTPPORT related info- and error-
messages. The file is overwritten on startup and meant for de-
bugging.
/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.
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 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_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). See also $VISUAL and $EDITOR under "ENVIRONMENT" in
tin(1)
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
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
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
mutt -s "%S" -- "%T" < %F
mutt -H %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 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 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.
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 built with mh-mail-handling support)
from ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups for mail-
groups. Default is ON.
show_help_mail_sign
Allows you to select whether tin(1) shows a help indica-
tion, a new mail indication, both, or neither in the var-
ious 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_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.
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 possible to set the threading type on a per group ba-
sis 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.
tls_ca_cert_file
The name of file containing all trusted CA certificates
used for NNTPS (RFC8143) 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 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 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
articles. All matching words are shown in col_markdash or
mono_markdash. If underscores_regex is blank, then tin(1)
uses a built-in default.
unlink_article
If ON remove ${TIN_HOMEDIR:-"$HOME"}/.article after post-
ing. Default is ON.
url_handler
The program that will be run when launching URLs in the
article viewer using PageViewUrl ('U'). The actual URL
will be appended. Default is url_handler.pl.
url_highlight
Enable highlighting URLs in message body. Default is ON.
use_color
If enabled tin(1) uses ANSI-colors. Default is OFF.
use_keypad
Use scroll keys on keypad. Default is OFF.
use_mouse
Allows the mouse button support in an xterm(1x) to be en-
abled/disabled. Default is OFF.
use_slrnface
If enabled slrnface(1) will be used to interpret the
''X-Face:'' header. For this option to have any effect,
tin(1) must be running in an xterm(1x) and slrnface(1)
must be in your $PATH. Default is OFF.
utf8_graphics
If ON use UTF-8 characters for indicator ('->'),
thread/attachment tree and ellipsis ('...'). Default is
OFF.
verbatim_begin_regex
A regular expression that tin will use to find the begin
of a verbatim block. Default is #v+
verbatim_end_regex
A regular expression that tin will use to find the end of
a verbatim block. Default is #v-
verbatim_handling
If ON verbatim blocks will be detected. Default is ON.
wildcard
Allows you to select how tin(1) matches strings. The de-
fault is 0 and uses the wildmat(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 filter file if you use this regu-
larly. 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
specified in col_markdash, col_markslash, col_markstar
and col_markstroke are used for word highlighting else
the character attributes specified in mono_markdash,
mono_markslash, mono_markstar and mono_markstroke are
used. Default is ON.
wrap_column
Sets the column at which a displayed article body should
be wrapped. If this value is equal to 0, it defaults to
the current screen width. If this value is greater than
your current screen width the part off-screen is not dis-
played. Thus setting this option to a large value can be
used to disable wrapping. If this value is negative the
wrap margin is the current screen width plus the given
value (as long as the result is still positive, otherwise
it will fall back to the current screen width). Default
is 0, wrapping at the current screen width.
wrap_on_next_unread
If enabled a search for the next unread article will wrap
around all articles to find also previous unread arti-
cles. If disabled the search stops at the end of the
thread list. Default is ON.
xpost_quote_format
Format is the same as for news_quote_format, this is used
when answering to a crossposting to several groups with
no ''Followup-To:'' set.
/etc/tin/tin.defaults
Yet another global configuration file with "variable=value"
pairs. This one is for the more general options which usually
can't be controlled via ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc and/or
${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc like resetting (to override
the built-in default) the newslibdir.
domainname
Sets a global domain name used in From lines
organization
Defines the name of your organization. $ORGANIZATION
overrides any specified value.
newslibdir
Defines the default place for some configuration files,
common values are /usr/lib/news, /var/lib/news, /usr/lo-
cal/lib/news or /news/db. $TIN_LIBDIR overrides any spec-
ified value.
bugaddress
Defines the email address to which users can send bug re-
ports using a built-in function. The default points to a
developers mailing list located at tin.org. You might
want to change this address to one of your local adminis-
tration if you want to deal with your lusers problems on
your own.
inewsdir
Defines the directory containing the inews(1) executable.
mm_charset
Default charset to be used in MIME's ''Content-Type:''
header. $MM_CHARSET overrides any specified value.
post_mime_encoding
Default encoding scheme used in MIME articles. 8bit might
be the best value.
mail_mime_encoding
Default encoding scheme used in MIME letters.
quoted-printable is a good choice here.
disable_gnksa_domain_check
Allow unregistered top level domains. As the list of
valid TLDs is no longer actively maintained the default
was changed to ON starting with tin(1) version 2.1.5
disable_sender
Don't generate a ''Sender:'' header. This has an effect
only if inews_prog is set to --internal.
spooldir
Base of your newsspool (Bnews, Cnews and INN traditional
spool style), common values are /var/spool/news,
/usr/spool/news, /news/spool. $TIN_SPOOLDIR overrides
any specified value.
overviewdir
Base of your NOV database newsoverview(5) (tradspool
style; might be the same dir as spooldir), common values
are /var/spool/overview, /usr/spool/overview, /news/over-
view. $TIN_NOVROOTDIR overrides any specified value.
overviewfile
Name of a single overview file, common values are .over-
view or over.view. $TIN_NOVFILENAME overrides any speci-
fied value.
overviewfmtfile
Full pathname of your newssystem's overview.fmt file;
usually the file residesin newslibdir and is named over-
view.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 configura-
tion 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 ac-
tive.times, so you only have to change this setting if
your configuration differs.
newsgroupsfile
Full pathname of your newssystem's newsgroups file; usu-
ally the file resides in newslibdir and is named news-
groups, so you only have to change this setting if your
configuration differs.
subscriptionsfile
Full pathname of your newssystem's subscriptions file;
usually the file resides in newslibdir and is named sub-
scriptions, 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
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), RFC1524, RFC2045, RFC2046, RFC2047, RFC2048,
RFC2231, RFC2980, RFC3977, RFC4155, RFC4643, RFC5322, RFC5536, RFC5537,
RFC6048, RFC8143
2.6.2 December 24th, 2022 tin(5)