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 re‐
51 placed 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 de‐
56 fined:
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 op‐
65 erating 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 ap‐
74 plied 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 ar‐
103 bitrarily 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 de‐
131 scription, optionally quoted, that describes the type of
132 data, to be used optionally by mail readers that wish to
133 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_select
345 Automatically perform the GroupMarkUnselArtRead ('X')
346 command after entering the group.
347 batch_save
349 Can be used to override the global setting in tinrc on a
350 per group basis. For more information read section AUTO‐
351 MATIC MAILING AND SAVING NEW NEWS in tin(1).
352 date_format
354 Identical to the tinrc variable of the same name
355 delete_tmp_files
357 If this is set to ON, then saved article files that have
358 been post-processed will be automatically deleted, other‐
359 wise the user will be asked whether to delete the post-
360 processed files. Automatic processing of marked articles
361 using GroupAutoSave ('S') will suppress prompting.
362 editor_format
364 Identical to the tinrc variable of the same name
365 extquote_handling
367 Identical to the tinrc variable of the same name
368 fcc Mailbox to save sent mails. The format of the mailbox is
370 controlled via the tinrc mailbox_format variable.
371 followup_to
373 Set ''Followup-To:'' header to the specified group(s).
374 from Identical to the tinrc variable mail_address
376 group_catchup_on_exit
378 Identical to the tinrc variable of the same name
379 group_format
381 Identical to the tinrc variable of the same name
382 mail_8bit_header
384 Identical to the tinrc variable of the same name
385 mail_mime_encoding
387 Identical to the tinrc variable of the same name
388 maildir
390 Identical to the tinrc variable of the same name
391 mailing_list
393 Used when a group is a mailing list. All responses to the
394 group will be directed to this email address instead
395 mark_ignore_tags
397 Identical to the tinrc variable of the same name
398 mark_saved_read
400 Identical to the tinrc variable of the same name
401 mime_forward
403 Determines whether usenet articles are forwarded as at‐
404 tachment or inline. When set to OFF, the forwarded arti‐
405 cle will be included in the body of the mail, while set‐
406 ting this variable to ON will cause the article to be at‐
407 tached as a separate MIME part. Enabling mime_forward is
408 particularly useful for articles consisting of multiple
409 MIME parts such as PGP/MIME signed messages or being en‐
410 coded in a different character set than your local one.
411 It is also useful if the receiver should be able to oper‐
412 ate on the entire forwarded article (i.e., view or save
413 it without your comments). On the other hand, if you want
414 to forward only some parts of the article or to insert
415 'inline' annotations, you might want to disable this op‐
416 tion. Currently mime_forward is forced if the article to
417 be attached is a multipart MIME article, this may change
418 in a future version. Please note that for this option to
419 have effect, the tinrc variable interactive_mailer has to
420 be set to 0 (which is the default).
421 mime_types_to_save
423 A comma separated list of MIME major/minor Content-Types
424 that will be saved when using the view/save and save/au‐
425 tosave features. A single * can be used to wildcard the
426 major and/or minor type and a ! as the first character in
427 an entry will negate it, eg: image/*,!im‐
428 age/bmp,!text/html. Default is */*
429 news_headers_to_display
431 Identical to the tinrc variable of the same name
432 news_headers_to_not_display
434 Identical to the tinrc variable of the same name
435 news_quote_format
437 Identical to the tinrc variable of the same name
438 organization
440 This can be used to set the article header field ''Orga‐
441 nization:''. It overrides the setting (if any) of organi‐
442 zation in /etc/tin/tin.defaults and $ORGANIZATION (or
443 $NEWSORG on Apollo DomainOS). Note that some news servers
444 might still overwrite the ''Organization:'' header.
445 pos_first_unread
447 Identical to the tinrc variable of the same name
448 post_8bit_header
450 Identical to the tinrc variable of the same name
451 post_mime_encoding
453 Identical to the tinrc variable of the same name
454 post_process_type
456 Identical to the tinrc variable of the same name
457 post_process_view
459 Identical to the tinrc variable of the same name
460 print_header
462 Identical to the tinrc variable of the same name
463 process_only_unread
465 Identical to the tinrc variable of the same name
466 prompt_followupto
468 Identical to the tinrc variable of the same name
469 quote_chars
471 Identical to the tinrc variable of the same name
472 savedir
474 Identical to the tinrc variable of the same name
475 savefile
477 show_author
479 Identical to the tinrc variable of the same name
480 show_info
482 Identical to the tinrc variable of the same name
483 show_only_unread_arts
485 Identical to the tinrc variable of the same name
486 show_signatures
488 Identical to the tinrc variable of the same name
489 sigdashes
491 Identical to the tinrc variable of the same name
492 sigfile
494 Identical to the tinrc variable of the same name
495 signature_repost
497 Identical to the tinrc variable of the same name
498 sort_article_type
500 Identical to the tinrc variable sort_article_type
501 sort_threads_type
503 Identical to the tinrc variable of the same name
504 tex2iso_conv
506 Identical to the tinrc variable of the same name
507 thread_articles
509 Identical to the tinrc variable of the same name
510 thread_catchup_on_exit
512 Identical to the tinrc variable of the same name
513 thread_format
515 Identical to the tinrc variable of the same name
516 thread_perc
518 Identical to the tinrc variable of the same name
519 trim_article_body
521 Identical to the tinrc variable of the same name
522 verbatim_handling
524 Identical to the tinrc variable of the same name
525 wrap_on_next_unread
527 Identical to the tinrc variable of the same name
528 x_body A piece of text that will be added at the start of a mes‐
530 sage body. If this string starts with a / or ~ then it is
531 assumed to be the name of a file containing the text to
532 insert.
533 x_comment_to
535 Insert ''X-Comment-To:'' header, this is only useful in
536 FIDO groups.
537 x_headers
539 A string including header-name and the contents of the
540 header that will be automatically added when posting. If
541 the string starts with a / or ~ then it is assumed to be
542 the name of a file containing the header and its content
543 to be inserted. If the string starts with a ! then what
544 follows is assumed to be the path to a program to be exe‐
545 cuted to generate the header and its content. %G is ex‐
546 panded to the current news.group.name and %P is expanded
547 to the news.group.name with all '.' replaced by '/'.
548 quick_kill_scope
550 A comma-separated list of newsgroup patterns (wildmat-
551 style) to which groups the filter rule added by QuickFil‐
552 terKill will be applied. If unset the default from the
553 tinrc variable default_filter_kill_global will be used.
554 quick_kill_expire
556 Identical to the tinrc variable default_filter_kill_ex‐
557 pire
558 quick_kill_case
560 Identical to the tinrc variable default_filter_kill_case
561 quick_kill_header
563 Identical to the tinrc variable default_fil‐
564 ter_kill_header
565 quick_select_scope
567 A comma-separated list of newsgroup patterns (wildmat-
568 style) to which groups the filter rule added by QuickFil‐
569 terSelect will be applied. If unset the default from the
570 tinrc variable default_filter_select_global will be used.
571 quick_select_expire
573 Identical to the tinrc variable default_filter_select_ex‐
574 pire
575 quick_select_case
577 Identical to the tinrc variable default_filter_se‐
578 lect_case
579 quick_select_header
581 Identical to the tinrc variable default_filter_se‐
582 lect_header
583 ispell Path and options for ispell(1)-like spell-checker, e.g.
585 "aspell --mode=email --dont-backup check"
586 mm_network_charset
588 Identical to the tinrc variable of the same name
589 undeclared_charset
591 Assume (broken) articles without MIME charset declaration
592 have this charset — default is US-ASCII. This attribute
593 works only on systems with working iconv(3), others might
594 have to compile tin(1) with --dis‐
595 able-mime-strict-charset.
596 Example:
598 # include extra headers
599 # assume ISO-8859-1 as charset if no charset is declared
600 scope=*
601 x_headers=~/.tin/headers
602 undeclared_charset=ISO-8859-1
603 # in *sources* set post process type to shar only
605 scope=*sources*
606 post_process_type=1
607 # in *binaries* turn on full post processing,
609 # remove tmp files and set Followup-To: poster
610 scope=*binaries*
611 post_process_type=2
612 delete_tmp_files=ON
613 followup_to=poster
614 # in fido.* newsgroups change quote_chars
616 # and add X-Comment-To: line
617 scope=fido.*
618 quote_chars=%I>_
619 x_comment_to=ON
620 # in *.test newsgroups, don't append signature
622 # and preset Subject
623 scope=*.test
624 sigfile=--none
625 x_headers=Subject: test - ignore - no reply
626 # assume ISO-2022-JP-2 as charset
628 scope=fj.*,japan.*
629 undeclared_charset=ISO-2022-JP-2
630 ${TIN_HOMEDIR:-"$HOME"}/.tin/filter
632 The filter file is used to assign scores to certain articles.
634 Based on the score an article can be filtered out (hidden) or
635 marked hot. Empty lines or lines beginning with a '#' are ig‐
636 nored.
637 comment
639 Every entry (rule) in the filter file might get a com‐
640 ment. Multiple lines are allowed (but only for comments
641 yet). Every line must start with the "comment=" keyword.
642 Comments must appear first in the rule. Comment lines
643 placed within a rule will be moved to the begin of the
644 next rule. This might be changed in the future. Don't use
645 '#' to mark comments as those lines are ignored and your
646 comments will get lost on the next write of the file.
647 group A comma-separated list of newsgroup patterns in wildmat-
649 style to which groups the filter rule will be applied.
650 This line is mandatory!
651 case 0=case-sensitive, 1=case-insensitive
653 score Score value of the rule; can also be one of the magic
655 words "kill" or "hot".
656 subj Match against ''Subject:''. The matching type used (wild‐
658 mat or regex) depends on the setting of the tinrc vari‐
659 able wildcard.
660 from Match against ''From:''. tin(1) converts the contents of
662 the ''From:'' header to an old style e-mail address, e.g.
663 ''some@body.example (John Doe)'' instead of ''John Doe
664 <some@body.example>'', before trying to match the pat‐
665 terns in the filter rule. The matching type used (wildmat
666 or regex) depends on the setting of the tinrc variable
667 wildcard.
668 msgid Match against ''Message-ID:'' and full ''References:''.
670 The matching type used (wildmat or regex) depends on the
671 setting of the tinrc variable wildcard.
672 msgid_last
674 Match against ''Message-ID:'' and last ''References:''
675 entry only. The matching type used (wildmat or regex) de‐
676 pends on the setting of the tinrc variable wildcard.
677 msgid_only
679 Match against ''Message-ID:''. The matching type used
680 (wildmat or regex) depends on the setting of the tinrc
681 variable wildcard.
682 refs_only
684 Match against ''References:''. The matching type used
685 (wildmat or regex) depends on the setting of the tinrc
686 variable wildcard.
687 lines Match against ''Lines:'', <num matches less than, >num
689 matches more than.
690 gnksa Match against ''From:'' address parser return codes. <num
692 matches less than, >num matches more than the returned
693 numeric value. GNKSA_LOCAL_DOMAIN_LITERAL or GNKSA_IN‐
694 VALID_DOMAIN are only returned if disable_gnksa_do‐
695 main_check is set to false. As the built in domain list
696 is outdated this should be considered carefully.
697 0 GNKSA_OK
698 1 GNKSA_INTERNAL_ERROR
699 100 GNKSA_LANGLE_MISSING
700 101 GNKSA_LPAREN_MISSING
701 102 GNKSA_RPAREN_MISSING
702 103 GNKSA_ATSIGN_MISSING
703 104 GNKSA_RANGLE_MISSING
704 200 GNKSA_SINGLE_DOMAIN
705 201 GNKSA_INVALID_DOMAIN
706 202 GNKSA_ILLEGAL_DOMAIN
707 203 GNKSA_UNKNOWN_DOMAIN
708 204 GNKSA_INVALID_FQDN_CHAR
709 205 GNKSA_ZERO_LENGTH_LABEL
710 206 GNKSA_ILLEGAL_LABEL_LENGTH
711 207 GNKSA_ILLEGAL_LABEL_HYPHEN
712 208 GNKSA_ILLEGAL_LABEL_BEGNUM
713 209 GNKSA_BAD_DOMAIN_LITERAL
714 210 GNKSA_LOCAL_DOMAIN_LITERAL
715 211 GNKSA_RBRACKET_MISSING
716 300 GNKSA_LOCALPART_MISSING
717 301 GNKSA_INVALID_LOCALPART
718 302 GNKSA_ZERO_LENGTH_LOCAL_WORD
719 400 GNKSA_ILLEGAL_UNQUOTED_CHAR
720 401 GNKSA_ILLEGAL_QUOTED_CHAR
721 402 GNKSA_ILLEGAL_ENCODED_CHAR
722 403 GNKSA_BAD_ENCODE_SYNTAX
723 404 GNKSA_ILLEGAL_PAREN_CHAR
724 405 GNKSA_INVALID_REALNAME
725 406 GNKSA_MISSING_REALNAME
726 xref Match against ''Xref:'' line. Before any matching is done
728 the line is turned into the same format ''Newsgroups:''
729 has that is it is turned into a comma separated newsgroup
730 list with all other information (i.e. the article
731 counter) removed. The matching type used (wildmat or
732 regex) depends on the setting of the tinrc variable wild‐
733 card.
734 path Match against ''Path:'' line. This may not work on some
736 servers. The matching type used (wildmat or regex) de‐
737 pends on the setting of the tinrc variable wildcard.
738 time time_t value when rule expires
740 Example:
742 comment=mark all articles about tin, rtin,
743 comment=tind, ktin or cdtin as hot
744 group=*
745 case=1
746 score=hot
747 subj=\b(cd|[rk]?)?tin(d|pre)?[-.0-9]*\b
748 /etc/tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
750 ${TIN_HOMEDIR:-"$HOME"}/.tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
751 Keymap-file, containing "keyname value [value]" pairs separated
753 by spaces or tabs. Below is a list of all rebindable keynames
754 and their defaults. If a keyname is bound to NULL it is unas‐
755 signed.
756 ShellEscape !
758 SetRange #
759 LastPage $
760 ToggleColor &
761 LastViewed -
762 SearchRepeat \
763 SearchSubjF /
764 SearchSubjB ?
765 SearchAuthB A
766 SearchBody B
767 CatchupNextUnread C
768 EditFilter E
769 ToggleHelpDisplay H
770 ToggleInverseVideo I
771 LookupMessage L
772 OptionMenu M
773 Postponed O ^O
774 QuitTin Q
775 BugReport R
776 DisplayPostHist W
777 MarkThrUnread Z
778 FirstPage ^
779 SearchAuthF a
780 Catchup c
781 Help h
782 ToggleInfoLastLine i
783 Down j ^N
784 Up k ^P
785 Print o
786 Quit q
787 Version v
788 Post w
789 MarkArtUnread z
790 QuickFilterSelect [
791 QuickFilterKill ]
792 Pipe |
793 ScrollUp <
794 ScrollDown >
795 PageUp b ^B ^U
796 PageDown ^D ^F SPACE
797 RedrawScr ^L
798 Postponed ^O
799 MenuFilterSelect ^A
800 MenuFilterKill ^K
801 MarkFeedRead ^X
802 MarkFeedUnread ^W
803 AttachSelect ^J ^M
805 AttachPipe p
806 AttachSave s
807 AttachTag t
808 AttachUntag U
809 AttachTagPattern =
810 AttachToggleTagged @
811 ConfigToggleAttrib TAB
813 ConfigSelect ^J ^M
814 ConfigLastPage G
815 ConfigNoSave Q
816 ConfigScopeMenu S
817 ConfigFirstPage g
818 ConfigResetAttrib r
819 FeedTag T
821 FeedArt a
822 FeedHot h
823 FeedPat p
824 FeedRepost r
825 FeedSupersede s
826 FeedThd t
827 FilterEdit e
829 FilterSave s
830 GroupNextUnreadArtOrGrp TAB
832 GroupReadBasenote ^J ^M
833 GroupSelThd *
834 GroupDoAutoSel +
835 GroupToggleThdSel .
836 GroupSelThdIfUnreadSelected ;
837 GroupSelPattern =
838 GroupReverseSel @
839 GroupCancel D
840 GroupToggleGetartLimit G
841 GroupMarkThdRead K
842 GroupNextUnreadArt N
843 GroupPrevUnreadArt P
844 GroupAutoSave S
845 GroupTagParts T
846 GroupUntag U
847 GroupMarkUnselArtRead X
848 GroupToggleSubjDisplay d
849 GroupGoto g
850 GroupListThd l
851 GroupMail m
852 GroupNextGroup n
853 GroupPrevGroup p
854 GroupToggleReadUnread r
855 GroupSave s
856 GroupTag t
857 GroupToggleThreading u
858 GroupRepost x
859 GroupUndoSel ~
860 HelpLastPage G
862 HelpFirstPage g
863 PageReplyQuoteHeaders ^E
865 PagePGPCheckArticle ^G
866 PageToggleRaw ^H
867 PageNextUnread TAB
868 PageNextThd ^J ^M
869 PageToggleTabs ^T
870 PageFollowupQuoteHeaders ^W
871 PageToggleTex2iso "
872 PageToggleAllHeaders *
873 PageToggleRot %
874 PageToggleUue (
875 PageReveal )
876 PageSkipIncludedText :
877 PageTopThd <
878 PageBotThd >
879 PageCancel D
880 PageFollowup F
881 PageLastPage G
882 PageKillThd K
883 PageNextUnreadArt N
884 PagePrevUnreadArt P
885 PageReply R
886 PageAutoSave S
887 PageGroupSel T
888 PageViewUrl U
889 PageViewAttach V
890 PageToggleHighlight _
891 PageEditArticle e
892 PageFollowupQuote f
893 PageFirstPage g
894 PageListThd l
895 PageMail m
896 PageNextArt n
897 PagePrevArt p
898 PageReplyQuote r
899 PageSave s
900 PageTag t
901 PageGotoParent u
902 PageRepost x
903 PgpEncSign b
905 PgpEncrypt e
906 PgpIncludekey i
907 PgpSign s
908 PostAbort a
910 PostContinue c
911 PostCancel d
912 PostEdit e
913 PostPGP g
914 PostIspell i
915 PostIgnore i
916 PostMail m
917 PostPostpone o
918 PostPost p y
919 PostSupersede s
920 PostSend s y
921 PostedArticlesSelect ^J ^M
923 PostponeOverride Y
925 PostponeAll A
926 PromptYes y Y
928 PromptNo n N
929 PProcNone n
931 PProcShar s
932 PProcYes y
933 SaveAppendFile a
935 SaveOverwriteFile o
936 SelectEnterNextUnreadGrp TAB n
938 SelectReadGrp ^J ^M
939 SelectResetNewsrc ^R
940 SelectSortActive .
941 SelectNextUnreadGrp N
942 SelectSubscribePat S
943 SelectUnsubscribePat U
944 SelectQuitNoWrite X
945 SelectSyncWithActive Y
946 SelectToggleDescriptions d
947 SelectGoto g
948 SelectMoveGrp m
949 SelectToggleReadDisplay r
950 SelectSubscribe s
951 SelectUnsubscribe u
952 SelectYankActive y
953 SelectMarkGrpUnread z Z
954 ScopeSelect ^J ^M
956 ScopeEditAttributesFile E
957 ScopeAdd a
958 ScopeDelete d
959 ScopeMove m
960 ScopeRename r
961 ThreadReadNextArtOrThread TAB
963 ThreadReadArt ^J ^M
964 ThreadSelArt *
965 ThreadToggleArtSel .
966 ThreadReverseSel @
967 ThreadCancel D
968 ThreadMarkArtRead K
969 ThreadAutoSave S
970 ThreadUntag U
971 ThreadToggleSubjDisplay d
972 ThreadMail m
973 ThreadSave s
974 ThreadTag t
975 ThreadTagParts T
976 ThreadUndoSel ~
977 UrlSelect ^J ^M
979 ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups
981 This file provides short descriptions of each mailgroup. (re‐
983 quires tin(1) to be build with mh-mail-handling support). Each
984 line consist of two tab-separated fields "mailgroupname one-line
985 description".
986 mailgroupname
988 is the name of the newsgroup
989 description
991 is a short single-line description of the group
992 ${TIN_HOMEDIR:-"$HOME"}/.tin/newsrctable
994 "nntpserver newsrc [shortname [...]]" pairs to use with the
996 ''-g'' command-line switch.
997 nntpserver
999 full qualified domain name of the news server.
1000 newsrc related newsrc.
1002 shortname
1004 nickname(s) for the nntpserver.
1005 Example:
1007 # sample newsrctable file
1008 news.tin.org .newsrc-tin.org tinorg
1009 news.example.org /tmp/nrc-ex example ex
1010 ${TIN_HOMEDIR:-"$HOME"}/.tin/posted
1012 Posting history. The file is written by tin(1) and used by Dis‐
1014 playPostHist ('W') command. It should not be altered manually.
1015 Any line that starts with "#" is a comment. Blank lines are ig‐
1016 nored. All other lines shall consist of at least four pipe-sepa‐
1017 rated fields, starting with a time stamp "dd-mm-yy", a single
1018 letter indicating the action which initiated the message, a
1019 group name or a mail address the message was sent to, the sub‐
1020 ject of the message and optionally the messages ''Message-ID''
1021 if known.
1022 ${TIN_HOMEDIR:-"$HOME"}/Mail/posted
1024 Copy of all posted articles in mbox(5) format. The filename can
1026 be changed by setting posted_articles_file.
1027 ${TIN_HOMEDIR:-"$HOME"}/.tin/postponed.articles
1029 Pool of postponed articles. This file is in mbox(5) format.
1031 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/newsgroups
1033 This file a copy of the servers newsgroups file which provides
1035 short descriptions of each newsgroup. It is automatically up‐
1036 dated on startup except when using the ''-X''or ''-q'' command-
1037 line option and an old copy exists. Each line consist of two
1038 tab-separated fields "group.name one-line de‐
1039 scription".
1040 group.name
1042 is the name of the newsgroup
1043 one-line description
1045 is a short single-line description of the group
1046 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/serverrc
1048 File to store $NNTPSERVER and $NNTPPORT related data via a list
1050 of "variable=value" pairs. Currently there are only two vari‐
1051 ables, both are not meant to be changed by the user.
1052 version
1054 Internal version number.
1055 last_newnews
1057 Internal timestamp used by tin(1) to keep track of new
1058 newsgroups on the server.
1059 /etc/tin/tinrc
1061 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc
1062 At startup, tin(1) reads in the configuration file. This con‐
1064 tains a list of "variable=value" pairs that can be used to con‐
1065 figure the way tin(1) works. If it exists, the global configura‐
1066 tion file, ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc is read first. After
1067 that, the user's own configuration file ${TIN_HOME‐
1068 DIR:-"$HOME"}/.tin/tinrc is read. The global file is useful for
1069 distributing system-wide defaults to new users who have no pri‐
1070 vate tinrc yet (see also /etc/tin/tin.defaults).
1071 abbreviate_groupname
1073 If ON abbreviate long newsgroup names at group selection
1074 level and article level (if necessary) like this:
1075 news.software.readers -> n.software.readers -> n.s.read‐
1076 ers -> n.s.r. Default is OFF.
1077 add_posted_to_filter
1079 If ON add posted articles which start a new thread to
1080 filter for highlighting follow-ups. Default is ON.
1081 advertising
1083 Turn ON advertising in header (''User-Agent:''). Default
1084 is ON.
1085 alternative_handling
1087 If ON strip multipart/alternative messages automatically.
1088 Default is ON.
1089 art_marked_deleted
1091 The character used to show that an article was deleted.
1092 Default is 'D'.
1093 art_marked_inrange
1095 The character used to show that an article is in a range.
1096 Default is '#'.
1097 art_marked_return
1099 The character used to show that an article will return as
1100 an unread article when the group is next entered. Default
1101 is '-'.
1102 art_marked_selected
1104 The character used to show that an article/thread is
1105 auto-selected (hot). Default is '*'.
1106 art_marked_recent
1108 The character used to show that an article/thread is re‐
1109 cent (not older than X days). See also recent_time. De‐
1110 fault is 'o'.
1111 art_marked_unread
1113 The character used to show that an article has not been
1114 read. Default is '+'.
1115 art_marked_read
1117 The character used to show that an article was read. De‐
1118 fault is ' '.
1119 art_marked_killed
1121 The character used to show that an article was killed.
1122 Default is 'K'. kill_level must be set accordingly.
1123 art_marked_read_selected
1125 The character used to show that an article was hot before
1126 it was read. Default is ':'. kill_level must be set ac‐
1127 cordingly.
1128 Ask before using MIME viewer (ask_for_metamail)
1130 If ON tin(1) will ask before using a MIME viewer (meta‐
1131 mail_prog) to display MIME messages. This only occurs if
1132 a MIME viewer is set. Default is OFF.
1133 auto_cc_bcc
1135 Automatically put your name in the ''Cc:'' and/or
1136 ''Bcc:'' field when mailing an article. Default is No.
1137 auto_list_thread
1139 If ON automatically list thread when entering it using
1140 right arrow key. Default is ON.
1141 auto_reconnect
1143 Reconnect to server automatically. Default is OFF.
1144 batch_save
1146 If set ON articles/threads will be saved in batch mode
1147 when save ''-S'' or mail ''-M, -N'' is specified on the
1148 command line. Default is ON.
1149 beginner_level
1151 If set ON a mini menu of the most useful commands will be
1152 displayed at the bottom of the screen for each level.
1153 Also a short posting etiquette will be displayed after
1154 composing an article. Default is ON.
1155 cache_overview_files
1157 If ON, create local copies of NNTP overview files. This
1158 can be used to considerably speed up accessing large
1159 groups when using a slow connection. Default is OFF.
1160 cancel_lock_algo
1162 Use this hash algorithm for cancel-locks. Only available
1163 when build with cancel-lock support. none disables the
1164 generation of cancel-locks. Valid values are none, sha1,
1165 sha256 and sha512. Default is sha1.
1166 catchup_read_groups
1168 If set ON the user is asked when quitting if all groups
1169 read during the current session should be marked read.
1170 Default is OFF.
1171 col_back
1173 Standard background color
1174 col_extquote
1176 Color of quoted text from external sources
1177 col_from
1179 Color of sender (From:)
1180 col_head
1182 Color of header-lines
1183 col_help
1185 Color of help pages
1186 col_invers_bg
1188 Color of background for inverse text
1189 col_invers_fg
1191 Color of foreground for inverse text
1192 col_markdash
1194 Color of words emphasized like _this_. See also
1195 word_h_display_marks and word_highlight.
1196 col_markslash
1198 Color of words emphasized like /this/. See also
1199 word_h_display_marks and word_highlight.
1200 col_markstar
1202 Color of words emphasized like *this*. See also
1203 word_h_display_marks and word_highlight.
1204 col_markstroke
1206 Color of words emphasized like -this-. See also
1207 word_h_display_marks and word_highlight.
1208 col_message
1210 Color of status messages in last line
1211 col_minihelp
1213 Color of mini help menu
1214 col_newsheaders
1216 Color of actual news header fields
1217 col_normal
1219 Standard foreground color
1220 col_quote
1222 Color of quoted lines
1223 col_quote2
1225 Color of twice quoted lines
1226 col_quote3
1228 Color of >=3 times quoted lines
1229 col_response
1231 Color of response counter. This is the text that says
1232 "Response x of y" in the article viewer.
1233 col_signature
1235 Color of signatures
1236 col_urls
1238 Color of urls highlight
1239 col_verbatim
1241 Color of verbatim blocks
1242 col_subject
1244 Color of article subject
1245 col_text
1247 Color of text-lines
1248 col_title
1250 Color of help/mail sign
1251 confirm_choice
1253 tin(1) can ask for manual confirmation to protect the
1254 user. Available choices:
1255 commands: Ask for confirmation before executing cer‐
1256 tain dangerous commands (e.g., Catchup ('c')). Com‐
1257 mands that this affects are marked in this manual
1258 with '[after confirmation]'.
1259 quit: You'll be asked to confirm that you wish to
1261 exit tin(1) when you use the Quit ('q') command.
1262 select: Ask for confirmation before marking all not
1264 selected (with GroupMarkUnselArtRead ('X') command)
1265 articles as read.
1266 Default is commands & quit.
1267 date_format
1269 Format string used for date representation. A description
1270 of the different format options can be found at
1271 strftime(3). tin(1) uses strftime(3) when available and
1272 supports most format options in his fallback code. De‐
1273 fault is "%a, %d %b %Y %H:%M:%S".
1274 default_art_search
1276 default_author_search
1278 default_config_search
1280 The last article/author/config option that was searched
1281 for.
1282 default_filter_days
1284 Default is 28.
1285 default_filter_kill_case
1287 Default for quick (1 key) kill filter case. ON = filter
1288 case sensitive, OFF = ignore case. Default is OFF.
1289 default_filter_kill_expire
1291 Default for quick (1 key) kill filter expire. ON = limit
1292 to default_filter_days, OFF = don't ever expire. Default
1293 is OFF.
1294 default_filter_kill_global
1296 Default for quick (1 key) kill filter global. ON=apply
1297 to all groups, OFF=apply to current group. Default is ON.
1298 default_filter_kill_header
1300 Default for quick (1 key) kill filter header.
1301 0 ''Subject:'' (case sensitive)
1302 1 ''Subject:'' (ignore case)
1303 2 ''From:'' (case sensitive)
1304 3 ''From:'' (ignore case)
1305 4 ''Message-ID:'' & full ''References:'' line
1306 5 ''Message-ID:'' & last ''References:'' entry only
1307 6 ''Message-ID:'' entry only
1308 7 ''Lines:''
1309 default_filter_select_case
1311 Default for quick (1 key) auto-selection filter case.
1312 ON=filter case sensitive, OFF=ignore case. Default is
1313 OFF.
1314 default_filter_select_expire
1316 Default for quick (1 key) auto-selection filter expire.
1317 ON = limit to default_filter_days, OFF = don't ever ex‐
1318 pire. Default is OFF.
1319 default_filter_select_global
1321 Default for quick (1 key) auto-selection filter global.
1322 ON=apply to all groups, OFF=apply to current group. De‐
1323 fault is ON.
1324 default_filter_select_header
1326 Default for quick (1 key) auto-selection filter header.
1327 0 ''Subject:'' (case sensitive)
1328 1 ''Subject:'' (ignore case)
1329 2 ''From:'' (case sensitive)
1330 3 ''From:'' (ignore case)
1331 4 ''Message-ID:'' & full ''References:'' line
1332 5 ''Message-ID:'' & last ''References:'' entry only
1333 6 ''Message-ID:'' entry only
1334 7 ''Lines:''
1335 default_goto_group
1337 default_group_search
1339 default_mail_address
1341 default_move_group
1343 default_pattern
1345 default_pipe_command
1347 default_post_newsgroups
1349 default_post_subject
1351 default_range_group
1353 default_range_select
1355 default_range_thread
1357 default_repost_group
1359 default_save_file
1361 default_save_mode
1363 default_select_pattern
1365 default_shell_command
1367 default_subject_search
1369 draw_arrow
1371 Allows groups/articles to be selected by an arrow '->' if
1372 set ON or by a highlighted bar if set OFF. Default is
1373 OFF.
1374 editor_format
1376 The format string used to create the editor start command
1377 with parameters. Default is '%E +%N %F' with %E=Editor,
1378 %N=Linenumber and %F=Filename (e.g., /bin/vi +7 .arti‐
1379 cle). See also $VISUAL and $EDITOR under "ENVIRONMENT" in
1380 tin(1)
1381 extquote_handling
1383 If ON quotes from external sources will be detected. De‐
1384 fault is OFF.
1385 extquote_regex
1387 A regular expression that will be applied when reading
1388 articles. All matching lines are shown in col_extquote.
1389 If extquote_regex is blank, then tin(1) uses a built-in
1390 default.
1391 force_screen_redraw
1393 Specifies whether a screen redraw should always be done
1394 after certain external commands. Default is OFF.
1395 getart_limit
1397 If getart_limit is > 0 not more than the last
1398 getart_limit articles/group are fetched from the server.
1399 If getart_limit is < 0 tin(1) will start fetching arti‐
1400 cles from your first unread minus absolute value of
1401 getart_limit. Default is 0, which means no limit.
1402 goto_next_unread
1404 Which keys tin(1) should accept to jump to the next un‐
1405 read article. Possible is any combination of PageDown
1406 and PageNextUnread. When PageDown is set tin(1) jumps to
1407 the next article at the end of the current one. When Pa‐
1408 geNextUnread is set tin(1) jumps immediately to the next
1409 article when PageNextUnread ('<TAB>') is pressed. Default
1410 is PageNextUnread.
1411 group_catchup_on_exit
1413 If ON catchup group when leaving with the left arrow key.
1414 Default is ON.
1415 group_format
1417 The format string used for the Group level. Default is
1418 "%n %m %R %L %s %F". The following substitutions are
1419 supported:
1420 %D date
1421 %F from, name and/or address
1422 %I initials
1423 %L line count
1424 %M message-id
1425 %R number of responses in thread
1426 %S score
1427 %m article marks
1428 %n current thread number
1429 %s subject
1430 %% %
1431 hide_uue
1433 If set to 'No' then raw uuencoded data is displayed. If
1434 set to 'Yes' then sections of uuencoded data will be
1435 shown with a single tag line showing the size and file‐
1436 name (much the same as a MIME attachment). If set to
1437 'Hide all' then any line that looks like uuencoded data
1438 will be folded into a tag line. This is useful when uuen‐
1439 coded data is split across more than one article but can
1440 also lead to false positives. This setting can also be
1441 toggled in the article viewer. Default is 'No'.
1442 inews_prog
1444 Path, name and options of external inews(1). If you are
1445 reading via NNTP the default value is "--internal" (use
1446 built-in NNTP inews), else it is "inews -h". The article
1447 is passed to inews_prog on STDIN via '< article'.
1448 info_in_last_line
1450 If ON, show current group description or article subject
1451 in the last line (not in the pager and global menu) —
1452 ToggleInfoLastLine ('i') toggles setting. This facility
1453 is useful as the full width of the screen is available to
1454 display long subjects. Default is OFF.
1455 interactive_mailer
1457 If greater than 0 your mailreader will be invoked earlier
1458 for reply so you can use more of its features (e.g. MIME,
1459 pgp, ...). 1 means include headers, 2 means don't include
1460 headers (old use_mailreader_i=ON option). 0 turns off us‐
1461 age. This option has to suit mailer_format. Default is 0.
1462 inverse_okay
1464 If ON use inverse video for page headers and URL high‐
1465 lighting. Default is ON.
1466 keep_dead_articles
1468 If ON keep all failed postings in ${TIN_HOME‐
1469 DIR:-"$HOME"}/dead.articles besides keeping the last
1470 failed posting in ${TIN_HOMEDIR:-"$HOME"}/dead.article.
1471 Default is ON.
1472 kill_level
1474 This option controls the processing and display of arti‐
1475 cles that are killed. There are 3 options, default is 0
1476 (Kill only unread arts).
1477 0 Kill only unread arts is the 'traditional' behavior
1479 of tin(1). Only unread articles are killed once
1480 only by marking them read. As filtering only hap‐
1481 pens on unread articles with kill_level set to 0,
1482 art_marked_killed and art_marked_read_selected are
1483 only shown once. When you reenter the group the
1484 mark will be gone.
1485 1 Kill all arts & show with K will process all arti‐
1487 cles in the group and therefore there is a process‐
1488 ing overhead when using this option. Killed arti‐
1489 cles are threaded as normal but they will be marked
1490 with art_marked_killed.
1491 2 Kill all arts and never show will process all arti‐
1493 cles in the group and therefore there is a process‐
1494 ing overhead when using this option. Killed arti‐
1495 cles simply does not get displayed at all.
1496 mail_8bit_header
1498 Allows 8bit characters unencoded in the header of mail
1499 message. Default is OFF. Turning it ON is effective only
1500 if mail_mime_encoding is also set to 8bit. Leaving it OFF
1501 is safe for most users and compliant to Internet Mail
1502 Standard (RFC5322 and RFC2047). Default is OFF.
1503 mail_address
1505 User's mail address (and full name), if not user‐
1506 name@host. This is used when creating articles, sending
1507 mail and when pgp(1) signing.
1508 mail_mime_encoding
1510 MIME encoding of the body in mail message, if necessary
1511 (8bit, base64, quoted-printable, 7bit). Default is
1512 quoted-printable.
1513 mail_quote_format
1515 Format of quote line when replying (via mail) to an arti‐
1516 cle (%A=Address, %D=Date, %F=Fullname+Address, %G=Group‐
1517 name, %M=Message-ID, %N=Fullname, %C=Firstname, %I=Ini‐
1518 tials). Default is "In article %M you wrote:"
1519 mailbox_format
1521 Select one of the following mailbox-formats: MBOXO (de‐
1522 fault, except on SCO), MBOXRD or MMDF (default on SCO).
1523 See mbox(5) and RFC4155 for more details on MBOXO and
1524 MBOXRD and mmdf(5) for more details about MMDF.
1525 maildir
1527 The directory where articles/threads are to be saved in
1528 mbox(5) format. This feature is mainly for use with the
1529 mutt(1) mail program. It allows the user to save arti‐
1530 cles/threads/groups simply by giving '=' as the filename
1531 to save to. Default is ${TIN_HOMEDIR:-"$HOME"}/Mail.
1532 mailer_format
1534 The format string used to create the mailer command with
1535 parameters that is used for mailing articles to other
1536 people. Default is '%M "%T" < %F' (e.g., /bin/mail "iain"
1537 < .article). The flexible format allows other mailers
1538 with different command line parameters to be used such as
1539 sendmail -oem -t < %F
1540 mutt -s "%S" -- "%T" < "%F"
1541 claws-mail --compose "mailto:%T?subject=%S&insert=%F"
1542 interactive_mailer must be set adequate. The following
1543 substitutions are supported:
1544 %F filename
1545 %M default_mailer
1546 %S subject-field
1547 %T to-filed
1548 %U username
1549 %% %
1550 mark_saved_read
1552 If ON mark articles that are saved as read. Default is
1553 ON.
1554 mark_ignore_tags
1556 When this is ON, the GroupMarkThdRead ('K'), Thread‐
1557 MarkArtRead ('K'), MarkThdUnread ('Z') at Group level and
1558 MarkArtUnread ('z') at Thread level functions mark just
1559 the current article or thread, ignoring other tagged,
1560 (un)read articles. When OFF, the same function presents a
1561 menu with choices of the current thread or article, all
1562 tagged, unread articles, or nothing.
1563 metamail_prog
1565 Path, name and options of external metamail(1) program
1566 used to view non-textual parts of articles. To use the
1567 built-in viewer, set to --internal. This is the default
1568 value when metamail(1) is not installed. Leave it blank
1569 if you don't want any automatic viewing of non-textual
1570 attachments. The PageViewAttach ('V') command can always
1571 be used to manually view any attachments. See also
1572 ask_for_metamail.
1573 mm_charset
1575 Charset supported locally, which is also used for MIME
1576 header (charset parameter and charset name in header en‐
1577 coding) in mail and news postings. If MIME_STRICT_CHARSET
1578 is defined at compile time, text in charset other than
1579 the value of this parameter is considered not displayable
1580 and represented as '?'. Otherwise, all character sets are
1581 regarded as compatible with the display. If it's not set,
1582 the value of the environment variable $MM_CHARSET is
1583 used. US-ASCII or compile-time default is used in case
1584 neither of them is defined. If your system supports
1585 iconv(3), this option is disabled and you should use
1586 mm_network_charset instead.
1587 mm_network_charset
1589 Charset used for posting and MIME headers; replaces
1590 mm_charset. Conversion between mm_network_charset and
1591 local charset (determined via nl_langinfo(3)) is done via
1592 iconv(3), if this function is not available on your sys‐
1593 tem this option is disabled and you have to use
1594 mm_charset instead. mm_network_charset is limited to one
1595 of the following charsets:
1596 US-ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16},
1597 KOI8-{R,U,RU} EUC-{CN,JP,KR,TW}, ISO-2022-{CN,CN-
1598 EXT,JP,JP-1,JP-2}, Big5, UTF-8
1599 Not all values might work on your system, see
1600 iconv_open(3) for more details. If it's not set, the
1601 value of the environment variable $MM_CHARSET is used.
1602 US-ASCII or compile-time default is used in case neither
1603 of them is defined.
1604 mono_markdash
1606 Character attribute of words emphasized like _this_. It
1607 depends on your terminal which attributes are usable. See
1608 also word_h_display_marks and word_highlight.
1609 mono_markslash
1611 Character attribute of words emphasized like /this/. It
1612 depends on your terminal which attributes are usable. See
1613 also word_h_display_marks and word_highlight.
1614 mono_markstar
1616 Character attribute of words emphasized like *this*. It
1617 depends on your terminal which attributes are usable. See
1618 also word_h_display_marks and word_highlight.
1619 mono_markstroke
1621 Character attribute of words emphasized like -this-. It
1622 depends on your terminal which attributes are usable. See
1623 also word_h_display_marks and word_highlight.
1624 newnews
1626 These are internal timers used by tin(1) to keep track of
1627 new newsgroups. Do not change them unless you understand
1628 what they are for.
1629 news_headers_to_display
1631 Which news headers you wish to see. If you want to see
1632 _all_ the headers, place an '*' as this value. This is
1633 the only way a wildcard can be used. If you enter 'X-'
1634 as the value, you will see all headers beginning with
1635 'X-' (like X-Alan or X-Pape). You can list more than one
1636 by delimiting with spaces. Not defining anything turns
1637 off this option.
1638 news_headers_to_not_display
1640 Same as news_headers_to_display except it denotes the op‐
1641 posite. An example of using both options might be if you
1642 thought 'X-' headers were A Good Thing(tm), but thought
1643 Alan and Pape were miscreants... well then you would do
1644 something like this: news_headers_to_display=X-
1645 news_headers_to_not_display=X-Alan X-Pape Not defining
1646 anything turns off this option.
1647 news_quote_format
1649 Format of quote line when posting/following up an article
1650 (%A=Address, %D=Date, %F=Fullname+Address, %G=Groupname,
1651 %M=Message-ID, %N=Fullname, %C=Firstname, %I=Initials).
1652 Default is "%F wrote:".
1653 nntp_read_timeout_secs
1655 Time in seconds to wait for a response from the server.
1656 Default is 120.
1657 normalization_form
1659 The normalization form which should be used to normalize
1660 unicode input. The possible values are:
1661 0 None: no normalization
1663 1 NFKC: Compatibility Decomposition, followed by
1665 Canonical Composition
1666 2 NFKD: Compatibility Decomposition
1668 3 NFC: Canonical Decomposition, followed by Canonical
1670 Composition
1671 4 NFD: Canonical Decomposition
1673 5 NFKC_CF: Compatibility Decomposition, followed by
1675 Canonical Composition and Case Folding
1676 Some normalization modes are only available if they are sup‐
1677 ported by the library tin(1) uses to do the normalization. NFC
1678 should be used if possible.
1679 pos_first_unread
1681 If ON put cursor at first unread article in group other‐
1682 wise at last article. Default is ON.
1683 post_8bit_header
1685 Allows 8bit characters unencoded in the header of a news
1686 article, if set this also disables the generation of
1687 MIME-headers when they are usually required. Default is
1688 OFF. Only enacted if post_mime_encoding is also set to
1689 8bit. In a number of local hierarchies where 8bit charac‐
1690 ters are used, using unencoded (raw) 8bit characters in
1691 header is acceptable and sometimes even recommended so
1692 that you need to check the convention adopted in the lo‐
1693 cal hierarchy of your interest to determine what to do
1694 with this and post_mime_encoding.
1695 post_mime_encoding
1697 MIME encoding of the body in news message, if necessary.
1698 (8bit, base64, quoted-printable, 7bit). Default is 8bit,
1699 which leads to no encoding. base64 and quoted-printable
1700 are usually undesired on usenet.
1701 post_process_view
1703 If ON, then tin(1) will start an appropriate viewer pro‐
1704 gram to display any files that were post processed and
1705 uudecoded. The program is determined using the mailcap(5)
1706 file. Default is ON.
1707 post_process_type
1709 This specifies whether to perform post processing on
1710 saved articles. Because the shell archive may contain
1711 commands you may not want to be executed, be careful when
1712 extracting shell archives. The following values are al‐
1713 lowed:
1714 0 No (default), no post processing is done.
1716 1 Shell archives, unpacking of multi-part shar(1)
1718 files only.
1719 2 Yes, binary attachments and data will be decoded
1721 and saved.
1722 posted_articles_file
1724 Keep posted articles in given file. If the given filename
1725 does not contain any expandable strings it will be pre‐
1726 fixed with ${TIN_HOMEDIR:-"$HOME"}/Mail/. If no filename
1727 is set then postings will not be saved. See the section
1728 "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
1729 for more information about the various expansion charac‐
1730 ters. Default is 'posted'.
1731 print_header
1733 If ON, then the full article header is sent to the
1734 printer. Otherwise only the ''Subject:'' and ''From:''
1735 fields are output. Default is OFF.
1736 printer
1738 The printer program with options that is to be used to
1739 print articles. The default is lpr(1) for BSD machines
1740 and lp(1) for SysV machines. Printing from tin(1) may
1741 have been disabled by the System Administrator.
1742 process_only_unread
1744 If ON only save/print/pipe/mail unread articles (tagged
1745 articles excepted). Default is OFF.
1746 prompt_followupto
1748 If ON show empty ''Followup-To:'' header when editing an
1749 article. Default is OFF.
1750 quote_chars
1752 The character used in quoting included text to article
1753 followups and mail replies. The '_' character represents
1754 a blank character and is replaced with ' ' when read, %I
1755 is replaced by author's initials. Default is '>_'.
1756 quote_style
1758 This bit coded integer value controls how articles are to
1759 be quoted when following up or replying to them. Any of
1760 the following options can be combined by adding all rele‐
1761 vant values. Default is 5, which means that quote charac‐
1762 ters are compressed and empty lines are quoted.
1763 1 Compress quotes Compress quote characters together
1765 when quoting multiple times (for example, '> > >'
1766 will be turned into '>>>'). This option is on by
1767 default.
1768 2 Quote Signatures This option is off by default.
1770 Signatures are always quoted regardless of this op‐
1771 tion when you are viewing an article in raw mode
1772 PageToggleRaw ('^H') and followup or reply to it.
1773 Signatures are never quoted regardless of this op‐
1774 tion when show_signatures is off.
1775 4 Quote empty lines This option is on by default.
1777 quote_regex
1779 A regular expression that will be applied when reading
1780 articles. All matching lines are shown in col_quote. If
1781 quote_regex is blank, then tin(1) uses a built-in de‐
1782 fault.
1783 quote_regex2
1785 A regular expression that will be applied when reading
1786 articles. All matching lines are shown in col_quote2. If
1787 quote_regex2 is blank, then tin(1) uses a built-in de‐
1788 fault.
1789 quote_regex3
1791 A regular expression that will be applied when reading
1792 articles. All matching lines are shown in col_quote3. If
1793 quote_regex3 is blank, then tin(1) uses a built-in de‐
1794 fault.
1795 recent_time
1797 If set to 0, this feature is deactivated, otherwise it
1798 means the number of days. Default is 2.
1799 render_bidi
1801 If ON tin(1) does the rendering of bi-directional text.
1802 If OFF tin(1) leaves the rendering of bi-directional text
1803 to the terminal. Default is OFF.
1804 reread_active_file_secs
1806 The news ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE‐
1807 FILE:-active} file is reread at regular intervals to show
1808 if any new news has arrived. Default is 1200. Setting
1809 this to 0 will disable this feature.
1810 savedir
1812 Directory where articles/threads are saved. Default is
1813 ${TIN_HOMEDIR:-"$HOME"}/News.
1814 score_limit_kill
1816 If the score of an article is below or equal this value
1817 the article gets marked as killed.
1818 score_limit_select
1820 If the score of an article is above or equal this value
1821 the article gets marked as hot.
1822 score_kill
1824 Score of an article which should be killed, this must be
1825 <= score_limit_kill.
1826 score_select
1828 Score of an article which should be marked hot, this must
1829 be >= score_limit_select.
1830 scroll_lines
1832 The number of lines that will be scrolled up/down in the
1833 article pager when using cursor-up/down. The default is 1
1834 (line-by-line). Set to 0 to get traditional tin page-by-
1835 page scrolling. Set to -1 to get page-by-page scrolling
1836 where the top/bottom line is carried over onto the next
1837 page. This setting supersedes
1838 show_last_line_prev_page=ON. Set to -2 to get half-page
1839 scrolling. This setting supersedes full_page_scroll=OFF.
1840 select_format
1842 The format string used for the Selection level. Default
1843 is "%f %n %U %G %d". The following substitutions are
1844 supported:
1845 %G group name
1846 %U unread count
1847 %d description
1848 %f group flag
1849 %n current group number
1850 %% %
1851 sort_function
1853 Function used for sorting articles. Default is 0.
1854 0 Use qsort(3) for sorting.
1856 1 Use heapsort(3) for sorting. This might be faster in
1858 large groups with long threads (somewhat presorted
1859 data).
1860 show_author
1862 Which information about the author should be shown. De‐
1863 fault is 2, authors full name.
1864 0 None, only the ''Subject:'' line will be displayed.
1866 1 Address, ''Subject:'' line & the address part of
1868 the ''From:'' line are displayed.
1869 2 Full Name, ''Subject:'' line & the authors full
1871 name part of the ''From:'' line are displayed (de‐
1872 fault).
1873 3 Address and Name, ''Subject:'' line & all of the
1875 ''From:'' line are displayed.
1876 show_description
1878 If ON show a short group description text after newsgroup
1879 name at the group selection level. The ''-d'' command-
1880 line flag will override the setting and turn descriptions
1881 off. The text used is taken from the ${TIN_LIB‐
1882 DIR:-NEWSLIBDIR}/newsgroups file and if supported (re‐
1883 quires tin(1) to be build with mh-mail-handling support)
1884 from ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups for mail‐
1885 groups. Default is ON.
1886 show_info
1888 Which information about the thread or article should be
1889 shown. Default is 1, show only the line count.
1890 0 None, no information will be displayed.
1892 1 Lines, in article listing the line count of an ar‐
1894 ticle will be displayed and in thread listing the
1895 line count of first (unread) article will be dis‐
1896 played.
1897 2 Score, in article listing the score of an article
1899 will be displayed and in thread listing the score
1900 of the thread will be displayed — see also
1901 thread_score.
1902 3 Lines & Score, display line count and score.
1904 show_only_unread_arts
1906 If ON show only new/unread articles otherwise show all
1907 articles. Default is ON.
1908 show_only_unread_groups
1910 If ON show only subscribed groups that contain unread ar‐
1911 ticles. Default is OFF.
1912 show_signatures
1914 If OFF don't show signatures when displaying articles.
1915 Default is ON.
1916 sigdashes
1918 If ON prepend the signature with sigdashes. Default is
1919 ON.
1920 sigfile
1922 The path that specifies the signature file to use when
1923 posting, following up to or replying to an article. If
1924 the path is a directory then the signature will be ran‐
1925 domly generated from files that are in the specified di‐
1926 rectory. If the path starts with a ! the program the path
1927 points to will be executed to generate a signature. In
1928 order to pass the group name to the program, %G can be
1929 specified. This will be replaced by the name of the cur‐
1930 rent newsgroup. --none will suppress any signature. De‐
1931 fault is ${TIN_HOMEDIR:-"$HOME"}/.Sig.
1932 signature_repost
1934 If ON add signature to reposted articles. Default is ON.
1935 slashes_regex
1937 A regular expression that will be applied when reading
1938 articles. All matching words are shown in col_markslash
1939 or mono_markslash. If slashes_regex is blank, then tin(1)
1940 uses a built-in default.
1941 sort_article_type
1943 This specifies how articles should be sorted. Sort by as‐
1944 cending Date (6) is the default. The following sort types
1945 are allowed:
1946 0 Nothing, don't sort articles.
1948 1 Subject: (descending), sort articles by ''Sub‐
1950 ject:'' field descending.
1951 2 Subject: (ascending), sort articles by ''Subject:''
1953 field ascending.
1954 3 From: (descending), sort articles by ''From:''
1956 field descending.
1957 4 From: (ascending), sort articles by ''From:'' field
1959 ascending.
1960 5 Date: (descending), sort articles by ''Date:''
1962 field descending.
1963 6 Date: (ascending), sort articles by ''Date:'' field
1965 ascending (default).
1966 7 Score (descending), sort articles by filtering
1968 score descending.
1969 8 Score (ascending), sort articles by filtering score
1971 ascending.
1972 9 Lines: (descending), sort articles by ''Lines:''
1974 field descending.
1975 10 Lines: (ascending), sort articles by ''Lines:''
1977 field ascending.
1978 sort_threads_type
1980 This specifies how threads will be sorted. Sort by de‐
1981 scending Score (1) is the default. The following sort
1982 types are allowed:
1983 0 Nothing, don't sort threads.
1985 1 Score (descending), sort threads by filtering score
1987 descending (default).
1988 2 Score (ascending), sort threads by filtering score
1990 ascending.
1991 3 Last posting date (descending), sort threads by
1993 date of last posting descending.
1994 4 Last posting date (ascending), sort threads by date
1996 of last posting ascending.
1997 spamtrap_warning_addresses
1999 Set this option to a list of comma-separated strings to
2000 be warned if you are replying to an article by mail where
2001 the e-mail address contains one of these strings. The
2002 matching is case-insensitive. Example:
2003 spam,delete,remove
2005 stars_regex
2007 A regular expression that will be applied when reading
2008 articles. All matching words are shown in col_markstar or
2009 mono_markstar. If stars_regex is blank, then tin(1) uses
2010 a built-in default.
2011 strip_blanks
2013 Strips the blanks from the end of each line therefore
2014 speeding up the display when reading on a slow terminal
2015 or via modem. Default is ON.
2016 strip_bogus
2018 Bogus groups are groups that are present in your
2019 ${TIN_HOMEDIR:-"$HOME"}/.newsrc file that no longer exist
2020 on the news server. There are 3 options. 0 means do noth‐
2021 ing & always keep bogus groups. 1 means bogus groups
2022 will be permanently removed. 2 means that bogus groups
2023 will appear on the Group Selection Menu, prefixed with a
2024 'D'. This allows you to unsubscribe from them as and when
2025 you wish. Default is 0 (Always Keep).
2026 strip_newsrc
2028 If ON, then unsubscribed groups will be permanently re‐
2029 moved from your ${TIN_HOMEDIR:-"$HOME"}/.newsrc file. De‐
2030 fault is OFF.
2031 strip_re_regex
2033 A regular expression to find Subject prefixes like "Re:"
2034 to remove If strip_re_regex is blank, then tin(1) uses a
2035 built-in default.
2036 strip_was_regex
2038 A regular expression to find Subject suffixes like
2039 "(was:" to remove. If strip_was_regex is blank, then
2040 tin(1) uses a built-in default.
2041 strokes_regex
2043 A regular expression that will be applied when reading
2044 articles. All matching words are shown in col_markstroke
2045 or mono_markstroke. If strokes_regex is blank, then
2046 tin(1) uses a built-in default.
2047 tex2iso_conv
2049 Decode German style TeX umlaut codes to ISO If ON, show
2050 "a as Umlaut-a, etc. Default is OFF. This behavior can
2051 also be toggled in the article viewer via PageToggle‐
2052 Tex2iso ('"').
2053 thread_articles
2055 Defines which threading method to use. The choices are:
2056 0) Don't thread, 1) Thread on Subject only 2) Thread on
2057 References only, 3) Thread on References then Subject
2058 (default) 4) Thread multipart articles on Subject. 5)
2059 Thread on Percentage Match of the Subjects It's also pos‐
2060 sible to set the threading type on a per group basis by
2061 setting the group attribute variable thread_articles to 0
2062 – 5 in the file ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes.
2063 thread_format
2065 The format string used for the Thread level. Default is
2066 "%n %m [%L] %T %F". The following substitutions are
2067 supported:
2068 %D date
2069 %F from, name and/or address
2070 %I initials
2071 %L line count
2072 %M message-id
2073 %S score
2074 %T thread tree
2075 %m article marks
2076 %n current article number
2077 %% %
2078 thread_perc
2080 Defines how close the subjects must match while threading
2081 by Percentage Match for threads to be considered part of
2082 a single thread. This value is in the range 0 to 100. The
2083 default is 75.
2084 thread_catchup_on_exit
2086 If ON catchup group/thread when leaving with the left ar‐
2087 row key. Default is ON.
2088 thread_score
2090 How the total score of a thread is computed. Default is
2091 0, the maximum score in this thread.
2092 0 Max, the maximum score in this thread.
2094 1 Sum, the sum of all scores in this thread.
2096 2 Average, the average score in this thread.
2098 translit
2100 If ON append //TRANSLIT to the first argument of
2101 iconv_open(3) to enable transliteration. This means that
2102 when a character cannot be represented in the target
2103 character set, it can be approximated through one or sev‐
2104 eral similarly looking characters. On systems where this
2105 extension doesn't exist, this option is disabled. Default
2106 is OFF.
2107 trim_article_body
2109 Allows you to select how tin(1) treats blank lines in ar‐
2110 ticle bodies. Default is 0. This option does not affect
2111 lines within verbatim blocks.
2112 0 Don't trim article body, do nothing.
2114 1 Skip leading blank lines.
2116 2 Skip trailing blank lines.
2118 3 Skip leading and trailing blank l., skip leading
2120 and trailing blank lines.
2121 4 Compact multiple between text, replace multiple
2123 blank lines between text blocks with one blank
2124 line.
2125 5 Compact multiple and skip leading, 4 + 1
2127 6 Compact multiple and skip trailing, 4 + 2
2129 7 Compact mltpl., skip lead. & trai., 4 + 3
2131 underscores_regex
2133 A regular expression that will be applied when reading
2134 articles. All matching words are shown in col_markdash or
2135 mono_markdash. If underscores_regex is blank, then tin(1)
2136 uses a built-in default.
2137 unlink_article
2139 If ON remove ${TIN_HOMEDIR:-"$HOME"}/.article after post‐
2140 ing. Default is ON.
2141 url_handler
2143 The program that will be run when launching URLs in the
2144 article viewer using PageViewUrl ('U'). The actual URL
2145 will be appended. Default is url_handler.pl.
2146 url_highlight
2148 Enable highlighting URLs in message body. Default is ON.
2149 use_color
2151 If enabled tin(1) uses ANSI-colors. Default is OFF.
2152 use_keypad
2154 Use scroll keys on keypad. Default is OFF.
2155 use_mouse
2157 Allows the mouse button support in an xterm(1x) to be en‐
2158 abled/disabled. Default is OFF.
2159 use_slrnface
2161 If enabled slrnface(1) will be used to interpret the
2162 ''X-Face:'' header. For this option to have any effect,
2163 tin(1) must be running in an xterm(1x) and slrnface(1)
2164 must be in your $PATH. Default is OFF.
2165 utf8_graphics
2167 If ON use UTF-8 characters for indicator ('->'),
2168 thread/attachment tree and ellipsis ('...'). Default is
2169 OFF.
2170 verbatim_begin_regex
2172 A regular expression that tin will use to find the begin
2173 of a verbatim block. Default is #v+
2174 verbatim_end_regex
2176 A regular expression that tin will use to find the end of
2177 a verbatim block. Default is #v-
2178 verbatim_handling
2180 If ON verbatim blocks will be detected. Default is ON.
2181 wildcard
2183 Allows you to select how tin(1) matches strings. The de‐
2184 fault is 0 and uses the wildmat(3) notation, which is how
2185 this has traditionally been handled. Setting this to 1
2186 allows you to use perl(1) compatible regular expressions
2187 pcre(3). (see also perlre(1) and pcrepattern(3)). You
2188 will probably want to update your filter file if you use
2189 this regularly. NB: Newsgroup names will always be
2190 matched using the wildmat(3) notation.
2191 word_h_display_marks
2193 Should the leading and ending stars, slashes, strokes and
2194 dashes also be displayed, even when they are highlighting
2195 marks?
2196 0 no
2198 1 yes, display mark
2200 2 print a space instead
2202 word_highlight
2204 Enable word highlighting. See word_h_display_marks for
2205 the options available. If use_color is enabled the colors
2206 specified in col_markdash, col_markslash, col_markstar
2207 and col_markstroke are used for word highlighting else
2208 the character attributes specified in mono_markdash,
2209 mono_markslash, mono_markstar and mono_markstroke are
2210 used. Default is ON.
2211 wrap_column
2213 Sets the column at which a displayed article body should
2214 be wrapped. If this value is equal to 0, it defaults to
2215 the current screen width. If this value is greater than
2216 your current screen width the part off-screen is not dis‐
2217 played. Thus setting this option to a large value can be
2218 used to disable wrapping. If this value is negative the
2219 wrap margin is the current screen width plus the given
2220 value (as long as the result is still positive, otherwise
2221 it will fall back to the current screen width). Default
2222 is 0, wrapping at the current screen width.
2223 wrap_on_next_unread
2225 If enabled a search for the next unread article will wrap
2226 around all articles to find also previous unread arti‐
2227 cles. If disabled the search stops at the end of the
2228 thread list. Default is ON.
2229 xpost_quote_format
2231 Format is the same as for news_quote_format, this is used
2232 when answering to a crossposting to several groups with
2233 no ''Followup-To:'' set.
2234 /etc/tin/tin.defaults
2236 Yet another global configuration file with "variable=value"
2238 pairs. This one is for the more general options which usually
2239 can't be controlled via ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc and/or
2240 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc like resetting (to override
2241 the built-in default) the newslibdir.
2242 domainname
2244 Sets a global domain name used in From lines
2245 organization
2247 Defines the name of your organization. $ORGANIZATION
2248 overrides any specified value.
2249 newslibdir
2251 Defines the default place for some configuration files,
2252 common values are /usr/lib/news, /var/lib/news, /usr/lo‐
2253 cal/lib/news or /news/db. $TIN_LIBDIR overrides any spec‐
2254 ified value.
2255 bugaddress
2257 Defines the email address to which users can send bug re‐
2258 ports using a built-in function. The default points to a
2259 developers mailing list located at tin.org. You might
2260 want to change this address to one of your local adminis‐
2261 tration if you want to deal with your lusers problems on
2262 your own.
2263 inewsdir
2265 Defines the directory containing the inews(1) executable.
2266 mm_charset
2268 Default charset to be used in MIME's ''Content-Type:''
2269 header. $MM_CHARSET overrides any specified value.
2270 post_mime_encoding
2272 Default encoding scheme used in MIME articles. 8bit might
2273 be the best value.
2274 mail_mime_encoding
2276 Default encoding scheme used in MIME letters.
2277 quoted-printable is a good choice here.
2278 disable_gnksa_domain_check
2280 Allow unregistered top level domains. As the list of
2281 valid TLDs is no longer actively maintained the default
2282 was changed to ON starting with tin(1) version 2.1.5
2283 disable_sender
2285 Don't generate a ''Sender:'' header. This has an effect
2286 only if inews_prog is set to --internal.
2287 spooldir
2289 Base of your newsspool (Bnews, Cnews and INN traditional
2290 spool style), common values are /var/spool/news,
2291 /usr/spool/news, /news/spool. $TIN_SPOOLDIR overrides
2292 any specified value.
2293 overviewdir
2295 Base of your NOV database newsoverview(5) (tradspool
2296 style; might be the same dir as spooldir), common values
2297 are /var/spool/overview, /usr/spool/overview, /news/over‐
2298 view. $TIN_NOVROOTDIR overrides any specified value.
2299 overviewfile
2301 Name of a single overview file, common values are .over‐
2302 view or over.view. $TIN_NOVFILENAME overrides any speci‐
2303 fied value.
2304 overviewfmtfile
2306 Full pathname of your newssystem's overview.fmt file;
2307 usually the file residesin newslibdir and is named over‐
2308 view.fmt, so you only have to change this setting if your
2309 configuration differs.
2310 activefile
2312 Full pathname of your newssystem's active file; usually
2313 the file resides in newslibdir and is named active, so
2314 you only have to change this setting if your configura‐
2315 tion differs. $TIN_ACTIVEFILE overrides any specified
2316 value.
2317 activetimesfile
2319 Full pathname of your newssystem's active.times file;
2320 usually the file resides in newslibdir and is named ac‐
2321 tive.times, so you only have to change this setting if
2322 your configuration differs.
2323 newsgroupsfile
2325 Full pathname of your newssystem's newsgroups file; usu‐
2326 ally the file resides in newslibdir and is named news‐
2327 groups, so you only have to change this setting if your
2328 configuration differs.
2329 subscriptionsfile
2331 Full pathname of your newssystem's subscriptions file;
2332 usually the file resides in newslibdir and is named sub‐
2333 scriptions, so you only have to change this setting if
2334 your configuration differs.
2335 /usr/local/share/locale/$LC_MESSAGES/LC_MESSAGES/tin.mo
2337 translation into language specified in $LC_ALL, $LC_MESSAGES or
2339 $LANG
2340 ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active}
2342 This file lists the newsgroups that the local site receives.
2344 Each newsgroup should be listed only once. Each line specifies
2345 one group; within each newsgroup, articles are assigned unique
2346 names, which are monotonically increasing numbers.
2347 If an article is posted to newsgroups not mentioned in this
2349 file, those newsgroups are ignored. If no valid newsgroups are
2350 specified, the article is rejected.
2351 Each line consists of four space-separated fields "name highmark
2353 lowmark flags".
2354 name is the name of the newsgroup
2356 highmark
2358 is the highest article number that has been used in that
2359 newsgroup
2360 lowmark
2362 is the lowest article number in the group; this number is
2363 not guaranteed to be accurate, and should only be taken
2364 to be a hint. Note that because of article cancellations,
2365 there may be gaps in the numbering sequence. If the low‐
2366 est article number is greater than the highest article
2367 number, then there are no articles in the newsgroup.
2368 flags can be one of those
2370 y local postings are allowed
2372 n no local postings are allowed, only remote ones
2374 m the group is moderated and all postings must be
2376 approved
2377 j articles in this group are not kept, but only
2379 passed on
2380 x articles cannot be posted to this newsgroup
2382 =foo.bar
2384 articles are locally filed into the ''foo.bar''
2385 group
2386 tin(1) only tries to read the file if you read directly from the
2388 local spool, if you read news via NNTP, tin(1) uses the
2389 LIST (RFC3977) or LIST COUNTS (RFC6048) command instead.
2390 ${TIN_LIBDIR:-NEWSLIBDIR}/active.times
2392 This file provides a chronological record of when newsgroups are
2394 created. It is normally updated by the local news server (e.g.
2395 innd(8)) whenever a new group is created. Each line consist of
2396 three space-separated fields "name time creator".
2397 name is the name of the newsgroup
2399 time is the time when the group was created, expressed as the
2401 number of seconds since the Epoch.
2402 creator
2404 is the electronic mail address of the person who created
2405 the group.
2406 tin(1) only tries to read the file if you read directly from the
2408 local spool, if you read news via NNTP, tin(1) uses the
2409 NEWGROUPS (RFC3977) command instead.
2410 ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups
2412 This file provides short descriptions of each newsgroup. It is
2414 normally updated by the local news server (e.g. innd(8)) when‐
2415 ever a new group is created. Each line consist of two tab-sepa‐
2416 rated fields "group.name one-line description".
2417 group.name
2419 is the name of the newsgroup
2420 one-line description
2422 is a short single-line description of the group
2423 tin(1) only tries to read the file if you read directly from the
2425 local spool, if you read news via NNTP, tin(1) uses the
2426 LIST NEWSGROUPS (RFC3977) command instead.
2427 ${TIN_LIBDIR:-NEWSLIBDIR}/organization
2429 This file might hold a default organization to be used in the
2431 ''Organization:'' header. $ORGANIZATION has a higher priority if
2432 set.
2433 ${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt
2435 This file specifies the organization of the news overview data‐
2437 base (see also newsoverview(5)). The order of lines in this
2438 file is important; it determines the order in which the fields
2439 will appear in the database. See also overview.fmt(5). tin(1)
2440 only tries to read the file if you read directly from the local
2441 spool, if you read news via NNTP, tin(1) uses the LIST OVER‐
2442 VIEW.FMT (RFC3977) command instead.
2443 ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions
2445 This file contains a list of newsgroups — one per line — which
2447 the client should subscribe to when the user has no ${TIN_HOME‐
2448 DIR:-"$HOME"}/.newsrc for the news server. tin(1) only tries to
2449 read the file if you read directly from the local spool, if you
2450 read news via NNTP, tin(1) uses the LIST SUBSCRIPTIONS (RFC6048)
2451 command instead.
2452
2454 inews(1), ispell(1), lp(1), lpr(1), metamail(1), mutt(1), perl(1),
2455 perlre(1), pgp(1), rn(1), shar(1), slrnface(1), tin(1), xterm(1x),
2456 heapsort(3), iconv(3), iconv_open(3), nl_langinfo(3), pcre(3),
2457 pcrepattern(3), qsort(3), strftime(3), system(3), active(5),
2458 mailcap(5), mbox(5), mmdf(5), newsoverview(5), overview.fmt(5),
2459 innd(8), RFC1524, RFC2045, RFC2046, RFC2047, RFC2048, RFC2231, RFC2980,
2460 RFC3977, RFC4155, RFC4643, RFC5322, RFC5536, RFC5537, RFC6048
24612.6.0 August 23rd, 2021 tin(5)