1tin(5) A Usenet newsreader tin(5)
2
6 tin, rtin - related files
7
10 This manpage describes the various (config) files and their formats
11 used by the tin(1) newsreader.
12
15 $MAILCAPS
16 ${TIN_HOMEDIR-"$HOME"}/.mailcap
17 /etc/mailcap
18 /usr/etc/mailcap
19 /usr/local/etc/mailcap
20 /etc/mail/mailcap
21 mailcap(4) files as defined in RFC1524. The Mailcap files are
23 read by tin(1) to determine how to display non-text messages at
24 the local site. Any line that starts with "#" is a comment.
25 Blank lines are ignored. Otherwise, each line defines a single
26 mailcap entry for a single content type. Long lines may be con‐
27 tinued by ending them with a backslash character, "\".
28 Each individual mailcap entry consists of a content-type speci‐
30 fication, a command to execute, and (possibly) a set of optional
31 "flag" values.
32 The "type" field is simply any legal content type name. It is
34 the string that will be matched against the "Content-Type"
35 header to decide if this is the mailcap entry that matches the
36 current message. Additionally, the type field may specify a sub‐
37 type or a wildcard to match all subtypes.
38 The "command" field is any UNIX command and is used to specify
40 the interpreter for the given type of message. It will be passed
41 to the shell via the system(3) facility.
42 Semicolons and backslashes within the command or any flag field
44 must be quoted with backslashes. If the field contains "%s",
45 those two characters will be replaced by the name of a file that
46 contains the body of the message. If it contains "%t", those two
47 characters will be replaced by the content-type field, including
48 the subtype, if any. If it contains "%{" followed by a parameter
49 name and a closing "}", then all those characters will be
50 replaced by the value of the named parameter, if any, from the
51 Content-Type header. Finally, if the field contains "\%", those
52 two characters will be replaced by a single "%" character.
53 Besides the type and command field the following "flags" are
55 defined:
56 compose
58 The "compose" field may be used to specify a program that
59 can be used to compose a new body or body part in the
60 given format. Its intended use is to support mail compos‐
61 ing agents that support the composition of multiple types
62 of mail using external composing agents. As with the
63 view-command, the semantics of program execution are
64 operating system dependent. The result of the composing
65 program may be data that is not yet suitable for mail
66 transport - that is, a Content-Transfer-Encoding may need
67 to be applied to the data.
68 composetyped
70 The "composetyped" field is similar to the "compose"
71 field, but is to be used when the composing program needs
72 to specify the Content-Type header field to be applied to
73 the composed data. The "compose" field is simpler, and is
74 preferred for use with existing (non-mail-oriented) pro‐
75 grams for composing data in a given format. The "compose‐
76 typed" field is necessary when the Content-Type informa‐
77 tion must include auxiliary parameters, and the composi‐
78 tion program must then know enough about mail formats to
79 produce output that includes the mail type information.
80 edit The "edit" field may be used to specify a program that
82 can be used to edit a body or body part in the given for‐
83 mat. In many cases, it may be identical in content to the
84 "compose" field, and shares the operating-system depen‐
85 dent semantics for program execution.
86 print The "print" field may be used to specify a program that
88 can be used to print a message or body part in the given
89 format. As with the view-command, the semantics of pro‐
90 gram execution are operating system dependent.
91 test The "test" field may be used to test some external condi‐
93 tion (e.g., the machine architecture, or the window sys‐
94 tem in use) to determine whether or not the mailcap line
95 applies. It specifies a program to be run to test some
96 condition. The semantics of execution and of the value
97 returned by the test program are operating system depen‐
98 dent. If the test fails, a subsequent mailcap entry
99 should be sought. Multiple test fields are not permitted
100 - since a test can call a program, it can already be
101 arbitrarily complex.
102 needsterminal
104 The "needsterminal" field indicates that the view-command
105 must be run on an interactive terminal. This is needed to
106 inform window-oriented user agents that an interactive
107 terminal is needed. (The decision is not left exclusively
108 to the view-command because in some circumstances it may
109 not be possible for such programs to tell whether or not
110 they are on interactive terminals.) The needsterminal
111 command should be assumed to apply to the compose and
112 edit commands, too, if they exist. Note that this is NOT
113 a test - it is a requirement for the environment in which
114 the program will be executed, and should typically cause
115 the creation of a terminal window when not executed on
116 either a real terminal or a terminal window.
117 copiousoutput
119 The "copiousoutput" field indicates that the output from
120 the view-command will be an extended stream of output,
121 and is to be interpreted as advice to the UA (User Agent
122 mail-reading program) that the output should be either
123 paged or made scroll-able. Note that it is probably a
124 mistake if needsterminal and copiousoutput are both spec‐
125 ified.
126 description
128 The "description" field simply provides a textual
129 description, optionally quoted, that describes the type
130 of data, to be used optionally by mail readers that wish
131 to describe the data before offering to display it.
132 textualnewlines
134 The "textualnewlines" field, if set to any non-zero
135 value, indicates that this type of data is line-oriented
136 and that, if encoded in base64, all newlines should be
137 converted to canonical form (CRLF) before encoding, and
138 will be in that form after decoding. In general, this
139 field is needed only if there is line-oriented data of
140 some type other than text/* or non-line- oriented data
141 that is a subtype of text.
142 x11-bitmap
144 The "x11-bitmap" field names a file, in X11 bitmap (xbm)
145 format, which points to an appropriate icon to be used to
146 visually denote the presence of this kind of data.
147 nametemplate
149 The "nametemplate" field gives a file name format, in
150 which %s will be replaced by a short unique string to
151 give the name of the temporary file to be passed to the
152 viewing command. This is only expected to be relevant in
153 environments where filename extensions are meaningful,
154 e.g., one could specify that a GIF file being passed to a
155 gif viewer should have a name ending in ".gif" by using
156 "nametemplate=%s.gif"
157 tin(1) currently only respects the "test", "description", "name‐
159 template" and partly the "needsterminal" flags, all other flags
160 are internally ignored. It also can't handle the "%F" and "%n"
161 expansions yet.
162 Example:
164 # mailcap file example
165 image/*;\
166 xv -8 -geometry +0 '%s';\
167 description=%{name} %t-Image;\
168 test=test "$DISPLAY";\
169 nametemplate=%s.IMAGE
170 message/rfc822;\
172 ${PAGER-"more"} '%s';\
173 edit=${EDITOR-"vi"} '%s';\
174 compose=${EDITOR-"vi"} '%s';\
175 print=a2ps '%s';\
176 needsterminal
177 /etc/nntpserver
179 default NNTP-server to read news from if not reading from the
181 local spool. '-g server', $NNTPSERVER have higher priority (in
182 that order), the default server given at compile time has lower
183 priority.
184 ${TIN_HOMEDIR-"$HOME"}/.cancelsecret
186 secret to be used for canlocks
188 ${TIN_HOMEDIR-"$HOME"}/.mime.types
190 /etc/mime.types
191 /etc/tin/mime.types
192 mime type / filename extension pairs
194 ${TIN_HOMEDIR-"$HOME"}/.newsauth
196 "nntpserver password [user]" pairs for NNTP servers that require
198 authorization. Any line that starts with "#" is a comment.
199 Blank lines are ignored. This file should be readable only for
200 the user as it contains the users uncrypted password for reading
201 news!
202 nntpserver
204 full qualified domain name of the newsserver.
205 password
207 users uncrypted password for reading news.
208 user username on the newsserver if it differs from the local
210 login. this field is optional.
211 Example:
213 # sample .newsauth file
214 news.example.org example
215 news.example.net news guest
216 ${TIN_HOMEDIR-"$HOME"}/.newsrc
218 "newsgroupflag [article[,article | -article]...]" lines.
220 newsgroup
222 the name of the newsgroup.
223 flag a flag indicating if the group is subscribed ':' or not
225 '!'.
226 article
228 range of already read articles from that group; numbers
229 separated by commas with sequential numbers collapsed
230 with hyphens.
231 Example:
233 # sample .newsrc file
234 news.software.b! 1-666,669
235 news.software.nntp: 1-13245,13247,13249
236 news.software.readers: 1-19567,19571-19597
237 ${TIN_HOMEDIR-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT+":$NNTPPORT"}/.oldnewsrc
239 backup of ${TIN_HOMEDIR-"$HOME"}/.newsrc
241 ${TIN_HOMEDIR-"$HOME"}/.signature
243 ${TIN_HOMEDIR-"$HOME"}/.Sig
244 signature
246 ${TIN_HOMEDIR-"$HOME"}/.sigfixed
248 fixed part of a randomly generated signature
250 ${TIN_HOMEDIR-"$HOME"}/.tin/.inputhistory
252 history of last used strings
254 ${TIN_INDEX_MAILDIR-"${TIN_HOMEDIR-"$HOME"}/.tin"}/.mail/
256 mailgroups index files
258 ${TIN_INDEX_NEWSDIR-"${TIN_HOMEDIR-"$HOME"}/.tin"}/.news${NNTPSERVER+"-$NNTPSERVER"}/
260 newsgroups index files
262 ${TIN_INDEX_SAVEDIR-"${TIN_HOMEDIR-"$HOME"}/.tin"}/.save/
264 saved newsgroups index files
266 ${TIN_HOMEDIR-"$HOME"}/.tin/active.mail
268 active file ("mail_group_name maxnum minnum mailspool"-pairs) of
270 user's mailgroups (requires tin(1) to be build with mh-mail-han‐
271 dling support).
272 mail_group_name
274 must be the pathname of the mailbox relative to field #4
275 with / changed to .
276 maxnum just put a large number here, something higher than the
278 highest message in the mailbox
279 minnum put 0 here
281 mailspool
283 path of mail spool directory. This must be the full path‐
284 name to the root of the mail folder area.
285 Example:
287 Mail.inbox 12345 00000 /home/foo
288 Mail.outbox 23456 00000 /home/foo
289 This allows access to the 'inbox' and 'outbox' folders of user
291 foo. They are accessed via /home/foo/Mail/inbox and
292 /home/foo/Mail/outbox
293 ${TIN_HOMEDIR-"$HOME"}/.tin/active.save
295 active file of user's saved newsgroups, used by tin -R.
297 /etc/tin/attributes
299 ${TIN_HOMEDIR-"$HOME"}/.tin/attributes
300 The group attributes files may be used to override some global
302 settings from ${TIN_HOMEDIR-"$HOME"}/.tin/tinrc on a per group
303 basis. Order is important as last match counts; this allows to
304 refine attributes for narrowed scopes. Note that the
305 scope=<grouplist> line has to be specified before the attributes
306 are specified for that list. All attributes are set to a reason‐
307 able default so you only have to specify the attribute that you
308 want to change. All toggle attributes are set by specifying
309 ON/OFF. Otherwise, they function exactly as their global equiv‐
310 alents. The following group attributes are available:
311 scope This changes the list of groups to which the attributes
313 that follow will be applied. See the section NEWSGROUP
314 LISTS & WILDCARDS in tin(1) for the types of pattern that
315 can be used here.
316 auto_save
318 Identical to the tinrc variable of the same name
319 auto_select
321 Automatically perform the GroupMarkUnselArtRead ('X')
322 command after entering the group.
323 batch_save
325 Can be used to override the global setting in tinrc on a
326 per group basis. For more information read section AUTO‐
327 MATIC MAILING AND SAVING NEW NEWS in tin(1).
328 delete_tmp_files
330 If this is set to ON, then saved article files that have
331 been post-processed will be automatically deleted, other‐
332 wise the user will be asked whether to delete the post-
333 processed files. Automatic processing of marked articles
334 using GroupAutoSave ('S') will suppress prompting.
335 fcc Mailbox to save sent mails. The format of the mailbox is
337 controlled via the tinrc mailbox_format variable.
338 followup_to
340 Set ''Followup-To:''-header to the specified group(s).
341 from Identical to the tinrc variable mail_address
343 maildir
345 Identical to the tinrc variable default_maildir
346 mailing_list
348 Used when a group is a mailing list. All responses to the
349 group will be directed to this email address instead
350 mime_forward
352 Determines whether usenet articles are forwarded as
353 attachment or inline. When set to OFF, the forwarded
354 article will be included in the body of the mail, while
355 setting this variable to ON will cause the article to be
356 attached as a separate MIME part. Enabling mime_forward
357 is particularly useful for articles consisting of multi‐
358 ple MIME parts such as PGP/MIME signed messages or being
359 encoded in a different character set than your local one.
360 It is also useful if the receiver should be able to oper‐
361 ate on the entire forwarded article (i.e., view or save
362 it without your comments). On the other hand, if you want
363 to forward only some parts of the article or to insert
364 'inline' annotations, you might want to disable this
365 option. Please note that for this option to have effect,
366 the tinrc variable interactive_mailer has to be set to 0
367 (which is the default).
368 mime_types_to_save
370 A comma separated list of MIME major/minor Content-Types
371 that will be saved when using the view/save and
372 save/autosave features. A single * can be used to wild‐
373 card the major and/or minor type and a ! as the first
374 character in an entry will negate it, eg:
375 image/*,!image/bmp,!text/html. Default is */*
376 news_quote_format
378 Identical to the tinrc variable of the same name
379 organization
381 This can be used to set the article header field ''Orga‐
382 nization:''. It overrides the setting (if any) of organi‐
383 zation in /etc/tin/tin.defaults and $ORGANIZATION (or
384 $NEWSORG on Apollo DomainOS). Note that some newsserver
385 might still overwrite the ''Organization:''-header.
386 post_proc_type
388 Identical to the tinrc variable post_process_type
389 quote_chars
391 Identical to the tinrc variable of the same name
392 savedir
394 Identical to the tinrc variable default_savedir
395 savefile
397 show_author
399 Identical to the tinrc variable of the same name
400 show_info
402 Identical to the tinrc variable of the same name
403 show_only_unread
405 Identical to the tinrc variable of the same name
406 sigfile
408 Identical to the tinrc variable default_sigfile
409 sort_art_type
411 Identical to the tinrc variable sort_article_type
412 sort_threads_type
414 Identical to the tinrc variable of the same name
415 tex2iso_conv
417 Identical to the tinrc variable of the same name
418 thread_arts
420 Identical to the tinrc variable thread_articles
421 thread_perc
423 Identical to the tinrc variable thread_perc
424 x_body A piece of text that will be added at the start of a mes‐
426 sage body. If this string starts with a / or ~ then it is
427 assumed to be the name of a file containing the text to
428 insert.
429 x_comment_to
431 Insert ''X-Comment-To:''-header, this is only useful in
432 FIDO groups.
433 x_headers
435 A string including header-name and the contents of the
436 header that will be automatically added when posting. If
437 the string starts with a / or ~ then it is assumed to be
438 the name of a file containing the header and its content
439 to be inserted. If the string starts with a ! then what
440 follows is assumed to be the path to a program to be exe‐
441 cuted to generate the header and its content.
442 quick_kill_scope
444 A comma-separated list of newsgroup patterns (wildmat-
445 style) to which groups the filter rule added by QuickFil‐
446 terKill will be applied. If unset the default from the
447 tinrc variable default_filter_kill_global will be used.
448 quick_kill_expire
450 Identical to the tinrc variable default_fil‐
451 ter_kill_expire
452 quick_kill_case
454 Identical to the tinrc variable default_filter_kill_case
455 quick_kill_header
457 Identical to the tinrc variable default_fil‐
458 ter_kill_header
459 quick_select_scope
461 A comma-separated list of newsgroup patterns (wildmat-
462 style) to which groups the filter rule added by QuickFil‐
463 terSelect will be applied. If unset the default from the
464 tinrc variable default_filter_select_global will be used.
465 quick_select_expire
467 Identical to the tinrc variable default_fil‐
468 ter_select_expire
469 quick_select_case
471 Identical to the tinrc variable default_fil‐
472 ter_select_case
473 quick_select_header
475 Identical to the tinrc variable default_fil‐
476 ter_select_header
477 ispell Path and options for ispell(1)-like spell-checker, e.g.
479 "aspell --mode=email --dont-backup check"
480 mm_network_charset
482 Identical to the tinrc variable of the same name
483 undeclared_charset
485 Assume (broken) articles without MIME charset declaration
486 have this charset - default is US-ASCII. This attribute
487 works only on systems with working iconv(3), others might
488 have to compile tin(1) with --dis‐
489 able-mime-strict-charset.
490 Example:
492 # include extra headers
493 # assume ISO-8859-1 as charset if no charset is declared
494 scope=*
495 x_headers=~/.tin/headers
496 undeclared_charset=ISO-8859-1
497 # in *sources* set post process type to shar only
499 scope=*sources*
500 post_proc_type=1
501 # in *binaries* turn on full post processing,
503 # remove tmp files and set Followup-To: poster
504 scope=*binaries*
505 post_proc_type=2
506 delete_tmp_files=ON
507 followup_to=poster
508 # in fido.* newsgroups change quote_chars
510 # and add X-Comment-To: line
511 scope=fido.*
512 quote_chars=%s>_
513 x_comment_to=ON
514 # in *.test newsgroups, don't append signature
516 # and preset Subject
517 scope=*.test
518 sigfile=--none
519 x_headers=Subject: test - ignore - no reply
520 # assume ISO-2022-JP-2 as charset
522 scope=fj.*,japan.*
523 undeclared_charset=ISO-2022-JP-2
524 ${TIN_HOMEDIR-"$HOME"}/.tin/filter
526 The filter file is used to assign scores to certain articles.
528 Based on the score an article can be filtered out (hidden) or
529 marked hot. Empty lines or lines beginning with a '#' are
530 ignored.
531 comment
533 Every entry (rule) in the filter file might get a com‐
534 ment. Multiple lines are allowed (but only for comments
535 yet). Every line must start with the "comment="-keyword.
536 Comments must appear first in the rule. Comment lines
537 placed within a rule will be moved to the begin of the
538 next rule. This might be changed in the future. Don't use
539 '#' to mark comments as those lines are ignored and your
540 comments will get lost on the next write of the file.
541 group A comma-separated list of newsgroup patterns (wildmat-
543 style) to which groups the filter rule will be applied.
544 This line is mandatory!
545 case 0=case-sensitive, 1=case-insensitive
547 score Score value of the rule; can also be one of the magic
549 words "kill" or "hot".
550 subj Match against ''Subject:''
552 from Match against ''From:''. tin(1) converts the contents of
554 the ''From:''-header to an old style e-mail address, e.g.
555 ''some@body.example (John Doe)'' instead of ''John Doe
556 <some@body.example>'', before trying to match the pat‐
557 terns in the filter rule.
558 msgid Match against ''Message-ID:'' and full ''References:''
560 msgid_last
562 Match against ''Message-ID:'' and last ''References:''
563 entry only
564 msgid_only
566 Match against ''Message-ID:''
567 refs_only
569 Match against ''References:''
570 lines Match against ''Lines:'', <num matches less than, >num
572 matches more than.
573 gnksa Match against ''From:''-address parser return codes.
575 xref Match against ''Xref:''-line. Before any matching is done
577 the line is turned into the same format ''Newsgroups:''
578 has that is it is turned into a comma separated newsgoup
579 list with all other informations (i.e. the article
580 counter) removed.
581 time time_t value when rule expires
583 Example:
585 comment=mark all articles about tin, rtin,
586 comment=tind, ktin or cdtin as hot
587 group=*
588 type=1
589 case=1
590 score=hot
591 subj=\b(cd|[rk]?)?tin(d|pre)?[-.0-9]*\b
592 /etc/tin/keymap${${LC_ALL-"${LC_CTYPE-"${LC_MESSAGES-"$LANG"}"}"}:+".${LC_ALL-"${LC_CTYPE-"${LC_MESSAGES-"$LANG"}"}"}"}
594 ${TIN_HOMEDIR-"$HOME"}/.tin/keymap${${LC_ALL-"${LC_CTYPE-"${LC_MESSAGES-"$LANG"}"}"}:+".${LC_ALL-"${LC_CTYPE-"${LC_MESSAGES-"$LANG"}"}"}"}
595 Keymap-file, containing "keyname value [value]" pairs seperated
597 by spaces or tabs. Below is a list of all rebindable keynames
598 and their defaults. If a keynames is bound to NULL it is unas‐
599 signed.
600 PageDown3 SPACE
602 ShellEscape !
603 SetRange #
604 LastPage $
605 ToggleColor &
606 LastViewed -
607 SearchRepeat \
608 SearchSubjF /
609 SearchSubjB ?
610 SearchAuthB A
611 SearchBody B
612 CatchupNextUnread C
613 EditFilter E
614 ToggleHelpDisplay H
615 ToggleInverseVideo I
616 LookupMessage L
617 OptionMenu M
618 Postponed O ^O
619 QuitTin Q
620 BugReport R
621 DisplayPostHist W
622 MarkThrUnread Z
623 FirstPage ^
624 SearchAuthF a
625 Catchup c
626 Help h
627 ToggleInfoLastLine i
628 Down j ^N
629 Up k ^P
630 Print o
631 Quit q
632 Version v
633 Post w
634 MarkArtUnread z
635 QuickFilterSelect [
636 QuickFilterKill ]
637 Pipe |
638 ScrollUp <
639 ScrollDown >
640 PageUp b ^B ^U
641 PageDown ^D ^F
642 RedrawScr ^L
643 Postponed ^O
644 MenuFilterSelect ^A
645 MenuFilterKill ^K
646 ConfigSelect ^J ^M
648 ConfigLastPage G
649 ConfigNoSave Q
650 ConfigFirstPage g
651 FeedTag T
653 FeedArt a
654 FeedHot h
655 FeedPat p
656 FeedRepost r
657 FeedSupersede s
658 FeedThd t
659 FilterEdit e
661 FilterSave s
662 GroupNextUnreadArtOrGrp TAB
664 GroupReadBasenote ^J ^M
665 GroupSelThd *
666 GroupDoAutoSel +
667 GroupToggleThdSel .
668 GroupSelThdIfUnreadSelected ;
669 GroupSelPattern =
670 GroupReverseSel @
671 GroupToggleGetartLimit G
672 GroupMarkThdRead K
673 GroupNextUnreadArt N
674 GroupPrevUnreadArt P
675 GroupAutoSave S
676 GroupTagParts T
677 GroupUntag U
678 GroupMarkUnselArtRead X
679 GroupToggleSubjDisplay d
680 GroupGoto g
681 GroupListThd l
682 GroupMail m
683 GroupNextGroup n
684 GroupPrevGroup p
685 GroupToggleReadUnread r
686 GroupSave s
687 GroupTag t
688 GroupToggleThreading u
689 GroupRepost x
690 GroupUndoSel ~
691 HelpLastPage G
693 HelpFirstPage g
694 PageReplyQuoteHeaders ^E
696 PagePGPCheckArticle ^G
697 PageToggleHeaders ^H
698 PageNextUnread TAB
699 PageNextThd ^J ^M
700 PageToggleTabs ^T
701 PageFollowupQuoteHeaders ^W
702 PageToggleTex2iso "
703 PageToggleRot %
704 PageToggleUue (
705 PageReveal )
706 PageSkipIncludedText :
707 PageTopThd <
708 PageBotThd >
709 PageCancel D
710 PageFollowup F
711 PageLastPage G
712 PageKillThd K
713 PageNextUnreadArt N
714 PagePrevUnreadArt P
715 PageReply R
716 PageAutoSave S
717 PageGroupSel T
718 PageViewUrl U
719 PageViewAttach V
720 PageToggleHighlight _
721 PageEditArticle e
722 PageFollowupQuote f
723 PageFirstPage g
724 PageListThd l
725 PageMail m
726 PageNextArt n
727 PagePrevArt p
728 PageReplyQuote r
729 PageSave s
730 PageTag t
731 PageGotoParent u
732 PageRepost x
733 PgpEncSign b
735 PgpEncrypt e
736 PgpIncludekey i
737 PgpSign s
738 PostAbort a
740 PostContinue c
741 PostCancel d
742 PostEdit e
743 PostPGP g
744 PostIspell i
745 PostIgnore i
746 PostMail m
747 PostPostpone o
748 PostPost p y
749 PostSupersede s
750 PostSend s y
751 PostponeOverride Y
753 PostponeAll A
754 PromptYes y Y
756 PromptNo n N
757 SaveAppendFile a
759 SaveOverwriteFile o
760 PProcNone n
762 PProcShar s
763 PProcYes y
764 SelectEnterNextUnreadGrp TAB n
766 SelectReadGrp ^J ^M
767 SelectResetNewsrc ^R
768 SelectSortActive .
769 SelectNextUnreadGrp N
770 SelectSubscribePat S
771 SelectUnsubscribePat U
772 SelectQuitNoWrite X
773 SelectSyncWithActive Y
774 SelectToggleDescriptions d
775 SelectGoto g
776 SelectMoveGrp m
777 SelectToggleReadDisplay r
778 SelectSubscribe s
779 SelectUnsubscribe u
780 SelectYankActive y
781 SelectMarkGrpUnread z Z
782 ThreadReadNextArtOrThread TAB
784 ThreadReadArt ^J ^M
785 ThreadSelArt *
786 ThreadToggleArtSel .
787 ThreadReverseSel @
788 ThreadMarkArtRead K
789 ThreadAutoSave S
790 ThreadUntag U
791 ThreadToggleSubjDisplay d
792 ThreadMail m
793 ThreadSave s
794 ThreadTag t
795 ThreadUndoSel ~
796 ${TIN_HOMEDIR-"$HOME"}/.tin/mailgroups
798 This file provides short descriptions of each mailgroup.
800 (requires tin(1) to be build with mh-mail-handling support).
801 Each line consist of two tab-separated fields "mailgroupname
802 one-line description".
803 mailgroupname
805 is the name of the newsgroup
806 description
808 is a short single-line description of the group
809 ${TIN_HOMEDIR-"$HOME"}/.tin/newsrctable
811 "nntpserver newsrc [shortname [...]]" pairs to use with the
813 ''-g'' command-line switch.
814 nntpserver
816 full qualified domain name of the newsserver.
817 newsrc related newsrc.
819 shortname
821 nickname(s) for the nntpserver.
822 Example:
824 # sample newsrctable file
825 news.tin.org .newsrc-tin.org tinorg
826 news.ka.nu /tmp/nrc-nu kanu nu
827 ${TIN_HOMEDIR-"$HOME"}/.tin/posted
829 posting history
831 ${TIN_HOMEDIR-"$HOME"}/Mail/posted
833 Copy of all posted articles in mbox(5) format. The filename can
835 be changed by setting posted_articles_file.
836 ${TIN_HOMEDIR-"$HOME"}/.tin/postponed.articles
838 Pool of postponed articles. This file is in mbox(5) format.
840 ${TIN_HOMEDIR-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT+":$NNTPPORT"}/newsgroups
842 This file a copy of the servers newsgroups file which provides
844 short descriptions of each newsgroup. It is automatically
845 updated on startup except when using the ''-X''or ''-q'' com‐
846 mand-line option and an old copy exists. Each line consist of
847 two tab-separated fields "group.name one-line
848 description".
849 group.name
851 is the name of the newsgroup
852 one-line description
854 is a short single-line description of the group
855 ${TIN_HOMEDIR-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT+":$NNTPPORT"}/serverrc
857 File to store $NNTPSERVER and $NNTPPORT related data via a list
859 of "variable=value" pairs. Currently there are only two vari‐
860 ables, both are not meant to be changed by the user.
861 version
863 Internal version number.
864 last_newnews
866 Internal timestamp used by tin(1) to keep track of new
867 newsgroups on the server.
868 /etc/tin/tinrc
870 ${TIN_HOMEDIR-"$HOME"}/.tin/tinrc
871 At startup, tin(1) reads in the configuration file. This con‐
873 tains a list of "variable=value" pairs that can be used to con‐
874 figure the way tin(1) works. If it exists, the global configura‐
875 tion file, ${TIN_LIBDIR}-NEWSLIBDIR}/tinrc is read first. After
876 that, the users own configuration file ${TIN_HOME‐
877 DIR-"$HOME"}/.tin/tinrc is read. The global file is useful for
878 distributing system-wide defaults to new users who have no pri‐
879 vate tinrc yet (see also /etc/tin/tin.defaults).
880 add_posted_to_filter
882 If ON add posted articles which start a new thread to
883 filter for highlighting follow-ups. Default is ON.
884 advertising
886 Turn ON advertising in header (''User-Agent:''). Default
887 is ON.
888 alternative_handling
890 If ON strip multipart/alternative messages automatically.
891 Default is ON.
892 art_marked_deleted
894 The character used to show that an article was deleted.
895 Default is 'D'.
896 art_marked_inrange
898 The character used to show that an article is in a range.
899 Default is '#'.
900 art_marked_return
902 The character used to show that an article will return as
903 an unread article when the group is next entered. Default
904 is '-'.
905 art_marked_selected
907 The character used to show that an article/thread is
908 auto-selected (hot). Default is '*'.
909 art_marked_recent
911 The character used to show that an article/thread is
912 recent (not older than X days). See also recent_time.
913 Default is 'o'.
914 art_marked_unread
916 The character used to show that an article has not been
917 read. Default is '+'.
918 art_marked_read
920 The character used to show that an article was read.
921 Default is ' '.
922 art_marked_killed
924 The character used to show that an article was killed.
925 Default is 'K'. kill_level must be set accordingly.
926 art_marked_read_selected
928 The character used to show that an article was hot before
929 it was read. Default is ':'. kill_level must be set
930 accordingly.
931 Ask before using MIME viewer (ask_for_metamail)
933 If ON tin(1) will ask before using a MIME viewer (meta‐
934 mail_prog) to display MIME messages. This only occurs if
935 a MIME viewer is set. Default is OFF.
936 auto_bcc
938 If ON automatically put your name in the ''Bcc:'' field
939 when mailing an article. Default is OFF.
940 auto_cc
942 If ON automatically put your name in the ''Cc:'' field
943 when mailing an article. Default is OFF.
944 auto_list_thread
946 If ON automatically list thread when entering it using
947 right arrow key. Default is ON.
948 auto_reconnect
950 Reconnect to server automatically. Default is OFF.
951 auto_save
953 If ON articles/threads with ''Archive-name:'' in header
954 will be automatically saved with the Archive-name &
955 part/patch no and post processed if post_process_type is
956 set to something other than 'No'. Default is OFF.
957 batch_save
959 If set ON articles/threads will be saved in batch mode
960 when save ''-S'' or mail ''-M, -N'' is specified on the
961 command line. Default is ON.
962 beginner_level
964 If set ON a mini menu of the most useful commands will be
965 displayed at the bottom of the screen for each level.
966 Also a short posting etiquette will be displayed after
967 composing an article. Default is ON.
968 cache_overview_files
970 If ON, create local copies of NNTP overview files. This
971 can be used to considerably speed up accessing large
972 groups when using a slow connection. Default is OFF.
973 catchup_read_groups
975 If set ON the user is asked when quitting if all groups
976 read during the current session should be marked read.
977 Default is OFF.
978 col_back
980 Standard background color
981 col_from
983 Color of sender (From:)
984 col_head
986 Color of header-lines
987 col_help
989 Color of help pages
990 col_invers_bg
992 Color of background for inverse text
993 col_invers_fg
995 Color of foreground for inverse text
996 col_markdash
998 Color of words emphasized like _this_. See also
999 word_h_display_marks and word_highlight.
1000 col_markslash
1002 Color of words emphasized like /this/. See also
1003 word_h_display_marks and word_highlight.
1004 col_markstar
1006 Color of words emphasized like *this*. See also
1007 word_h_display_marks and word_highlight.
1008 col_markstroke
1010 Color of words emphasized like -this-. See also
1011 word_h_display_marks and word_highlight.
1012 col_minihelp
1014 Color of mini help menu
1015 col_newsheaders
1017 Color of actual news header fields
1018 col_normal
1020 Standard foreground color
1021 col_quote
1023 Color of quoted lines
1024 col_quote2
1026 Color of twice quoted lines
1027 col_quote3
1029 Color of >=3 times quoted lines
1030 col_response
1032 Color of response counter. This is the text that says
1033 'Response x of y' in the article viewer.
1034 col_signature
1036 Color of signatures
1037 col_urls
1039 Color of urls highlight
1040 col_subject
1042 Color of article subject
1043 col_text
1045 Color of text-lines
1046 col_title
1048 Color of help/main sign
1049 confirm_choice
1051 tin(1) can ask for manual confirmation to protect the
1052 user. Available choices:
1053 commands: Ask for confirmation before executing cer‐
1054 tain dangerous commands (e.g., Catchup ('c')). Com‐
1055 mands that this affects are marked in this manual
1056 with '[after confirmation]'.
1057 quit: You'll be asked to confirm that you wish to
1059 exit tin(1) when you use the Quit ('q') command.
1060 select: Ask for confirmation before marking all not
1062 selected (with GroupMarkUnselArtRead ('X') command)
1063 articles as read.
1064 Default is commands & quit.
1065 date_format
1067 Format string used for date representation. A description
1068 of the different format options can be found at strf‐
1069 time(3). tin(1). uses strftime(3) when available and
1070 supports most format options in his fallback code.
1071 Default is "%a, %d %b %Y %H:%M:%S".
1072 default_art_search
1074 default_author_search
1076 default_config_search
1078 The last article/author/config option that was searched
1079 for.
1080 default_editor_format
1082 The format string used to create the editor start command
1083 with parameters. Default is '%E +%N %F' (e.g., /bin/vi
1084 +7 .article).
1085 default_filter_days
1087 Default is 28.
1088 default_filter_kill_case
1090 Default for quick (1 key) kill filter case. ON = filter
1091 case sensitive, OFF = ignore case. Default is OFF.
1092 default_filter_kill_expire
1094 Default for quick (1 key) kill filter expire. ON = limit
1095 to 'default_filter_days', OFF = don't ever expire.
1096 Default is OFF.
1097 default_filter_kill_global
1099 Default for quick (1 key) kill filter global. ON=apply to
1100 all groups, OFF=apply to current group. Default is ON.
1101 default_filter_kill_header
1103 Default for quick (1 key) kill filter header.
1104 0,1
1106 ''Subject:''
1107 2,3
1109 ''From:''
1110 4
1112 ''Message-ID:'' & full ''References:'' line
1113 5
1115 ''Message-ID:'' & last ''References:'' entry only
1116 6
1118 ''Message-ID:'' entry only
1119 7
1121 ''Lines:''
1122 default_filter_select_case
1124 Default for quick (1 key) auto-selection filter case.
1125 ON=filter case sensitive, OFF=ignore case. Default is
1126 OFF.
1127 default_filter_select_expire
1129 Default for quick (1 key) auto-selection filter expire.
1130 ON = limit to 'default_filter_days', OFF = don't ever
1131 expire. Default is OFF.
1132 default_filter_select_global
1134 Default for quick (1 key) auto-selection filter global.
1135 ON=apply to all groups, OFF=apply to current group.
1136 Default is ON.
1137 default_filter_select_header
1139 Default for quick (1 key) auto-selection filter header.
1140 0,1
1142 ''Subject:''
1143 2,3
1145 ''From:''
1146 4
1148 ''Message-ID:'' & full ''References:'' line
1149 5
1151 ''Message-ID:'' & last ''References:'' entry only
1152 6
1154 ''Message-ID:'' entry only
1155 7
1157 ''Lines:''
1158 default_goto_group
1160 default_group_search
1162 default_mail_address
1164 default_maildir
1166 The directory where articles/threads are to be saved in
1167 mbox(5) format. This feature is mainly for use with the
1168 elm(1) mail program. It allows the user to save arti‐
1169 cles/threads/groups simply by giving '=' as the filename
1170 to save to. Default is ${TIN_HOMEDIR-"$HOME"}/Mail.
1171 default_mailer_format
1173 The format string used to create the mailer command with
1174 parameters that is used for mailing articles to other
1175 people. Default is '%M "%T" < %F' (e.g., /bin/mail "iain"
1176 < .article). The flexible format allows other mailers
1177 with different command line parameters to be used such as
1178 'elm -s "%S" "%T" < "%F"' (e.g., elm -s "subject" "iain"
1179 < .article) or 'sendmail -oem -t < %F' (e.g. sendmail
1180 -oem -t < .article).
1181 default_move_group
1183 default_pattern
1185 default_pipe_command
1187 default_post_newsgroups
1189 default_post_subject
1191 default_printer
1193 The printer program with options that is to be used to
1194 print articles. The default is lpr(1) for BSD machines
1195 and lp(1) for SysV machines. Printing from tin(1) may
1196 have been disabled by the System Administrator.
1197 default_range_group
1199 default_range_select
1201 default_range_thread
1203 default_repost_group
1205 default_save_file
1207 default_save_mode
1209 default_savedir
1211 Directory where articles/threads are saved. Default is
1212 ${TIN_HOMEDIR-"$HOME"}/News.
1213 default_select_pattern
1215 default_shell_command
1217 default_sigfile
1219 The path that specifies the signature file to use when
1220 posting, following up to or replying to an article. If
1221 the path is a directory then the signature will be ran‐
1222 domly generated from files that are in the specified
1223 directory. If the path starts with a ! the program the
1224 path points to will be executed to generate a signature.
1225 tin(1) will pass the name of the current newsgroup as
1226 argument to the program. --none will suppress any signa‐
1227 ture. Default is ${TIN_HOMEDIR-"$HOME"}/.Sig.
1228 default_subject_search
1230 draw_arrow
1232 Allows groups/articles to be selected by an arrow '->' if
1233 set ON or by an highlighted bar if set OFF.
1234 force_screen_redraw
1236 Specifies whether a screen redraw should always be done
1237 after certain external commands. Default is OFF.
1238 getart_limit
1240 If getart_limit is > 0 not more than getart_limit arti‐
1241 cles/group are fetched from the server. If getart_limit
1242 is < 0 tin(1) will start fetching articles from your
1243 first unread minus absolute value of getart_limit.
1244 Default is 0, which means no limit.
1245 group_catchup_on_exit
1247 If ON catchup group when leaving with the left arrow key.
1248 Default is ON.
1249 groupname_max_length
1251 Maximum length of the names of newsgroups to be displayed
1252 so that more of the newsgroup description can be dis‐
1253 played. Default is 32.
1254 hide_uue
1256 If set to 'No' then raw uuencoded data is displayed. If
1257 set to 'Yes' then sections of uuencoded data will be
1258 shown with a single tag line showing the size and file‐
1259 name (much the same as a MIME attachment). If set to
1260 'Hide all' then any line that looks like uuencoded data
1261 will be folded into a tag line. This is useful when uuen‐
1262 coded data is split across more than one article but can
1263 also lead to false positives. This setting can also be
1264 toggled in the article viewer. Default is 'No'.
1265 inews_prog
1267 Path, name and options of external inews(1). If you are
1268 reading via NNTP the default value is "--internal" (use
1269 built-in NNTP inews), else it is "inews -h". The article
1270 is passed to inews_prog on STDIN via '< article'.
1271 info_in_last_line
1273 If ON, show current group description or article subject
1274 in the last line (not in the pager and global menu) -
1275 ToggleInfoLastLine ('i' toggles setting). This facility
1276 is useful as the full width of the screen is available to
1277 display long subjects. Default is OFF.
1278 interactive_mailer
1280 If greater than 0 your mailreader will be invoked earlier
1281 for reply so you can use more of its features (e.g. MIME,
1282 pgp, ...). 1 means include headers, 2 means don't include
1283 headers (old use_mailreader_i=ON option). 0 turns off
1284 usage. This option has to suit default_mailer_format.
1285 Default is 0.
1286 inverse_okay
1288 If ON use inverse video for page headers and URL high‐
1289 lighting. Default is ON.
1290 keep_dead_articles
1292 If ON keep all failed postings in ${TIN_HOME‐
1293 DIR-"$HOME"}/dead.articles besides keeping the last
1294 failed posting in ${TIN_HOMEDIR-"$HOME"}/dead.article.
1295 Default is ON.
1296 kill_level
1298 This option controls the processing and display of arti‐
1299 cles that are killed. There are 3 options:
1300 0 Kill only unread arts is the 'traditional' behavior of
1302 tin(1). Only unread articles are killed once only by
1303 marking them read. As filtering only happens on unread
1304 articles with kill_level set to 0, art_marked_killed and
1305 art_marked_read_selected are only shown once. When you
1306 reenter the group the mark will be gone.
1307 1 Kill all arts & show with K will process all articles in
1309 the group and therefore there is a processing overhead
1310 when using this option. Killed articles are threaded as
1311 normal but they will be marked with art_marked_killed.
1312 2 Kill all arts and never show will process all articles
1314 in the group and therefore there is a processing over‐
1315 head when using this option. Killed articles simply does
1316 not get displayed at all.
1317 Default is 0 (Kill only unread arts).
1318 mail_8bit_header
1320 Allows 8bit characters unencoded in the header of mail
1321 message. Default is OFF. Turning it ON is effective only
1322 if mail_mime_encoding is also set to 8bit. Leaving it OFF
1323 is safe for most users and compliant to Internet Mail
1324 Standard (RFC2822 and RFC2047). Default is OFF.
1325 mail_address
1327 User's mail address (and full name), if not user‐
1328 name@host. This is used when creating articles, sending
1329 mail and when pgp(1) signing.
1330 mail_mime_encoding
1332 MIME encoding of the body in mail message, if necessary
1333 (8bit, base64, quoted-printable, 7bit). Default is 8bit
1334 and no encoding (or charset conversion) is performed
1335 (i.e., local charset is used as it is).
1336 mail_quote_format
1338 Format of quote line when replying (via mail) to an arti‐
1339 cle (%A=Address, %D=Date, %F=Fullname+Address, %G=Group‐
1340 name, %M=Message-ID, %N=Fullname, %C=Firstname, %I=Ini‐
1341 tials). Default is "In article %M you wrote:"
1342 mailbox_format
1344 Select one of the following mailbox-formats: MBOXO
1345 (default, except on SCO), MBOXRD or MMDF (default on
1346 SCO). See mbox(5) for more details on MBOXO and MBOXRD
1347 and mmdf(5) for more details about MMDF.
1348 mark_saved_read
1350 If ON mark articles that are saved as read. Default is
1351 ON.
1352 mark_ignore_tags
1354 When this is ON, the GroupMarkThdRead, ThreadMarkArtRead
1355 functions ('K') mark just the current article or thread,
1356 ignoring other tagged, unread articles. When OFF, the
1357 same function presents a menu with choices of the current
1358 thread or article, all tagged, unread articles, or noth‐
1359 ing.
1360 metamail_prog
1362 Path, name and options of external metamail(1) program
1363 used to view non-textual parts of articles. To use the
1364 built-in viewer, set to --internal. This is the default
1365 value when metamail(1) is not installed. Leave it blank
1366 if you don't want any automatic viewing of non-textual
1367 attachments. The 'V' command can always be used to manu‐
1368 ally view any attachments. See also ask_for_metamail.
1369 mm_charset
1371 Charset supported locally, which is also used for MIME
1372 header (charset parameter and charset name in header
1373 encoding) in mail and news postings. If
1374 MIME_STRICT_CHARSET is defined at the compile time, text
1375 in charset other than the value of this parameter is con‐
1376 sidered not displayable and represented as '?'. Other‐
1377 wise, all character sets are regarded as compatible with
1378 the display. If it's not set, the value of the environ‐
1379 ment variable $MM_CHARSET is used. US-ASCII or compile-
1380 time default is used in case neither of them is defined.
1381 If your system supports iconv(3), this option is disabled
1382 and you should use mm_network_charset instead.
1383 mm_network_charset
1385 Charset used for posting and MIME headers; replaces
1386 mm_charset. Conversion between mm_network_charset and
1387 local charset (determined via nl_langinfo(3)) is done via
1388 iconv(3), if this function is not available on your sys‐
1389 tem this option is disabled and you have to use
1390 mm_charset instead. mm_network_charset is limited to one
1391 of the following charsets:
1392 US-ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16},
1393 KOI8-{R,U,RU} EUC-{CN,JP,KR,TW}, ISO-2022-{CN,CN-
1394 EXT,JP,JP-1,JP-2}, Big5, UTF-8
1395 Not all values might work on your system, see
1396 iconv_open(3) for more details. If it's not set, the
1397 value of the environment variable $MM_CHARSET is used.
1398 US-ASCII or compile-time default is used in case neither
1399 of them is defined.
1400 mono_markdash
1402 Character attribute of words emphasized like _this_. It
1403 is depending on your terminal which attributes are
1404 usable. See also word_h_display_marks and word_highlight.
1405 mono_markslash
1407 Character attribute of words emphasized like /this/. It
1408 is depending on your terminal which attributes are
1409 usable. See also word_h_display_marks and word_highlight.
1410 mono_markstar
1412 Character attribute of words emphasized like *this*. It
1413 is depending on your terminal which attributes are
1414 usable. See also word_h_display_marks and word_highlight.
1415 mono_markstroke
1417 Character attribute of words emphasized like -this-. It
1418 is depending on your terminal which attributes are
1419 usable. See also word_h_display_marks and word_highlight.
1420 newnews
1422 These are internal timers used by tin(1) to keep track of
1423 new newsgroups. Do not change them unless you understand
1424 what they are for.
1425 news_headers_to_display
1427 Which news headers you wish to see. If you want to see
1428 _all_ the headers, place an '*' as this value. This is
1429 the only way a wildcard can be used. If you enter 'X-'
1430 as the value, you will see all headers beginning with
1431 'X-' (like X-Alan or X-Pape). You can list more than one
1432 by delimiting with spaces. Not defining anything turns
1433 off this option.
1434 news_headers_to_not_display
1436 Same as news_headers_to_display except it denotes the
1437 opposite. An example of using both options might be if
1438 you thought X- headers were A Good Thing(tm), but thought
1439 Alan and Pape were miscreants... well then you would do
1440 something like this: news_headers_to_display=X-
1441 news_headers_to_not_display=X-Alan X-Pape Not defining
1442 anything turns off this option.
1443 news_quote_format
1445 Format of quote line when posting/following up an article
1446 (%A=Address, %D=Date, %F=Fullname+Address, %G=Groupname,
1447 %M=Message-ID, %N=Fullname, %C=Firstname, %I=Initials).
1448 Default is "%F wrote:".
1449 normalization_form
1451 The normalization form which should be used to normalize
1452 unicode input. The possible values are:
1453 0 None: no normalization
1455 1 NFKC: Compatibility Decomposition, followed by Canonical
1457 Composition
1458 2 NFKD: Compatibility Decomposition
1460 3 NFC: Canonical Decomposition, followed by Canonical Com‐
1462 position
1463 4 NFD: Canonical Decomposition
1465 Some normalization modes are only available if they are sup‐
1466 ported by the library tin(1) uses to do the normalization.
1467 Default is NFKC.
1468 pgdn_goto_next
1470 If ON the PageDown keys will go to the next unread arti‐
1471 cle when pressed at the end of a message. Default is ON.
1472 pos_first_unread
1474 If ON put cursor at first unread article in group other‐
1475 wise at last article. Default is ON.
1476 post_8bit_header
1478 Allows 8bit characters unencoded in the header of a news
1479 article, if set this also disables the generation of
1480 MIME-headers when they are usualy required. Default is
1481 OFF. Only enacted if post_mime_encoding is also set to
1482 8bit. In a number of local hierarchies where 8bit charac‐
1483 ters are used, using unencoded (raw) 8bit characters in
1484 header is acceptable and sometimes even recommended so
1485 that you need to check the convention adopted in the
1486 local hierarchy of your interest to determine what to do
1487 with this and post_mime_encoding.
1488 post_mime_encoding
1490 MIME encoding of the body in news message, if necessary.
1491 (8bit, base64, quoted-printable, 7bit) Default is 8bit,
1492 which leads to no encoding. base64 and quoted-printable
1493 are usually undesired on usenet.
1494 post_process_view
1496 If ON, then tin(1) will start an appropriate viewer pro‐
1497 gram to display any files that were post processed and
1498 uudecoded. The program is determined using the mailcap
1499 file. Default is ON.
1500 post_process_type
1502 This specifies whether to perform post processing on
1503 saved articles. Because the shell archive may contain
1504 commands you may not want to be executed, be careful when
1505 extracting shell archives. The following values are
1506 allowed:
1507 0 No (default), no post processing is done.
1509 1 Shell archives, unpacking of multi-part shar(1) files
1511 only. Because the shell archive may contain commands
1512 you may not want to be executed, be careful with this
1513 option.
1514 2 Yes, binary attachments and data will be decoded and
1516 saved.
1517 posted_articles_file
1519 Keep posted articles in ${TIN_HOME‐
1520 DIR-"$HOME"}/Mail/posted_articles_file. If no filename
1521 is set then postings will not be saved. Default is
1522 'posted'.
1523 print_header
1525 If ON, then the full article header is sent to the
1526 printer. Otherwise only the ''Subject:'' and ''From:''
1527 fields are output. Default is OFF.
1528 process_only_unread
1530 If ON only save/print/pipe/mail unread articles (tagged
1531 articles excepted). Default is OFF.
1532 prompt_followupto
1534 If ON show empty ''Followup-To:'' header when editing an
1535 article. Default is OFF.
1536 quote_chars
1538 The character used in quoting included text to article
1539 followups and mail replies. The '_' character represents
1540 a blank character and is replaced with ' ' when read.
1541 Default is '>_'.
1542 quote_style
1544 This bit coded integer value controls how articles are to
1545 be quoted when following up or replying to them. Any of
1546 the following options can be combined by adding all rele‐
1547 vant values. Default is 5, which means that quote charac‐
1548 ters are compressed and empty lines are quoted.
1549 1 Compress quotes Compress quote characters together when
1551 quoting multiple times (for example, '> > >' will be
1552 turned into '>>>'). This option is on by default.
1553 2 Quote Signatures This option is off by default. Signa‐
1555 tures are always quoted regardless of this option when
1556 you are viewing an article in raw mode PageToggleHeaders
1557 ('^H') and followup or reply to it.
1558 4 Quote empty lines This option is on by default.
1560 quote_regex
1562 A regular expression that will be applied when reading
1563 articles. All matching lines are shown in col_quote. If
1564 quote_regex is blank, then tin(1) uses a built-in
1565 default.
1566 quote_regex2
1568 A regular expression that will be applied when reading
1569 articles. All matching lines are shown in col_quote2. If
1570 quote_regex2 is blank, then tin(1) uses a built-in
1571 default.
1572 quote_regex3
1574 A regular expression that will be applied when reading
1575 articles. All matching lines are shown in col_quote3. If
1576 quote_regex3 is blank, then tin(1) uses a built-in
1577 default.
1578 recent_time
1580 If set to 0, this feature is deactivated, otherwise it
1581 means the number of days. Default is 2.
1582 render_bidi
1584 If ON tin does the rendering of bi-directional text. If
1585 OFF tin leaves the rendering of bi-directional text to
1586 the terminal. Default is OFF.
1587 reread_active_file_secs
1589 The news ${TIN_LIBDIR-NEWSLIBDIR}"/"${TIN_ACTIVE‐
1590 FILE-active} file is reread at regular intervals to show
1591 if any new news has arrived. Default is 1200. Setting
1592 this to 0 will disable this feature.
1593 score_limit_kill
1595 If the score of an article is below or equal this value
1596 the article gets marked as killed.
1597 score_limit_select
1599 If the score of an article is above or equal this value
1600 the article gets marked as hot.
1601 score_kill
1603 Score of an article which should be killed, this must be
1604 <= score_limit_kill.
1605 score_select
1607 Score of an article which should be marked hot, this must
1608 be >= score_limit_select.
1609 scroll_lines
1611 The number of lines that will be scrolled up/down in the
1612 article pager when using cursor-up/down. The default is 1
1613 (line-by-line). Set to 0 to get traditional page-by-page
1614 scrolling. Set to -1 to get page-by-page scrolling where
1615 the top/bottom line is carried over onto the next page.
1616 This setting supersedes show_last_line_prev_page=ON. Set
1617 to -2 to get half-page scrolling. This setting supersedes
1618 full_page_scroll=OFF.
1619 show_author
1621 Which information about the author should be shown.
1622 Default is 2, authors full name.
1623 0 None, only the ''Subject:'' line will be displayed.
1625 1 Address, ''Subject:'' line & the address part of the
1627 ''From:'' line are displayed.
1628 2 Full Name, ''Subject:'' line & the authors full name
1630 part of the ''From:'' line are displayed (default).
1631 3 Address and Name, ''Subject:'' line & all of the
1633 ''From:'' line are displayed.
1634 show_description
1636 If ON show a short group description text after newsgroup
1637 name at the group selection level. The ''-d'' command-
1638 line flag will override the setting and turn descriptions
1639 off. The text used is taken from the ${TIN_LIB‐
1640 DIR-NEWSLIBDIR}/newsgroups file and if supported
1641 (requires tin(1) to be build with mh-mail-handling sup‐
1642 port) from ${TIN_HOMEDIR-"$HOME"}/.tin/mailgroups for
1643 mailgroups. Default is ON.
1644 show_info
1646 Which information about the thread or article should be
1647 shown. Default is 1, show only the line count.
1648 0 None, no information will be displayed.
1650 1 Lines, in article listing the line count of an article
1652 will be displayed and in thread listing the line count
1653 of first (unread) article will be displayed.
1654 2 Score, in article listing the score of an article will
1656 be displayed and in thread listing the score of the
1657 thread will be displayed - see also thread_score.
1658 3 Lines & Score, display line count and score.
1660 show_only_unread_arts
1662 If ON show only new/unread articles otherwise show all
1663 articles. Default is ON.
1664 show_only_unread_groups
1666 If ON show only subscribed groups that contain unread
1667 articles. Default is OFF.
1668 show_signatures
1670 If OFF don't show signatures when displaying articles.
1671 Default is ON.
1672 sigdashes
1674 If ON prepend the signature with sigdashes. Default is
1675 ON.
1676 signature_repost
1678 If ON add signature to reposted articles. Default is ON.
1679 slashes_regex
1681 A regular expression that will be applied when reading
1682 articles. All matching words are shown in col_markslash
1683 or mono_markslash. If slashes_regex is blank, then tin(1)
1684 uses a built-in default.
1685 sort_article_type
1687 This specifies how articles should be sorted.Sort by
1688 ascending Date (6) is the default. The following sort
1689 types are allowed:
1690 0 Nothing, don't sort articles.
1692 1 Subject: (descending), sort articles by ''Subject:''
1694 field descending.
1695 2 Subject: (ascending), sort articles by ''Subject:''
1697 field ascending.
1698 3 From: (descending), sort articles by ''From:'' field
1700 descending.
1701 4 From: (ascending), sort articles by ''From:'' field
1703 ascending.
1704 5 Date: (descending), sort articles by ''Date:'' field
1706 descending.
1707 6 Date: (ascending), sort articles by ''Date:'' field
1709 ascending (default).
1710 7 Score (descending), sort articles by filtering score
1712 descending.
1713 8 Score (ascending), sort articles by filtering score
1715 ascending.
1716 9 Lines: (descending), sort articles by ''Lines:'' field
1718 descending.
1719 10 Lines: (ascending), sort articles by ''Lines:'' field
1721 ascending.
1722 sort_threads_type
1724 This specifies how threads will be sorted. Sort by
1725 descending Score (1) is the default. The following sort
1726 types are allowed:
1727 0 Nothing, don't sort threads.
1729 1 Score (descending), sort threads by filtering score
1731 descending (default).
1732 2 Score (ascending), sort threads by filtering score
1734 ascending.
1735 space_goto_next_unread
1737 SPACE normally acts as a PageDown key and has no effect
1738 at the end of an article. If this option is turned ON the
1739 SPACE command will go to the next unread article when the
1740 end of the article is reached (rn (1)-style pager).
1741 spamtrap_warning_addresses
1743 Set this option to a list of comma-separated strings to
1744 be warned if you are replying to an article by mail where
1745 the e-mail address contains one of these strings. The
1746 matching is case-insensitive.
1747 stars_regex
1749 A regular expression that will be applied when reading
1750 articles. All matching words are shown in col_markstar or
1751 mono_markstar. If stars_regex is blank, then tin(1) uses
1752 a built-in default.
1753 start_editor_offset
1755 Set ON if the editor used for posting, follow-ups and bug
1756 reports has the capability of starting and positioning
1757 the cursor at a specified line within a file. Default is
1758 ON.
1759 strip_blanks
1761 Strips the blanks from the end of each line therefore
1762 speeding up the display when reading on a slow terminal
1763 or via modem. Default is ON.
1764 strip_bogus
1766 Bogus groups are groups that are present in your
1767 ${TIN_HOMEDIR-"$HOME"}/.newsrc file that no longer exist
1768 on the news server. There are 3 options. 0 means do noth‐
1769 ing & always keep bogus groups. 1 means bogus groups
1770 will be permanently removed. 2 means that bogus groups
1771 will appear on the Group Selection Menu, prefixed with a
1772 'D'. This allows you to unsubscribe from them as and when
1773 you wish. Default is 0 (Always Keep).
1774 strip_newsrc
1776 If ON, then unsubscribed groups will be permanently
1777 removed from your ${TIN_HOMEDIR-"$HOME"}/.newsrc file.
1778 Default is OFF.
1779 strokes_regex
1781 A regular expression that will be applied when reading
1782 articles. All matching words are shown in col_markstroke
1783 or mono_markstroke. If strokes_regex is blank, then
1784 tin(1) uses a built-in default.
1785 tab_goto_next_unread
1787 If enabled pressing PageNextUnread ('<TAB>') at the arti‐
1788 cle viewer level will go to the next unread article imme‐
1789 diately instead of first paging through the current one.
1790 Default is ON.
1791 tex2iso_conv
1793 Decode German style TeX umlaut codes to ISO If ON, show
1794 "a as Umlaut-a, etc. Default is OFF. This behavior can
1795 also be toggled in the article viewer via PageToggle‐
1796 Tex2iso ('"').
1797 thread_articles
1799 Defines which threading method to use. The choices are:
1800 0) Don't thread, 1) Thread on Subject only 2) Thread on
1801 References only, 3) Thread on References then Subject
1802 (default) 4) Thread multipart articles on Subject. 5)
1803 Thread on Percentage Match of the Subjects It's also pos‐
1804 sible to set the threading type on a per group basis by
1805 setting the group attribute variable thread_arts to 0 - 5
1806 in the file ${TIN_HOMEDIR-"$HOME"}/.tin/attributes.
1807 thread_perc
1809 Defines how close the subjects must match while threading
1810 by Percentage Match for threads to be considered part of
1811 a single thread. This value is in the range 0 to 100. The
1812 default is 75.
1813 thread_catchup_on_exit
1815 If ON catchup group/thread when leaving with the left
1816 arrow key. Default is ON.
1817 thread_score
1819 How the total score of a thread is computed. Default is
1820 0, the maximum score in this thread.
1821 0 Max, the maximum score in this thread.
1823 1 Sum, the sum of all scores in this thread.
1825 2 Average, the average score in this thread.
1827 translit
1829 If ON append //TRANSLIT to the first argument of
1830 iconv_open(3) to enable transliteration. This means that
1831 when a character cannot be represented in the target
1832 character set, it can be approximated through one or sev‐
1833 eral similarly looking characters. On systems where this
1834 extension doesn't exist, this option is disabled. Default
1835 is OFF.
1836 underscores_regex
1838 A regular expression that will be applied when reading
1839 articles. All matching words are shown in col_markdash or
1840 mono_markdash. If undescores_regex is blank, then tin(1)
1841 uses a built-in default.
1842 unlink_article
1844 If ON remove ${TIN_HOMEDIR-"$HOME"}/.article after post‐
1845 ing. Default is ON.
1846 url_handler
1848 The program that will be run when launching URLs in the
1849 article viewer using PageViewUrl ('U'). The actual URL
1850 will be appended to this. Default is url_handler.sh %s.
1851 url_highlight
1853 Enable highlighting URLs in message body. Default is ON.
1854 use_color
1856 If enabled tin(1) uses ANSI-colors. Default is OFF.
1857 use_keypad
1859 Use scroll keys on keypad. Default is OFF.
1860 use_mouse
1862 Allows the mouse key support in a xterm(1x) to be
1863 enabled/disabled. Default is OFF.
1864 use_slrnface
1866 If enabled slrnface(1) will be used to interpret the
1867 ''X-Face:'' header. For this option to have any effect,
1868 tin(1) must be running in an xterm(1x) and slrnface(1)
1869 must be in your $PATH. Default is OFF.
1870 wildcard
1872 Allows you to select how tin(1) matches strings. The
1873 default is 0 and uses the wildmat notation, which is how
1874 this has traditionally been handled. Setting this to 1
1875 allows you to use perl(1) compatible regular expressions
1876 pcre(3). You will probably want to update your filter
1877 file if you use this regularly. NB: Newsgroup names will
1878 always be matched using the wildmat notation.
1879 word_h_display_marks
1881 Should the leading and ending stars, slashes, strokes and
1882 dashes also be displayed, even when they are highlighting
1883 marks?
1884 0 no
1886 1 yes, display mark
1888 2 print a space instead
1890 word_highlight
1892 Enable word highlighting. See word_h_display_marks for
1893 the options available. If use_color is enabled the colors
1894 specified in col_markdash, col_markslash, col_markstar
1895 and col_markstroke are used for word highlighting else
1896 the character attributes specified in mono_markdash,
1897 mono_markslash, mono_markstar and mono_markstroke are
1898 used.
1899 wrap_column
1901 Sets the column at which a displayed article body should
1902 be wrapped. If this value is equal to 0, it defaults to
1903 the current screen width. If this value is greater than
1904 your current screen width the part off-screen is not dis‐
1905 played. Thus setting this option to a large value can be
1906 used to disable wrapping. If this value is negative the
1907 wrap margin is the current screen width plus the given
1908 value (as long as the result is still positive, otherwise
1909 it will fall back to the current screen width). Default
1910 is 0, wrapping at the current screen width.
1911 wrap_on_next_unread
1913 If enabled a search for the next unread article will wrap
1914 around all articles to find also previous unread arti‐
1915 cles. If disabled the search stops at the end of the
1916 thread list. Default is ON.
1917 xpost_quote_format
1919 Format is the same as for news_quote_format, this is used
1920 when answering to a crossposting to several groups with
1921 no ''Followup-To:'' set.
1922 /etc/tin/tin.defaults
1924 Yet another global configuration file with "variable=value"
1926 pairs. This one is for the more general options which usually
1927 can't be controlled via ${TIN_LIBDIR-NEWSLIBDIR}/tinrc and/or
1928 ${TIN_HOMEDIR-"$HOME"}/.tin/tinrc like resetting (to override
1929 the built-in default) the newslibdir.
1930 domainname
1932 Sets a global domain name used in From lines
1933 organization
1935 Defines the name of your organization. $ORGANIZATION
1936 overrides any specified value.
1937 newslibdir
1939 Defines the default place for some configuration files,
1940 common values are /usr/lib/news, /var/lib/news,
1941 /usr/local/lib/news or /news/db. $TIN_LIBDIR overrides
1942 any specified value.
1943 bugaddress
1945 Defines the email address to which users can send bug
1946 reports using a built-in function. The default points to
1947 a developers mailing list located at tin.org. You might
1948 want to change this address to one of your local adminis‐
1949 tration if you want to deal with your lusers problems on
1950 your own.
1951 inewsdir
1953 Defines the directory containing of the inews(1) exe‐
1954 cutable
1955 mm_charset
1957 Default charset to be used in MIME's Content-Type header.
1958 $MM_CHARSET overrides any specified value.
1959 post_mime_encoding
1961 Default encoding scheme use in MIME articles. 8bit might
1962 be the best value.
1963 mail_mime_encoding
1965 Default encoding scheme use in MIME letters. quoted-
1966 printable is a good choice here.
1967 disable_gnksa_domain_check
1969 Allow unregistered top level domains
1970 disable_sender
1972 Don't generate a ''Sender:''-header. This has no effect
1973 if inews_prog is not set to --internal.
1974 spooldir
1976 Base of your newsspool (Bnews, Cnews and INN traditional
1977 spool style), common values are /var/spool/news,
1978 /usr/spool/news, /news/spool. $TIN_SPOOLDIR overrides
1979 any specified value.
1980 overviewdir
1982 Base of your NOV database newsoverview(5) (tradspool
1983 style; might be the same dir as spooldir), common values
1984 are /var/spool/overview, /usr/spool/overview, /news/over‐
1985 view. $TIN_NOVROOTDIR overrides any specified value.
1986 overviewfile
1988 Name of a single overview file, common values are .over‐
1989 view, over.view.
1990 activefile
1992 Full pathname of your newssystem's active file; usually
1993 the active file resides in newslibdir and is named
1994 active, so you only have to change this setting if your
1995 configuration differs. $TIN_ACTIVEFILE overrides any
1996 specified value.
1997 activetimesfile
1999 Full pathname of your newssystem's active.times file;
2000 usually the active.times file is newslibdir, so you only
2001 have to change this setting if your configuration dif‐
2002 fers.
2003 newsgroupsfile
2005 Full pathname of your newssystem's newsgroups file; usu‐
2006 ally the newsgroups file is in newslibdir, so you only
2007 have to change this setting if your configuration dif‐
2008 fers.
2009 subscriptionsfile
2011 Full pathname of your newssystem's subscriptions file;
2012 usually the subscriptions file is in newslibdir, so you
2013 only have to change this setting if your configuration
2014 differs.
2015 /usr/local/share/locale/${LC_MESSAGES}/LC_MESSAGES/tin.mo
2017 translation into language specified in $LC_ALL, $LC_MESSAGES or
2019 $LANG
2020 ${TIN_LIBDIR-NEWSLIBDIR}"/"${TIN_ACTIVEFILE-active}
2022 This file lists the newsgroups that the local site receives.
2024 Each newsgroup should be listed only once. Each line specifies
2025 one group; within each newsgroup, articles are assigned unique
2026 names, which are monotonically increasing numbers.
2027 If an article is posted to newsgroups not mentioned in this
2029 file, those newsgroups are ignored. If no valid newsgroups are
2030 specified, the article is rejected.
2031 Each line consists of four space-separated fields "name highmark
2033 lowmark flags".
2034 name is the name of the newsgroup
2036 highmark
2038 is the highest article number that has been used in that
2039 newsgroup
2040 lowmark
2042 is the lowest article number in the group; this number is
2043 not guaranteed to be accurate, and should only be taken
2044 to be a hint. Note that because of article cancellations,
2045 there may be gaps in the numbering sequence. If the low‐
2046 est article number is greater then the highest article
2047 number, then there are no articles in the newsgroup.
2048 flags can be one of those
2050 y local postings are allowed
2052 n no local postings are allowed, only remote ones
2054 m the group is moderated and all postings must be
2056 approved
2057 j articles in this group are not kept, but only
2059 passed on
2060 x articles cannot be posted to this newsgroup
2062 =foo.bar
2064 articles are locally filed into the ''foo.bar''
2065 group
2066 tin(1) only tries to read the file if you read directly from the
2068 local spool, if you read news via NNTP, tin(1) uses the
2069 LIST (RFC977) command instead.
2070 ${TIN_LIBDIR-NEWSLIBDIR}/active.times
2072 This file provides a chronological record of when newsgroups are
2074 created. It is normally updated by the local newsserver (e.g.
2075 innd(8)) whenever a new group is created. Each line consist of
2076 three space-separated fields "name time creator".
2077 name is the name of the newsgroup
2079 time is the time when the group was created, expressed as the
2081 number of seconds since the epoch.
2082 creator
2084 is the electronic mail address of the person who created
2085 the group.
2086 tin(1) only tries to read the file if you read directly from the
2088 local spool, if you read news via NNTP, tin(1) uses the
2089 NEWGROUPS (RFC977) command instead.
2090 ${TIN_LIBDIR-NEWSLIBDIR}/newsgroups
2092 This file provides short descriptions of each newsgroup. It is
2094 normally updated by the local newsserver (e.g. innd(8)) when‐
2095 ever a new group is created. Each line consist of two tab-sepa‐
2096 rated fields "group.name one-line description".
2097 group.name
2099 is the name of the newsgroup
2100 one-line description
2102 is a short single-line description of the group
2103 tin(1) only tries to read the file if you read directly from the
2105 local spool, if you read news via NNTP, tin(1) uses the
2106 LIST NEWSGROUPS (RFC2980) command instead.
2107 ${TIN_LIBDIR-NEWSLIBDIR}/organization
2109 This file specifies might hold a default organization to be used
2111 in the ''Organization:'' header. $ORGANIZATION has a higher pri‐
2112 ority if set.
2113 ${TIN_LIBDIR-NEWSLIBDIR}/overview.fmt
2115 This file specifies the organization of the news overview data‐
2117 base (see also newsoverview(5)). The order of lines in this
2118 file is important; it determines the order in which the fields
2119 will appear in the database. tin(1) currently only understands
2120 the order specified in RFC2980. See also overview.fmt(5).
2121 tin(1) only tries to read the file if you read directly from the
2122 local spool, if you read news via NNTP, tin(1) uses the LIST
2123 OVERVIEW.FMT (RFC2980) command instead.
2124 ${TIN_LIBDIR-NEWSLIBDIR}/subscriptions
2126 This file contains a list of newsgroups - one per line - which
2128 the client should subscribe to when the user has no ${TIN_HOME‐
2129 DIR-"$HOME"}/.newsrc for the newsserver. tin(1) only tries to
2130 read the file if you read directly from the local spool, if you
2131 read news via NNTP, tin(1) uses the LIST SUBSCRIPTIONS (RFC2980)
2132 command instead.
2133
2135 elm(1), inews(1), ispell(1), lp(1), lpr(1), metamail(1) perl(1),
2136 pgp(1), rn(1), shar(1), slrnface(1), tin(1), xterm(1x), iconv(3),
2137 iconv_open(3), nl_langinfo(3), pcre(3), strftime(3), system(3), mail‐
2138 cap(4), active(5), mbox(5), mmdf(5), newsoverview(5), overview.fmt(5),
2139 innd(8), RFC977, RFC1036, RFC1524, RFC2045, RFC2046, RFC2047, RFC2048,
2140 RFC2822, RFC2980
21411.8.3 February 1st, 2007 tin(5)