1tin(5) Usenet newsreader tin(5)
2
6 tin, rtin - related files
7
10 This man page describes the various (config) files and their formats
11 used by the tin(1) newsreader. All files are expected to have unix
12 style ('\n' aka LF) line endings.
13
16 $MAILCAPS
17 ~/.mailcap
18 /etc/mailcap
19 /usr/etc/mailcap
20 /usr/local/etc/mailcap
21 /etc/mail/mailcap
22 mailcap(5) files as defined in RFC1524. The mailcap files are
24 read by tin(1) to determine how to display non-text messages at
25 the local site. Any line that starts with "#" is a comment.
26 Blank lines are ignored. Otherwise, each line defines a single
27 mailcap entry for a single content type. Long lines may be con‐
28 tinued by ending them with a backslash character, "\".
29 Each individual mailcap entry consists of a content-type speci‐
31 fication, a command to execute, and (possibly) a set of optional
32 "flag" values.
33 The "type" field is simply any legal content type name. It is
35 the string that will be matched against the ''Content-Type:''
36 header to decide if this is the mailcap entry that matches the
37 current message. Additionally, the type field may specify a sub‐
38 type or a wildcard to match all subtypes.
39 The "command" field is any UNIX command and is used to specify
41 the interpreter for the given type of message. It will be passed
42 to the shell via the system(3) facility.
43 Semicolons and backslashes within the command or any flag field
45 must be quoted with backslashes. If the field contains "%s",
46 those two characters will be replaced by the name of a file that
47 contains the body of the message. If it contains "%t", those two
48 characters will be replaced by the content-type field, including
49 the subtype, if any. If it contains "%{" followed by a parameter
50 name and a closing "}", then all those characters will be
51 replaced by the value of the named parameter, if any, from the
52 ''Content-Type:'' header. Finally, if the field contains "\%",
53 those two characters will be replaced by a single "%" character.
54 Besides the type and command field the following "flags" are
56 defined:
57 compose
59 The "compose" field may be used to specify a program that
60 can be used to compose a new body or body part in the
61 given format. Its intended use is to support mail compos‐
62 ing agents that support the composition of multiple types
63 of mail using external composing agents. As with the
64 view-command, the semantics of program execution are
65 operating system dependent. The result of the composing
66 program may be data that is not yet suitable for mail
67 transport — that is, a Content-Transfer-Encoding may need
68 to be applied to the data.
69 composetyped
71 The "composetyped" field is similar to the "compose"
72 field, but is to be used when the composing program needs
73 to specify the ''Content-Type:'' header field to be
74 applied to the composed data. The "compose" field is sim‐
75 pler, and is preferred for use with existing (non-mail-
76 oriented) programs for composing data in a given format.
77 The "composetyped" field is necessary when the Con‐
78 tent-Type information must include auxiliary parameters,
79 and the composition program must then know enough about
80 mail formats to produce output that includes the mail
81 type information.
82 edit The "edit" field may be used to specify a program that
84 can be used to edit a body or body part in the given for‐
85 mat. In many cases, it may be identical in content to the
86 "compose" field, and shares the operating-system depen‐
87 dent semantics for program execution.
88 print The "print" field may be used to specify a program that
90 can be used to print a message or body part in the given
91 format. As with the view-command, the semantics of pro‐
92 gram execution are operating system dependent.
93 test The "test" field may be used to test some external condi‐
95 tion (e.g., the machine architecture, or the window sys‐
96 tem in use) to determine whether or not the mailcap line
97 applies. It specifies a program to be run to test some
98 condition. The semantics of execution and of the value
99 returned by the test program are operating system depen‐
100 dent. If the test fails, a subsequent mailcap entry
101 should be sought. Multiple test fields are not permitted
102 — since a test can call a program, it can already be
103 arbitrarily complex.
104 needsterminal
106 The "needsterminal" field indicates that the view-command
107 must be run on an interactive terminal. This is needed to
108 inform window-oriented user agents that an interactive
109 terminal is needed. (The decision is not left exclusively
110 to the view-command because in some circumstances it may
111 not be possible for such programs to tell whether or not
112 they are on interactive terminals.) The needsterminal
113 command should be assumed to apply to the compose and
114 edit commands, too, if they exist. Note that this is NOT
115 a test - it is a requirement for the environment in which
116 the program will be executed, and should typically cause
117 the creation of a terminal window when not executed on
118 either a real terminal or a terminal window.
119 copiousoutput
121 The "copiousoutput" field indicates that the output from
122 the view-command will be an extended stream of output,
123 and is to be interpreted as advice to the UA (User Agent
124 mail-reading program) that the output should be either
125 paged or made scroll-able. Note that it is probably a
126 mistake if needsterminal and copiousoutput are both spec‐
127 ified.
128 description
130 The "description" field simply provides a textual
131 description, optionally quoted, that describes the type
132 of data, to be used optionally by mail readers that wish
133 to describe the data before offering to display it.
134 textualnewlines
136 The "textualnewlines" field, if set to any non-zero
137 value, indicates that this type of data is line-oriented
138 and that, if encoded in base64, all newlines should be
139 converted to canonical form (CRLF) before encoding, and
140 will be in that form after decoding. In general, this
141 field is needed only if there is line-oriented data of
142 some type other than text/* or non-line- oriented data
143 that is a subtype of text.
144 x11-bitmap
146 The "x11-bitmap" field names a file, in X11 bitmap (xbm)
147 format, which points to an appropriate icon to be used to
148 visually denote the presence of this kind of data.
149 nametemplate
151 The "nametemplate" field gives a filename format, in
152 which %s will be replaced by a short unique string to
153 give the name of the temporary file to be passed to the
154 viewing command. This is only expected to be relevant in
155 environments where filename extensions are meaningful,
156 e.g., one could specify that a GIF file being passed to a
157 gif viewer should have a name ending in ".gif" by using
158 "nametemplate=%s.gif"
159 tin(1) currently only respects the "test", "description", "name‐
161 template" and partly the "needsterminal" flags, all other flags
162 are internally ignored. It also can't handle the "%F" and "%n"
163 expansions yet.
164 Example:
166 # mailcap file example
167 image/*;\
168 xv -8 -geometry +0 '%s';\
169 description=%{name} %t-Image;\
170 test=test "$DISPLAY" != "";\
171 nametemplate=%s.IMAGE
172 message/rfc822;\
174 ${PAGER:-"more"} '%s';\
175 edit=${EDITOR:-"vi"} '%s';\
176 compose=${EDITOR:-"vi"} '%s';\
177 print=a2ps '%s';\
178 needsterminal
179 /etc/nntpserver
181 default NNTP-server to read news from if not reading from the
183 local spool. '-g server', $NNTPSERVER have higher priority (in
184 that order), the default server given at compile time has lower
185 priority.
186 ${TIN_HOMEDIR:-"$HOME"}/.cancelsecret
188 secret to be used for cancel-locks if tin(1) is build with sup‐
190 port for it. An empty secret file disables the cancel-lock cre‐
191 ation in that case. This file should be readable only by the
192 user.
193 ${TIN_HOMEDIR:-"$HOME"}/.mime.types
195 /etc/mime.types
196 /etc/tin/mime.types
197 mime type / filename extension pairs
199 ${TIN_HOMEDIR:-"$HOME"}/.newsauth
201 "nntpserver password [user]" pairs for NNTP servers that require
203 authorization. If the password contains a space or a tab it must
204 be enclosed in double quotes ("). Usernames must not be enclosed
205 in double quotes and thus can't contain spaces or tabs. Any line
206 that starts with "#" is a comment. Blank lines are ignored. This
207 file should be readable only for the user as it contains the
208 user's unencrypted password for reading news!
209 nntpserver
211 full qualified domain name of the news server.
212 password
214 user's unencrypted password for reading news.
215 user username on the news server if it differs from the local
217 login. This field is optional.
218 Example:
220 # sample .newsauth file
221 news.example.org secret
222 news.example.net arcane guest
223 news.example.com "top secret" james.bond@example.com
224 ${TIN_HOMEDIR:-"$HOME"}/.newsrc
226 "newsgroupflag [article[,article | -article]...]" lines.
228 newsgroup
230 the name of the newsgroup.
231 flag a flag indicating if the group is subscribed ':' or not
233 '!'.
234 article
236 range of already read articles from that group; numbers
237 separated by commas with sequential numbers collapsed
238 with hyphens.
239 Example:
241 # sample .newsrc file
242 news.software.b! 1-666,669
243 news.software.nntp: 1-13245,13247,13249
244 news.software.readers: 1-19567,19571-19597
245 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/.oldnewsrc
247 backup of ${TIN_HOMEDIR:-"$HOME"}/.newsrc
249 ${TIN_HOMEDIR:-"$HOME"}/.signature
251 ${TIN_HOMEDIR:-"$HOME"}/.Sig
252 signature
254 ${TIN_HOMEDIR:-"$HOME"}/.sigfixed
256 fixed part of a randomly generated signature
258 ${TIN_HOMEDIR:-"$HOME"}/.tin/.inputhistory
260 history of last used strings
262 ${TIN_INDEX_MAILDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.mail/
264 mailgroups index files
266 ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news${NNTPSERVER:+"-$NNTPSERVER"}/
268 newsgroups index files
270 ${TIN_INDEX_SAVEDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.save/
272 saved newsgroups index files
274 ${TIN_HOMEDIR:-"$HOME"}/.tin/active.mail
276 active file ("mail_group_name maxnum minnum mailspool" quadru‐
278 ples) of user's mailgroups (requires tin(1) to be build with mh-
279 mail-handling support).
280 mail_group_name
282 must be the pathname of the mailbox relative to field #4
283 with / changed to .
284 maxnum just put a large number here, something higher than the
286 highest message in the mailbox
287 minnum put 0 here
289 mailspool
291 path of mail spool directory. This must be the full path‐
292 name to the root of the mail folder area.
293 Example:
295 Mail.inbox 12345 00000 /home/foo
296 Mail.outbox 23456 00000 /home/foo
297 This allows access to the 'inbox' and 'outbox' folders of user
299 foo. They are accessed via /home/foo/Mail/inbox and
300 /home/foo/Mail/outbox
301 ${TIN_HOMEDIR:-"$HOME"}/.tin/active.save
303 active file of user's saved newsgroups, used by tin -R.
305 /etc/tin/attributes
307 ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes
308 The group attributes files may be used to override some global
310 settings from ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc on a per group
311 basis. Order is important as last match counts; this allows one
312 to refine attributes for narrowed scopes. Note that the
313 scope=<grouplist> line has to be specified before the attributes
314 are specified for that list and each attribute can only be set
315 once per scope section. All attributes are set to a reasonable
316 default so you only have to specify the attribute that you want
317 to change. All toggle attributes are set by specifying ON/OFF.
318 Otherwise, they function exactly as their global equivalents.
319 The following group attributes are available:
320 scope This changes the list of groups to which the attributes
322 that follow will be applied. See the section NEWSGROUP
323 LISTS & WILDCARDS in tin(1) for the types of pattern that
324 can be used here.
325 add_posted_to_filter
327 Identical to the tinrc variable of the same name
328 advertising
330 Identical to the tinrc variable of the same name
331 alternative_handling
333 Identical to the tinrc variable of the same name
334 ask_for_metamail
336 Identical to the tinrc variable of the same name
337 auto_cc_bcc
339 Identical to the tinrc variable of the same name
340 auto_list_thread
342 Identical to the tinrc variable of the same name
343 auto_save
345 Identical to the tinrc variable of the same name
346 auto_select
348 Automatically perform the GroupMarkUnselArtRead ('X')
349 command after entering the group.
350 batch_save
352 Can be used to override the global setting in tinrc on a
353 per group basis. For more information read section AUTO‐
354 MATIC MAILING AND SAVING NEW NEWS in tin(1).
355 date_format
357 Identical to the tinrc variable of the same name
358 delete_tmp_files
360 If this is set to ON, then saved article files that have
361 been post-processed will be automatically deleted, other‐
362 wise the user will be asked whether to delete the post-
363 processed files. Automatic processing of marked articles
364 using GroupAutoSave ('S') will suppress prompting.
365 editor_format
367 Identical to the tinrc variable of the same name
368 extquote_handling
370 Identical to the tinrc variable of the same name
371 fcc Mailbox to save sent mails. The format of the mailbox is
373 controlled via the tinrc mailbox_format variable.
374 followup_to
376 Set ''Followup-To:'' header to the specified group(s).
377 from Identical to the tinrc variable mail_address
379 group_catchup_on_exit
381 Identical to the tinrc variable of the same name
382 group_format
384 Identical to the tinrc variable of the same name
385 mail_8bit_header
387 Identical to the tinrc variable of the same name
388 mail_mime_encoding
390 Identical to the tinrc variable of the same name
391 maildir
393 Identical to the tinrc variable of the same name
394 mailing_list
396 Used when a group is a mailing list. All responses to the
397 group will be directed to this email address instead
398 mark_ignore_tags
400 Identical to the tinrc variable of the same name
401 mark_saved_read
403 Identical to the tinrc variable of the same name
404 mime_forward
406 Determines whether usenet articles are forwarded as
407 attachment or inline. When set to OFF, the forwarded
408 article will be included in the body of the mail, while
409 setting this variable to ON will cause the article to be
410 attached as a separate MIME part. Enabling mime_forward
411 is particularly useful for articles consisting of multi‐
412 ple MIME parts such as PGP/MIME signed messages or being
413 encoded in a different character set than your local one.
414 It is also useful if the receiver should be able to oper‐
415 ate on the entire forwarded article (i.e., view or save
416 it without your comments). On the other hand, if you want
417 to forward only some parts of the article or to insert
418 'inline' annotations, you might want to disable this
419 option. Currently mime_forward is forced if the article
420 to be attached is a multipart MIME article, this may
421 change in a future version. Please note that for this
422 option to have effect, the tinrc variable interac‐
423 tive_mailer has to be set to 0 (which is the default).
424 mime_types_to_save
426 A comma separated list of MIME major/minor Content-Types
427 that will be saved when using the view/save and
428 save/autosave features. A single * can be used to wild‐
429 card the major and/or minor type and a ! as the first
430 character in an entry will negate it, eg:
431 image/*,!image/bmp,!text/html. Default is */*
432 news_headers_to_display
434 Identical to the tinrc variable of the same name
435 news_headers_to_not_display
437 Identical to the tinrc variable of the same name
438 news_quote_format
440 Identical to the tinrc variable of the same name
441 organization
443 This can be used to set the article header field ''Orga‐
444 nization:''. It overrides the setting (if any) of organi‐
445 zation in /etc/tin/tin.defaults and $ORGANIZATION (or
446 $NEWSORG on Apollo DomainOS). Note that some news servers
447 might still overwrite the ''Organization:'' header.
448 pos_first_unread
450 Identical to the tinrc variable of the same name
451 post_8bit_header
453 Identical to the tinrc variable of the same name
454 post_mime_encoding
456 Identical to the tinrc variable of the same name
457 post_process_type
459 Identical to the tinrc variable of the same name
460 post_process_view
462 Identical to the tinrc variable of the same name
463 print_header
465 Identical to the tinrc variable of the same name
466 process_only_unread
468 Identical to the tinrc variable of the same name
469 prompt_followupto
471 Identical to the tinrc variable of the same name
472 quote_chars
474 Identical to the tinrc variable of the same name
475 savedir
477 Identical to the tinrc variable of the same name
478 savefile
480 show_author
482 Identical to the tinrc variable of the same name
483 show_info
485 Identical to the tinrc variable of the same name
486 show_only_unread_arts
488 Identical to the tinrc variable of the same name
489 show_signatures
491 Identical to the tinrc variable of the same name
492 sigdashes
494 Identical to the tinrc variable of the same name
495 sigfile
497 Identical to the tinrc variable of the same name
498 signature_repost
500 Identical to the tinrc variable of the same name
501 sort_article_type
503 Identical to the tinrc variable sort_article_type
504 sort_threads_type
506 Identical to the tinrc variable of the same name
507 start_editor_offset
509 Identical to the tinrc variable of the same name
510 tex2iso_conv
512 Identical to the tinrc variable of the same name
513 thread_articles
515 Identical to the tinrc variable of the same name
516 thread_catchup_on_exit
518 Identical to the tinrc variable of the same name
519 thread_format
521 Identical to the tinrc variable of the same name
522 thread_perc
524 Identical to the tinrc variable of the same name
525 trim_article_body
527 Identical to the tinrc variable of the same name
528 verbatim_handling
530 Identical to the tinrc variable of the same name
531 wrap_on_next_unread
533 Identical to the tinrc variable of the same name
534 x_body A piece of text that will be added at the start of a mes‐
536 sage body. If this string starts with a / or ~ then it is
537 assumed to be the name of a file containing the text to
538 insert.
539 x_comment_to
541 Insert ''X-Comment-To:'' header, this is only useful in
542 FIDO groups.
543 x_headers
545 A string including header-name and the contents of the
546 header that will be automatically added when posting. If
547 the string starts with a / or ~ then it is assumed to be
548 the name of a file containing the header and its content
549 to be inserted. If the string starts with a ! then what
550 follows is assumed to be the path to a program to be exe‐
551 cuted to generate the header and its content. %G is
552 expanded to the current news.group.name and %P is
553 expanded to the news.group.name with all '.' replaced by
554 '/'.
555 quick_kill_scope
557 A comma-separated list of newsgroup patterns (wildmat-
558 style) to which groups the filter rule added by QuickFil‐
559 terKill will be applied. If unset the default from the
560 tinrc variable default_filter_kill_global will be used.
561 quick_kill_expire
563 Identical to the tinrc variable default_fil‐
564 ter_kill_expire
565 quick_kill_case
567 Identical to the tinrc variable default_filter_kill_case
568 quick_kill_header
570 Identical to the tinrc variable default_fil‐
571 ter_kill_header
572 quick_select_scope
574 A comma-separated list of newsgroup patterns (wildmat-
575 style) to which groups the filter rule added by QuickFil‐
576 terSelect will be applied. If unset the default from the
577 tinrc variable default_filter_select_global will be used.
578 quick_select_expire
580 Identical to the tinrc variable default_fil‐
581 ter_select_expire
582 quick_select_case
584 Identical to the tinrc variable default_fil‐
585 ter_select_case
586 quick_select_header
588 Identical to the tinrc variable default_fil‐
589 ter_select_header
590 ispell Path and options for ispell(1)-like spell-checker, e.g.
592 "aspell --mode=email --dont-backup check"
593 mm_network_charset
595 Identical to the tinrc variable of the same name
596 undeclared_charset
598 Assume (broken) articles without MIME charset declaration
599 have this charset — default is US-ASCII. This attribute
600 works only on systems with working iconv(3), others might
601 have to compile tin(1) with --dis‐
602 able-mime-strict-charset.
603 Example:
605 # include extra headers
606 # assume ISO-8859-1 as charset if no charset is declared
607 scope=*
608 x_headers=~/.tin/headers
609 undeclared_charset=ISO-8859-1
610 # in *sources* set post process type to shar only
612 scope=*sources*
613 post_process_type=1
614 # in *binaries* turn on full post processing,
616 # remove tmp files and set Followup-To: poster
617 scope=*binaries*
618 post_process_type=2
619 delete_tmp_files=ON
620 followup_to=poster
621 # in fido.* newsgroups change quote_chars
623 # and add X-Comment-To: line
624 scope=fido.*
625 quote_chars=%I>_
626 x_comment_to=ON
627 # in *.test newsgroups, don't append signature
629 # and preset Subject
630 scope=*.test
631 sigfile=--none
632 x_headers=Subject: test - ignore - no reply
633 # assume ISO-2022-JP-2 as charset
635 scope=fj.*,japan.*
636 undeclared_charset=ISO-2022-JP-2
637 ${TIN_HOMEDIR:-"$HOME"}/.tin/filter
639 The filter file is used to assign scores to certain articles.
641 Based on the score an article can be filtered out (hidden) or
642 marked hot. Empty lines or lines beginning with a '#' are
643 ignored.
644 comment
646 Every entry (rule) in the filter file might get a com‐
647 ment. Multiple lines are allowed (but only for comments
648 yet). Every line must start with the "comment=" keyword.
649 Comments must appear first in the rule. Comment lines
650 placed within a rule will be moved to the begin of the
651 next rule. This might be changed in the future. Don't use
652 '#' to mark comments as those lines are ignored and your
653 comments will get lost on the next write of the file.
654 group A comma-separated list of newsgroup patterns in wildmat-
656 style to which groups the filter rule will be applied.
657 This line is mandatory!
658 case 0=case-sensitive, 1=case-insensitive
660 score Score value of the rule; can also be one of the magic
662 words "kill" or "hot".
663 subj Match against ''Subject:''. The matching type used (wild‐
665 mat or regex) depends on the setting of the tinrc vari‐
666 able wildcard.
667 from Match against ''From:''. tin(1) converts the contents of
669 the ''From:'' header to an old style e-mail address, e.g.
670 ''some@body.example (John Doe)'' instead of ''John Doe
671 <some@body.example>'', before trying to match the pat‐
672 terns in the filter rule. The matching type used (wildmat
673 or regex) depends on the setting of the tinrc variable
674 wildcard.
675 msgid Match against ''Message-ID:'' and full ''References:''.
677 The matching type used (wildmat or regex) depends on the
678 setting of the tinrc variable wildcard.
679 msgid_last
681 Match against ''Message-ID:'' and last ''References:''
682 entry only. The matching type used (wildmat or regex)
683 depends on the setting of the tinrc variable wildcard.
684 msgid_only
686 Match against ''Message-ID:''. The matching type used
687 (wildmat or regex) depends on the setting of the tinrc
688 variable wildcard.
689 refs_only
691 Match against ''References:''. The matching type used
692 (wildmat or regex) depends on the setting of the tinrc
693 variable wildcard.
694 lines Match against ''Lines:'', <num matches less than, >num
696 matches more than.
697 gnksa Match against ''From:'' address parser return codes. <num
699 matches less than, >num matches more than the returned
700 numeric value. GNKSA_LOCAL_DOMAIN_LITERAL or
701 GNKSA_INVALID_DOMAIN are only returned if dis‐
702 able_gnksa_domain_check is set to false. As the built in
703 domain list is outdated this should be considered care‐
704 fully.
705 0 GNKSA_OK
706 1 GNKSA_INTERNAL_ERROR
707 100 GNKSA_LANGLE_MISSING
708 101 GNKSA_LPAREN_MISSING
709 102 GNKSA_RPAREN_MISSING
710 103 GNKSA_ATSIGN_MISSING
711 104 GNKSA_RANGLE_MISSING
712 200 GNKSA_SINGLE_DOMAIN
713 201 GNKSA_INVALID_DOMAIN
714 202 GNKSA_ILLEGAL_DOMAIN
715 203 GNKSA_UNKNOWN_DOMAIN
716 204 GNKSA_INVALID_FQDN_CHAR
717 205 GNKSA_ZERO_LENGTH_LABEL
718 206 GNKSA_ILLEGAL_LABEL_LENGTH
719 207 GNKSA_ILLEGAL_LABEL_HYPHEN
720 208 GNKSA_ILLEGAL_LABEL_BEGNUM
721 209 GNKSA_BAD_DOMAIN_LITERAL
722 210 GNKSA_LOCAL_DOMAIN_LITERAL
723 211 GNKSA_RBRACKET_MISSING
724 300 GNKSA_LOCALPART_MISSING
725 301 GNKSA_INVALID_LOCALPART
726 302 GNKSA_ZERO_LENGTH_LOCAL_WORD
727 400 GNKSA_ILLEGAL_UNQUOTED_CHAR
728 401 GNKSA_ILLEGAL_QUOTED_CHAR
729 402 GNKSA_ILLEGAL_ENCODED_CHAR
730 403 GNKSA_BAD_ENCODE_SYNTAX
731 404 GNKSA_ILLEGAL_PAREN_CHAR
732 405 GNKSA_INVALID_REALNAME
733 406 GNKSA_MISSING_REALNAME
734 xref Match against ''Xref:'' line. Before any matching is done
736 the line is turned into the same format ''Newsgroups:''
737 has that is it is turned into a comma separated newsgroup
738 list with all other information (i.e. the article
739 counter) removed. The matching type used (wildmat or
740 regex) depends on the setting of the tinrc variable wild‐
741 card.
742 path Match against ''Path:'' line. This may not work on some
744 servers. The matching type used (wildmat or regex)
745 depends on the setting of the tinrc variable wildcard.
746 time time_t value when rule expires
748 Example:
750 comment=mark all articles about tin, rtin,
751 comment=tind, ktin or cdtin as hot
752 group=*
753 case=1
754 score=hot
755 subj=\b(cd|[rk]?)?tin(d|pre)?[-.0-9]*\b
756 /etc/tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
758 ${TIN_HOMEDIR:-"$HOME"}/.tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
759 Keymap-file, containing "keyname value [value]" pairs separated
761 by spaces or tabs. Below is a list of all rebindable keynames
762 and their defaults. If a keyname is bound to NULL it is unas‐
763 signed.
764 ShellEscape !
766 SetRange #
767 LastPage $
768 ToggleColor &
769 LastViewed -
770 SearchRepeat \
771 SearchSubjF /
772 SearchSubjB ?
773 SearchAuthB A
774 SearchBody B
775 CatchupNextUnread C
776 EditFilter E
777 ToggleHelpDisplay H
778 ToggleInverseVideo I
779 LookupMessage L
780 OptionMenu M
781 Postponed O ^O
782 QuitTin Q
783 BugReport R
784 DisplayPostHist W
785 MarkThrUnread Z
786 FirstPage ^
787 SearchAuthF a
788 Catchup c
789 Help h
790 ToggleInfoLastLine i
791 Down j ^N
792 Up k ^P
793 Print o
794 Quit q
795 Version v
796 Post w
797 MarkArtUnread z
798 QuickFilterSelect [
799 QuickFilterKill ]
800 Pipe |
801 ScrollUp <
802 ScrollDown >
803 PageUp b ^B ^U
804 PageDown ^D ^F SPACE
805 RedrawScr ^L
806 Postponed ^O
807 MenuFilterSelect ^A
808 MenuFilterKill ^K
809 MarkFeedRead ^X
810 MarkFeedUnread ^W
811 AttachSelect ^J ^M
813 AttachPipe p
814 AttachSave s
815 AttachTag t
816 AttachUntag U
817 AttachTagPattern =
818 AttachToggleTagged @
819 ConfigToggleAttrib TAB
821 ConfigSelect ^J ^M
822 ConfigLastPage G
823 ConfigNoSave Q
824 ConfigScopeMenu S
825 ConfigFirstPage g
826 ConfigResetAttrib r
827 FeedTag T
829 FeedArt a
830 FeedHot h
831 FeedPat p
832 FeedRepost r
833 FeedSupersede s
834 FeedThd t
835 FilterEdit e
837 FilterSave s
838 GroupNextUnreadArtOrGrp TAB
840 GroupReadBasenote ^J ^M
841 GroupSelThd *
842 GroupDoAutoSel +
843 GroupToggleThdSel .
844 GroupSelThdIfUnreadSelected ;
845 GroupSelPattern =
846 GroupReverseSel @
847 GroupCancel D
848 GroupToggleGetartLimit G
849 GroupMarkThdRead K
850 GroupNextUnreadArt N
851 GroupPrevUnreadArt P
852 GroupAutoSave S
853 GroupTagParts T
854 GroupUntag U
855 GroupMarkUnselArtRead X
856 GroupToggleSubjDisplay d
857 GroupGoto g
858 GroupListThd l
859 GroupMail m
860 GroupNextGroup n
861 GroupPrevGroup p
862 GroupToggleReadUnread r
863 GroupSave s
864 GroupTag t
865 GroupToggleThreading u
866 GroupRepost x
867 GroupUndoSel ~
868 HelpLastPage G
870 HelpFirstPage g
871 PageReplyQuoteHeaders ^E
873 PagePGPCheckArticle ^G
874 PageToggleRaw ^H
875 PageNextUnread TAB
876 PageNextThd ^J ^M
877 PageToggleTabs ^T
878 PageFollowupQuoteHeaders ^W
879 PageToggleTex2iso "
880 PageToggleAllHeaders *
881 PageToggleRot %
882 PageToggleUue (
883 PageReveal )
884 PageSkipIncludedText :
885 PageTopThd <
886 PageBotThd >
887 PageCancel D
888 PageFollowup F
889 PageLastPage G
890 PageKillThd K
891 PageNextUnreadArt N
892 PagePrevUnreadArt P
893 PageReply R
894 PageAutoSave S
895 PageGroupSel T
896 PageViewUrl U
897 PageViewAttach V
898 PageToggleHighlight _
899 PageEditArticle e
900 PageFollowupQuote f
901 PageFirstPage g
902 PageListThd l
903 PageMail m
904 PageNextArt n
905 PagePrevArt p
906 PageReplyQuote r
907 PageSave s
908 PageTag t
909 PageGotoParent u
910 PageRepost x
911 PgpEncSign b
913 PgpEncrypt e
914 PgpIncludekey i
915 PgpSign s
916 PostAbort a
918 PostContinue c
919 PostCancel d
920 PostEdit e
921 PostPGP g
922 PostIspell i
923 PostIgnore i
924 PostMail m
925 PostPostpone o
926 PostPost p y
927 PostSupersede s
928 PostSend s y
929 PostponeOverride Y
931 PostponeAll A
932 PromptYes y Y
934 PromptNo n N
935 SaveAppendFile a
937 SaveOverwriteFile o
938 PProcNone n
940 PProcShar s
941 PProcYes y
942 SelectEnterNextUnreadGrp TAB n
944 SelectReadGrp ^J ^M
945 SelectResetNewsrc ^R
946 SelectSortActive .
947 SelectNextUnreadGrp N
948 SelectSubscribePat S
949 SelectUnsubscribePat U
950 SelectQuitNoWrite X
951 SelectSyncWithActive Y
952 SelectToggleDescriptions d
953 SelectGoto g
954 SelectMoveGrp m
955 SelectToggleReadDisplay r
956 SelectSubscribe s
957 SelectUnsubscribe u
958 SelectYankActive y
959 SelectMarkGrpUnread z Z
960 ScopeSelect ^J ^M
962 ScopeEditAttributesFile E
963 ScopeAdd a
964 ScopeDelete d
965 ScopeMove m
966 ScopeRename r
967 ThreadReadNextArtOrThread TAB
969 ThreadReadArt ^J ^M
970 ThreadSelArt *
971 ThreadToggleArtSel .
972 ThreadReverseSel @
973 ThreadCancel D
974 ThreadMarkArtRead K
975 ThreadAutoSave S
976 ThreadUntag U
977 ThreadToggleSubjDisplay d
978 ThreadMail m
979 ThreadSave s
980 ThreadTag t
981 ThreadTagParts T
982 ThreadUndoSel ~
983 UrlSelect ^J ^M
985 ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups
987 This file provides short descriptions of each mailgroup.
989 (requires tin(1) to be build with mh-mail-handling support).
990 Each line consist of two tab-separated fields "mailgroupname
991 one-line description".
992 mailgroupname
994 is the name of the newsgroup
995 description
997 is a short single-line description of the group
998 ${TIN_HOMEDIR:-"$HOME"}/.tin/newsrctable
1000 "nntpserver newsrc [shortname [...]]" pairs to use with the
1002 ''-g'' command-line switch.
1003 nntpserver
1005 full qualified domain name of the news server.
1006 newsrc related newsrc.
1008 shortname
1010 nickname(s) for the nntpserver.
1011 Example:
1013 # sample newsrctable file
1014 news.tin.org .newsrc-tin.org tinorg
1015 news.example.org /tmp/nrc-ex example ex
1016 ${TIN_HOMEDIR:-"$HOME"}/.tin/posted
1018 posting history
1020 ${TIN_HOMEDIR:-"$HOME"}/Mail/posted
1022 Copy of all posted articles in mbox(5) format. The filename can
1024 be changed by setting posted_articles_file.
1025 ${TIN_HOMEDIR:-"$HOME"}/.tin/postponed.articles
1027 Pool of postponed articles. This file is in mbox(5) format.
1029 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/newsgroups
1031 This file a copy of the servers newsgroups file which provides
1033 short descriptions of each newsgroup. It is automatically
1034 updated on startup except when using the ''-X''or ''-q'' com‐
1035 mand-line option and an old copy exists. Each line consist of
1036 two tab-separated fields "group.name one-line
1037 description".
1038 group.name
1040 is the name of the newsgroup
1041 one-line description
1043 is a short single-line description of the group
1044 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/serverrc
1046 File to store $NNTPSERVER and $NNTPPORT related data via a list
1048 of "variable=value" pairs. Currently there are only two vari‐
1049 ables, both are not meant to be changed by the user.
1050 version
1052 Internal version number.
1053 last_newnews
1055 Internal timestamp used by tin(1) to keep track of new
1056 newsgroups on the server.
1057 /etc/tin/tinrc
1059 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc
1060 At startup, tin(1) reads in the configuration file. This con‐
1062 tains a list of "variable=value" pairs that can be used to con‐
1063 figure the way tin(1) works. If it exists, the global configura‐
1064 tion file, ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc is read first. After
1065 that, the user's own configuration file ${TIN_HOME‐
1066 DIR:-"$HOME"}/.tin/tinrc is read. The global file is useful for
1067 distributing system-wide defaults to new users who have no pri‐
1068 vate tinrc yet (see also /etc/tin/tin.defaults).
1069 abbreviate_groupname
1071 If ON abbreviate long newsgroup names at group selection
1072 level and article level (if necessary) like this:
1073 news.software.readers -> n.software.readers -> n.s.read‐
1074 ers -> n.s.r. Default is OFF.
1075 add_posted_to_filter
1077 If ON add posted articles which start a new thread to
1078 filter for highlighting follow-ups. Default is ON.
1079 advertising
1081 Turn ON advertising in header (''User-Agent:''). Default
1082 is ON.
1083 alternative_handling
1085 If ON strip multipart/alternative messages automatically.
1086 Default is ON.
1087 art_marked_deleted
1089 The character used to show that an article was deleted.
1090 Default is 'D'.
1091 art_marked_inrange
1093 The character used to show that an article is in a range.
1094 Default is '#'.
1095 art_marked_return
1097 The character used to show that an article will return as
1098 an unread article when the group is next entered. Default
1099 is '-'.
1100 art_marked_selected
1102 The character used to show that an article/thread is
1103 auto-selected (hot). Default is '*'.
1104 art_marked_recent
1106 The character used to show that an article/thread is
1107 recent (not older than X days). See also recent_time.
1108 Default is 'o'.
1109 art_marked_unread
1111 The character used to show that an article has not been
1112 read. Default is '+'.
1113 art_marked_read
1115 The character used to show that an article was read.
1116 Default is ' '.
1117 art_marked_killed
1119 The character used to show that an article was killed.
1120 Default is 'K'. kill_level must be set accordingly.
1121 art_marked_read_selected
1123 The character used to show that an article was hot before
1124 it was read. Default is ':'. kill_level must be set
1125 accordingly.
1126 Ask before using MIME viewer (ask_for_metamail)
1128 If ON tin(1) will ask before using a MIME viewer (meta‐
1129 mail_prog) to display MIME messages. This only occurs if
1130 a MIME viewer is set. Default is OFF.
1131 auto_cc_bcc
1133 Automatically put your name in the ''Cc:'' and/or
1134 ''Bcc:'' field when mailing an article. Default is No.
1135 auto_list_thread
1137 If ON automatically list thread when entering it using
1138 right arrow key. Default is ON.
1139 auto_reconnect
1141 Reconnect to server automatically. Default is OFF.
1142 auto_save
1144 If ON articles/threads with ''Archive-name:'' in header
1145 will be automatically saved with the Archive-name &
1146 part/patch no and post processed if post_process_type is
1147 set to something other than 'No'. Default is OFF.
1148 batch_save
1150 If set ON articles/threads will be saved in batch mode
1151 when save ''-S'' or mail ''-M, -N'' is specified on the
1152 command line. Default is ON.
1153 beginner_level
1155 If set ON a mini menu of the most useful commands will be
1156 displayed at the bottom of the screen for each level.
1157 Also a short posting etiquette will be displayed after
1158 composing an article. Default is ON.
1159 cache_overview_files
1161 If ON, create local copies of NNTP overview files. This
1162 can be used to considerably speed up accessing large
1163 groups when using a slow connection. Default is OFF.
1164 cancel_lock_algo
1166 Use this hash algorithm for cancel-locks. Only available
1167 when build with cancel-lock support. none disables the
1168 generation of cancel-locks. Valid values are none, sha1,
1169 sha256 and sha512. Default is sha1.
1170 catchup_read_groups
1172 If set ON the user is asked when quitting if all groups
1173 read during the current session should be marked read.
1174 Default is OFF.
1175 col_back
1177 Standard background color
1178 col_extquote
1180 Color of quoted text from external sources
1181 col_from
1183 Color of sender (From:)
1184 col_head
1186 Color of header-lines
1187 col_help
1189 Color of help pages
1190 col_invers_bg
1192 Color of background for inverse text
1193 col_invers_fg
1195 Color of foreground for inverse text
1196 col_markdash
1198 Color of words emphasized like _this_. See also
1199 word_h_display_marks and word_highlight.
1200 col_markslash
1202 Color of words emphasized like /this/. See also
1203 word_h_display_marks and word_highlight.
1204 col_markstar
1206 Color of words emphasized like *this*. See also
1207 word_h_display_marks and word_highlight.
1208 col_markstroke
1210 Color of words emphasized like -this-. See also
1211 word_h_display_marks and word_highlight.
1212 col_message
1214 Color of status messages in last line
1215 col_minihelp
1217 Color of mini help menu
1218 col_newsheaders
1220 Color of actual news header fields
1221 col_normal
1223 Standard foreground color
1224 col_quote
1226 Color of quoted lines
1227 col_quote2
1229 Color of twice quoted lines
1230 col_quote3
1232 Color of >=3 times quoted lines
1233 col_response
1235 Color of response counter. This is the text that says
1236 "Response x of y" in the article viewer.
1237 col_signature
1239 Color of signatures
1240 col_urls
1242 Color of urls highlight
1243 col_verbatim
1245 Color of verbatim blocks
1246 col_subject
1248 Color of article subject
1249 col_text
1251 Color of text-lines
1252 col_title
1254 Color of help/mail sign
1255 confirm_choice
1257 tin(1) can ask for manual confirmation to protect the
1258 user. Available choices:
1259 commands: Ask for confirmation before executing cer‐
1260 tain dangerous commands (e.g., Catchup ('c')). Com‐
1261 mands that this affects are marked in this manual
1262 with '[after confirmation]'.
1263 quit: You'll be asked to confirm that you wish to
1265 exit tin(1) when you use the Quit ('q') command.
1266 select: Ask for confirmation before marking all not
1268 selected (with GroupMarkUnselArtRead ('X') command)
1269 articles as read.
1270 Default is commands & quit.
1271 date_format
1273 Format string used for date representation. A description
1274 of the different format options can be found at
1275 strftime(3). tin(1) uses strftime(3) when available and
1276 supports most format options in his fallback code.
1277 Default is "%a, %d %b %Y %H:%M:%S".
1278 default_art_search
1280 default_author_search
1282 default_config_search
1284 The last article/author/config option that was searched
1285 for.
1286 default_filter_days
1288 Default is 28.
1289 default_filter_kill_case
1291 Default for quick (1 key) kill filter case. ON = filter
1292 case sensitive, OFF = ignore case. Default is OFF.
1293 default_filter_kill_expire
1295 Default for quick (1 key) kill filter expire. ON = limit
1296 to default_filter_days, OFF = don't ever expire. Default
1297 is OFF.
1298 default_filter_kill_global
1300 Default for quick (1 key) kill filter global. ON=apply
1301 to all groups, OFF=apply to current group. Default is ON.
1302 default_filter_kill_header
1304 Default for quick (1 key) kill filter header.
1305 0 ''Subject:'' (case sensitive)
1306 1 ''Subject:'' (ignore case)
1307 2 ''From:'' (case sensitive)
1308 3 ''From:'' (ignore case)
1309 4 ''Message-ID:'' & full ''References:'' line
1310 5 ''Message-ID:'' & last ''References:'' entry only
1311 6 ''Message-ID:'' entry only
1312 7 ''Lines:''
1313 default_filter_select_case
1315 Default for quick (1 key) auto-selection filter case.
1316 ON=filter case sensitive, OFF=ignore case. Default is
1317 OFF.
1318 default_filter_select_expire
1320 Default for quick (1 key) auto-selection filter expire.
1321 ON = limit to default_filter_days, OFF = don't ever
1322 expire. Default is OFF.
1323 default_filter_select_global
1325 Default for quick (1 key) auto-selection filter global.
1326 ON=apply to all groups, OFF=apply to current group.
1327 Default is ON.
1328 default_filter_select_header
1330 Default for quick (1 key) auto-selection filter header.
1331 0 ''Subject:'' (case sensitive)
1332 1 ''Subject:'' (ignore case)
1333 2 ''From:'' (case sensitive)
1334 3 ''From:'' (ignore case)
1335 4 ''Message-ID:'' & full ''References:'' line
1336 5 ''Message-ID:'' & last ''References:'' entry only
1337 6 ''Message-ID:'' entry only
1338 7 ''Lines:''
1339 default_goto_group
1341 default_group_search
1343 default_mail_address
1345 default_move_group
1347 default_pattern
1349 default_pipe_command
1351 default_post_newsgroups
1353 default_post_subject
1355 default_range_group
1357 default_range_select
1359 default_range_thread
1361 default_repost_group
1363 default_save_file
1365 default_save_mode
1367 default_select_pattern
1369 default_shell_command
1371 default_subject_search
1373 draw_arrow
1375 Allows groups/articles to be selected by an arrow '->' if
1376 set ON or by a highlighted bar if set OFF. Default is
1377 OFF.
1378 editor_format
1380 The format string used to create the editor start command
1381 with parameters. Default is '%E +%N %F' with %E=Editor,
1382 %N=Linenumber and %F=Filename (e.g., /bin/vi +7 .arti‐
1383 cle).
1384 extquote_handling
1386 If ON quotes from external sources will be detected.
1387 Default is OFF.
1388 extquote_regex
1390 A regular expression that will be applied when reading
1391 articles. All matching lines are shown in col_extquote.
1392 If extquote_regex is blank, then tin(1) uses a built-in
1393 default.
1394 force_screen_redraw
1396 Specifies whether a screen redraw should always be done
1397 after certain external commands. Default is OFF.
1398 getart_limit
1400 If getart_limit is > 0 not more than the last
1401 getart_limit articles/group are fetched from the server.
1402 If getart_limit is < 0 tin(1) will start fetching arti‐
1403 cles from your first unread minus absolute value of
1404 getart_limit. Default is 0, which means no limit.
1405 goto_next_unread
1407 Which keys tin(1) should accept to jump to the next
1408 unread article. Possible is any combination of PageDown
1409 and PageNextUnread. When PageDown is set tin(1) jumps to
1410 the next article at the end of the current one. When
1411 PageNextUnread is set tin(1) jumps immediately to the
1412 next article when PageNextUnread ('<TAB>') is pressed.
1413 Default is PageNextUnread.
1414 group_catchup_on_exit
1416 If ON catchup group when leaving with the left arrow key.
1417 Default is ON.
1418 group_format
1420 The format string used for the Group level. Default is
1421 "%n %m %R %L %s %F". The following substitutions are
1422 supported:
1423 %D date
1424 %F from, name and/or address
1425 %I initials
1426 %L line count
1427 %M message-id
1428 %R number of responses in thread
1429 %S score
1430 %m article marks
1431 %n current thread number
1432 %s subject
1433 %% %
1434 hide_uue
1436 If set to 'No' then raw uuencoded data is displayed. If
1437 set to 'Yes' then sections of uuencoded data will be
1438 shown with a single tag line showing the size and file‐
1439 name (much the same as a MIME attachment). If set to
1440 'Hide all' then any line that looks like uuencoded data
1441 will be folded into a tag line. This is useful when uuen‐
1442 coded data is split across more than one article but can
1443 also lead to false positives. This setting can also be
1444 toggled in the article viewer. Default is 'No'.
1445 inews_prog
1447 Path, name and options of external inews(1). If you are
1448 reading via NNTP the default value is "--internal" (use
1449 built-in NNTP inews), else it is "inews -h". The article
1450 is passed to inews_prog on STDIN via '< article'.
1451 info_in_last_line
1453 If ON, show current group description or article subject
1454 in the last line (not in the pager and global menu) —
1455 ToggleInfoLastLine ('i') toggles setting. This facility
1456 is useful as the full width of the screen is available to
1457 display long subjects. Default is OFF.
1458 interactive_mailer
1460 If greater than 0 your mailreader will be invoked earlier
1461 for reply so you can use more of its features (e.g. MIME,
1462 pgp, ...). 1 means include headers, 2 means don't include
1463 headers (old use_mailreader_i=ON option). 0 turns off
1464 usage. This option has to suit mailer_format. Default is
1465 0.
1466 inverse_okay
1468 If ON use inverse video for page headers and URL high‐
1469 lighting. Default is ON.
1470 keep_dead_articles
1472 If ON keep all failed postings in ${TIN_HOME‐
1473 DIR:-"$HOME"}/dead.articles besides keeping the last
1474 failed posting in ${TIN_HOMEDIR:-"$HOME"}/dead.article.
1475 Default is ON.
1476 kill_level
1478 This option controls the processing and display of arti‐
1479 cles that are killed. There are 3 options, default is 0
1480 (Kill only unread arts).
1481 0 Kill only unread arts is the 'traditional' behavior
1483 of tin(1). Only unread articles are killed once
1484 only by marking them read. As filtering only hap‐
1485 pens on unread articles with kill_level set to 0,
1486 art_marked_killed and art_marked_read_selected are
1487 only shown once. When you reenter the group the
1488 mark will be gone.
1489 1 Kill all arts & show with K will process all arti‐
1491 cles in the group and therefore there is a process‐
1492 ing overhead when using this option. Killed arti‐
1493 cles are threaded as normal but they will be marked
1494 with art_marked_killed.
1495 2 Kill all arts and never show will process all arti‐
1497 cles in the group and therefore there is a process‐
1498 ing overhead when using this option. Killed arti‐
1499 cles simply does not get displayed at all.
1500 mail_8bit_header
1502 Allows 8bit characters unencoded in the header of mail
1503 message. Default is OFF. Turning it ON is effective only
1504 if mail_mime_encoding is also set to 8bit. Leaving it OFF
1505 is safe for most users and compliant to Internet Mail
1506 Standard (RFC5322 and RFC2047). Default is OFF.
1507 mail_address
1509 User's mail address (and full name), if not user‐
1510 name@host. This is used when creating articles, sending
1511 mail and when pgp(1) signing.
1512 mail_mime_encoding
1514 MIME encoding of the body in mail message, if necessary
1515 (8bit, base64, quoted-printable, 7bit). Default is
1516 quoted-printable.
1517 mail_quote_format
1519 Format of quote line when replying (via mail) to an arti‐
1520 cle (%A=Address, %D=Date, %F=Fullname+Address, %G=Group‐
1521 name, %M=Message-ID, %N=Fullname, %C=Firstname, %I=Ini‐
1522 tials). Default is "In article %M you wrote:"
1523 mailbox_format
1525 Select one of the following mailbox-formats: MBOXO
1526 (default, except on SCO), MBOXRD or MMDF (default on
1527 SCO). See mbox(5) and RFC4155 for more details on MBOXO
1528 and MBOXRD and mmdf(5) for more details about MMDF.
1529 maildir
1531 The directory where articles/threads are to be saved in
1532 mbox(5) format. This feature is mainly for use with the
1533 elm(1) mail program. It allows the user to save arti‐
1534 cles/threads/groups simply by giving '=' as the filename
1535 to save to. Default is ${TIN_HOMEDIR:-"$HOME"}/Mail.
1536 mailer_format
1538 The format string used to create the mailer command with
1539 parameters that is used for mailing articles to other
1540 people. Default is '%M "%T" < %F' (e.g., /bin/mail "iain"
1541 < .article). The flexible format allows other mailers
1542 with different command line parameters to be used such as
1543 sendmail -oem -t < %F
1544 elm -s "%S" "%T" < "%F"
1545 claws-mail --compose "mailto:%T?subject=%S&insert=%F"
1546 interactive_mailer must be set adequate. The following
1547 substitutions are supported:
1548 %F filename
1549 %M default_mailer
1550 %S subject-field
1551 %T to-filed
1552 %U username
1553 %% %
1554 mark_saved_read
1556 If ON mark articles that are saved as read. Default is
1557 ON.
1558 mark_ignore_tags
1560 When this is ON, the GroupMarkThdRead ('K'), Thread‐
1561 MarkArtRead ('K'), MarkThdUnread ('Z') at Group level and
1562 MarkArtUnread ('z') at Thread level functions mark just
1563 the current article or thread, ignoring other tagged,
1564 (un)read articles. When OFF, the same function presents a
1565 menu with choices of the current thread or article, all
1566 tagged, unread articles, or nothing.
1567 metamail_prog
1569 Path, name and options of external metamail(1) program
1570 used to view non-textual parts of articles. To use the
1571 built-in viewer, set to --internal. This is the default
1572 value when metamail(1) is not installed. Leave it blank
1573 if you don't want any automatic viewing of non-textual
1574 attachments. The 'V' command can always be used to manu‐
1575 ally view any attachments. See also ask_for_metamail.
1576 mm_charset
1578 Charset supported locally, which is also used for MIME
1579 header (charset parameter and charset name in header
1580 encoding) in mail and news postings. If
1581 MIME_STRICT_CHARSET is defined at compile time, text in
1582 charset other than the value of this parameter is consid‐
1583 ered not displayable and represented as '?'. Otherwise,
1584 all character sets are regarded as compatible with the
1585 display. If it's not set, the value of the environment
1586 variable $MM_CHARSET is used. US-ASCII or compile-time
1587 default is used in case neither of them is defined. If
1588 your system supports iconv(3), this option is disabled
1589 and you should use mm_network_charset instead.
1590 mm_network_charset
1592 Charset used for posting and MIME headers; replaces
1593 mm_charset. Conversion between mm_network_charset and
1594 local charset (determined via nl_langinfo(3)) is done via
1595 iconv(3), if this function is not available on your sys‐
1596 tem this option is disabled and you have to use
1597 mm_charset instead. mm_network_charset is limited to one
1598 of the following charsets:
1599 US-ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16},
1600 KOI8-{R,U,RU} EUC-{CN,JP,KR,TW}, ISO-2022-{CN,CN-
1601 EXT,JP,JP-1,JP-2}, Big5, UTF-8
1602 Not all values might work on your system, see
1603 iconv_open(3) for more details. If it's not set, the
1604 value of the environment variable $MM_CHARSET is used.
1605 US-ASCII or compile-time default is used in case neither
1606 of them is defined.
1607 mono_markdash
1609 Character attribute of words emphasized like _this_. It
1610 depends on your terminal which attributes are usable. See
1611 also word_h_display_marks and word_highlight.
1612 mono_markslash
1614 Character attribute of words emphasized like /this/. It
1615 depends on your terminal which attributes are usable. See
1616 also word_h_display_marks and word_highlight.
1617 mono_markstar
1619 Character attribute of words emphasized like *this*. It
1620 depends on your terminal which attributes are usable. See
1621 also word_h_display_marks and word_highlight.
1622 mono_markstroke
1624 Character attribute of words emphasized like -this-. It
1625 depends on your terminal which attributes are usable. See
1626 also word_h_display_marks and word_highlight.
1627 newnews
1629 These are internal timers used by tin(1) to keep track of
1630 new newsgroups. Do not change them unless you understand
1631 what they are for.
1632 news_headers_to_display
1634 Which news headers you wish to see. If you want to see
1635 _all_ the headers, place an '*' as this value. This is
1636 the only way a wildcard can be used. If you enter 'X-'
1637 as the value, you will see all headers beginning with
1638 'X-' (like X-Alan or X-Pape). You can list more than one
1639 by delimiting with spaces. Not defining anything turns
1640 off this option.
1641 news_headers_to_not_display
1643 Same as news_headers_to_display except it denotes the
1644 opposite. An example of using both options might be if
1645 you thought 'X-' headers were A Good Thing(tm), but
1646 thought Alan and Pape were miscreants... well then you
1647 would do something like this: news_headers_to_display=X-
1648 news_headers_to_not_display=X-Alan X-Pape Not defining
1649 anything turns off this option.
1650 news_quote_format
1652 Format of quote line when posting/following up an article
1653 (%A=Address, %D=Date, %F=Fullname+Address, %G=Groupname,
1654 %M=Message-ID, %N=Fullname, %C=Firstname, %I=Initials).
1655 Default is "%F wrote:".
1656 nntp_read_timeout_secs
1658 Time in seconds to wait for a response from the server.
1659 Default is 120.
1660 normalization_form
1662 The normalization form which should be used to normalize
1663 unicode input. The possible values are:
1664 0 None: no normalization
1666 1 NFKC: Compatibility Decomposition, followed by
1668 Canonical Composition
1669 2 NFKD: Compatibility Decomposition
1671 3 NFC: Canonical Decomposition, followed by Canonical
1673 Composition
1674 4 NFD: Canonical Decomposition
1676 5 NFKC_CF: Compatibility Decomposition, followed by
1678 Canonical Composition and Case Folding
1679 Some normalization modes are only available if they are sup‐
1680 ported by the library tin(1) uses to do the normalization. NFC
1681 should be used if possible.
1682 pos_first_unread
1684 If ON put cursor at first unread article in group other‐
1685 wise at last article. Default is ON.
1686 post_8bit_header
1688 Allows 8bit characters unencoded in the header of a news
1689 article, if set this also disables the generation of
1690 MIME-headers when they are usually required. Default is
1691 OFF. Only enacted if post_mime_encoding is also set to
1692 8bit. In a number of local hierarchies where 8bit charac‐
1693 ters are used, using unencoded (raw) 8bit characters in
1694 header is acceptable and sometimes even recommended so
1695 that you need to check the convention adopted in the
1696 local hierarchy of your interest to determine what to do
1697 with this and post_mime_encoding.
1698 post_mime_encoding
1700 MIME encoding of the body in news message, if necessary.
1701 (8bit, base64, quoted-printable, 7bit). Default is 8bit,
1702 which leads to no encoding. base64 and quoted-printable
1703 are usually undesired on usenet.
1704 post_process_view
1706 If ON, then tin(1) will start an appropriate viewer pro‐
1707 gram to display any files that were post processed and
1708 uudecoded. The program is determined using the mailcap(5)
1709 file. Default is ON.
1710 post_process_type
1712 This specifies whether to perform post processing on
1713 saved articles. Because the shell archive may contain
1714 commands you may not want to be executed, be careful when
1715 extracting shell archives. The following values are
1716 allowed:
1717 0 No (default), no post processing is done.
1719 1 Shell archives, unpacking of multi-part shar(1)
1721 files only. Because the shell archive may contain
1722 commands you may not want to be executed, be care‐
1723 ful with this option.
1724 2 Yes, binary attachments and data will be decoded
1726 and saved.
1727 posted_articles_file
1729 Keep posted articles in given file. If the given filename
1730 does not contain any expandable strings it will be pre‐
1731 fixed with ${TIN_HOMEDIR:-"$HOME"}/Mail/. If no filename
1732 is set then postings will not be saved. See the section
1733 "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
1734 for more information about the various expansion charac‐
1735 ters. Default is 'posted'.
1736 print_header
1738 If ON, then the full article header is sent to the
1739 printer. Otherwise only the ''Subject:'' and ''From:''
1740 fields are output. Default is OFF.
1741 printer
1743 The printer program with options that is to be used to
1744 print articles. The default is lpr(1) for BSD machines
1745 and lp(1) for SysV machines. Printing from tin(1) may
1746 have been disabled by the System Administrator.
1747 process_only_unread
1749 If ON only save/print/pipe/mail unread articles (tagged
1750 articles excepted). Default is OFF.
1751 prompt_followupto
1753 If ON show empty ''Followup-To:'' header when editing an
1754 article. Default is OFF.
1755 quote_chars
1757 The character used in quoting included text to article
1758 followups and mail replies. The '_' character represents
1759 a blank character and is replaced with ' ' when read, %I
1760 is replaced by author's initials. Default is '>_'.
1761 quote_style
1763 This bit coded integer value controls how articles are to
1764 be quoted when following up or replying to them. Any of
1765 the following options can be combined by adding all rele‐
1766 vant values. Default is 5, which means that quote charac‐
1767 ters are compressed and empty lines are quoted.
1768 1 Compress quotes Compress quote characters together
1770 when quoting multiple times (for example, '> > >'
1771 will be turned into '>>>'). This option is on by
1772 default.
1773 2 Quote Signatures This option is off by default.
1775 Signatures are always quoted regardless of this
1776 option when you are viewing an article in raw mode
1777 PageToggleRaw ('^H') and followup or reply to it.
1778 Signatures are never quoted regardless of this
1779 option when show_signatures is off.
1780 4 Quote empty lines This option is on by default.
1782 quote_regex
1784 A regular expression that will be applied when reading
1785 articles. All matching lines are shown in col_quote. If
1786 quote_regex is blank, then tin(1) uses a built-in
1787 default.
1788 quote_regex2
1790 A regular expression that will be applied when reading
1791 articles. All matching lines are shown in col_quote2. If
1792 quote_regex2 is blank, then tin(1) uses a built-in
1793 default.
1794 quote_regex3
1796 A regular expression that will be applied when reading
1797 articles. All matching lines are shown in col_quote3. If
1798 quote_regex3 is blank, then tin(1) uses a built-in
1799 default.
1800 recent_time
1802 If set to 0, this feature is deactivated, otherwise it
1803 means the number of days. Default is 2.
1804 render_bidi
1806 If ON tin(1) does the rendering of bi-directional text.
1807 If OFF tin(1) leaves the rendering of bi-directional text
1808 to the terminal. Default is OFF.
1809 reread_active_file_secs
1811 The news ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE‐
1812 FILE:-active} file is reread at regular intervals to show
1813 if any new news has arrived. Default is 1200. Setting
1814 this to 0 will disable this feature.
1815 savedir
1817 Directory where articles/threads are saved. Default is
1818 ${TIN_HOMEDIR:-"$HOME"}/News.
1819 score_limit_kill
1821 If the score of an article is below or equal this value
1822 the article gets marked as killed.
1823 score_limit_select
1825 If the score of an article is above or equal this value
1826 the article gets marked as hot.
1827 score_kill
1829 Score of an article which should be killed, this must be
1830 <= score_limit_kill.
1831 score_select
1833 Score of an article which should be marked hot, this must
1834 be >= score_limit_select.
1835 scroll_lines
1837 The number of lines that will be scrolled up/down in the
1838 article pager when using cursor-up/down. The default is 1
1839 (line-by-line). Set to 0 to get traditional tin page-by-
1840 page scrolling. Set to -1 to get page-by-page scrolling
1841 where the top/bottom line is carried over onto the next
1842 page. This setting supersedes
1843 show_last_line_prev_page=ON. Set to -2 to get half-page
1844 scrolling. This setting supersedes full_page_scroll=OFF.
1845 select_format
1847 The format string used for the Selection level. Default
1848 is "%f %n %U %G %d". The following substitutions are
1849 supported:
1850 %G group name
1851 %U unread count
1852 %d description
1853 %f group flag
1854 %n current group number
1855 %% %
1856 sort_function
1858 Function used for sorting articles. Default is 0.
1859 0 Use qsort(3) for sorting.
1861 1 Use heapsort(3) for sorting. This might be faster in
1863 large groups with long threads (somewhat presorted
1864 data).
1865 show_author
1867 Which information about the author should be shown.
1868 Default is 2, authors full name.
1869 0 None, only the ''Subject:'' line will be displayed.
1871 1 Address, ''Subject:'' line & the address part of
1873 the ''From:'' line are displayed.
1874 2 Full Name, ''Subject:'' line & the authors full
1876 name part of the ''From:'' line are displayed
1877 (default).
1878 3 Address and Name, ''Subject:'' line & all of the
1880 ''From:'' line are displayed.
1881 show_description
1883 If ON show a short group description text after newsgroup
1884 name at the group selection level. The ''-d'' command-
1885 line flag will override the setting and turn descriptions
1886 off. The text used is taken from the ${TIN_LIB‐
1887 DIR:-NEWSLIBDIR}/newsgroups file and if supported
1888 (requires tin(1) to be build with mh-mail-handling sup‐
1889 port) from ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups for
1890 mailgroups. Default is ON.
1891 show_info
1893 Which information about the thread or article should be
1894 shown. Default is 1, show only the line count.
1895 0 None, no information will be displayed.
1897 1 Lines, in article listing the line count of an
1899 article will be displayed and in thread listing the
1900 line count of first (unread) article will be dis‐
1901 played.
1902 2 Score, in article listing the score of an article
1904 will be displayed and in thread listing the score
1905 of the thread will be displayed — see also
1906 thread_score.
1907 3 Lines & Score, display line count and score.
1909 show_only_unread_arts
1911 If ON show only new/unread articles otherwise show all
1912 articles. Default is ON.
1913 show_only_unread_groups
1915 If ON show only subscribed groups that contain unread
1916 articles. Default is OFF.
1917 show_signatures
1919 If OFF don't show signatures when displaying articles.
1920 Default is ON.
1921 sigdashes
1923 If ON prepend the signature with sigdashes. Default is
1924 ON.
1925 sigfile
1927 The path that specifies the signature file to use when
1928 posting, following up to or replying to an article. If
1929 the path is a directory then the signature will be ran‐
1930 domly generated from files that are in the specified
1931 directory. If the path starts with a ! the program the
1932 path points to will be executed to generate a signature.
1933 In order to pass the group name to the program, %G can be
1934 specified. This will be replaced by the name of the cur‐
1935 rent newsgroup. --none will suppress any signature.
1936 Default is ${TIN_HOMEDIR:-"$HOME"}/.Sig.
1937 signature_repost
1939 If ON add signature to reposted articles. Default is ON.
1940 slashes_regex
1942 A regular expression that will be applied when reading
1943 articles. All matching words are shown in col_markslash
1944 or mono_markslash. If slashes_regex is blank, then tin(1)
1945 uses a built-in default.
1946 sort_article_type
1948 This specifies how articles should be sorted. Sort by
1949 ascending Date (6) is the default. The following sort
1950 types are allowed:
1951 0 Nothing, don't sort articles.
1953 1 Subject: (descending), sort articles by ''Sub‐
1955 ject:'' field descending.
1956 2 Subject: (ascending), sort articles by ''Subject:''
1958 field ascending.
1959 3 From: (descending), sort articles by ''From:''
1961 field descending.
1962 4 From: (ascending), sort articles by ''From:'' field
1964 ascending.
1965 5 Date: (descending), sort articles by ''Date:''
1967 field descending.
1968 6 Date: (ascending), sort articles by ''Date:'' field
1970 ascending (default).
1971 7 Score (descending), sort articles by filtering
1973 score descending.
1974 8 Score (ascending), sort articles by filtering score
1976 ascending.
1977 9 Lines: (descending), sort articles by ''Lines:''
1979 field descending.
1980 10 Lines: (ascending), sort articles by ''Lines:''
1982 field ascending.
1983 sort_threads_type
1985 This specifies how threads will be sorted. Sort by
1986 descending Score (1) is the default. The following sort
1987 types are allowed:
1988 0 Nothing, don't sort threads.
1990 1 Score (descending), sort threads by filtering score
1992 descending (default).
1993 2 Score (ascending), sort threads by filtering score
1995 ascending.
1996 3 Last posting date (descending), sort threads by
1998 date of last posting descending.
1999 4 Last posting date (ascending), sort threads by date
2001 of last posting ascending.
2002 spamtrap_warning_addresses
2004 Set this option to a list of comma-separated strings to
2005 be warned if you are replying to an article by mail where
2006 the e-mail address contains one of these strings. The
2007 matching is case-insensitive. Example:
2008 spam,delete,remove
2010 stars_regex
2012 A regular expression that will be applied when reading
2013 articles. All matching words are shown in col_markstar or
2014 mono_markstar. If stars_regex is blank, then tin(1) uses
2015 a built-in default.
2016 start_editor_offset
2018 Set ON if the editor used for posting, follow-ups and bug
2019 reports has the capability of starting and positioning
2020 the cursor at a specified line within a file. Default is
2021 ON.
2022 strip_blanks
2024 Strips the blanks from the end of each line therefore
2025 speeding up the display when reading on a slow terminal
2026 or via modem. Default is ON.
2027 strip_bogus
2029 Bogus groups are groups that are present in your
2030 ${TIN_HOMEDIR:-"$HOME"}/.newsrc file that no longer exist
2031 on the news server. There are 3 options. 0 means do noth‐
2032 ing & always keep bogus groups. 1 means bogus groups
2033 will be permanently removed. 2 means that bogus groups
2034 will appear on the Group Selection Menu, prefixed with a
2035 'D'. This allows you to unsubscribe from them as and when
2036 you wish. Default is 0 (Always Keep).
2037 strip_newsrc
2039 If ON, then unsubscribed groups will be permanently
2040 removed from your ${TIN_HOMEDIR:-"$HOME"}/.newsrc file.
2041 Default is OFF.
2042 strip_re_regex
2044 A regular expression to find Subject prefixes like "Re:"
2045 to remove If strip_re_regex is blank, then tin(1) uses a
2046 built-in default.
2047 strip_was_regex
2049 A regular expression to find Subject suffixes like
2050 "(was:" to remove. If strip_was_regex is blank, then
2051 tin(1) uses a built-in default.
2052 strokes_regex
2054 A regular expression that will be applied when reading
2055 articles. All matching words are shown in col_markstroke
2056 or mono_markstroke. If strokes_regex is blank, then
2057 tin(1) uses a built-in default.
2058 tex2iso_conv
2060 Decode German style TeX umlaut codes to ISO If ON, show
2061 "a as Umlaut-a, etc. Default is OFF. This behavior can
2062 also be toggled in the article viewer via PageToggle‐
2063 Tex2iso ('"').
2064 thread_articles
2066 Defines which threading method to use. The choices are:
2067 0) Don't thread, 1) Thread on Subject only 2) Thread on
2068 References only, 3) Thread on References then Subject
2069 (default) 4) Thread multipart articles on Subject. 5)
2070 Thread on Percentage Match of the Subjects It's also pos‐
2071 sible to set the threading type on a per group basis by
2072 setting the group attribute variable thread_articles to 0
2073 – 5 in the file ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes.
2074 thread_format
2076 The format string used for the Thread level. Default is
2077 "%n %m [%L] %T %F". The following substitutions are
2078 supported:
2079 %D date
2080 %F from, name and/or address
2081 %I initials
2082 %L line count
2083 %M message-id
2084 %S score
2085 %T thread tree
2086 %m article marks
2087 %n current article number
2088 %% %
2089 thread_perc
2091 Defines how close the subjects must match while threading
2092 by Percentage Match for threads to be considered part of
2093 a single thread. This value is in the range 0 to 100. The
2094 default is 75.
2095 thread_catchup_on_exit
2097 If ON catchup group/thread when leaving with the left
2098 arrow key. Default is ON.
2099 thread_score
2101 How the total score of a thread is computed. Default is
2102 0, the maximum score in this thread.
2103 0 Max, the maximum score in this thread.
2105 1 Sum, the sum of all scores in this thread.
2107 2 Average, the average score in this thread.
2109 translit
2111 If ON append //TRANSLIT to the first argument of
2112 iconv_open(3) to enable transliteration. This means that
2113 when a character cannot be represented in the target
2114 character set, it can be approximated through one or sev‐
2115 eral similarly looking characters. On systems where this
2116 extension doesn't exist, this option is disabled. Default
2117 is OFF.
2118 trim_article_body
2120 Allows you to select how tin(1) treats blank lines in
2121 article bodies. Default is 0. This option does not
2122 affect lines within verbatim blocks.
2123 0 Don't trim article body, do nothing.
2125 1 Skip leading blank lines.
2127 2 Skip trailing blank lines.
2129 3 Skip leading and trailing blank l., skip leading
2131 and trailing blank lines.
2132 4 Compact multiple between text, replace multiple
2134 blank lines between textblocks with one blank line.
2135 5 Compact multiple and skip leading, 4 + 1
2137 6 Compact multiple and skip trailing, 4 + 2
2139 7 Compact mltpl., skip lead. & trai., 4 + 3
2141 underscores_regex
2143 A regular expression that will be applied when reading
2144 articles. All matching words are shown in col_markdash or
2145 mono_markdash. If underscores_regex is blank, then tin(1)
2146 uses a built-in default.
2147 unlink_article
2149 If ON remove ${TIN_HOMEDIR:-"$HOME"}/.article after post‐
2150 ing. Default is ON.
2151 url_handler
2153 The program that will be run when launching URLs in the
2154 article viewer using PageViewUrl ('U'). The actual URL
2155 will be appended. Default is url_handler.pl.
2156 url_highlight
2158 Enable highlighting URLs in message body. Default is ON.
2159 use_color
2161 If enabled tin(1) uses ANSI-colors. Default is OFF.
2162 use_keypad
2164 Use scroll keys on keypad. Default is OFF.
2165 use_mouse
2167 Allows the mouse button support in an xterm(1x) to be
2168 enabled/disabled. Default is OFF.
2169 use_slrnface
2171 If enabled slrnface(1) will be used to interpret the
2172 ''X-Face:'' header. For this option to have any effect,
2173 tin(1) must be running in an xterm(1x) and slrnface(1)
2174 must be in your $PATH. Default is OFF.
2175 utf8_graphics
2177 If ON use UTF-8 characters for indicator ('->'),
2178 thread/attachment tree and ellipsis ('...'). Default is
2179 OFF.
2180 verbatim_begin_regex
2182 A regular expression that tin will use to find the begin
2183 of a verbatim block. Default is #v+
2184 verbatim_end_regex
2186 A regular expression that tin will use to find the end of
2187 a verbatim block. Default is #v-
2188 verbatim_handling
2190 If ON verbatim blocks will be detected. Default is ON.
2191 wildcard
2193 Allows you to select how tin(1) matches strings. The
2194 default is 0 and uses the wildmat notation, which is how
2195 this has traditionally been handled. Setting this to 1
2196 allows you to use perl(1) compatible regular expressions
2197 pcre(3). (see also perlre(1) and pcrepattern(3)). You
2198 will probably want to update your filter file if you use
2199 this regularly. NB: Newsgroup names will always be
2200 matched using the wildmat notation.
2201 word_h_display_marks
2203 Should the leading and ending stars, slashes, strokes and
2204 dashes also be displayed, even when they are highlighting
2205 marks?
2206 0 no
2208 1 yes, display mark
2210 2 print a space instead
2212 word_highlight
2214 Enable word highlighting. See word_h_display_marks for
2215 the options available. If use_color is enabled the colors
2216 specified in col_markdash, col_markslash, col_markstar
2217 and col_markstroke are used for word highlighting else
2218 the character attributes specified in mono_markdash,
2219 mono_markslash, mono_markstar and mono_markstroke are
2220 used. Default is ON.
2221 wrap_column
2223 Sets the column at which a displayed article body should
2224 be wrapped. If this value is equal to 0, it defaults to
2225 the current screen width. If this value is greater than
2226 your current screen width the part off-screen is not dis‐
2227 played. Thus setting this option to a large value can be
2228 used to disable wrapping. If this value is negative the
2229 wrap margin is the current screen width plus the given
2230 value (as long as the result is still positive, otherwise
2231 it will fall back to the current screen width). Default
2232 is 0, wrapping at the current screen width.
2233 wrap_on_next_unread
2235 If enabled a search for the next unread article will wrap
2236 around all articles to find also previous unread arti‐
2237 cles. If disabled the search stops at the end of the
2238 thread list. Default is ON.
2239 xpost_quote_format
2241 Format is the same as for news_quote_format, this is used
2242 when answering to a crossposting to several groups with
2243 no ''Followup-To:'' set.
2244 /etc/tin/tin.defaults
2246 Yet another global configuration file with "variable=value"
2248 pairs. This one is for the more general options which usually
2249 can't be controlled via ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc and/or
2250 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc like resetting (to override
2251 the built-in default) the newslibdir.
2252 domainname
2254 Sets a global domain name used in From lines
2255 organization
2257 Defines the name of your organization. $ORGANIZATION
2258 overrides any specified value.
2259 newslibdir
2261 Defines the default place for some configuration files,
2262 common values are /usr/lib/news, /var/lib/news,
2263 /usr/local/lib/news or /news/db. $TIN_LIBDIR overrides
2264 any specified value.
2265 bugaddress
2267 Defines the email address to which users can send bug
2268 reports using a built-in function. The default points to
2269 a developers mailing list located at tin.org. You might
2270 want to change this address to one of your local adminis‐
2271 tration if you want to deal with your lusers problems on
2272 your own.
2273 inewsdir
2275 Defines the directory containing the inews(1) executable.
2276 mm_charset
2278 Default charset to be used in MIME's ''Content-Type:''
2279 header. $MM_CHARSET overrides any specified value.
2280 post_mime_encoding
2282 Default encoding scheme used in MIME articles. 8bit might
2283 be the best value.
2284 mail_mime_encoding
2286 Default encoding scheme used in MIME letters.
2287 quoted-printable is a good choice here.
2288 disable_gnksa_domain_check
2290 Allow unregistered top level domains. As the list of
2291 valid TLDs is no longer actively maintained the default
2292 was changed to ON starting with tin(1) version 2.1.5
2293 disable_sender
2295 Don't generate a ''Sender:'' header. This has an effect
2296 only if inews_prog is set to --internal.
2297 spooldir
2299 Base of your newsspool (Bnews, Cnews and INN traditional
2300 spool style), common values are /var/spool/news,
2301 /usr/spool/news, /news/spool. $TIN_SPOOLDIR overrides
2302 any specified value.
2303 overviewdir
2305 Base of your NOV database newsoverview(5) (tradspool
2306 style; might be the same dir as spooldir), common values
2307 are /var/spool/overview, /usr/spool/overview, /news/over‐
2308 view. $TIN_NOVROOTDIR overrides any specified value.
2309 overviewfile
2311 Name of a single overview file, common values are .over‐
2312 view, over.view. $TIN_NOVFILENAME overrides any specified
2313 value.
2314 overviewfmtfile
2316 Full pathname of your newssystem's overview.fmt file;
2317 usually the overview.fmt file is in newslibdir, so you
2318 only have to change this setting if your configuration
2319 differs.
2320 activefile
2322 Full pathname of your newssystem's active file; usually
2323 the active file resides in newslibdir and is named
2324 active, so you only have to change this setting if your
2325 configuration differs. $TIN_ACTIVEFILE overrides any
2326 specified value.
2327 activetimesfile
2329 Full pathname of your newssystem's active.times file;
2330 usually the active.times file is newslibdir, so you only
2331 have to change this setting if your configuration dif‐
2332 fers.
2333 newsgroupsfile
2335 Full pathname of your newssystem's newsgroups file; usu‐
2336 ally the newsgroups file is in newslibdir, so you only
2337 have to change this setting if your configuration dif‐
2338 fers.
2339 subscriptionsfile
2341 Full pathname of your newssystem's subscriptions file;
2342 usually the subscriptions file is in newslibdir, so you
2343 only have to change this setting if your configuration
2344 differs.
2345 /usr/local/share/locale/$LC_MESSAGES/LC_MESSAGES/tin.mo
2347 translation into language specified in $LC_ALL, $LC_MESSAGES or
2349 $LANG
2350 ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active}
2352 This file lists the newsgroups that the local site receives.
2354 Each newsgroup should be listed only once. Each line specifies
2355 one group; within each newsgroup, articles are assigned unique
2356 names, which are monotonically increasing numbers.
2357 If an article is posted to newsgroups not mentioned in this
2359 file, those newsgroups are ignored. If no valid newsgroups are
2360 specified, the article is rejected.
2361 Each line consists of four space-separated fields "name highmark
2363 lowmark flags".
2364 name is the name of the newsgroup
2366 highmark
2368 is the highest article number that has been used in that
2369 newsgroup
2370 lowmark
2372 is the lowest article number in the group; this number is
2373 not guaranteed to be accurate, and should only be taken
2374 to be a hint. Note that because of article cancellations,
2375 there may be gaps in the numbering sequence. If the low‐
2376 est article number is greater than the highest article
2377 number, then there are no articles in the newsgroup.
2378 flags can be one of those
2380 y local postings are allowed
2382 n no local postings are allowed, only remote ones
2384 m the group is moderated and all postings must be
2386 approved
2387 j articles in this group are not kept, but only
2389 passed on
2390 x articles cannot be posted to this newsgroup
2392 =foo.bar
2394 articles are locally filed into the ''foo.bar''
2395 group
2396 tin(1) only tries to read the file if you read directly from the
2398 local spool, if you read news via NNTP, tin(1) uses the
2399 LIST (RFC3977) or LIST COUNTS (RFC6048) command instead.
2400 ${TIN_LIBDIR:-NEWSLIBDIR}/active.times
2402 This file provides a chronological record of when newsgroups are
2404 created. It is normally updated by the local news server (e.g.
2405 innd(8)) whenever a new group is created. Each line consist of
2406 three space-separated fields "name time creator".
2407 name is the name of the newsgroup
2409 time is the time when the group was created, expressed as the
2411 number of seconds since the Epoch.
2412 creator
2414 is the electronic mail address of the person who created
2415 the group.
2416 tin(1) only tries to read the file if you read directly from the
2418 local spool, if you read news via NNTP, tin(1) uses the
2419 NEWGROUPS (RFC3977) command instead.
2420 ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups
2422 This file provides short descriptions of each newsgroup. It is
2424 normally updated by the local news server (e.g. innd(8)) when‐
2425 ever a new group is created. Each line consist of two tab-sepa‐
2426 rated fields "group.name one-line description".
2427 group.name
2429 is the name of the newsgroup
2430 one-line description
2432 is a short single-line description of the group
2433 tin(1) only tries to read the file if you read directly from the
2435 local spool, if you read news via NNTP, tin(1) uses the
2436 LIST NEWSGROUPS (RFC3977) command instead.
2437 ${TIN_LIBDIR:-NEWSLIBDIR}/organization
2439 This file might hold a default organization to be used in the
2441 ''Organization:'' header. $ORGANIZATION has a higher priority if
2442 set.
2443 ${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt
2445 This file specifies the organization of the news overview data‐
2447 base (see also newsoverview(5)). The order of lines in this
2448 file is important; it determines the order in which the fields
2449 will appear in the database. See also overview.fmt(5). tin(1)
2450 only tries to read the file if you read directly from the local
2451 spool, if you read news via NNTP, tin(1) uses the LIST OVER‐
2452 VIEW.FMT (RFC3977) command instead.
2453 ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions
2455 This file contains a list of newsgroups — one per line — which
2457 the client should subscribe to when the user has no ${TIN_HOME‐
2458 DIR:-"$HOME"}/.newsrc for the news server. tin(1) only tries to
2459 read the file if you read directly from the local spool, if you
2460 read news via NNTP, tin(1) uses the LIST SUBSCRIPTIONS (RFC6048)
2461 command instead.
2462
2464 elm(1), inews(1), ispell(1), lp(1), lpr(1), metamail(1), perl(1),
2465 perlre(1), pgp(1), rn(1), shar(1), slrnface(1), tin(1), xterm(1x),
2466 heapsort(3), iconv(3), iconv_open(3), nl_langinfo(3), pcre(3),
2467 pcrepattern(3), qsort(3), strftime(3), system(3), active(5),
2468 mailcap(5), mbox(5), mmdf(5), newsoverview(5), overview.fmt(5),
2469 innd(8), RFC1524, RFC2045, RFC2046, RFC2047, RFC2048, RFC2231, RFC2980,
2470 RFC3977, RFC4155, RFC4643, RFC5322, RFC5536, RFC5537, RFC6048
24712.4.5 December 24th, 2020 tin(5)