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 built 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. Empty lines and lines which start with "#"
239 are ignored and not written back.
240 Example:
242 # sample .newsrc file
243 news.software.b! 1-666,669
244 news.software.nntp: 1-13245,13247,13249
245 news.software.readers: 1-19567,19571-19597
246 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/.oldnewsrc
248 backup of ${TIN_HOMEDIR:-"$HOME"}/.newsrc
250 ${TIN_HOMEDIR:-"$HOME"}/.signature
252 ${TIN_HOMEDIR:-"$HOME"}/.Sig
253 signature
255 ${TIN_HOMEDIR:-"$HOME"}/.sigfixed
257 fixed part of a randomly generated signature
259 ${TIN_HOMEDIR:-"$HOME"}/.tin/.inputhistory
261 history of last used strings
263 ${TIN_INDEX_MAILDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.mail/
265 mailgroups index files
267 ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news${NNTPSERVER:+"-$NNTPSERVER"}/
269 newsgroups index files
271 ${TIN_INDEX_SAVEDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.save/
273 saved newsgroups index files
275 ${TIN_HOMEDIR:-"$HOME"}/.tin/active.mail
277 active file ("mailgroupname maxnum minnum mailspool" quadruples)
279 of user's mailgroups (requires tin(1) to be built with mh-mail-
280 handling support).
281 mailgroupname
283 must be the pathname of the mailbox relative to field #4
284 with '/' changed to '.'
285 maxnum just put a large number here, something higher than the
287 highest message in the mailbox
288 minnum put 0 here
290 mailspool
292 path of mail spool directory. This must be the full path‐
293 name to the root of the mail folder area.
294 Example:
296 Mail.inbox 12345 00000 /home/foo
297 Mail.outbox 23456 00000 /home/foo
298 This allows access to the 'inbox' and 'outbox' folders of user
300 foo. They are accessed via /home/foo/Mail/inbox and
301 /home/foo/Mail/outbox
302 ${TIN_HOMEDIR:-"$HOME"}/.tin/active.save
304 active file of user's saved newsgroups, used by tin -R.
306 /etc/tin/attributes
308 ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes
309 The group attributes files may be used to override some global
311 settings from ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc on a per group
312 basis. Order is important as last match counts; this allows one
313 to refine attributes for narrowed scopes. Note that the
314 scope=<grouplist> line has to be specified before the attributes
315 are specified for that list and each attribute can only be set
316 once per scope section. All attributes are set to a reasonable
317 default so you only have to specify the attribute that you want
318 to change. All toggle attributes are set by specifying ON/OFF.
319 Otherwise, they function exactly as their global equivalents.
320 The following group attributes are available:
321 scope This changes the list of groups to which the attributes
323 that follow will be applied. See the section NEWSGROUP
324 LISTS & WILDCARDS in tin(1) for the types of pattern that
325 can be used here.
326 add_posted_to_filter
328 Identical to the tinrc variable of the same name
329 advertising
331 Identical to the tinrc variable of the same name
332 alternative_handling
334 Identical to the tinrc variable of the same name
335 ask_for_metamail
337 Identical to the tinrc variable of the same name
338 auto_cc_bcc
340 Identical to the tinrc variable of the same name
341 auto_list_thread
343 Identical to the tinrc variable of the same name
344 auto_select
346 Automatically perform the GroupMarkUnselArtRead ('X')
347 command after entering the group.
348 batch_save
350 Can be used to override the global setting in tinrc on a
351 per group basis. For more information read section AUTO‐
352 MATIC MAILING AND SAVING NEW NEWS in tin(1).
353 date_format
355 Identical to the tinrc variable of the same name
356 delete_tmp_files
358 If this is set to ON, then saved article files that have
359 been post-processed will be automatically deleted, other‐
360 wise the user will be asked whether to delete the post-
361 processed files. Automatic processing of marked articles
362 using GroupAutoSave ('S') will suppress prompting.
363 editor_format
365 Identical to the tinrc variable of the same name
366 extquote_handling
368 Identical to the tinrc variable of the same name
369 fcc Mailbox to save sent mails. The format of the mailbox is
371 controlled via the tinrc mailbox_format variable.
372 followup_to
374 Set ''Followup-To:'' header to the specified group(s).
375 from Identical to the tinrc variable mail_address
377 group_catchup_on_exit
379 Identical to the tinrc variable of the same name
380 group_format
382 Identical to the tinrc variable of the same name
383 mail_8bit_header
385 Identical to the tinrc variable of the same name
386 mail_mime_encoding
388 Identical to the tinrc variable of the same name
389 maildir
391 Identical to the tinrc variable of the same name
392 mailing_list
394 Used when a group is a mailing list. All responses to the
395 group will be directed to this email address instead
396 mark_ignore_tags
398 Identical to the tinrc variable of the same name
399 mark_saved_read
401 Identical to the tinrc variable of the same name
402 mime_forward
404 Determines whether usenet articles are forwarded as at‐
405 tachment or inline. When set to OFF, the forwarded arti‐
406 cle will be included in the body of the mail, while set‐
407 ting this variable to ON will cause the article to be at‐
408 tached as a separate MIME part. Enabling mime_forward is
409 particularly useful for articles consisting of multiple
410 MIME parts such as PGP/MIME signed messages or being en‐
411 coded in a different character set than your local one.
412 It is also useful if the receiver should be able to oper‐
413 ate on the entire forwarded article (i.e., view or save
414 it without your comments). On the other hand, if you want
415 to forward only some parts of the article or to insert
416 'inline' annotations, you might want to disable this op‐
417 tion. Currently mime_forward is forced if the article to
418 be attached is a multipart MIME article, this may change
419 in a future version. Please note that for this option to
420 have effect, the tinrc variable interactive_mailer has to
421 be set to 0 (which is the default).
422 mime_types_to_save
424 A comma separated list of MIME major/minor Content-Types
425 that will be saved when using the view/save and save/au‐
426 tosave features. A single * can be used to wildcard the
427 major and/or minor type and a ! as the first character in
428 an entry will negate it, eg: image/*,!im‐
429 age/bmp,!text/html. Default is */*
430 news_headers_to_display
432 Identical to the tinrc variable of the same name
433 news_headers_to_not_display
435 Identical to the tinrc variable of the same name
436 news_quote_format
438 Identical to the tinrc variable of the same name
439 organization
441 This can be used to set the article header field ''Orga‐
442 nization:''. It overrides the setting (if any) of organi‐
443 zation in /etc/tin/tin.defaults and $ORGANIZATION (or
444 $NEWSORG on Apollo DomainOS). Note that some news servers
445 might still overwrite the ''Organization:'' header.
446 pos_first_unread
448 Identical to the tinrc variable of the same name
449 post_8bit_header
451 Identical to the tinrc variable of the same name
452 post_mime_encoding
454 Identical to the tinrc variable of the same name
455 post_process_type
457 Identical to the tinrc variable of the same name
458 post_process_view
460 Identical to the tinrc variable of the same name
461 print_header
463 Identical to the tinrc variable of the same name
464 process_only_unread
466 Identical to the tinrc variable of the same name
467 prompt_followupto
469 Identical to the tinrc variable of the same name
470 quote_chars
472 Identical to the tinrc variable of the same name
473 savedir
475 Identical to the tinrc variable of the same name
476 savefile
478 show_author
480 Identical to the tinrc variable of the same name
481 show_info
483 Identical to the tinrc variable of the same name
484 show_only_unread_arts
486 Identical to the tinrc variable of the same name
487 show_signatures
489 Identical to the tinrc variable of the same name
490 sigdashes
492 Identical to the tinrc variable of the same name
493 sigfile
495 Identical to the tinrc variable of the same name
496 signature_repost
498 Identical to the tinrc variable of the same name
499 sort_article_type
501 Identical to the tinrc variable sort_article_type
502 sort_threads_type
504 Identical to the tinrc variable of the same name
505 tex2iso_conv
507 Identical to the tinrc variable of the same name
508 thread_articles
510 Identical to the tinrc variable of the same name
511 thread_catchup_on_exit
513 Identical to the tinrc variable of the same name
514 thread_format
516 Identical to the tinrc variable of the same name
517 thread_perc
519 Identical to the tinrc variable of the same name
520 trim_article_body
522 Identical to the tinrc variable of the same name
523 suppress_soft_hyphens
525 Identical to the tinrc variable of the same name
526 verbatim_handling
528 Identical to the tinrc variable of the same name
529 wrap_on_next_unread
531 Identical to the tinrc variable of the same name
532 x_body A piece of text that will be added at the start of a mes‐
534 sage body. If this string starts with a / or ~ then it is
535 assumed to be the name of a file containing the text to
536 insert.
537 x_comment_to
539 Insert ''X-Comment-To:'' header, this is only useful in
540 FIDO groups.
541 x_headers
543 A string including header-name and the contents of the
544 header that will be automatically added when posting. If
545 the string starts with a / or ~ then it is assumed to be
546 the name of a file containing the header and its content
547 to be inserted. If the string starts with a ! then what
548 follows is assumed to be the path to a program to be exe‐
549 cuted to generate the header and its content. %G is ex‐
550 panded to the current news.group.name and %P is expanded
551 to the news.group.name with all '.' replaced by '/'.
552 quick_kill_scope
554 A comma-separated list of newsgroup patterns (wildmat-
555 style) to which groups the filter rule added by QuickFil‐
556 terKill will be applied. If unset the default from the
557 tinrc variable default_filter_kill_global will be used.
558 quick_kill_expire
560 Identical to the tinrc variable default_filter_kill_ex‐
561 pire
562 quick_kill_case
564 Identical to the tinrc variable default_filter_kill_case
565 quick_kill_header
567 Identical to the tinrc variable default_fil‐
568 ter_kill_header
569 quick_select_scope
571 A comma-separated list of newsgroup patterns (wildmat-
572 style) to which groups the filter rule added by QuickFil‐
573 terSelect will be applied. If unset the default from the
574 tinrc variable default_filter_select_global will be used.
575 quick_select_expire
577 Identical to the tinrc variable default_filter_select_ex‐
578 pire
579 quick_select_case
581 Identical to the tinrc variable default_filter_se‐
582 lect_case
583 quick_select_header
585 Identical to the tinrc variable default_filter_se‐
586 lect_header
587 ispell Path and options for ispell(1)-like spell-checker, e.g.
589 "aspell --mode=email --dont-backup check"
590 mm_network_charset
592 Identical to the tinrc variable of the same name
593 undeclared_charset
595 Assume (broken) articles without MIME charset declaration
596 have this charset — default is US-ASCII. This attribute
597 works only on systems with working iconv(3), others might
598 have to compile tin(1) with --dis‐
599 able-mime-strict-charset.
600 Example:
602 # include extra headers
603 # assume ISO-8859-1 as charset if no charset is declared
604 scope=*
605 x_headers=~/.tin/headers
606 undeclared_charset=ISO-8859-1
607 # in *sources* set post process type to shar only
609 scope=*sources*
610 post_process_type=1
611 # in *binaries* turn on full post processing,
613 # remove tmp files and set Followup-To: poster
614 scope=*binaries*
615 post_process_type=2
616 delete_tmp_files=ON
617 followup_to=poster
618 # in fido.* newsgroups change quote_chars
620 # and add X-Comment-To: line
621 scope=fido.*
622 quote_chars=%I>_
623 x_comment_to=ON
624 # in *.test newsgroups, don't append signature
626 # and preset Subject
627 scope=*.test
628 sigfile=--none
629 x_headers=Subject: test - ignore - no reply
630 # assume ISO-2022-JP-2 as charset
632 scope=fj.*,japan.*
633 undeclared_charset=ISO-2022-JP-2
634 ${TIN_HOMEDIR:-"$HOME"}/.tin/filter
636 The filter file is used to assign scores to certain articles.
638 Based on the score an article can be filtered out (hidden) or
639 marked hot. Empty lines or lines beginning with a '#' are ig‐
640 nored.
641 comment
643 Every entry (rule) in the filter file might get a com‐
644 ment. Multiple lines are allowed (but only for comments
645 yet). Every line must start with the "comment=" keyword.
646 Comments must appear first in the rule. Comment lines
647 placed within a rule will be moved to the begin of the
648 next rule. This might be changed in the future. Don't use
649 '#' to mark comments as those lines are ignored and your
650 comments will get lost on the next write of the file.
651 group A comma-separated list of newsgroup patterns in wildmat-
653 style to which groups the filter rule will be applied.
654 This line is mandatory!
655 case 0=case-sensitive, 1=case-insensitive
657 score Score value of the rule; can also be one of the magic
659 words "kill" or "hot".
660 subj Match against ''Subject:''. The matching type used (wild‐
662 mat or regex) depends on the setting of the tinrc vari‐
663 able wildcard.
664 from Match against ''From:''. tin(1) converts the contents of
666 the ''From:'' header to an old style e-mail address, e.g.
667 ''some@body.example (John Doe)'' instead of ''John Doe
668 <some@body.example>'', before trying to match the pat‐
669 terns in the filter rule. The matching type used (wildmat
670 or regex) depends on the setting of the tinrc variable
671 wildcard.
672 msgid Match against ''Message-ID:'' and full ''References:''.
674 The matching type used (wildmat or regex) depends on the
675 setting of the tinrc variable wildcard.
676 msgid_last
678 Match against ''Message-ID:'' and last ''References:''
679 entry only. The matching type used (wildmat or regex) de‐
680 pends on the setting of the tinrc variable wildcard.
681 msgid_only
683 Match against ''Message-ID:''. The matching type used
684 (wildmat or regex) depends on the setting of the tinrc
685 variable wildcard.
686 refs_only
688 Match against ''References:''. The matching type used
689 (wildmat or regex) depends on the setting of the tinrc
690 variable wildcard.
691 lines Match against ''Lines:'', <num matches less than, >num
693 matches more than.
694 gnksa Match against ''From:'' address parser return codes. <num
696 matches less than, >num matches more than the returned
697 numeric value. GNKSA_LOCAL_DOMAIN_LITERAL or GNKSA_IN‐
698 VALID_DOMAIN are only returned if disable_gnksa_do‐
699 main_check is set to false. As the built in domain list
700 is outdated this should be considered carefully.
701 0 GNKSA_OK
702 1 GNKSA_INTERNAL_ERROR
703 100 GNKSA_LANGLE_MISSING
704 101 GNKSA_LPAREN_MISSING
705 102 GNKSA_RPAREN_MISSING
706 103 GNKSA_ATSIGN_MISSING
707 104 GNKSA_RANGLE_MISSING
708 200 GNKSA_SINGLE_DOMAIN
709 201 GNKSA_INVALID_DOMAIN
710 202 GNKSA_ILLEGAL_DOMAIN
711 203 GNKSA_UNKNOWN_DOMAIN
712 204 GNKSA_INVALID_FQDN_CHAR
713 205 GNKSA_ZERO_LENGTH_LABEL
714 206 GNKSA_ILLEGAL_LABEL_LENGTH
715 207 GNKSA_ILLEGAL_LABEL_HYPHEN
716 208 GNKSA_ILLEGAL_LABEL_BEGNUM
717 209 GNKSA_BAD_DOMAIN_LITERAL
718 210 GNKSA_LOCAL_DOMAIN_LITERAL
719 211 GNKSA_RBRACKET_MISSING
720 300 GNKSA_LOCALPART_MISSING
721 301 GNKSA_INVALID_LOCALPART
722 302 GNKSA_ZERO_LENGTH_LOCAL_WORD
723 400 GNKSA_ILLEGAL_UNQUOTED_CHAR
724 401 GNKSA_ILLEGAL_QUOTED_CHAR
725 402 GNKSA_ILLEGAL_ENCODED_CHAR
726 403 GNKSA_BAD_ENCODE_SYNTAX
727 404 GNKSA_ILLEGAL_PAREN_CHAR
728 405 GNKSA_INVALID_REALNAME
729 406 GNKSA_MISSING_REALNAME
730 xref Match against ''Xref:'' line. Before any matching is done
732 the line is turned into the same format ''Newsgroups:''
733 has that is it is turned into a comma separated newsgroup
734 list with all other information (i.e. the article
735 counter) removed. The matching type used (wildmat or
736 regex) depends on the setting of the tinrc variable wild‐
737 card.
738 path Match against ''Path:'' line. This may not work on some
740 servers. The matching type used (wildmat or regex) de‐
741 pends on the setting of the tinrc variable wildcard.
742 time time_t value when rule expires
744 Example:
746 comment=mark all articles about tin, rtin,
747 comment=tind, ktin or cdtin as hot
748 group=*
749 case=1
750 score=hot
751 subj=\b(cd|[rk]?)?tin(d|pre)?[-.0-9]*\b
752 ${TIN_HOMEDIR:-"$HOME"}/.tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
754 /etc/tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
755 Keymap-file, containing "keyname value [value]" pairs separated
757 by spaces or tabs. If the keymap-file named with full specified
758 locale(5) is not found, less specific ones are looked for. Vari‐
759 ous parts will be stripped off the name, in the following order
760 codeset, normalized codeset, territory and modifier when looking
761 for the keymap-file. 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 ConnectionInfo J
780 LookupMessage L
781 OptionMenu M
782 Postponed O ^O
783 QuitTin Q
784 BugReport R
785 DisplayPostHist W
786 MarkThrUnread Z
787 FirstPage ^
788 SearchAuthF a
789 Catchup c
790 Help h
791 ToggleInfoLastLine i
792 Down j ^N
793 Up k ^P
794 Print o
795 Quit q
796 Version v
797 Post w
798 MarkArtUnread z
799 QuickFilterSelect [
800 QuickFilterKill ]
801 Pipe |
802 ScrollUp <
803 ScrollDown >
804 PageUp b ^B ^U
805 PageDown ^D ^F SPACE
806 RedrawScr ^L
807 Postponed ^O
808 MenuFilterSelect ^A
809 MenuFilterKill ^K
810 MarkFeedRead ^X
811 MarkFeedUnread ^W
812 AttachSelect ^J ^M
814 AttachPipe p
815 AttachSave s
816 AttachTag t
817 AttachUntag U
818 AttachTagPattern =
819 AttachToggleTagged @
820 ConfigToggleAttrib TAB
822 ConfigSelect ^J ^M
823 ConfigLastPage G
824 ConfigNoSave Q
825 ConfigScopeMenu S
826 ConfigFirstPage g
827 ConfigResetAttrib r
828 FeedTag T
830 FeedArt a
831 FeedHot h
832 FeedPat p
833 FeedRepost r
834 FeedSupersede s
835 FeedThd t
836 FilterEdit e
838 FilterSave s
839 GroupNextUnreadArtOrGrp TAB
841 GroupReadBasenote ^J ^M
842 GroupSelThd *
843 GroupDoAutoSel +
844 GroupToggleThdSel .
845 GroupSelThdIfUnreadSelected ;
846 GroupSelPattern =
847 GroupReverseSel @
848 GroupCancel D
849 GroupToggleGetartLimit G
850 GroupMarkThdRead K
851 GroupNextUnreadArt N
852 GroupPrevUnreadArt P
853 GroupAutoSave S
854 GroupTagParts T
855 GroupUntag U
856 GroupMarkUnselArtRead X
857 GroupToggleSubjDisplay d
858 GroupGoto g
859 GroupListThd l
860 GroupMail m
861 GroupNextGroup n
862 GroupPrevGroup p
863 GroupToggleReadUnread r
864 GroupSave s
865 GroupTag t
866 GroupToggleThreading u
867 GroupRepost x
868 GroupUndoSel ~
869 HelpLastPage G
871 HelpFirstPage g
872 PageReplyQuoteHeaders ^E
874 PagePGPCheckArticle ^G
875 PageToggleRaw ^H
876 PageNextUnread TAB
877 PageNextThd ^J ^M
878 PageToggleTabs ^T
879 PageFollowupQuoteHeaders ^W
880 PageToggleTex2iso "
881 PageToggleAllHeaders *
882 PageToggleRot %
883 PageToggleUue (
884 PageReveal )
885 PageSkipIncludedText :
886 PageTopThd <
887 PageBotThd >
888 PageCancel D
889 PageFollowup F
890 PageLastPage G
891 PageKillThd K
892 PageNextUnreadArt N
893 PagePrevUnreadArt P
894 PageReply R
895 PageAutoSave S
896 PageGroupSel T
897 PageViewUrl U
898 PageViewAttach V
899 PageToggleHighlight _
900 PageEditArticle e
901 PageFollowupQuote f
902 PageFirstPage g
903 PageListThd l
904 PageMail m
905 PageNextArt n
906 PagePrevArt p
907 PageReplyQuote r
908 PageSave s
909 PageTag t
910 PageGotoParent u
911 PageRepost x
912 PgpEncSign b
914 PgpEncrypt e
915 PgpIncludekey i
916 PgpSign s
917 PostAbort a
919 PostContinue c
920 PostCancel d
921 PostEdit e
922 PostPGP g
923 PostIspell i
924 PostIgnore i
925 PostMail m
926 PostPostpone o
927 PostPost p y
928 PostSupersede s
929 PostSend s y
930 PostedArticlesSelect ^J ^M
932 PostponeOverride Y
934 PostponeAll A
935 PromptYes y Y
937 PromptNo n N
938 PProcNone n
940 PProcShar s
941 PProcYes y
942 SaveAppendFile a
944 SaveOverwriteFile o
945 SelectEnterNextUnreadGrp TAB n
947 SelectReadGrp ^J ^M
948 SelectResetNewsrc ^R
949 SelectSortActive .
950 SelectNextUnreadGrp N
951 SelectSubscribePat S
952 SelectUnsubscribePat U
953 SelectQuitNoWrite X
954 SelectSyncWithActive Y
955 SelectToggleDescriptions d
956 SelectGoto g
957 SelectMoveGrp m
958 SelectToggleReadDisplay r
959 SelectSubscribe s
960 SelectUnsubscribe u
961 SelectYankActive y
962 SelectMarkGrpUnread z Z
963 ScopeSelect ^J ^M
965 ScopeEditAttributesFile E
966 ScopeAdd a
967 ScopeDelete d
968 ScopeMove m
969 ScopeRename r
970 ThreadReadNextArtOrThread TAB
972 ThreadReadArt ^J ^M
973 ThreadSelArt *
974 ThreadToggleArtSel .
975 ThreadReverseSel @
976 ThreadCancel D
977 ThreadMarkArtRead K
978 ThreadAutoSave S
979 ThreadUntag U
980 ThreadToggleSubjDisplay d
981 ThreadMail m
982 ThreadSave s
983 ThreadTag t
984 ThreadTagParts T
985 ThreadUndoSel ~
986 UrlSelect ^J ^M
988 ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups
990 This file provides short descriptions of each mailgroup. (re‐
992 quires tin(1) to be built with mh-mail-handling support). Each
993 line consist of two tab-separated fields "mailgroupname one-line
994 description".
995 mailgroupname
997 is the name of the newsgroup
998 description
1000 is a short single-line description of the group
1001 ${TIN_HOMEDIR:-"$HOME"}/.tin/newsrctable
1003 "nntpserver newsrc [shortname [...]]" pairs to use with the
1005 ''-g'' command-line switch. The matching is case-insensitive and
1006 any line that starts with "#", ";" or " " is treated as a com‐
1007 ment.
1008 nntpserver
1010 full qualified domain name of the news server. The string
1011 "default" or "*" acts as wildcard to match any name, such
1012 a line should be placed last.
1013 newsrc related newsrc.
1015 shortname
1017 nickname(s) for the nntpserver.
1018 Example:
1020 # sample newsrctable file
1021 news.tin.org .newsrc-tin.org tinorg
1022 news.example.org /tmp/nrc-ex example ex
1023 * ~/.tin/newsrcs/${NNTPSERVER-localhost}
1024 ${TIN_HOMEDIR:-"$HOME"}/.tin/posted
1026 Posting history. The file is written by tin(1) and used by Dis‐
1028 playPostHist ('W') command. It should not be altered manually.
1029 Any line that starts with "#" is a comment. Blank lines are ig‐
1030 nored. All other lines shall consist of at least four pipe-sepa‐
1031 rated fields, starting with a time stamp "dd-mm-yy", a single
1032 letter indicating the action which initiated the message, a
1033 group name or a mail address the message was sent to, the sub‐
1034 ject of the message and optionally the messages ''Message-ID''
1035 if known.
1036 ${TIN_HOMEDIR:-"$HOME"}/Mail/posted
1038 Copy of all posted articles in mbox(5) format. The filename can
1040 be changed by setting posted_articles_file.
1041 ${TIN_HOMEDIR:-"$HOME"}/.tin/postponed.articles
1043 Pool of postponed articles. This file is in mbox(5) format.
1045 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/newsgroups
1047 This file a copy of the servers newsgroups file which provides
1049 short descriptions of each newsgroup. It is automatically up‐
1050 dated on startup except when using the ''-X''or ''-q'' command-
1051 line option and an old copy exists. Each line consist of two
1052 tab-separated fields "group.name one-line de‐
1053 scription".
1054 group.name
1056 is the name of the newsgroup
1057 one-line description
1059 is a short single-line description of the group
1060 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/serverrc
1062 File to store $NNTPSERVER and $NNTPPORT related data via a list
1064 of "variable=value" pairs. Currently there are only two vari‐
1065 ables, both are not meant to be changed by the user.
1066 version
1068 Internal version number.
1069 last_newnews
1071 Internal timestamp used by tin(1) to keep track of new
1072 newsgroups on the server.
1073 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/msglog
1075 File to store $NNTPSERVER and $NNTPPORT related info- and error-
1077 messages. The file is overwritten on startup and meant for de‐
1078 bugging.
1079 /etc/tin/tinrc
1081 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc
1082 At startup, tin(1) reads in the configuration file. This con‐
1084 tains a list of "variable=value" pairs that can be used to con‐
1085 figure the way tin(1) works. If it exists, the global configura‐
1086 tion file, ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc is read first. After
1087 that, the user's own configuration file ${TIN_HOME‐
1088 DIR:-"$HOME"}/.tin/tinrc is read. The global file is useful for
1089 distributing system-wide defaults to new users who have no pri‐
1090 vate tinrc yet (see also /etc/tin/tin.defaults).
1091 abbreviate_groupname
1093 If ON abbreviate long newsgroup names at group selection
1094 level and article level (if necessary) like this:
1095 news.software.readers -> n.software.readers -> n.s.read‐
1096 ers -> n.s.r. Default is OFF.
1097 add_posted_to_filter
1099 If ON add posted articles which start a new thread to
1100 filter for highlighting follow-ups. Default is ON.
1101 advertising
1103 Turn ON advertising in header (''User-Agent:''). Default
1104 is ON.
1105 alternative_handling
1107 If ON strip multipart/alternative messages automatically.
1108 Default is ON.
1109 art_marked_deleted
1111 The character used to show that an article was deleted.
1112 Default is 'D'.
1113 art_marked_inrange
1115 The character used to show that an article is in a range.
1116 Default is '#'.
1117 art_marked_return
1119 The character used to show that an article will return as
1120 an unread article when the group is next entered. Default
1121 is '-'.
1122 art_marked_selected
1124 The character used to show that an article/thread is
1125 auto-selected (hot). Default is '*'.
1126 art_marked_recent
1128 The character used to show that an article/thread is re‐
1129 cent (not older than X days). See also recent_time. De‐
1130 fault is 'o'.
1131 art_marked_unread
1133 The character used to show that an article has not been
1134 read. Default is '+'.
1135 art_marked_read
1137 The character used to show that an article was read. De‐
1138 fault is ' '.
1139 art_marked_killed
1141 The character used to show that an article was killed.
1142 Default is 'K'. kill_level must be set accordingly.
1143 art_marked_read_selected
1145 The character used to show that an article was hot before
1146 it was read. Default is ':'. kill_level must be set ac‐
1147 cordingly.
1148 Ask before using MIME viewer (ask_for_metamail)
1150 If ON tin(1) will ask before using a MIME viewer (meta‐
1151 mail_prog) to display MIME messages. This only occurs if
1152 a MIME viewer is set. Default is OFF.
1153 auto_cc_bcc
1155 Automatically put your name in the ''Cc:'' and/or
1156 ''Bcc:'' field when mailing an article. Default is No.
1157 auto_list_thread
1159 If ON automatically list thread when entering it using
1160 right arrow key. Default is ON.
1161 auto_reconnect
1163 Reconnect to server automatically. Default is OFF.
1164 batch_save
1166 If set ON articles/threads will be saved in batch mode
1167 when save ''-S'' or mail ''-M, -N'' is specified on the
1168 command line. Default is ON.
1169 beginner_level
1171 If set ON a mini menu of the most useful commands will be
1172 displayed at the bottom of the screen for each level.
1173 Also a short posting etiquette will be displayed after
1174 composing an article. Default is ON.
1175 cache_overview_files
1177 If ON, create local copies of NNTP overview files. This
1178 can be used to considerably speed up accessing large
1179 groups when using a slow connection. Default is OFF.
1180 cancel_lock_algo
1182 Use this hash algorithm for cancel-locks. Only available
1183 when built with cancel-lock support. none disables the
1184 generation of cancel-locks. Valid values are none, sha1,
1185 sha256 and sha512. Default is sha1.
1186 catchup_read_groups
1188 If set ON the user is asked when quitting if all groups
1189 read during the current session should be marked read.
1190 Default is OFF.
1191 col_back
1193 Standard background color
1194 col_extquote
1196 Color of quoted text from external sources
1197 col_from
1199 Color of sender (From:)
1200 col_head
1202 Color of header-lines
1203 col_help
1205 Color of help pages
1206 col_invers_bg
1208 Color of background for inverse text
1209 col_invers_fg
1211 Color of foreground for inverse text
1212 col_markdash
1214 Color of words emphasized like _this_. See also
1215 word_h_display_marks and word_highlight.
1216 col_markslash
1218 Color of words emphasized like /this/. See also
1219 word_h_display_marks and word_highlight.
1220 col_markstar
1222 Color of words emphasized like *this*. See also
1223 word_h_display_marks and word_highlight.
1224 col_markstroke
1226 Color of words emphasized like -this-. See also
1227 word_h_display_marks and word_highlight.
1228 col_message
1230 Color of status messages in last line
1231 col_minihelp
1233 Color of mini help menu
1234 col_newsheaders
1236 Color of actual news header fields
1237 col_normal
1239 Standard foreground color
1240 col_quote
1242 Color of quoted lines
1243 col_quote2
1245 Color of twice quoted lines
1246 col_quote3
1248 Color of >=3 times quoted lines
1249 col_response
1251 Color of response counter. This is the text that says
1252 "Response x of y" in the article viewer.
1253 col_signature
1255 Color of signatures
1256 col_urls
1258 Color of urls highlight
1259 col_verbatim
1261 Color of verbatim blocks
1262 col_subject
1264 Color of article subject
1265 col_text
1267 Color of text-lines
1268 col_title
1270 Color of help/mail sign
1271 confirm_choice
1273 tin(1) can ask for manual confirmation to protect the
1274 user. Available choices:
1275 commands: Ask for confirmation before executing cer‐
1276 tain dangerous commands (e.g., Catchup ('c')). Com‐
1277 mands that this affects are marked in this manual
1278 with '[after confirmation]'.
1279 quit: You'll be asked to confirm that you wish to
1281 exit tin(1) when you use the Quit ('q') command.
1282 select: Ask for confirmation before marking all not
1284 selected (with GroupMarkUnselArtRead ('X') command)
1285 articles as read.
1286 Default is commands & quit.
1287 date_format
1289 Format string used for date representation. A description
1290 of the different format options can be found at
1291 strftime(3). tin(1) uses strftime(3) when available and
1292 supports most format options in his fallback code. De‐
1293 fault is "%a, %d %b %Y %H:%M:%S".
1294 default_art_search
1296 default_author_search
1298 default_config_search
1300 The last article/author/config option that was searched
1301 for.
1302 default_filter_days
1304 Default is 28.
1305 default_filter_kill_case
1307 Default for quick (1 key) kill filter case. ON = filter
1308 case sensitive, OFF = ignore case. Default is OFF.
1309 default_filter_kill_expire
1311 Default for quick (1 key) kill filter expire. ON = limit
1312 to default_filter_days, OFF = don't ever expire. Default
1313 is OFF.
1314 default_filter_kill_global
1316 Default for quick (1 key) kill filter global. ON=apply
1317 to all groups, OFF=apply to current group. Default is ON.
1318 default_filter_kill_header
1320 Default for quick (1 key) kill filter header.
1321 0 ''Subject:'' (case sensitive)
1322 1 ''Subject:'' (ignore case)
1323 2 ''From:'' (case sensitive)
1324 3 ''From:'' (ignore case)
1325 4 ''Message-ID:'' & full ''References:'' line
1326 5 ''Message-ID:'' & last ''References:'' entry only
1327 6 ''Message-ID:'' entry only
1328 7 ''Lines:''
1329 default_filter_select_case
1331 Default for quick (1 key) auto-selection filter case.
1332 ON=filter case sensitive, OFF=ignore case. Default is
1333 OFF.
1334 default_filter_select_expire
1336 Default for quick (1 key) auto-selection filter expire.
1337 ON = limit to default_filter_days, OFF = don't ever ex‐
1338 pire. Default is OFF.
1339 default_filter_select_global
1341 Default for quick (1 key) auto-selection filter global.
1342 ON=apply to all groups, OFF=apply to current group. De‐
1343 fault is ON.
1344 default_filter_select_header
1346 Default for quick (1 key) auto-selection filter header.
1347 0 ''Subject:'' (case sensitive)
1348 1 ''Subject:'' (ignore case)
1349 2 ''From:'' (case sensitive)
1350 3 ''From:'' (ignore case)
1351 4 ''Message-ID:'' & full ''References:'' line
1352 5 ''Message-ID:'' & last ''References:'' entry only
1353 6 ''Message-ID:'' entry only
1354 7 ''Lines:''
1355 default_goto_group
1357 default_group_search
1359 default_mail_address
1361 default_move_group
1363 default_pattern
1365 default_pipe_command
1367 default_post_newsgroups
1369 default_post_subject
1371 default_range_group
1373 default_range_select
1375 default_range_thread
1377 default_repost_group
1379 default_save_file
1381 default_save_mode
1383 default_select_pattern
1385 default_shell_command
1387 default_subject_search
1389 draw_arrow
1391 Allows groups/articles to be selected by an arrow '->' if
1392 set ON or by a highlighted bar if set OFF. Default is
1393 OFF.
1394 editor_format
1396 The format string used to create the editor start command
1397 with parameters. Default is '%E +%N %F' with %E=Editor,
1398 %N=Linenumber and %F=Filename (e.g., /bin/vi +7 .arti‐
1399 cle). See also $VISUAL and $EDITOR under "ENVIRONMENT" in
1400 tin(1)
1401 extquote_handling
1403 If ON quotes from external sources will be detected. De‐
1404 fault is OFF.
1405 extquote_regex
1407 A regular expression that will be applied when reading
1408 articles. All matching lines are shown in col_extquote.
1409 If extquote_regex is blank, then tin(1) uses a built-in
1410 default.
1411 force_screen_redraw
1413 Specifies whether a screen redraw should always be done
1414 after certain external commands. Default is OFF.
1415 getart_limit
1417 If getart_limit is > 0 not more than the last
1418 getart_limit articles/group are fetched from the server.
1419 If getart_limit is < 0 tin(1) will start fetching arti‐
1420 cles from your first unread minus absolute value of
1421 getart_limit. Default is 0, which means no limit.
1422 goto_next_unread
1424 Which keys tin(1) should accept to jump to the next un‐
1425 read article. Possible is any combination of PageDown
1426 and PageNextUnread. When PageDown is set tin(1) jumps to
1427 the next article at the end of the current one. When Pa‐
1428 geNextUnread is set tin(1) jumps immediately to the next
1429 article when PageNextUnread ('<TAB>') is pressed. Default
1430 is PageNextUnread.
1431 group_catchup_on_exit
1433 If ON catchup group when leaving with the left arrow key.
1434 Default is ON.
1435 group_format
1437 The format string used for the Group level. Default is
1438 "%n %m %R %L %s %F". The following substitutions are
1439 supported:
1440 %D date
1441 %F from, name and/or address
1442 %I initials
1443 %L line count
1444 %M message-id
1445 %R number of responses in thread
1446 %S score
1447 %m article marks
1448 %n current thread number
1449 %s subject
1450 %% %
1451 hide_uue
1453 If set to 'No' then raw uuencoded data is displayed. If
1454 set to 'Yes' then sections of uuencoded data will be
1455 shown with a single tag line showing the size and file‐
1456 name (much the same as a MIME attachment). If set to
1457 'Hide all' then any line that looks like uuencoded data
1458 will be folded into a tag line. This is useful when uuen‐
1459 coded data is split across more than one article but can
1460 also lead to false positives. This setting can also be
1461 toggled in the article viewer. Default is 'No'.
1462 inews_prog
1464 Path, name and options of external inews(1). If you are
1465 reading via NNTP the default value is "--internal" (use
1466 built-in NNTP inews), else it is "inews -h". The article
1467 is passed to inews_prog on STDIN via '< article'.
1468 info_in_last_line
1470 If ON, show current group description or article subject
1471 in the last line (not in the pager and global menu) —
1472 ToggleInfoLastLine ('i') toggles setting. This facility
1473 is useful as the full width of the screen is available to
1474 display long subjects. Default is OFF.
1475 interactive_mailer
1477 If greater than 0 your mailreader will be invoked earlier
1478 for reply so you can use more of its features (e.g. MIME,
1479 pgp, ...). 1 means include headers, 2 means don't include
1480 headers (old use_mailreader_i=ON option). 0 turns off us‐
1481 age. This option has to suit mailer_format. Default is 0.
1482 inverse_okay
1484 If ON use inverse video for page headers and URL high‐
1485 lighting. Default is ON.
1486 keep_dead_articles
1488 If ON keep all failed postings in ${TIN_HOME‐
1489 DIR:-"$HOME"}/dead.articles besides keeping the last
1490 failed posting in ${TIN_HOMEDIR:-"$HOME"}/dead.article.
1491 Default is ON.
1492 kill_level
1494 This option controls the processing and display of arti‐
1495 cles that are killed. There are 3 options, default is 0
1496 (Kill only unread arts).
1497 0 Kill only unread arts is the 'traditional' behavior
1499 of tin(1). Only unread articles are killed once
1500 only by marking them read. As filtering only hap‐
1501 pens on unread articles with kill_level set to 0,
1502 art_marked_killed and art_marked_read_selected are
1503 only shown once. When you reenter the group the
1504 mark will be gone.
1505 1 Kill all arts & show with K will process all arti‐
1507 cles in the group and therefore there is a process‐
1508 ing overhead when using this option. Killed arti‐
1509 cles are threaded as normal but they will be marked
1510 with art_marked_killed.
1511 2 Kill all arts and never show will process all arti‐
1513 cles in the group and therefore there is a process‐
1514 ing overhead when using this option. Killed arti‐
1515 cles simply does not get displayed at all.
1516 mail_8bit_header
1518 Allows 8bit characters unencoded in the header of mail
1519 message. Default is OFF. Turning it ON is effective only
1520 if mail_mime_encoding is also set to 8bit. Leaving it OFF
1521 is safe for most users and compliant to Internet Mail
1522 Standard (RFC5322 and RFC2047). Default is OFF.
1523 mail_address
1525 User's mail address (and full name), if not user‐
1526 name@host. This is used when creating articles, sending
1527 mail and when pgp(1) signing.
1528 mail_mime_encoding
1530 MIME encoding of the body in mail message, if necessary
1531 (8bit, base64, quoted-printable, 7bit). Default is
1532 quoted-printable.
1533 mail_quote_format
1535 Format of quote line when replying (via mail) to an arti‐
1536 cle (%A=Address, %D=Date, %F=Fullname+Address, %G=Group‐
1537 name, %M=Message-ID, %N=Fullname, %C=Firstname, %I=Ini‐
1538 tials). Default is "In article %M you wrote:"
1539 mailbox_format
1541 Select one of the following mailbox-formats: MBOXO (de‐
1542 fault, except on SCO), MBOXRD or MMDF (default on SCO).
1543 See mbox(5) and RFC4155 for more details on MBOXO and
1544 MBOXRD and mmdf(5) for more details about MMDF.
1545 maildir
1547 The directory where articles/threads are to be saved in
1548 mbox(5) format. This feature is mainly for use with the
1549 mutt(1) mail program. It allows the user to save arti‐
1550 cles/threads/groups simply by giving '=' as the filename
1551 to save to. Default is ${TIN_HOMEDIR:-"$HOME"}/Mail.
1552 mailer_format
1554 The format string used to create the mailer command with
1555 parameters that is used for mailing articles to other
1556 people. Default is '%M "%T" < %F' (e.g., /bin/mail "iain"
1557 < ~/.article). The flexible format allows other mailers
1558 with different command line parameters to be used such as
1559 sendmail -oem -t < %F
1560 mutt -s "%S" -- "%T" < %F
1561 mutt -H %F
1562 claws-mail --compose "mailto:%T?subject=%S&insert=%F"
1563 interactive_mailer must be set adequate. The following
1564 substitutions are supported:
1565 %F filename
1566 %M default_mailer
1567 %S subject-field
1568 %T to-filed
1569 %U username
1570 %% %
1571 mark_saved_read
1573 If ON mark articles that are saved as read. Default is
1574 ON.
1575 mark_ignore_tags
1577 When this is ON, the GroupMarkThdRead ('K'), Thread‐
1578 MarkArtRead ('K'), MarkThdUnread ('Z') at Group level and
1579 MarkArtUnread ('z') at Thread level functions mark just
1580 the current article or thread, ignoring other tagged,
1581 (un)read articles. When OFF, the same function presents a
1582 menu with choices of the current thread or article, all
1583 tagged, unread articles, or nothing.
1584 metamail_prog
1586 Path, name and options of external metamail(1) program
1587 used to view non-textual parts of articles. To use the
1588 built-in viewer, set to --internal. This is the default
1589 value when metamail(1) is not installed. Leave it blank
1590 if you don't want any automatic viewing of non-textual
1591 attachments. The PageViewAttach ('V') command can always
1592 be used to manually view any attachments. See also
1593 ask_for_metamail.
1594 mm_charset
1596 Charset supported locally, which is also used for MIME
1597 header (charset parameter and charset name in header en‐
1598 coding) in mail and news postings. If MIME_STRICT_CHARSET
1599 is defined at compile time, text in charset other than
1600 the value of this parameter is considered not displayable
1601 and represented as '?'. Otherwise, all character sets are
1602 regarded as compatible with the display. If it's not set,
1603 the value of the environment variable $MM_CHARSET is
1604 used. US-ASCII or compile-time default is used in case
1605 neither of them is defined. If your system supports
1606 iconv(3), this option is disabled and you should use
1607 mm_network_charset instead.
1608 mm_network_charset
1610 Charset used for posting and MIME headers; replaces
1611 mm_charset. Conversion between mm_network_charset and
1612 local charset (determined via nl_langinfo(3)) is done via
1613 iconv(3), if this function is not available on your sys‐
1614 tem this option is disabled and you have to use
1615 mm_charset instead. mm_network_charset is limited to one
1616 of the following charsets:
1617 US-ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16},
1618 KOI8-{R,U,RU} EUC-{CN,JP,KR,TW}, ISO-2022-{CN,CN-
1619 EXT,JP,JP-1,JP-2}, Big5, UTF-8
1620 Not all values might work on your system, see
1621 iconv_open(3) for more details. If it's not set, the
1622 value of the environment variable $MM_CHARSET is used.
1623 US-ASCII or compile-time default is used in case neither
1624 of them is defined.
1625 mono_markdash
1627 Character attribute of words emphasized like _this_. It
1628 depends on your terminal which attributes are usable. See
1629 also word_h_display_marks and word_highlight.
1630 mono_markslash
1632 Character attribute of words emphasized like /this/. It
1633 depends on your terminal which attributes are usable. See
1634 also word_h_display_marks and word_highlight.
1635 mono_markstar
1637 Character attribute of words emphasized like *this*. It
1638 depends on your terminal which attributes are usable. See
1639 also word_h_display_marks and word_highlight.
1640 mono_markstroke
1642 Character attribute of words emphasized like -this-. It
1643 depends on your terminal which attributes are usable. See
1644 also word_h_display_marks and word_highlight.
1645 newnews
1647 These are internal timers used by tin(1) to keep track of
1648 new newsgroups. Do not change them unless you understand
1649 what they are for.
1650 news_headers_to_display
1652 Which news headers you wish to see. If you want to see
1653 _all_ the headers, place an '*' as this value. This is
1654 the only way a wildcard can be used. If you enter 'X-'
1655 as the value, you will see all headers beginning with
1656 'X-' (like X-Alan or X-Pape). You can list more than one
1657 by delimiting with spaces. Not defining anything turns
1658 off this option.
1659 news_headers_to_not_display
1661 Same as news_headers_to_display except it denotes the op‐
1662 posite. An example of using both options might be if you
1663 thought 'X-' headers were A Good Thing(tm), but thought
1664 Alan and Pape were miscreants... well then you would do
1665 something like this: news_headers_to_display=X-
1666 news_headers_to_not_display=X-Alan X-Pape Not defining
1667 anything turns off this option.
1668 news_quote_format
1670 Format of quote line when posting/following up an article
1671 (%A=Address, %D=Date, %F=Fullname+Address, %G=Groupname,
1672 %M=Message-ID, %N=Fullname, %C=Firstname, %I=Initials).
1673 Default is "%F wrote:".
1674 nntp_read_timeout_secs
1676 Time in seconds to wait for a response from the server.
1677 Default is 120.
1678 normalization_form
1680 The normalization form which should be used to normalize
1681 unicode input. The possible values are:
1682 0 None: no normalization
1684 1 NFKC: Compatibility Decomposition, followed by
1686 Canonical Composition
1687 2 NFKD: Compatibility Decomposition
1689 3 NFC: Canonical Decomposition, followed by Canonical
1691 Composition
1692 4 NFD: Canonical Decomposition
1694 5 NFKC_CF: Compatibility Decomposition, followed by
1696 Canonical Composition and Case Folding
1697 Some normalization modes are only available if they are sup‐
1698 ported by the library tin(1) uses to do the normalization. NFC
1699 should be used if possible.
1700 pos_first_unread
1702 If ON put cursor at first unread article in group other‐
1703 wise at last article. Default is ON.
1704 post_8bit_header
1706 Allows 8bit characters unencoded in the header of a news
1707 article, if set this also disables the generation of
1708 MIME-headers when they are usually required. Default is
1709 OFF. Only enacted if post_mime_encoding is also set to
1710 8bit. In a number of local hierarchies where 8bit charac‐
1711 ters are used, using unencoded (raw) 8bit characters in
1712 header is acceptable and sometimes even recommended so
1713 that you need to check the convention adopted in the lo‐
1714 cal hierarchy of your interest to determine what to do
1715 with this and post_mime_encoding.
1716 post_mime_encoding
1718 MIME encoding of the body in news message, if necessary.
1719 (8bit, base64, quoted-printable, 7bit). Default is 8bit,
1720 which leads to no encoding. base64 and quoted-printable
1721 are usually undesired on usenet.
1722 post_process_view
1724 If ON, then tin(1) will start an appropriate viewer pro‐
1725 gram to display any files that were post processed and
1726 uudecoded. The program is determined using the mailcap(5)
1727 file. Default is ON.
1728 post_process_type
1730 This specifies whether to perform post processing on
1731 saved articles. Because the shell archive may contain
1732 commands you may not want to be executed, be careful when
1733 extracting shell archives. The following values are al‐
1734 lowed:
1735 0 No (default), no post processing is done.
1737 1 Shell archives, unpacking of multi-part shar(1)
1739 files only.
1740 2 Yes, binary attachments and data will be decoded
1742 and saved.
1743 posted_articles_file
1745 Keep posted articles in given file. If the given filename
1746 does not contain any expandable strings it will be pre‐
1747 fixed with ${TIN_HOMEDIR:-"$HOME"}/Mail/. If no filename
1748 is set then postings will not be saved. See the section
1749 "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
1750 for more information about the various expansion charac‐
1751 ters. Default is 'posted'.
1752 print_header
1754 If ON, then the full article header is sent to the
1755 printer. Otherwise only the ''Subject:'' and ''From:''
1756 fields are output. Default is OFF.
1757 printer
1759 The printer program with options that is to be used to
1760 print articles. The default is lpr(1) for BSD machines
1761 and lp(1) for SysV machines. Printing from tin(1) may
1762 have been disabled by the System Administrator.
1763 process_only_unread
1765 If ON only save/print/pipe/mail unread articles (tagged
1766 articles excepted). Default is OFF.
1767 prompt_followupto
1769 If ON show empty ''Followup-To:'' header when editing an
1770 article. Default is OFF.
1771 quote_chars
1773 The character used in quoting included text to article
1774 followups and mail replies. The '_' character represents
1775 a blank character and is replaced with ' ' when read, %I
1776 is replaced by author's initials. Default is '>_'.
1777 quote_style
1779 This bit coded integer value controls how articles are to
1780 be quoted when following up or replying to them. Any of
1781 the following options can be combined by adding all rele‐
1782 vant values. Default is 5, which means that quote charac‐
1783 ters are compressed and empty lines are quoted.
1784 1 Compress quotes Compress quote characters together
1786 when quoting multiple times (for example, '> > >'
1787 will be turned into '>>>'). This option is on by
1788 default.
1789 2 Quote Signatures This option is off by default.
1791 Signatures are always quoted regardless of this op‐
1792 tion when you are viewing an article in raw mode
1793 PageToggleRaw ('^H') and followup or reply to it.
1794 Signatures are never quoted regardless of this op‐
1795 tion when show_signatures is off.
1796 4 Quote empty lines This option is on by default.
1798 quote_regex
1800 A regular expression that will be applied when reading
1801 articles. All matching lines are shown in col_quote. If
1802 quote_regex is blank, then tin(1) uses a built-in de‐
1803 fault.
1804 quote_regex2
1806 A regular expression that will be applied when reading
1807 articles. All matching lines are shown in col_quote2. If
1808 quote_regex2 is blank, then tin(1) uses a built-in de‐
1809 fault.
1810 quote_regex3
1812 A regular expression that will be applied when reading
1813 articles. All matching lines are shown in col_quote3. If
1814 quote_regex3 is blank, then tin(1) uses a built-in de‐
1815 fault.
1816 recent_time
1818 If set to 0, this feature is deactivated, otherwise it
1819 means the number of days. Default is 2.
1820 render_bidi
1822 If ON tin(1) does the rendering of bi-directional text.
1823 If OFF tin(1) leaves the rendering of bi-directional text
1824 to the terminal. Default is OFF.
1825 reread_active_file_secs
1827 The news ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE‐
1828 FILE:-active} file is reread at regular intervals to show
1829 if any new news has arrived. Default is 1200. Setting
1830 this to 0 will disable this feature.
1831 savedir
1833 Directory where articles/threads are saved. Default is
1834 ${TIN_HOMEDIR:-"$HOME"}/News.
1835 score_limit_kill
1837 If the score of an article is below or equal this value
1838 the article gets marked as killed.
1839 score_limit_select
1841 If the score of an article is above or equal this value
1842 the article gets marked as hot.
1843 score_kill
1845 Score of an article which should be killed, this must be
1846 <= score_limit_kill.
1847 score_select
1849 Score of an article which should be marked hot, this must
1850 be >= score_limit_select.
1851 scroll_lines
1853 The number of lines that will be scrolled up/down in the
1854 article pager when using cursor-up/down. The default is 1
1855 (line-by-line). Set to 0 to get traditional tin page-by-
1856 page scrolling. Set to -1 to get page-by-page scrolling
1857 where the top/bottom line is carried over onto the next
1858 page. This setting supersedes
1859 show_last_line_prev_page=ON. Set to -2 to get half-page
1860 scrolling. This setting supersedes full_page_scroll=OFF.
1861 select_format
1863 The format string used for the Selection level. Default
1864 is "%f %n %U %G %d". The following substitutions are
1865 supported:
1866 %G group name
1867 %U unread count
1868 %d description
1869 %f group flag
1870 %n current group number
1871 %% %
1872 sort_function
1874 Function used for sorting articles. Default is 0.
1875 0 Use qsort(3) for sorting.
1877 1 Use heapsort(3) for sorting. This might be faster in
1879 large groups with long threads (somewhat presorted
1880 data).
1881 show_author
1883 Which information about the author should be shown. De‐
1884 fault is 2, authors full name.
1885 0 None, only the ''Subject:'' line will be displayed.
1887 1 Address, ''Subject:'' line & the address part of
1889 the ''From:'' line are displayed.
1890 2 Full Name, ''Subject:'' line & the authors full
1892 name part of the ''From:'' line are displayed (de‐
1893 fault).
1894 3 Address and Name, ''Subject:'' line & all of the
1896 ''From:'' line are displayed.
1897 show_description
1899 If ON show a short group description text after newsgroup
1900 name at the group selection level. The ''-d'' command-
1901 line flag will override the setting and turn descriptions
1902 off. The text used is taken from the ${TIN_LIB‐
1903 DIR:-NEWSLIBDIR}/newsgroups file and if supported (re‐
1904 quires tin(1) to be built with mh-mail-handling support)
1905 from ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups for mail‐
1906 groups. Default is ON.
1907 show_help_mail_sign
1909 Allows you to select whether tin(1) shows a help indica‐
1910 tion, a new mail indication, both, or neither in the var‐
1911 ious level titles. Default is 3.
1912 0 Don't show help or mail sign.
1914 1 Show only help sign.
1916 2 Show only mail sign if new mail, show only the mail
1918 sign, and only if new mail has arrived.
1919 3 Show mail if new mail else help s., show mail sign
1921 if new mail has arrived otherwise show help sign.
1922 show_info
1924 Which information about the thread or article should be
1925 shown. Default is 1, show only the line count.
1926 0 None, no information will be displayed.
1928 1 Lines, in article listing the line count of an ar‐
1930 ticle will be displayed and in thread listing the
1931 line count of first (unread) article will be dis‐
1932 played.
1933 2 Score, in article listing the score of an article
1935 will be displayed and in thread listing the score
1936 of the thread will be displayed — see also
1937 thread_score.
1938 3 Lines & Score, display line count and score.
1940 show_only_unread_arts
1942 If ON show only new/unread articles otherwise show all
1943 articles. Default is ON.
1944 show_only_unread_groups
1946 If ON show only subscribed groups that contain unread ar‐
1947 ticles. Default is OFF.
1948 show_signatures
1950 If OFF don't show signatures when displaying articles.
1951 Default is ON.
1952 sigdashes
1954 If ON prepend the signature with sigdashes. Default is
1955 ON.
1956 sigfile
1958 The path that specifies the signature file to use when
1959 posting, following up to or replying to an article. If
1960 the path is a directory then the signature will be ran‐
1961 domly generated from files that are in the specified di‐
1962 rectory. If the path starts with a ! the program the path
1963 points to will be executed to generate a signature. In
1964 order to pass the group name to the program, %G can be
1965 specified. This will be replaced by the name of the cur‐
1966 rent newsgroup. --none will suppress any signature. De‐
1967 fault is ${TIN_HOMEDIR:-"$HOME"}/.Sig.
1968 signature_repost
1970 If ON add signature to reposted articles. Default is ON.
1971 slashes_regex
1973 A regular expression that will be applied when reading
1974 articles. All matching words are shown in col_markslash
1975 or mono_markslash. If slashes_regex is blank, then tin(1)
1976 uses a built-in default.
1977 sort_article_type
1979 This specifies how articles should be sorted. Sort by as‐
1980 cending Date (6) is the default. The following sort types
1981 are allowed:
1982 0 Nothing, don't sort articles.
1984 1 Subject: (descending), sort articles by ''Sub‐
1986 ject:'' field descending.
1987 2 Subject: (ascending), sort articles by ''Subject:''
1989 field ascending.
1990 3 From: (descending), sort articles by ''From:''
1992 field descending.
1993 4 From: (ascending), sort articles by ''From:'' field
1995 ascending.
1996 5 Date: (descending), sort articles by ''Date:''
1998 field descending.
1999 6 Date: (ascending), sort articles by ''Date:'' field
2001 ascending (default).
2002 7 Score (descending), sort articles by filtering
2004 score descending.
2005 8 Score (ascending), sort articles by filtering score
2007 ascending.
2008 9 Lines: (descending), sort articles by ''Lines:''
2010 field descending.
2011 10 Lines: (ascending), sort articles by ''Lines:''
2013 field ascending.
2014 sort_threads_type
2016 This specifies how threads will be sorted. Sort by de‐
2017 scending Score (1) is the default. The following sort
2018 types are allowed:
2019 0 Nothing, don't sort threads.
2021 1 Score (descending), sort threads by filtering score
2023 descending (default).
2024 2 Score (ascending), sort threads by filtering score
2026 ascending.
2027 3 Last posting date (descending), sort threads by
2029 date of last posting descending.
2030 4 Last posting date (ascending), sort threads by date
2032 of last posting ascending.
2033 spamtrap_warning_addresses
2035 Set this option to a list of comma-separated strings to
2036 be warned if you are replying to an article by mail where
2037 the e-mail address contains one of these strings. The
2038 matching is case-insensitive. Example:
2039 spam,delete,remove
2041 stars_regex
2043 A regular expression that will be applied when reading
2044 articles. All matching words are shown in col_markstar or
2045 mono_markstar. If stars_regex is blank, then tin(1) uses
2046 a built-in default.
2047 strip_blanks
2049 Strips the blanks from the end of each line therefore
2050 speeding up the display when reading on a slow terminal
2051 or via modem. Default is ON.
2052 strip_bogus
2054 Bogus groups are groups that are present in your
2055 ${TIN_HOMEDIR:-"$HOME"}/.newsrc file that no longer exist
2056 on the news server. There are 3 options. 0 means do noth‐
2057 ing & always keep bogus groups. 1 means bogus groups
2058 will be permanently removed. 2 means that bogus groups
2059 will appear on the Group Selection Menu, prefixed with a
2060 'D'. This allows you to unsubscribe from them as and when
2061 you wish. Default is 0 (Always Keep).
2062 strip_newsrc
2064 If ON, then unsubscribed groups will be permanently re‐
2065 moved from your ${TIN_HOMEDIR:-"$HOME"}/.newsrc file. De‐
2066 fault is OFF.
2067 strip_re_regex
2069 A regular expression to find Subject prefixes like "Re:"
2070 to remove If strip_re_regex is blank, then tin(1) uses a
2071 built-in default.
2072 strip_was_regex
2074 A regular expression to find Subject suffixes like
2075 "(was:" to remove. If strip_was_regex is blank, then
2076 tin(1) uses a built-in default.
2077 strokes_regex
2079 A regular expression that will be applied when reading
2080 articles. All matching words are shown in col_markstroke
2081 or mono_markstroke. If strokes_regex is blank, then
2082 tin(1) uses a built-in default.
2083 tex2iso_conv
2085 Decode German style TeX umlaut codes to ISO If ON, show
2086 "a as Umlaut-a, etc. Default is OFF. This behavior can
2087 also be toggled in the article viewer via PageToggle‐
2088 Tex2iso ('"').
2089 thread_articles
2091 Defines which threading method to use. The choices are:
2092 0 Don't thread
2094 1 Thread on Subject only
2096 2 Thread on References only
2098 3 Thread on References then Subject (default)
2100 4 Thread multipart articles on Subject
2102 5 Thread on Percentage Match of the Subjects
2104 It's also possible to set the threading type on a per group ba‐
2105 sis by setting the group attribute variable thread_articles to 0
2106 – 5 in the file ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes.
2107 thread_format
2109 The format string used for the Thread level. Default is
2110 "%n %m [%L] %T %F". The following substitutions are
2111 supported:
2112 %D date
2113 %F from, name and/or address
2114 %I initials
2115 %L line count
2116 %M message-id
2117 %S score
2118 %T thread tree
2119 %m article marks
2120 %n current article number
2121 %% %
2122 thread_perc
2124 Defines how close the subjects must match while threading
2125 by Percentage Match for threads to be considered part of
2126 a single thread. This value is in the range 0 to 100. The
2127 default is 75.
2128 thread_catchup_on_exit
2130 If ON catchup group/thread when leaving with the left ar‐
2131 row key. Default is ON.
2132 thread_score
2134 How the total score of a thread is computed. Default is
2135 0, the maximum score in this thread.
2136 0 Max, the maximum score in this thread.
2138 1 Sum, the sum of all scores in this thread.
2140 2 Average, the average score in this thread.
2142 tls_ca_cert_file
2144 The name of file containing all trusted CA certificates
2145 used for NNTPS (RFC8143) connections. If left empty the
2146 system default will be used.
2147 translit
2149 If ON append //TRANSLIT to the first argument of
2150 iconv_open(3) to enable transliteration. This means that
2151 when a character cannot be represented in the target
2152 character set, it can be approximated through one or sev‐
2153 eral similarly looking characters. On systems where this
2154 extension doesn't exist, this option is disabled. Default
2155 is OFF.
2156 trim_article_body
2158 Allows you to select how tin(1) treats blank lines in ar‐
2159 ticle bodies. Default is 0. This option does not affect
2160 lines within verbatim blocks.
2161 0 Don't trim article body, do nothing.
2163 1 Skip leading blank lines.
2165 2 Skip trailing blank lines.
2167 3 Skip leading and trailing blank l., skip leading
2169 and trailing blank lines.
2170 4 Compact multiple between text, replace multiple
2172 blank lines between text blocks with one blank
2173 line.
2174 5 Compact multiple and skip leading, 4 + 1
2176 6 Compact multiple and skip trailing, 4 + 2
2178 7 Compact mltpl., skip lead. & trai., 4 + 3
2180 suppress_soft_hyphens
2182 If ON remove soft hyphens (U+00AD) from non verbatim
2183 blocks when displaying articles. Default is OFF.
2184 underscores_regex
2186 A regular expression that will be applied when reading
2187 articles. All matching words are shown in col_markdash or
2188 mono_markdash. If underscores_regex is blank, then tin(1)
2189 uses a built-in default.
2190 unlink_article
2192 If ON remove ${TIN_HOMEDIR:-"$HOME"}/.article after post‐
2193 ing. Default is ON.
2194 url_handler
2196 The program that will be run when launching URLs in the
2197 article viewer using PageViewUrl ('U'). The actual URL
2198 will be appended. Default is url_handler.pl.
2199 url_highlight
2201 Enable highlighting URLs in message body. Default is ON.
2202 use_color
2204 If enabled tin(1) uses ANSI-colors. Default is OFF.
2205 use_keypad
2207 Use scroll keys on keypad. Default is OFF.
2208 use_mouse
2210 Allows the mouse button support in an xterm(1x) to be en‐
2211 abled/disabled. Default is OFF.
2212 use_slrnface
2214 If enabled slrnface(1) will be used to interpret the
2215 ''X-Face:'' header. For this option to have any effect,
2216 tin(1) must be running in an xterm(1x) and slrnface(1)
2217 must be in your $PATH. Default is OFF.
2218 utf8_graphics
2220 If ON use UTF-8 characters for indicator ('->'),
2221 thread/attachment tree and ellipsis ('...'). Default is
2222 OFF.
2223 verbatim_begin_regex
2225 A regular expression that tin will use to find the begin
2226 of a verbatim block. Default is #v+
2227 verbatim_end_regex
2229 A regular expression that tin will use to find the end of
2230 a verbatim block. Default is #v-
2231 verbatim_handling
2233 If ON verbatim blocks will be detected. Default is ON.
2234 wildcard
2236 Allows you to select how tin(1) matches strings. The de‐
2237 fault is 0 and uses the wildmat(3) notation, which is how
2238 this has traditionally been handled. Setting this to 1
2239 allows you to use perl(1) compatible regular expressions
2240 pcre(3) or pcre2(3). (see also perlre(1) and
2241 pcrepattern(3) or pcre2pattern(3)). You will probably
2242 want to update your filter file if you use this regu‐
2243 larly. NB: Newsgroup names will always be matched using
2244 the wildmat(3) notation.
2245 word_h_display_marks
2247 Should the leading and ending stars, slashes, strokes and
2248 dashes also be displayed, even when they are highlighting
2249 marks?
2250 0 no
2252 1 yes, display mark
2254 2 print a space instead
2256 word_highlight
2258 Enable word highlighting. See word_h_display_marks for
2259 the options available. If use_color is enabled the colors
2260 specified in col_markdash, col_markslash, col_markstar
2261 and col_markstroke are used for word highlighting else
2262 the character attributes specified in mono_markdash,
2263 mono_markslash, mono_markstar and mono_markstroke are
2264 used. Default is ON.
2265 wrap_column
2267 Sets the column at which a displayed article body should
2268 be wrapped. If this value is equal to 0, it defaults to
2269 the current screen width. If this value is greater than
2270 your current screen width the part off-screen is not dis‐
2271 played. Thus setting this option to a large value can be
2272 used to disable wrapping. If this value is negative the
2273 wrap margin is the current screen width plus the given
2274 value (as long as the result is still positive, otherwise
2275 it will fall back to the current screen width). Default
2276 is 0, wrapping at the current screen width.
2277 wrap_on_next_unread
2279 If enabled a search for the next unread article will wrap
2280 around all articles to find also previous unread arti‐
2281 cles. If disabled the search stops at the end of the
2282 thread list. Default is ON.
2283 xpost_quote_format
2285 Format is the same as for news_quote_format, this is used
2286 when answering to a crossposting to several groups with
2287 no ''Followup-To:'' set.
2288 /etc/tin/tin.defaults
2290 Yet another global configuration file with "variable=value"
2292 pairs. This one is for the more general options which usually
2293 can't be controlled via ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc and/or
2294 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc like resetting (to override
2295 the built-in default) the newslibdir.
2296 domainname
2298 Sets a global domain name used in From lines
2299 organization
2301 Defines the name of your organization. $ORGANIZATION
2302 overrides any specified value.
2303 newslibdir
2305 Defines the default place for some configuration files,
2306 common values are /usr/lib/news, /var/lib/news, /usr/lo‐
2307 cal/lib/news or /news/db. $TIN_LIBDIR overrides any spec‐
2308 ified value.
2309 bugaddress
2311 Defines the email address to which users can send bug re‐
2312 ports using a built-in function. The default points to a
2313 developers mailing list located at tin.org. You might
2314 want to change this address to one of your local adminis‐
2315 tration if you want to deal with your lusers problems on
2316 your own.
2317 inewsdir
2319 Defines the directory containing the inews(1) executable.
2320 mm_charset
2322 Default charset to be used in MIME's ''Content-Type:''
2323 header. $MM_CHARSET overrides any specified value.
2324 post_mime_encoding
2326 Default encoding scheme used in MIME articles. 8bit might
2327 be the best value.
2328 mail_mime_encoding
2330 Default encoding scheme used in MIME letters.
2331 quoted-printable is a good choice here.
2332 disable_gnksa_domain_check
2334 Allow unregistered top level domains. As the list of
2335 valid TLDs is no longer actively maintained the default
2336 was changed to ON starting with tin(1) version 2.1.5
2337 disable_sender
2339 Don't generate a ''Sender:'' header. This has an effect
2340 only if inews_prog is set to --internal.
2341 spooldir
2343 Base of your newsspool (Bnews, Cnews and INN traditional
2344 spool style), common values are /var/spool/news,
2345 /usr/spool/news, /news/spool. $TIN_SPOOLDIR overrides
2346 any specified value.
2347 overviewdir
2349 Base of your NOV database newsoverview(5) (tradspool
2350 style; might be the same dir as spooldir), common values
2351 are /var/spool/overview, /usr/spool/overview, /news/over‐
2352 view. $TIN_NOVROOTDIR overrides any specified value.
2353 overviewfile
2355 Name of a single overview file, common values are .over‐
2356 view or over.view. $TIN_NOVFILENAME overrides any speci‐
2357 fied value.
2358 overviewfmtfile
2360 Full pathname of your newssystem's overview.fmt file;
2361 usually the file residesin newslibdir and is named over‐
2362 view.fmt, so you only have to change this setting if your
2363 configuration differs.
2364 activefile
2366 Full pathname of your newssystem's active file; usually
2367 the file resides in newslibdir and is named active, so
2368 you only have to change this setting if your configura‐
2369 tion differs. $TIN_ACTIVEFILE overrides any specified
2370 value.
2371 activetimesfile
2373 Full pathname of your newssystem's active.times file;
2374 usually the file resides in newslibdir and is named ac‐
2375 tive.times, so you only have to change this setting if
2376 your configuration differs.
2377 newsgroupsfile
2379 Full pathname of your newssystem's newsgroups file; usu‐
2380 ally the file resides in newslibdir and is named news‐
2381 groups, so you only have to change this setting if your
2382 configuration differs.
2383 subscriptionsfile
2385 Full pathname of your newssystem's subscriptions file;
2386 usually the file resides in newslibdir and is named sub‐
2387 scriptions, so you only have to change this setting if
2388 your configuration differs.
2389 /usr/local/share/locale/$LC_MESSAGES/LC_MESSAGES/tin.mo
2391 translation into language specified in $LC_ALL, $LC_MESSAGES or
2393 $LANG
2394 ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active}
2396 This file lists the newsgroups that the local site receives.
2398 Each newsgroup should be listed only once. Each line specifies
2399 one group; within each newsgroup, articles are assigned unique
2400 names, which are monotonically increasing numbers.
2401 If an article is posted to newsgroups not mentioned in this
2403 file, those newsgroups are ignored. If no valid newsgroups are
2404 specified, the article is rejected.
2405 Each line consists of four space-separated fields "name highmark
2407 lowmark flags".
2408 name is the name of the newsgroup
2410 highmark
2412 is the highest article number that has been used in that
2413 newsgroup
2414 lowmark
2416 is the lowest article number in the group; this number is
2417 not guaranteed to be accurate, and should only be taken
2418 to be a hint. Note that because of article cancellations,
2419 there may be gaps in the numbering sequence. If the low‐
2420 est article number is greater than the highest article
2421 number, then there are no articles in the newsgroup.
2422 flags can be one of those
2424 y local postings are allowed
2426 n no local postings are allowed, only remote ones
2428 m the group is moderated and all postings must be
2430 approved
2431 j articles in this group are not kept, but only
2433 passed on
2434 x articles cannot be posted to this newsgroup
2436 =foo.bar
2438 articles are locally filed into the ''foo.bar''
2439 group
2440 tin(1) only tries to read the file if you read directly from the
2442 local spool, if you read news via NNTP, tin(1) uses the
2443 LIST (RFC3977) or LIST COUNTS (RFC6048) command instead.
2444 ${TIN_LIBDIR:-NEWSLIBDIR}/active.times
2446 This file provides a chronological record of when newsgroups are
2448 created. It is normally updated by the local news server (e.g.
2449 innd(8)) whenever a new group is created. Each line consist of
2450 three space-separated fields "name time creator".
2451 name is the name of the newsgroup
2453 time is the time when the group was created, expressed as the
2455 number of seconds since the Epoch.
2456 creator
2458 is the electronic mail address of the person who created
2459 the group.
2460 tin(1) only tries to read the file if you read directly from the
2462 local spool, if you read news via NNTP, tin(1) uses the
2463 NEWGROUPS (RFC3977) command instead.
2464 ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups
2466 This file provides short descriptions of each newsgroup. It is
2468 normally updated by the local news server (e.g. innd(8)) when‐
2469 ever a new group is created. Each line consist of two tab-sepa‐
2470 rated fields "group.name one-line description".
2471 group.name
2473 is the name of the newsgroup
2474 one-line description
2476 is a short single-line description of the group
2477 tin(1) only tries to read the file if you read directly from the
2479 local spool, if you read news via NNTP, tin(1) uses the
2480 LIST NEWSGROUPS (RFC3977) command instead.
2481 ${TIN_LIBDIR:-NEWSLIBDIR}/organization
2483 This file might hold a default organization to be used in the
2485 ''Organization:'' header. $ORGANIZATION has a higher priority if
2486 set.
2487 ${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt
2489 This file specifies the organization of the news overview data‐
2491 base (see also newsoverview(5)). The order of lines in this
2492 file is important; it determines the order in which the fields
2493 will appear in the database. See also overview.fmt(5). tin(1)
2494 only tries to read the file if you read directly from the local
2495 spool, if you read news via NNTP, tin(1) uses the LIST OVER‐
2496 VIEW.FMT (RFC3977) command instead.
2497 ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions
2499 This file contains a list of newsgroups — one per line — which
2501 the client should subscribe to when the user has no ${TIN_HOME‐
2502 DIR:-"$HOME"}/.newsrc for the news server. tin(1) only tries to
2503 read the file if you read directly from the local spool, if you
2504 read news via NNTP, tin(1) uses the LIST SUBSCRIPTIONS (RFC6048)
2505 command instead.
2506
2509 inews(1), ispell(1), lp(1), lpr(1), metamail(1), mutt(1), perl(1),
2510 perlre(1), pgp(1), rn(1), shar(1), slrnface(1), tin(1), xterm(1x),
2511 heapsort(3), iconv(3), iconv_open(3), nl_langinfo(3), pcre(3),
2512 pcre2(3), pcrepattern(3), pcre2pattern(3), qsort(3), strftime(3),
2513 system(3), active(5), mailcap(5), mbox(5), mmdf(5), newsoverview(5),
2514 overview.fmt(5), innd(8), RFC1524, RFC2045, RFC2046, RFC2047, RFC2048,
2515 RFC2231, RFC2980, RFC3977, RFC4155, RFC4643, RFC5322, RFC5536, RFC5537,
2516 RFC6048, RFC8143
25172.6.2 December 24th, 2022 tin(5)