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. 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 ("mail_group_name maxnum minnum mailspool" quadru‐
279 ples) of user's mailgroups (requires tin(1) to be build with mh-
280 mail-handling support).
281 mail_group_name
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 verbatim_handling
525 Identical to the tinrc variable of the same name
526 wrap_on_next_unread
528 Identical to the tinrc variable of the same name
529 x_body A piece of text that will be added at the start of a mes‐
531 sage body. If this string starts with a / or ~ then it is
532 assumed to be the name of a file containing the text to
533 insert.
534 x_comment_to
536 Insert ''X-Comment-To:'' header, this is only useful in
537 FIDO groups.
538 x_headers
540 A string including header-name and the contents of the
541 header that will be automatically added when posting. If
542 the string starts with a / or ~ then it is assumed to be
543 the name of a file containing the header and its content
544 to be inserted. If the string starts with a ! then what
545 follows is assumed to be the path to a program to be exe‐
546 cuted to generate the header and its content. %G is ex‐
547 panded to the current news.group.name and %P is expanded
548 to the news.group.name with all '.' replaced by '/'.
549 quick_kill_scope
551 A comma-separated list of newsgroup patterns (wildmat-
552 style) to which groups the filter rule added by QuickFil‐
553 terKill will be applied. If unset the default from the
554 tinrc variable default_filter_kill_global will be used.
555 quick_kill_expire
557 Identical to the tinrc variable default_filter_kill_ex‐
558 pire
559 quick_kill_case
561 Identical to the tinrc variable default_filter_kill_case
562 quick_kill_header
564 Identical to the tinrc variable default_fil‐
565 ter_kill_header
566 quick_select_scope
568 A comma-separated list of newsgroup patterns (wildmat-
569 style) to which groups the filter rule added by QuickFil‐
570 terSelect will be applied. If unset the default from the
571 tinrc variable default_filter_select_global will be used.
572 quick_select_expire
574 Identical to the tinrc variable default_filter_select_ex‐
575 pire
576 quick_select_case
578 Identical to the tinrc variable default_filter_se‐
579 lect_case
580 quick_select_header
582 Identical to the tinrc variable default_filter_se‐
583 lect_header
584 ispell Path and options for ispell(1)-like spell-checker, e.g.
586 "aspell --mode=email --dont-backup check"
587 mm_network_charset
589 Identical to the tinrc variable of the same name
590 undeclared_charset
592 Assume (broken) articles without MIME charset declaration
593 have this charset — default is US-ASCII. This attribute
594 works only on systems with working iconv(3), others might
595 have to compile tin(1) with --dis‐
596 able-mime-strict-charset.
597 Example:
599 # include extra headers
600 # assume ISO-8859-1 as charset if no charset is declared
601 scope=*
602 x_headers=~/.tin/headers
603 undeclared_charset=ISO-8859-1
604 # in *sources* set post process type to shar only
606 scope=*sources*
607 post_process_type=1
608 # in *binaries* turn on full post processing,
610 # remove tmp files and set Followup-To: poster
611 scope=*binaries*
612 post_process_type=2
613 delete_tmp_files=ON
614 followup_to=poster
615 # in fido.* newsgroups change quote_chars
617 # and add X-Comment-To: line
618 scope=fido.*
619 quote_chars=%I>_
620 x_comment_to=ON
621 # in *.test newsgroups, don't append signature
623 # and preset Subject
624 scope=*.test
625 sigfile=--none
626 x_headers=Subject: test - ignore - no reply
627 # assume ISO-2022-JP-2 as charset
629 scope=fj.*,japan.*
630 undeclared_charset=ISO-2022-JP-2
631 ${TIN_HOMEDIR:-"$HOME"}/.tin/filter
633 The filter file is used to assign scores to certain articles.
635 Based on the score an article can be filtered out (hidden) or
636 marked hot. Empty lines or lines beginning with a '#' are ig‐
637 nored.
638 comment
640 Every entry (rule) in the filter file might get a com‐
641 ment. Multiple lines are allowed (but only for comments
642 yet). Every line must start with the "comment=" keyword.
643 Comments must appear first in the rule. Comment lines
644 placed within a rule will be moved to the begin of the
645 next rule. This might be changed in the future. Don't use
646 '#' to mark comments as those lines are ignored and your
647 comments will get lost on the next write of the file.
648 group A comma-separated list of newsgroup patterns in wildmat-
650 style to which groups the filter rule will be applied.
651 This line is mandatory!
652 case 0=case-sensitive, 1=case-insensitive
654 score Score value of the rule; can also be one of the magic
656 words "kill" or "hot".
657 subj Match against ''Subject:''. The matching type used (wild‐
659 mat or regex) depends on the setting of the tinrc vari‐
660 able wildcard.
661 from Match against ''From:''. tin(1) converts the contents of
663 the ''From:'' header to an old style e-mail address, e.g.
664 ''some@body.example (John Doe)'' instead of ''John Doe
665 <some@body.example>'', before trying to match the pat‐
666 terns in the filter rule. The matching type used (wildmat
667 or regex) depends on the setting of the tinrc variable
668 wildcard.
669 msgid Match against ''Message-ID:'' and full ''References:''.
671 The matching type used (wildmat or regex) depends on the
672 setting of the tinrc variable wildcard.
673 msgid_last
675 Match against ''Message-ID:'' and last ''References:''
676 entry only. The matching type used (wildmat or regex) de‐
677 pends on the setting of the tinrc variable wildcard.
678 msgid_only
680 Match against ''Message-ID:''. The matching type used
681 (wildmat or regex) depends on the setting of the tinrc
682 variable wildcard.
683 refs_only
685 Match against ''References:''. The matching type used
686 (wildmat or regex) depends on the setting of the tinrc
687 variable wildcard.
688 lines Match against ''Lines:'', <num matches less than, >num
690 matches more than.
691 gnksa Match against ''From:'' address parser return codes. <num
693 matches less than, >num matches more than the returned
694 numeric value. GNKSA_LOCAL_DOMAIN_LITERAL or GNKSA_IN‐
695 VALID_DOMAIN are only returned if disable_gnksa_do‐
696 main_check is set to false. As the built in domain list
697 is outdated this should be considered carefully.
698 0 GNKSA_OK
699 1 GNKSA_INTERNAL_ERROR
700 100 GNKSA_LANGLE_MISSING
701 101 GNKSA_LPAREN_MISSING
702 102 GNKSA_RPAREN_MISSING
703 103 GNKSA_ATSIGN_MISSING
704 104 GNKSA_RANGLE_MISSING
705 200 GNKSA_SINGLE_DOMAIN
706 201 GNKSA_INVALID_DOMAIN
707 202 GNKSA_ILLEGAL_DOMAIN
708 203 GNKSA_UNKNOWN_DOMAIN
709 204 GNKSA_INVALID_FQDN_CHAR
710 205 GNKSA_ZERO_LENGTH_LABEL
711 206 GNKSA_ILLEGAL_LABEL_LENGTH
712 207 GNKSA_ILLEGAL_LABEL_HYPHEN
713 208 GNKSA_ILLEGAL_LABEL_BEGNUM
714 209 GNKSA_BAD_DOMAIN_LITERAL
715 210 GNKSA_LOCAL_DOMAIN_LITERAL
716 211 GNKSA_RBRACKET_MISSING
717 300 GNKSA_LOCALPART_MISSING
718 301 GNKSA_INVALID_LOCALPART
719 302 GNKSA_ZERO_LENGTH_LOCAL_WORD
720 400 GNKSA_ILLEGAL_UNQUOTED_CHAR
721 401 GNKSA_ILLEGAL_QUOTED_CHAR
722 402 GNKSA_ILLEGAL_ENCODED_CHAR
723 403 GNKSA_BAD_ENCODE_SYNTAX
724 404 GNKSA_ILLEGAL_PAREN_CHAR
725 405 GNKSA_INVALID_REALNAME
726 406 GNKSA_MISSING_REALNAME
727 xref Match against ''Xref:'' line. Before any matching is done
729 the line is turned into the same format ''Newsgroups:''
730 has that is it is turned into a comma separated newsgroup
731 list with all other information (i.e. the article
732 counter) removed. The matching type used (wildmat or
733 regex) depends on the setting of the tinrc variable wild‐
734 card.
735 path Match against ''Path:'' line. This may not work on some
737 servers. The matching type used (wildmat or regex) de‐
738 pends on the setting of the tinrc variable wildcard.
739 time time_t value when rule expires
741 Example:
743 comment=mark all articles about tin, rtin,
744 comment=tind, ktin or cdtin as hot
745 group=*
746 case=1
747 score=hot
748 subj=\b(cd|[rk]?)?tin(d|pre)?[-.0-9]*\b
749 /etc/tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
751 ${TIN_HOMEDIR:-"$HOME"}/.tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
752 Keymap-file, containing "keyname value [value]" pairs separated
754 by spaces or tabs. Below is a list of all rebindable keynames
755 and their defaults. If a keyname is bound to NULL it is unas‐
756 signed.
757 ShellEscape !
759 SetRange #
760 LastPage $
761 ToggleColor &
762 LastViewed -
763 SearchRepeat \
764 SearchSubjF /
765 SearchSubjB ?
766 SearchAuthB A
767 SearchBody B
768 CatchupNextUnread C
769 EditFilter E
770 ToggleHelpDisplay H
771 ToggleInverseVideo I
772 LookupMessage L
773 OptionMenu M
774 Postponed O ^O
775 QuitTin Q
776 BugReport R
777 DisplayPostHist W
778 MarkThrUnread Z
779 FirstPage ^
780 SearchAuthF a
781 Catchup c
782 Help h
783 ToggleInfoLastLine i
784 Down j ^N
785 Up k ^P
786 Print o
787 Quit q
788 Version v
789 Post w
790 MarkArtUnread z
791 QuickFilterSelect [
792 QuickFilterKill ]
793 Pipe |
794 ScrollUp <
795 ScrollDown >
796 PageUp b ^B ^U
797 PageDown ^D ^F SPACE
798 RedrawScr ^L
799 Postponed ^O
800 MenuFilterSelect ^A
801 MenuFilterKill ^K
802 MarkFeedRead ^X
803 MarkFeedUnread ^W
804 AttachSelect ^J ^M
806 AttachPipe p
807 AttachSave s
808 AttachTag t
809 AttachUntag U
810 AttachTagPattern =
811 AttachToggleTagged @
812 ConfigToggleAttrib TAB
814 ConfigSelect ^J ^M
815 ConfigLastPage G
816 ConfigNoSave Q
817 ConfigScopeMenu S
818 ConfigFirstPage g
819 ConfigResetAttrib r
820 FeedTag T
822 FeedArt a
823 FeedHot h
824 FeedPat p
825 FeedRepost r
826 FeedSupersede s
827 FeedThd t
828 FilterEdit e
830 FilterSave s
831 GroupNextUnreadArtOrGrp TAB
833 GroupReadBasenote ^J ^M
834 GroupSelThd *
835 GroupDoAutoSel +
836 GroupToggleThdSel .
837 GroupSelThdIfUnreadSelected ;
838 GroupSelPattern =
839 GroupReverseSel @
840 GroupCancel D
841 GroupToggleGetartLimit G
842 GroupMarkThdRead K
843 GroupNextUnreadArt N
844 GroupPrevUnreadArt P
845 GroupAutoSave S
846 GroupTagParts T
847 GroupUntag U
848 GroupMarkUnselArtRead X
849 GroupToggleSubjDisplay d
850 GroupGoto g
851 GroupListThd l
852 GroupMail m
853 GroupNextGroup n
854 GroupPrevGroup p
855 GroupToggleReadUnread r
856 GroupSave s
857 GroupTag t
858 GroupToggleThreading u
859 GroupRepost x
860 GroupUndoSel ~
861 HelpLastPage G
863 HelpFirstPage g
864 PageReplyQuoteHeaders ^E
866 PagePGPCheckArticle ^G
867 PageToggleRaw ^H
868 PageNextUnread TAB
869 PageNextThd ^J ^M
870 PageToggleTabs ^T
871 PageFollowupQuoteHeaders ^W
872 PageToggleTex2iso "
873 PageToggleAllHeaders *
874 PageToggleRot %
875 PageToggleUue (
876 PageReveal )
877 PageSkipIncludedText :
878 PageTopThd <
879 PageBotThd >
880 PageCancel D
881 PageFollowup F
882 PageLastPage G
883 PageKillThd K
884 PageNextUnreadArt N
885 PagePrevUnreadArt P
886 PageReply R
887 PageAutoSave S
888 PageGroupSel T
889 PageViewUrl U
890 PageViewAttach V
891 PageToggleHighlight _
892 PageEditArticle e
893 PageFollowupQuote f
894 PageFirstPage g
895 PageListThd l
896 PageMail m
897 PageNextArt n
898 PagePrevArt p
899 PageReplyQuote r
900 PageSave s
901 PageTag t
902 PageGotoParent u
903 PageRepost x
904 PgpEncSign b
906 PgpEncrypt e
907 PgpIncludekey i
908 PgpSign s
909 PostAbort a
911 PostContinue c
912 PostCancel d
913 PostEdit e
914 PostPGP g
915 PostIspell i
916 PostIgnore i
917 PostMail m
918 PostPostpone o
919 PostPost p y
920 PostSupersede s
921 PostSend s y
922 PostedArticlesSelect ^J ^M
924 PostponeOverride Y
926 PostponeAll A
927 PromptYes y Y
929 PromptNo n N
930 PProcNone n
932 PProcShar s
933 PProcYes y
934 SaveAppendFile a
936 SaveOverwriteFile o
937 SelectEnterNextUnreadGrp TAB n
939 SelectReadGrp ^J ^M
940 SelectResetNewsrc ^R
941 SelectSortActive .
942 SelectNextUnreadGrp N
943 SelectSubscribePat S
944 SelectUnsubscribePat U
945 SelectQuitNoWrite X
946 SelectSyncWithActive Y
947 SelectToggleDescriptions d
948 SelectGoto g
949 SelectMoveGrp m
950 SelectToggleReadDisplay r
951 SelectSubscribe s
952 SelectUnsubscribe u
953 SelectYankActive y
954 SelectMarkGrpUnread z Z
955 ScopeSelect ^J ^M
957 ScopeEditAttributesFile E
958 ScopeAdd a
959 ScopeDelete d
960 ScopeMove m
961 ScopeRename r
962 ThreadReadNextArtOrThread TAB
964 ThreadReadArt ^J ^M
965 ThreadSelArt *
966 ThreadToggleArtSel .
967 ThreadReverseSel @
968 ThreadCancel D
969 ThreadMarkArtRead K
970 ThreadAutoSave S
971 ThreadUntag U
972 ThreadToggleSubjDisplay d
973 ThreadMail m
974 ThreadSave s
975 ThreadTag t
976 ThreadTagParts T
977 ThreadUndoSel ~
978 UrlSelect ^J ^M
980 ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups
982 This file provides short descriptions of each mailgroup. (re‐
984 quires tin(1) to be build with mh-mail-handling support). Each
985 line consist of two tab-separated fields "mailgroupname one-line
986 description".
987 mailgroupname
989 is the name of the newsgroup
990 description
992 is a short single-line description of the group
993 ${TIN_HOMEDIR:-"$HOME"}/.tin/newsrctable
995 "nntpserver newsrc [shortname [...]]" pairs to use with the
997 ''-g'' command-line switch.
998 nntpserver
1000 full qualified domain name of the news server.
1001 newsrc related newsrc.
1003 shortname
1005 nickname(s) for the nntpserver.
1006 Example:
1008 # sample newsrctable file
1009 news.tin.org .newsrc-tin.org tinorg
1010 news.example.org /tmp/nrc-ex example ex
1011 ${TIN_HOMEDIR:-"$HOME"}/.tin/posted
1013 Posting history. The file is written by tin(1) and used by Dis‐
1015 playPostHist ('W') command. It should not be altered manually.
1016 Any line that starts with "#" is a comment. Blank lines are ig‐
1017 nored. All other lines shall consist of at least four pipe-sepa‐
1018 rated fields, starting with a time stamp "dd-mm-yy", a single
1019 letter indicating the action which initiated the message, a
1020 group name or a mail address the message was sent to, the sub‐
1021 ject of the message and optionally the messages ''Message-ID''
1022 if known.
1023 ${TIN_HOMEDIR:-"$HOME"}/Mail/posted
1025 Copy of all posted articles in mbox(5) format. The filename can
1027 be changed by setting posted_articles_file.
1028 ${TIN_HOMEDIR:-"$HOME"}/.tin/postponed.articles
1030 Pool of postponed articles. This file is in mbox(5) format.
1032 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/newsgroups
1034 This file a copy of the servers newsgroups file which provides
1036 short descriptions of each newsgroup. It is automatically up‐
1037 dated on startup except when using the ''-X''or ''-q'' command-
1038 line option and an old copy exists. Each line consist of two
1039 tab-separated fields "group.name one-line de‐
1040 scription".
1041 group.name
1043 is the name of the newsgroup
1044 one-line description
1046 is a short single-line description of the group
1047 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/serverrc
1049 File to store $NNTPSERVER and $NNTPPORT related data via a list
1051 of "variable=value" pairs. Currently there are only two vari‐
1052 ables, both are not meant to be changed by the user.
1053 version
1055 Internal version number.
1056 last_newnews
1058 Internal timestamp used by tin(1) to keep track of new
1059 newsgroups on the server.
1060 /etc/tin/tinrc
1062 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc
1063 At startup, tin(1) reads in the configuration file. This con‐
1065 tains a list of "variable=value" pairs that can be used to con‐
1066 figure the way tin(1) works. If it exists, the global configura‐
1067 tion file, ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc is read first. After
1068 that, the user's own configuration file ${TIN_HOME‐
1069 DIR:-"$HOME"}/.tin/tinrc is read. The global file is useful for
1070 distributing system-wide defaults to new users who have no pri‐
1071 vate tinrc yet (see also /etc/tin/tin.defaults).
1072 abbreviate_groupname
1074 If ON abbreviate long newsgroup names at group selection
1075 level and article level (if necessary) like this:
1076 news.software.readers -> n.software.readers -> n.s.read‐
1077 ers -> n.s.r. Default is OFF.
1078 add_posted_to_filter
1080 If ON add posted articles which start a new thread to
1081 filter for highlighting follow-ups. Default is ON.
1082 advertising
1084 Turn ON advertising in header (''User-Agent:''). Default
1085 is ON.
1086 alternative_handling
1088 If ON strip multipart/alternative messages automatically.
1089 Default is ON.
1090 art_marked_deleted
1092 The character used to show that an article was deleted.
1093 Default is 'D'.
1094 art_marked_inrange
1096 The character used to show that an article is in a range.
1097 Default is '#'.
1098 art_marked_return
1100 The character used to show that an article will return as
1101 an unread article when the group is next entered. Default
1102 is '-'.
1103 art_marked_selected
1105 The character used to show that an article/thread is
1106 auto-selected (hot). Default is '*'.
1107 art_marked_recent
1109 The character used to show that an article/thread is re‐
1110 cent (not older than X days). See also recent_time. De‐
1111 fault is 'o'.
1112 art_marked_unread
1114 The character used to show that an article has not been
1115 read. Default is '+'.
1116 art_marked_read
1118 The character used to show that an article was read. De‐
1119 fault is ' '.
1120 art_marked_killed
1122 The character used to show that an article was killed.
1123 Default is 'K'. kill_level must be set accordingly.
1124 art_marked_read_selected
1126 The character used to show that an article was hot before
1127 it was read. Default is ':'. kill_level must be set ac‐
1128 cordingly.
1129 Ask before using MIME viewer (ask_for_metamail)
1131 If ON tin(1) will ask before using a MIME viewer (meta‐
1132 mail_prog) to display MIME messages. This only occurs if
1133 a MIME viewer is set. Default is OFF.
1134 auto_cc_bcc
1136 Automatically put your name in the ''Cc:'' and/or
1137 ''Bcc:'' field when mailing an article. Default is No.
1138 auto_list_thread
1140 If ON automatically list thread when entering it using
1141 right arrow key. Default is ON.
1142 auto_reconnect
1144 Reconnect to server automatically. Default is OFF.
1145 batch_save
1147 If set ON articles/threads will be saved in batch mode
1148 when save ''-S'' or mail ''-M, -N'' is specified on the
1149 command line. Default is ON.
1150 beginner_level
1152 If set ON a mini menu of the most useful commands will be
1153 displayed at the bottom of the screen for each level.
1154 Also a short posting etiquette will be displayed after
1155 composing an article. Default is ON.
1156 cache_overview_files
1158 If ON, create local copies of NNTP overview files. This
1159 can be used to considerably speed up accessing large
1160 groups when using a slow connection. Default is OFF.
1161 cancel_lock_algo
1163 Use this hash algorithm for cancel-locks. Only available
1164 when build with cancel-lock support. none disables the
1165 generation of cancel-locks. Valid values are none, sha1,
1166 sha256 and sha512. Default is sha1.
1167 catchup_read_groups
1169 If set ON the user is asked when quitting if all groups
1170 read during the current session should be marked read.
1171 Default is OFF.
1172 col_back
1174 Standard background color
1175 col_extquote
1177 Color of quoted text from external sources
1178 col_from
1180 Color of sender (From:)
1181 col_head
1183 Color of header-lines
1184 col_help
1186 Color of help pages
1187 col_invers_bg
1189 Color of background for inverse text
1190 col_invers_fg
1192 Color of foreground for inverse text
1193 col_markdash
1195 Color of words emphasized like _this_. See also
1196 word_h_display_marks and word_highlight.
1197 col_markslash
1199 Color of words emphasized like /this/. See also
1200 word_h_display_marks and word_highlight.
1201 col_markstar
1203 Color of words emphasized like *this*. See also
1204 word_h_display_marks and word_highlight.
1205 col_markstroke
1207 Color of words emphasized like -this-. See also
1208 word_h_display_marks and word_highlight.
1209 col_message
1211 Color of status messages in last line
1212 col_minihelp
1214 Color of mini help menu
1215 col_newsheaders
1217 Color of actual news header fields
1218 col_normal
1220 Standard foreground color
1221 col_quote
1223 Color of quoted lines
1224 col_quote2
1226 Color of twice quoted lines
1227 col_quote3
1229 Color of >=3 times quoted lines
1230 col_response
1232 Color of response counter. This is the text that says
1233 "Response x of y" in the article viewer.
1234 col_signature
1236 Color of signatures
1237 col_urls
1239 Color of urls highlight
1240 col_verbatim
1242 Color of verbatim blocks
1243 col_subject
1245 Color of article subject
1246 col_text
1248 Color of text-lines
1249 col_title
1251 Color of help/mail sign
1252 confirm_choice
1254 tin(1) can ask for manual confirmation to protect the
1255 user. Available choices:
1256 commands: Ask for confirmation before executing cer‐
1257 tain dangerous commands (e.g., Catchup ('c')). Com‐
1258 mands that this affects are marked in this manual
1259 with '[after confirmation]'.
1260 quit: You'll be asked to confirm that you wish to
1262 exit tin(1) when you use the Quit ('q') command.
1263 select: Ask for confirmation before marking all not
1265 selected (with GroupMarkUnselArtRead ('X') command)
1266 articles as read.
1267 Default is commands & quit.
1268 date_format
1270 Format string used for date representation. A description
1271 of the different format options can be found at
1272 strftime(3). tin(1) uses strftime(3) when available and
1273 supports most format options in his fallback code. De‐
1274 fault is "%a, %d %b %Y %H:%M:%S".
1275 default_art_search
1277 default_author_search
1279 default_config_search
1281 The last article/author/config option that was searched
1282 for.
1283 default_filter_days
1285 Default is 28.
1286 default_filter_kill_case
1288 Default for quick (1 key) kill filter case. ON = filter
1289 case sensitive, OFF = ignore case. Default is OFF.
1290 default_filter_kill_expire
1292 Default for quick (1 key) kill filter expire. ON = limit
1293 to default_filter_days, OFF = don't ever expire. Default
1294 is OFF.
1295 default_filter_kill_global
1297 Default for quick (1 key) kill filter global. ON=apply
1298 to all groups, OFF=apply to current group. Default is ON.
1299 default_filter_kill_header
1301 Default for quick (1 key) kill filter header.
1302 0 ''Subject:'' (case sensitive)
1303 1 ''Subject:'' (ignore case)
1304 2 ''From:'' (case sensitive)
1305 3 ''From:'' (ignore case)
1306 4 ''Message-ID:'' & full ''References:'' line
1307 5 ''Message-ID:'' & last ''References:'' entry only
1308 6 ''Message-ID:'' entry only
1309 7 ''Lines:''
1310 default_filter_select_case
1312 Default for quick (1 key) auto-selection filter case.
1313 ON=filter case sensitive, OFF=ignore case. Default is
1314 OFF.
1315 default_filter_select_expire
1317 Default for quick (1 key) auto-selection filter expire.
1318 ON = limit to default_filter_days, OFF = don't ever ex‐
1319 pire. Default is OFF.
1320 default_filter_select_global
1322 Default for quick (1 key) auto-selection filter global.
1323 ON=apply to all groups, OFF=apply to current group. De‐
1324 fault is ON.
1325 default_filter_select_header
1327 Default for quick (1 key) auto-selection filter header.
1328 0 ''Subject:'' (case sensitive)
1329 1 ''Subject:'' (ignore case)
1330 2 ''From:'' (case sensitive)
1331 3 ''From:'' (ignore case)
1332 4 ''Message-ID:'' & full ''References:'' line
1333 5 ''Message-ID:'' & last ''References:'' entry only
1334 6 ''Message-ID:'' entry only
1335 7 ''Lines:''
1336 default_goto_group
1338 default_group_search
1340 default_mail_address
1342 default_move_group
1344 default_pattern
1346 default_pipe_command
1348 default_post_newsgroups
1350 default_post_subject
1352 default_range_group
1354 default_range_select
1356 default_range_thread
1358 default_repost_group
1360 default_save_file
1362 default_save_mode
1364 default_select_pattern
1366 default_shell_command
1368 default_subject_search
1370 draw_arrow
1372 Allows groups/articles to be selected by an arrow '->' if
1373 set ON or by a highlighted bar if set OFF. Default is
1374 OFF.
1375 editor_format
1377 The format string used to create the editor start command
1378 with parameters. Default is '%E +%N %F' with %E=Editor,
1379 %N=Linenumber and %F=Filename (e.g., /bin/vi +7 .arti‐
1380 cle). See also $VISUAL and $EDITOR under "ENVIRONMENT" in
1381 tin(1)
1382 extquote_handling
1384 If ON quotes from external sources will be detected. De‐
1385 fault is OFF.
1386 extquote_regex
1388 A regular expression that will be applied when reading
1389 articles. All matching lines are shown in col_extquote.
1390 If extquote_regex is blank, then tin(1) uses a built-in
1391 default.
1392 force_screen_redraw
1394 Specifies whether a screen redraw should always be done
1395 after certain external commands. Default is OFF.
1396 getart_limit
1398 If getart_limit is > 0 not more than the last
1399 getart_limit articles/group are fetched from the server.
1400 If getart_limit is < 0 tin(1) will start fetching arti‐
1401 cles from your first unread minus absolute value of
1402 getart_limit. Default is 0, which means no limit.
1403 goto_next_unread
1405 Which keys tin(1) should accept to jump to the next un‐
1406 read article. Possible is any combination of PageDown
1407 and PageNextUnread. When PageDown is set tin(1) jumps to
1408 the next article at the end of the current one. When Pa‐
1409 geNextUnread is set tin(1) jumps immediately to the next
1410 article when PageNextUnread ('<TAB>') is pressed. Default
1411 is PageNextUnread.
1412 group_catchup_on_exit
1414 If ON catchup group when leaving with the left arrow key.
1415 Default is ON.
1416 group_format
1418 The format string used for the Group level. Default is
1419 "%n %m %R %L %s %F". The following substitutions are
1420 supported:
1421 %D date
1422 %F from, name and/or address
1423 %I initials
1424 %L line count
1425 %M message-id
1426 %R number of responses in thread
1427 %S score
1428 %m article marks
1429 %n current thread number
1430 %s subject
1431 %% %
1432 hide_uue
1434 If set to 'No' then raw uuencoded data is displayed. If
1435 set to 'Yes' then sections of uuencoded data will be
1436 shown with a single tag line showing the size and file‐
1437 name (much the same as a MIME attachment). If set to
1438 'Hide all' then any line that looks like uuencoded data
1439 will be folded into a tag line. This is useful when uuen‐
1440 coded data is split across more than one article but can
1441 also lead to false positives. This setting can also be
1442 toggled in the article viewer. Default is 'No'.
1443 inews_prog
1445 Path, name and options of external inews(1). If you are
1446 reading via NNTP the default value is "--internal" (use
1447 built-in NNTP inews), else it is "inews -h". The article
1448 is passed to inews_prog on STDIN via '< article'.
1449 info_in_last_line
1451 If ON, show current group description or article subject
1452 in the last line (not in the pager and global menu) —
1453 ToggleInfoLastLine ('i') toggles setting. This facility
1454 is useful as the full width of the screen is available to
1455 display long subjects. Default is OFF.
1456 interactive_mailer
1458 If greater than 0 your mailreader will be invoked earlier
1459 for reply so you can use more of its features (e.g. MIME,
1460 pgp, ...). 1 means include headers, 2 means don't include
1461 headers (old use_mailreader_i=ON option). 0 turns off us‐
1462 age. This option has to suit mailer_format. Default is 0.
1463 inverse_okay
1465 If ON use inverse video for page headers and URL high‐
1466 lighting. Default is ON.
1467 keep_dead_articles
1469 If ON keep all failed postings in ${TIN_HOME‐
1470 DIR:-"$HOME"}/dead.articles besides keeping the last
1471 failed posting in ${TIN_HOMEDIR:-"$HOME"}/dead.article.
1472 Default is ON.
1473 kill_level
1475 This option controls the processing and display of arti‐
1476 cles that are killed. There are 3 options, default is 0
1477 (Kill only unread arts).
1478 0 Kill only unread arts is the 'traditional' behavior
1480 of tin(1). Only unread articles are killed once
1481 only by marking them read. As filtering only hap‐
1482 pens on unread articles with kill_level set to 0,
1483 art_marked_killed and art_marked_read_selected are
1484 only shown once. When you reenter the group the
1485 mark will be gone.
1486 1 Kill all arts & show with K will process all arti‐
1488 cles in the group and therefore there is a process‐
1489 ing overhead when using this option. Killed arti‐
1490 cles are threaded as normal but they will be marked
1491 with art_marked_killed.
1492 2 Kill all arts and never show will process all arti‐
1494 cles in the group and therefore there is a process‐
1495 ing overhead when using this option. Killed arti‐
1496 cles simply does not get displayed at all.
1497 mail_8bit_header
1499 Allows 8bit characters unencoded in the header of mail
1500 message. Default is OFF. Turning it ON is effective only
1501 if mail_mime_encoding is also set to 8bit. Leaving it OFF
1502 is safe for most users and compliant to Internet Mail
1503 Standard (RFC5322 and RFC2047). Default is OFF.
1504 mail_address
1506 User's mail address (and full name), if not user‐
1507 name@host. This is used when creating articles, sending
1508 mail and when pgp(1) signing.
1509 mail_mime_encoding
1511 MIME encoding of the body in mail message, if necessary
1512 (8bit, base64, quoted-printable, 7bit). Default is
1513 quoted-printable.
1514 mail_quote_format
1516 Format of quote line when replying (via mail) to an arti‐
1517 cle (%A=Address, %D=Date, %F=Fullname+Address, %G=Group‐
1518 name, %M=Message-ID, %N=Fullname, %C=Firstname, %I=Ini‐
1519 tials). Default is "In article %M you wrote:"
1520 mailbox_format
1522 Select one of the following mailbox-formats: MBOXO (de‐
1523 fault, except on SCO), MBOXRD or MMDF (default on SCO).
1524 See mbox(5) and RFC4155 for more details on MBOXO and
1525 MBOXRD and mmdf(5) for more details about MMDF.
1526 maildir
1528 The directory where articles/threads are to be saved in
1529 mbox(5) format. This feature is mainly for use with the
1530 mutt(1) mail program. It allows the user to save arti‐
1531 cles/threads/groups simply by giving '=' as the filename
1532 to save to. Default is ${TIN_HOMEDIR:-"$HOME"}/Mail.
1533 mailer_format
1535 The format string used to create the mailer command with
1536 parameters that is used for mailing articles to other
1537 people. Default is '%M "%T" < %F' (e.g., /bin/mail "iain"
1538 < .article). The flexible format allows other mailers
1539 with different command line parameters to be used such as
1540 sendmail -oem -t < %F
1541 mutt -s "%S" -- "%T" < "%F"
1542 claws-mail --compose "mailto:%T?subject=%S&insert=%F"
1543 interactive_mailer must be set adequate. The following
1544 substitutions are supported:
1545 %F filename
1546 %M default_mailer
1547 %S subject-field
1548 %T to-filed
1549 %U username
1550 %% %
1551 mark_saved_read
1553 If ON mark articles that are saved as read. Default is
1554 ON.
1555 mark_ignore_tags
1557 When this is ON, the GroupMarkThdRead ('K'), Thread‐
1558 MarkArtRead ('K'), MarkThdUnread ('Z') at Group level and
1559 MarkArtUnread ('z') at Thread level functions mark just
1560 the current article or thread, ignoring other tagged,
1561 (un)read articles. When OFF, the same function presents a
1562 menu with choices of the current thread or article, all
1563 tagged, unread articles, or nothing.
1564 metamail_prog
1566 Path, name and options of external metamail(1) program
1567 used to view non-textual parts of articles. To use the
1568 built-in viewer, set to --internal. This is the default
1569 value when metamail(1) is not installed. Leave it blank
1570 if you don't want any automatic viewing of non-textual
1571 attachments. The PageViewAttach ('V') command can always
1572 be used to manually view any attachments. See also
1573 ask_for_metamail.
1574 mm_charset
1576 Charset supported locally, which is also used for MIME
1577 header (charset parameter and charset name in header en‐
1578 coding) in mail and news postings. If MIME_STRICT_CHARSET
1579 is defined at compile time, text in charset other than
1580 the value of this parameter is considered not displayable
1581 and represented as '?'. Otherwise, all character sets are
1582 regarded as compatible with the display. If it's not set,
1583 the value of the environment variable $MM_CHARSET is
1584 used. US-ASCII or compile-time default is used in case
1585 neither of them is defined. If your system supports
1586 iconv(3), this option is disabled and you should use
1587 mm_network_charset instead.
1588 mm_network_charset
1590 Charset used for posting and MIME headers; replaces
1591 mm_charset. Conversion between mm_network_charset and
1592 local charset (determined via nl_langinfo(3)) is done via
1593 iconv(3), if this function is not available on your sys‐
1594 tem this option is disabled and you have to use
1595 mm_charset instead. mm_network_charset is limited to one
1596 of the following charsets:
1597 US-ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16},
1598 KOI8-{R,U,RU} EUC-{CN,JP,KR,TW}, ISO-2022-{CN,CN-
1599 EXT,JP,JP-1,JP-2}, Big5, UTF-8
1600 Not all values might work on your system, see
1601 iconv_open(3) for more details. If it's not set, the
1602 value of the environment variable $MM_CHARSET is used.
1603 US-ASCII or compile-time default is used in case neither
1604 of them is defined.
1605 mono_markdash
1607 Character attribute of words emphasized like _this_. It
1608 depends on your terminal which attributes are usable. See
1609 also word_h_display_marks and word_highlight.
1610 mono_markslash
1612 Character attribute of words emphasized like /this/. It
1613 depends on your terminal which attributes are usable. See
1614 also word_h_display_marks and word_highlight.
1615 mono_markstar
1617 Character attribute of words emphasized like *this*. It
1618 depends on your terminal which attributes are usable. See
1619 also word_h_display_marks and word_highlight.
1620 mono_markstroke
1622 Character attribute of words emphasized like -this-. It
1623 depends on your terminal which attributes are usable. See
1624 also word_h_display_marks and word_highlight.
1625 newnews
1627 These are internal timers used by tin(1) to keep track of
1628 new newsgroups. Do not change them unless you understand
1629 what they are for.
1630 news_headers_to_display
1632 Which news headers you wish to see. If you want to see
1633 _all_ the headers, place an '*' as this value. This is
1634 the only way a wildcard can be used. If you enter 'X-'
1635 as the value, you will see all headers beginning with
1636 'X-' (like X-Alan or X-Pape). You can list more than one
1637 by delimiting with spaces. Not defining anything turns
1638 off this option.
1639 news_headers_to_not_display
1641 Same as news_headers_to_display except it denotes the op‐
1642 posite. An example of using both options might be if you
1643 thought 'X-' headers were A Good Thing(tm), but thought
1644 Alan and Pape were miscreants... well then you would do
1645 something like this: news_headers_to_display=X-
1646 news_headers_to_not_display=X-Alan X-Pape Not defining
1647 anything turns off this option.
1648 news_quote_format
1650 Format of quote line when posting/following up an article
1651 (%A=Address, %D=Date, %F=Fullname+Address, %G=Groupname,
1652 %M=Message-ID, %N=Fullname, %C=Firstname, %I=Initials).
1653 Default is "%F wrote:".
1654 nntp_read_timeout_secs
1656 Time in seconds to wait for a response from the server.
1657 Default is 120.
1658 normalization_form
1660 The normalization form which should be used to normalize
1661 unicode input. The possible values are:
1662 0 None: no normalization
1664 1 NFKC: Compatibility Decomposition, followed by
1666 Canonical Composition
1667 2 NFKD: Compatibility Decomposition
1669 3 NFC: Canonical Decomposition, followed by Canonical
1671 Composition
1672 4 NFD: Canonical Decomposition
1674 5 NFKC_CF: Compatibility Decomposition, followed by
1676 Canonical Composition and Case Folding
1677 Some normalization modes are only available if they are sup‐
1678 ported by the library tin(1) uses to do the normalization. NFC
1679 should be used if possible.
1680 pos_first_unread
1682 If ON put cursor at first unread article in group other‐
1683 wise at last article. Default is ON.
1684 post_8bit_header
1686 Allows 8bit characters unencoded in the header of a news
1687 article, if set this also disables the generation of
1688 MIME-headers when they are usually required. Default is
1689 OFF. Only enacted if post_mime_encoding is also set to
1690 8bit. In a number of local hierarchies where 8bit charac‐
1691 ters are used, using unencoded (raw) 8bit characters in
1692 header is acceptable and sometimes even recommended so
1693 that you need to check the convention adopted in the lo‐
1694 cal hierarchy of your interest to determine what to do
1695 with this and post_mime_encoding.
1696 post_mime_encoding
1698 MIME encoding of the body in news message, if necessary.
1699 (8bit, base64, quoted-printable, 7bit). Default is 8bit,
1700 which leads to no encoding. base64 and quoted-printable
1701 are usually undesired on usenet.
1702 post_process_view
1704 If ON, then tin(1) will start an appropriate viewer pro‐
1705 gram to display any files that were post processed and
1706 uudecoded. The program is determined using the mailcap(5)
1707 file. Default is ON.
1708 post_process_type
1710 This specifies whether to perform post processing on
1711 saved articles. Because the shell archive may contain
1712 commands you may not want to be executed, be careful when
1713 extracting shell archives. The following values are al‐
1714 lowed:
1715 0 No (default), no post processing is done.
1717 1 Shell archives, unpacking of multi-part shar(1)
1719 files only.
1720 2 Yes, binary attachments and data will be decoded
1722 and saved.
1723 posted_articles_file
1725 Keep posted articles in given file. If the given filename
1726 does not contain any expandable strings it will be pre‐
1727 fixed with ${TIN_HOMEDIR:-"$HOME"}/Mail/. If no filename
1728 is set then postings will not be saved. See the section
1729 "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
1730 for more information about the various expansion charac‐
1731 ters. Default is 'posted'.
1732 print_header
1734 If ON, then the full article header is sent to the
1735 printer. Otherwise only the ''Subject:'' and ''From:''
1736 fields are output. Default is OFF.
1737 printer
1739 The printer program with options that is to be used to
1740 print articles. The default is lpr(1) for BSD machines
1741 and lp(1) for SysV machines. Printing from tin(1) may
1742 have been disabled by the System Administrator.
1743 process_only_unread
1745 If ON only save/print/pipe/mail unread articles (tagged
1746 articles excepted). Default is OFF.
1747 prompt_followupto
1749 If ON show empty ''Followup-To:'' header when editing an
1750 article. Default is OFF.
1751 quote_chars
1753 The character used in quoting included text to article
1754 followups and mail replies. The '_' character represents
1755 a blank character and is replaced with ' ' when read, %I
1756 is replaced by author's initials. Default is '>_'.
1757 quote_style
1759 This bit coded integer value controls how articles are to
1760 be quoted when following up or replying to them. Any of
1761 the following options can be combined by adding all rele‐
1762 vant values. Default is 5, which means that quote charac‐
1763 ters are compressed and empty lines are quoted.
1764 1 Compress quotes Compress quote characters together
1766 when quoting multiple times (for example, '> > >'
1767 will be turned into '>>>'). This option is on by
1768 default.
1769 2 Quote Signatures This option is off by default.
1771 Signatures are always quoted regardless of this op‐
1772 tion when you are viewing an article in raw mode
1773 PageToggleRaw ('^H') and followup or reply to it.
1774 Signatures are never quoted regardless of this op‐
1775 tion when show_signatures is off.
1776 4 Quote empty lines This option is on by default.
1778 quote_regex
1780 A regular expression that will be applied when reading
1781 articles. All matching lines are shown in col_quote. If
1782 quote_regex is blank, then tin(1) uses a built-in de‐
1783 fault.
1784 quote_regex2
1786 A regular expression that will be applied when reading
1787 articles. All matching lines are shown in col_quote2. If
1788 quote_regex2 is blank, then tin(1) uses a built-in de‐
1789 fault.
1790 quote_regex3
1792 A regular expression that will be applied when reading
1793 articles. All matching lines are shown in col_quote3. If
1794 quote_regex3 is blank, then tin(1) uses a built-in de‐
1795 fault.
1796 recent_time
1798 If set to 0, this feature is deactivated, otherwise it
1799 means the number of days. Default is 2.
1800 render_bidi
1802 If ON tin(1) does the rendering of bi-directional text.
1803 If OFF tin(1) leaves the rendering of bi-directional text
1804 to the terminal. Default is OFF.
1805 reread_active_file_secs
1807 The news ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE‐
1808 FILE:-active} file is reread at regular intervals to show
1809 if any new news has arrived. Default is 1200. Setting
1810 this to 0 will disable this feature.
1811 savedir
1813 Directory where articles/threads are saved. Default is
1814 ${TIN_HOMEDIR:-"$HOME"}/News.
1815 score_limit_kill
1817 If the score of an article is below or equal this value
1818 the article gets marked as killed.
1819 score_limit_select
1821 If the score of an article is above or equal this value
1822 the article gets marked as hot.
1823 score_kill
1825 Score of an article which should be killed, this must be
1826 <= score_limit_kill.
1827 score_select
1829 Score of an article which should be marked hot, this must
1830 be >= score_limit_select.
1831 scroll_lines
1833 The number of lines that will be scrolled up/down in the
1834 article pager when using cursor-up/down. The default is 1
1835 (line-by-line). Set to 0 to get traditional tin page-by-
1836 page scrolling. Set to -1 to get page-by-page scrolling
1837 where the top/bottom line is carried over onto the next
1838 page. This setting supersedes
1839 show_last_line_prev_page=ON. Set to -2 to get half-page
1840 scrolling. This setting supersedes full_page_scroll=OFF.
1841 select_format
1843 The format string used for the Selection level. Default
1844 is "%f %n %U %G %d". The following substitutions are
1845 supported:
1846 %G group name
1847 %U unread count
1848 %d description
1849 %f group flag
1850 %n current group number
1851 %% %
1852 sort_function
1854 Function used for sorting articles. Default is 0.
1855 0 Use qsort(3) for sorting.
1857 1 Use heapsort(3) for sorting. This might be faster in
1859 large groups with long threads (somewhat presorted
1860 data).
1861 show_author
1863 Which information about the author should be shown. De‐
1864 fault is 2, authors full name.
1865 0 None, only the ''Subject:'' line will be displayed.
1867 1 Address, ''Subject:'' line & the address part of
1869 the ''From:'' line are displayed.
1870 2 Full Name, ''Subject:'' line & the authors full
1872 name part of the ''From:'' line are displayed (de‐
1873 fault).
1874 3 Address and Name, ''Subject:'' line & all of the
1876 ''From:'' line are displayed.
1877 show_description
1879 If ON show a short group description text after newsgroup
1880 name at the group selection level. The ''-d'' command-
1881 line flag will override the setting and turn descriptions
1882 off. The text used is taken from the ${TIN_LIB‐
1883 DIR:-NEWSLIBDIR}/newsgroups file and if supported (re‐
1884 quires tin(1) to be build with mh-mail-handling support)
1885 from ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups for mail‐
1886 groups. Default is ON.
1887 show_info
1889 Which information about the thread or article should be
1890 shown. Default is 1, show only the line count.
1891 0 None, no information will be displayed.
1893 1 Lines, in article listing the line count of an ar‐
1895 ticle will be displayed and in thread listing the
1896 line count of first (unread) article will be dis‐
1897 played.
1898 2 Score, in article listing the score of an article
1900 will be displayed and in thread listing the score
1901 of the thread will be displayed — see also
1902 thread_score.
1903 3 Lines & Score, display line count and score.
1905 show_only_unread_arts
1907 If ON show only new/unread articles otherwise show all
1908 articles. Default is ON.
1909 show_only_unread_groups
1911 If ON show only subscribed groups that contain unread ar‐
1912 ticles. Default is OFF.
1913 show_signatures
1915 If OFF don't show signatures when displaying articles.
1916 Default is ON.
1917 sigdashes
1919 If ON prepend the signature with sigdashes. Default is
1920 ON.
1921 sigfile
1923 The path that specifies the signature file to use when
1924 posting, following up to or replying to an article. If
1925 the path is a directory then the signature will be ran‐
1926 domly generated from files that are in the specified di‐
1927 rectory. If the path starts with a ! the program the path
1928 points to will be executed to generate a signature. In
1929 order to pass the group name to the program, %G can be
1930 specified. This will be replaced by the name of the cur‐
1931 rent newsgroup. --none will suppress any signature. De‐
1932 fault is ${TIN_HOMEDIR:-"$HOME"}/.Sig.
1933 signature_repost
1935 If ON add signature to reposted articles. Default is ON.
1936 slashes_regex
1938 A regular expression that will be applied when reading
1939 articles. All matching words are shown in col_markslash
1940 or mono_markslash. If slashes_regex is blank, then tin(1)
1941 uses a built-in default.
1942 sort_article_type
1944 This specifies how articles should be sorted. Sort by as‐
1945 cending Date (6) is the default. The following sort types
1946 are allowed:
1947 0 Nothing, don't sort articles.
1949 1 Subject: (descending), sort articles by ''Sub‐
1951 ject:'' field descending.
1952 2 Subject: (ascending), sort articles by ''Subject:''
1954 field ascending.
1955 3 From: (descending), sort articles by ''From:''
1957 field descending.
1958 4 From: (ascending), sort articles by ''From:'' field
1960 ascending.
1961 5 Date: (descending), sort articles by ''Date:''
1963 field descending.
1964 6 Date: (ascending), sort articles by ''Date:'' field
1966 ascending (default).
1967 7 Score (descending), sort articles by filtering
1969 score descending.
1970 8 Score (ascending), sort articles by filtering score
1972 ascending.
1973 9 Lines: (descending), sort articles by ''Lines:''
1975 field descending.
1976 10 Lines: (ascending), sort articles by ''Lines:''
1978 field ascending.
1979 sort_threads_type
1981 This specifies how threads will be sorted. Sort by de‐
1982 scending Score (1) is the default. The following sort
1983 types are allowed:
1984 0 Nothing, don't sort threads.
1986 1 Score (descending), sort threads by filtering score
1988 descending (default).
1989 2 Score (ascending), sort threads by filtering score
1991 ascending.
1992 3 Last posting date (descending), sort threads by
1994 date of last posting descending.
1995 4 Last posting date (ascending), sort threads by date
1997 of last posting ascending.
1998 spamtrap_warning_addresses
2000 Set this option to a list of comma-separated strings to
2001 be warned if you are replying to an article by mail where
2002 the e-mail address contains one of these strings. The
2003 matching is case-insensitive. Example:
2004 spam,delete,remove
2006 stars_regex
2008 A regular expression that will be applied when reading
2009 articles. All matching words are shown in col_markstar or
2010 mono_markstar. If stars_regex is blank, then tin(1) uses
2011 a built-in default.
2012 strip_blanks
2014 Strips the blanks from the end of each line therefore
2015 speeding up the display when reading on a slow terminal
2016 or via modem. Default is ON.
2017 strip_bogus
2019 Bogus groups are groups that are present in your
2020 ${TIN_HOMEDIR:-"$HOME"}/.newsrc file that no longer exist
2021 on the news server. There are 3 options. 0 means do noth‐
2022 ing & always keep bogus groups. 1 means bogus groups
2023 will be permanently removed. 2 means that bogus groups
2024 will appear on the Group Selection Menu, prefixed with a
2025 'D'. This allows you to unsubscribe from them as and when
2026 you wish. Default is 0 (Always Keep).
2027 strip_newsrc
2029 If ON, then unsubscribed groups will be permanently re‐
2030 moved from your ${TIN_HOMEDIR:-"$HOME"}/.newsrc file. De‐
2031 fault is OFF.
2032 strip_re_regex
2034 A regular expression to find Subject prefixes like "Re:"
2035 to remove If strip_re_regex is blank, then tin(1) uses a
2036 built-in default.
2037 strip_was_regex
2039 A regular expression to find Subject suffixes like
2040 "(was:" to remove. If strip_was_regex is blank, then
2041 tin(1) uses a built-in default.
2042 strokes_regex
2044 A regular expression that will be applied when reading
2045 articles. All matching words are shown in col_markstroke
2046 or mono_markstroke. If strokes_regex is blank, then
2047 tin(1) uses a built-in default.
2048 tex2iso_conv
2050 Decode German style TeX umlaut codes to ISO If ON, show
2051 "a as Umlaut-a, etc. Default is OFF. This behavior can
2052 also be toggled in the article viewer via PageToggle‐
2053 Tex2iso ('"').
2054 thread_articles
2056 Defines which threading method to use. The choices are:
2057 0) Don't thread, 1) Thread on Subject only 2) Thread on
2058 References only, 3) Thread on References then Subject
2059 (default) 4) Thread multipart articles on Subject. 5)
2060 Thread on Percentage Match of the Subjects It's also pos‐
2061 sible to set the threading type on a per group basis by
2062 setting the group attribute variable thread_articles to 0
2063 – 5 in the file ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes.
2064 thread_format
2066 The format string used for the Thread level. Default is
2067 "%n %m [%L] %T %F". The following substitutions are
2068 supported:
2069 %D date
2070 %F from, name and/or address
2071 %I initials
2072 %L line count
2073 %M message-id
2074 %S score
2075 %T thread tree
2076 %m article marks
2077 %n current article number
2078 %% %
2079 thread_perc
2081 Defines how close the subjects must match while threading
2082 by Percentage Match for threads to be considered part of
2083 a single thread. This value is in the range 0 to 100. The
2084 default is 75.
2085 thread_catchup_on_exit
2087 If ON catchup group/thread when leaving with the left ar‐
2088 row key. Default is ON.
2089 thread_score
2091 How the total score of a thread is computed. Default is
2092 0, the maximum score in this thread.
2093 0 Max, the maximum score in this thread.
2095 1 Sum, the sum of all scores in this thread.
2097 2 Average, the average score in this thread.
2099 translit
2101 If ON append //TRANSLIT to the first argument of
2102 iconv_open(3) to enable transliteration. This means that
2103 when a character cannot be represented in the target
2104 character set, it can be approximated through one or sev‐
2105 eral similarly looking characters. On systems where this
2106 extension doesn't exist, this option is disabled. Default
2107 is OFF.
2108 trim_article_body
2110 Allows you to select how tin(1) treats blank lines in ar‐
2111 ticle bodies. Default is 0. This option does not affect
2112 lines within verbatim blocks.
2113 0 Don't trim article body, do nothing.
2115 1 Skip leading blank lines.
2117 2 Skip trailing blank lines.
2119 3 Skip leading and trailing blank l., skip leading
2121 and trailing blank lines.
2122 4 Compact multiple between text, replace multiple
2124 blank lines between text blocks with one blank
2125 line.
2126 5 Compact multiple and skip leading, 4 + 1
2128 6 Compact multiple and skip trailing, 4 + 2
2130 7 Compact mltpl., skip lead. & trai., 4 + 3
2132 underscores_regex
2134 A regular expression that will be applied when reading
2135 articles. All matching words are shown in col_markdash or
2136 mono_markdash. If underscores_regex is blank, then tin(1)
2137 uses a built-in default.
2138 unlink_article
2140 If ON remove ${TIN_HOMEDIR:-"$HOME"}/.article after post‐
2141 ing. Default is ON.
2142 url_handler
2144 The program that will be run when launching URLs in the
2145 article viewer using PageViewUrl ('U'). The actual URL
2146 will be appended. Default is url_handler.pl.
2147 url_highlight
2149 Enable highlighting URLs in message body. Default is ON.
2150 use_color
2152 If enabled tin(1) uses ANSI-colors. Default is OFF.
2153 use_keypad
2155 Use scroll keys on keypad. Default is OFF.
2156 use_mouse
2158 Allows the mouse button support in an xterm(1x) to be en‐
2159 abled/disabled. Default is OFF.
2160 use_slrnface
2162 If enabled slrnface(1) will be used to interpret the
2163 ''X-Face:'' header. For this option to have any effect,
2164 tin(1) must be running in an xterm(1x) and slrnface(1)
2165 must be in your $PATH. Default is OFF.
2166 utf8_graphics
2168 If ON use UTF-8 characters for indicator ('->'),
2169 thread/attachment tree and ellipsis ('...'). Default is
2170 OFF.
2171 verbatim_begin_regex
2173 A regular expression that tin will use to find the begin
2174 of a verbatim block. Default is #v+
2175 verbatim_end_regex
2177 A regular expression that tin will use to find the end of
2178 a verbatim block. Default is #v-
2179 verbatim_handling
2181 If ON verbatim blocks will be detected. Default is ON.
2182 wildcard
2184 Allows you to select how tin(1) matches strings. The de‐
2185 fault is 0 and uses the wildmat(3) notation, which is how
2186 this has traditionally been handled. Setting this to 1
2187 allows you to use perl(1) compatible regular expressions
2188 pcre(3). (see also perlre(1) and pcrepattern(3)). You
2189 will probably want to update your filter file if you use
2190 this regularly. NB: Newsgroup names will always be
2191 matched using the wildmat(3) notation.
2192 word_h_display_marks
2194 Should the leading and ending stars, slashes, strokes and
2195 dashes also be displayed, even when they are highlighting
2196 marks?
2197 0 no
2199 1 yes, display mark
2201 2 print a space instead
2203 word_highlight
2205 Enable word highlighting. See word_h_display_marks for
2206 the options available. If use_color is enabled the colors
2207 specified in col_markdash, col_markslash, col_markstar
2208 and col_markstroke are used for word highlighting else
2209 the character attributes specified in mono_markdash,
2210 mono_markslash, mono_markstar and mono_markstroke are
2211 used. Default is ON.
2212 wrap_column
2214 Sets the column at which a displayed article body should
2215 be wrapped. If this value is equal to 0, it defaults to
2216 the current screen width. If this value is greater than
2217 your current screen width the part off-screen is not dis‐
2218 played. Thus setting this option to a large value can be
2219 used to disable wrapping. If this value is negative the
2220 wrap margin is the current screen width plus the given
2221 value (as long as the result is still positive, otherwise
2222 it will fall back to the current screen width). Default
2223 is 0, wrapping at the current screen width.
2224 wrap_on_next_unread
2226 If enabled a search for the next unread article will wrap
2227 around all articles to find also previous unread arti‐
2228 cles. If disabled the search stops at the end of the
2229 thread list. Default is ON.
2230 xpost_quote_format
2232 Format is the same as for news_quote_format, this is used
2233 when answering to a crossposting to several groups with
2234 no ''Followup-To:'' set.
2235 /etc/tin/tin.defaults
2237 Yet another global configuration file with "variable=value"
2239 pairs. This one is for the more general options which usually
2240 can't be controlled via ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc and/or
2241 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc like resetting (to override
2242 the built-in default) the newslibdir.
2243 domainname
2245 Sets a global domain name used in From lines
2246 organization
2248 Defines the name of your organization. $ORGANIZATION
2249 overrides any specified value.
2250 newslibdir
2252 Defines the default place for some configuration files,
2253 common values are /usr/lib/news, /var/lib/news, /usr/lo‐
2254 cal/lib/news or /news/db. $TIN_LIBDIR overrides any spec‐
2255 ified value.
2256 bugaddress
2258 Defines the email address to which users can send bug re‐
2259 ports using a built-in function. The default points to a
2260 developers mailing list located at tin.org. You might
2261 want to change this address to one of your local adminis‐
2262 tration if you want to deal with your lusers problems on
2263 your own.
2264 inewsdir
2266 Defines the directory containing the inews(1) executable.
2267 mm_charset
2269 Default charset to be used in MIME's ''Content-Type:''
2270 header. $MM_CHARSET overrides any specified value.
2271 post_mime_encoding
2273 Default encoding scheme used in MIME articles. 8bit might
2274 be the best value.
2275 mail_mime_encoding
2277 Default encoding scheme used in MIME letters.
2278 quoted-printable is a good choice here.
2279 disable_gnksa_domain_check
2281 Allow unregistered top level domains. As the list of
2282 valid TLDs is no longer actively maintained the default
2283 was changed to ON starting with tin(1) version 2.1.5
2284 disable_sender
2286 Don't generate a ''Sender:'' header. This has an effect
2287 only if inews_prog is set to --internal.
2288 spooldir
2290 Base of your newsspool (Bnews, Cnews and INN traditional
2291 spool style), common values are /var/spool/news,
2292 /usr/spool/news, /news/spool. $TIN_SPOOLDIR overrides
2293 any specified value.
2294 overviewdir
2296 Base of your NOV database newsoverview(5) (tradspool
2297 style; might be the same dir as spooldir), common values
2298 are /var/spool/overview, /usr/spool/overview, /news/over‐
2299 view. $TIN_NOVROOTDIR overrides any specified value.
2300 overviewfile
2302 Name of a single overview file, common values are .over‐
2303 view or over.view. $TIN_NOVFILENAME overrides any speci‐
2304 fied value.
2305 overviewfmtfile
2307 Full pathname of your newssystem's overview.fmt file;
2308 usually the file residesin newslibdir and is named over‐
2309 view.fmt, so you only have to change this setting if your
2310 configuration differs.
2311 activefile
2313 Full pathname of your newssystem's active file; usually
2314 the file resides in newslibdir and is named active, so
2315 you only have to change this setting if your configura‐
2316 tion differs. $TIN_ACTIVEFILE overrides any specified
2317 value.
2318 activetimesfile
2320 Full pathname of your newssystem's active.times file;
2321 usually the file resides in newslibdir and is named ac‐
2322 tive.times, so you only have to change this setting if
2323 your configuration differs.
2324 newsgroupsfile
2326 Full pathname of your newssystem's newsgroups file; usu‐
2327 ally the file resides in newslibdir and is named news‐
2328 groups, so you only have to change this setting if your
2329 configuration differs.
2330 subscriptionsfile
2332 Full pathname of your newssystem's subscriptions file;
2333 usually the file resides in newslibdir and is named sub‐
2334 scriptions, so you only have to change this setting if
2335 your configuration differs.
2336 /usr/local/share/locale/$LC_MESSAGES/LC_MESSAGES/tin.mo
2338 translation into language specified in $LC_ALL, $LC_MESSAGES or
2340 $LANG
2341 ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active}
2343 This file lists the newsgroups that the local site receives.
2345 Each newsgroup should be listed only once. Each line specifies
2346 one group; within each newsgroup, articles are assigned unique
2347 names, which are monotonically increasing numbers.
2348 If an article is posted to newsgroups not mentioned in this
2350 file, those newsgroups are ignored. If no valid newsgroups are
2351 specified, the article is rejected.
2352 Each line consists of four space-separated fields "name highmark
2354 lowmark flags".
2355 name is the name of the newsgroup
2357 highmark
2359 is the highest article number that has been used in that
2360 newsgroup
2361 lowmark
2363 is the lowest article number in the group; this number is
2364 not guaranteed to be accurate, and should only be taken
2365 to be a hint. Note that because of article cancellations,
2366 there may be gaps in the numbering sequence. If the low‐
2367 est article number is greater than the highest article
2368 number, then there are no articles in the newsgroup.
2369 flags can be one of those
2371 y local postings are allowed
2373 n no local postings are allowed, only remote ones
2375 m the group is moderated and all postings must be
2377 approved
2378 j articles in this group are not kept, but only
2380 passed on
2381 x articles cannot be posted to this newsgroup
2383 =foo.bar
2385 articles are locally filed into the ''foo.bar''
2386 group
2387 tin(1) only tries to read the file if you read directly from the
2389 local spool, if you read news via NNTP, tin(1) uses the
2390 LIST (RFC3977) or LIST COUNTS (RFC6048) command instead.
2391 ${TIN_LIBDIR:-NEWSLIBDIR}/active.times
2393 This file provides a chronological record of when newsgroups are
2395 created. It is normally updated by the local news server (e.g.
2396 innd(8)) whenever a new group is created. Each line consist of
2397 three space-separated fields "name time creator".
2398 name is the name of the newsgroup
2400 time is the time when the group was created, expressed as the
2402 number of seconds since the Epoch.
2403 creator
2405 is the electronic mail address of the person who created
2406 the group.
2407 tin(1) only tries to read the file if you read directly from the
2409 local spool, if you read news via NNTP, tin(1) uses the
2410 NEWGROUPS (RFC3977) command instead.
2411 ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups
2413 This file provides short descriptions of each newsgroup. It is
2415 normally updated by the local news server (e.g. innd(8)) when‐
2416 ever a new group is created. Each line consist of two tab-sepa‐
2417 rated fields "group.name one-line description".
2418 group.name
2420 is the name of the newsgroup
2421 one-line description
2423 is a short single-line description of the group
2424 tin(1) only tries to read the file if you read directly from the
2426 local spool, if you read news via NNTP, tin(1) uses the
2427 LIST NEWSGROUPS (RFC3977) command instead.
2428 ${TIN_LIBDIR:-NEWSLIBDIR}/organization
2430 This file might hold a default organization to be used in the
2432 ''Organization:'' header. $ORGANIZATION has a higher priority if
2433 set.
2434 ${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt
2436 This file specifies the organization of the news overview data‐
2438 base (see also newsoverview(5)). The order of lines in this
2439 file is important; it determines the order in which the fields
2440 will appear in the database. See also overview.fmt(5). tin(1)
2441 only tries to read the file if you read directly from the local
2442 spool, if you read news via NNTP, tin(1) uses the LIST OVER‐
2443 VIEW.FMT (RFC3977) command instead.
2444 ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions
2446 This file contains a list of newsgroups — one per line — which
2448 the client should subscribe to when the user has no ${TIN_HOME‐
2449 DIR:-"$HOME"}/.newsrc for the news server. tin(1) only tries to
2450 read the file if you read directly from the local spool, if you
2451 read news via NNTP, tin(1) uses the LIST SUBSCRIPTIONS (RFC6048)
2452 command instead.
2453
2455 inews(1), ispell(1), lp(1), lpr(1), metamail(1), mutt(1), perl(1),
2456 perlre(1), pgp(1), rn(1), shar(1), slrnface(1), tin(1), xterm(1x),
2457 heapsort(3), iconv(3), iconv_open(3), nl_langinfo(3), pcre(3),
2458 pcrepattern(3), qsort(3), strftime(3), system(3), active(5),
2459 mailcap(5), mbox(5), mmdf(5), newsoverview(5), overview.fmt(5),
2460 innd(8), RFC1524, RFC2045, RFC2046, RFC2047, RFC2048, RFC2231, RFC2980,
2461 RFC3977, RFC4155, RFC4643, RFC5322, RFC5536, RFC5537, RFC6048
24622.6.1 December 24th, 2021 tin(5)