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 if test -x /usr/bin/less \;\
173 then less '%s' \;\
174 else more '%s' \; fi;\
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 canlocks
190 ${TIN_HOMEDIR-"$HOME"}/.mime.types
192 /etc/mime.types
193 /etc/tin/mime.types
194 mime type / filename extension pairs
196 ${TIN_HOMEDIR-"$HOME"}/.newsauth
198 "nntpserver password [user]" pairs for NNTP servers that require
200 authorization. Any line that starts with "#" is a comment.
201 Blank lines are ignored. This file should be readable only for
202 the user as it contains the users uncrypted password for reading
203 news!
204 nntpserver
206 full qualified domain name of the newsserver.
207 password
209 users uncrypted password for reading news.
210 user username on the newsserver if it differs from the local
212 login. this field is optional.
213 Example:
215 # sample .newsauth file
216 news.example.org example
217 news.example.net news guest
218 ${TIN_HOMEDIR-"$HOME"}/.newsrc
220 "newsgroupflag [article[,article | -article]...]" lines.
222 newsgroup
224 the name of the newsgroup.
225 flag a flag indicating if the group is subscribed ':' or not
227 '!'.
228 article
230 range of already read articles from that group; numbers
231 separated by commas with sequential numbers collapsed
232 with hyphens.
233 Example:
235 # sample .newsrc file
236 news.software.b! 1-666,669
237 news.software.nntp: 1-13245,13247,13249
238 news.software.readers: 1-19567,19571-19597
239 ${TIN_HOMEDIR-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT+":$NNTPPORT"}/.old‐
241 newsrc
242 backup of ${TIN_HOMEDIR-"$HOME"}/.newsrc
244 ${TIN_HOMEDIR-"$HOME"}/.signature
246 ${TIN_HOMEDIR-"$HOME"}/.Sig
247 signature
249 ${TIN_HOMEDIR-"$HOME"}/.sigfixed
251 fixed part of a randomly generated signature
253 ${TIN_HOMEDIR-"$HOME"}/.tin/.inputhistory
255 history of last used strings
257 ${TIN_INDEX_MAILDIR-"${TIN_HOMEDIR-"$HOME"}/.tin"}/.mail/
259 mailgroups index files
261 ${TIN_INDEX_NEWSDIR-"${TIN_HOME‐
263 DIR-"$HOME"}/.tin"}/.news${NNTPSERVER+"-$NNTPSERVER"}/
264 newsgroups index files
266 ${TIN_INDEX_SAVEDIR-"${TIN_HOMEDIR-"$HOME"}/.tin"}/.save/
268 saved newsgroups index files
270 ${TIN_HOMEDIR-"$HOME"}/.tin/active.mail
272 active file ("mail_group_name maxnum minnum mailspool"-pairs) of
274 user's mailgroups (requires tin(1) to be build with mh-mail-han‐
275 dling support).
276 mail_group_name
278 must be the pathname of the mailbox relative to field #4
279 with / changed to .
280 maxnum just put a large number here, something higher than the
282 highest message in the mailbox
283 minnum put 0 here
285 mailspool
287 path of mail spool directory. This must be the full path‐
288 name to the root of the mail folder area.
289 Example:
291 Mail.inbox 12345 00000 /home/foo
292 Mail.outbox 23456 00000 /home/foo
293 This allows access to the 'inbox' and 'outbox' folders of user
295 foo. They are accessed via /home/foo/Mail/inbox and
296 /home/foo/Mail/outbox
297 ${TIN_HOMEDIR-"$HOME"}/.tin/active.save
299 active file of user's saved newsgroups, used by tin -R.
301 /etc/tin/attributes
303 ${TIN_HOMEDIR-"$HOME"}/.tin/attributes
304 The group attributes files may be used to override some global
306 settings from ${TIN_HOMEDIR-"$HOME"}/.tin/tinrc on a per group
307 basis. Order is important as last match counts; this allows to
308 refine attributes for narrowed scopes. Note that the
309 scope=<grouplist> line has to be specified before the attributes
310 are specified for that list. All attributes are set to a reason‐
311 able default so you only have to specify the attribute that you
312 want to change. All toggle attributes are set by specifying
313 ON/OFF. Otherwise, they function exactly as their global equiv‐
314 alents. The following group attributes are available:
315 scope This changes the list of groups to which the attributes
317 that follow will be applied. See the section NEWSGROUP
318 LISTS & WILDCARDS in tin(1) for the types of pattern that
319 can be used here.
320 auto_save
322 Identical to the tinrc variable of the same name
323 auto_select
325 Automatically perform the GroupMarkUnselArtRead ('X')
326 command after entering the group.
327 batch_save
329 Can be used to override the global setting in tinrc on a
330 per group basis. For more information read section AUTO‐
331 MATIC MAILING AND SAVING NEW NEWS in tin(1).
332 delete_tmp_files
334 If this is set to ON, then saved article files that have
335 been post-processed will be automatically deleted, other‐
336 wise the user will be asked whether to delete the post-
337 processed files. Automatic processing of marked articles
338 using GroupAutoSave ('S') will suppress prompting.
339 fcc Mailbox to save sent mails. The format of the mailbox is
341 controlled via the tinrc mailbox_format variable.
342 followup_to
344 Set ''Followup-To:''-header to the specified group(s).
345 from Identical to the tinrc variable mail_address
347 maildir
349 Identical to the tinrc variable default_maildir
350 mailing_list
352 Used when a group is a mailing list. All responses to the
353 group will be directed to this email address instead
354 mime_forward
356 Determines whether usenet articles are forwarded as
357 attachment or inline. When set to OFF, the forwarded
358 article will be included in the body of the mail, while
359 setting this variable to ON will cause the article to be
360 attached as a separate MIME part. Enabling mime_forward
361 is particularly useful for articles consisting of multi‐
362 ple MIME parts such as PGP/MIME signed messages or being
363 encoded in a different character set than your local one.
364 It is also useful if the receiver should be able to oper‐
365 ate on the entire forwarded article (i.e., view or save
366 it without your comments). On the other hand, if you want
367 to forward only some parts of the article or to insert
368 'inline' annotations, you might want to disable this
369 option. Please note that for this option to have effect,
370 the tinrc variable interactive_mailer has to be set to 0
371 (which is the default).
372 mime_types_to_save
374 A comma separated list of MIME major/minor Content-Types
375 that will be saved when using the view/save and
376 save/autosave features. A single * can be used to wild‐
377 card the major and/or minor type and a ! as the first
378 character in an entry will negate it, eg:
379 image/*,!image/bmp,!text/html. Default is */*
380 news_quote_format
382 Identical to the tinrc variable of the same name
383 organization
385 This can be used to set the article header field ''Orga‐
386 nization:''. It overrides the setting (if any) of organi‐
387 zation in /etc/tin/tin.defaults and $ORGANIZATION (or
388 $NEWSORG on Apollo DomainOS). Note that some newsserver
389 might still overwrite the ''Organization:''-header.
390 post_proc_type
392 Identical to the tinrc variable post_process_type
393 quote_chars
395 Identical to the tinrc variable of the same name
396 savedir
398 Identical to the tinrc variable default_savedir
399 savefile
401 show_author
403 Identical to the tinrc variable of the same name
404 show_info
406 Identical to the tinrc variable of the same name
407 show_only_unread
409 Identical to the tinrc variable of the same name
410 sigfile
412 Identical to the tinrc variable default_sigfile
413 sort_art_type
415 Identical to the tinrc variable sort_article_type
416 sort_threads_type
418 Identical to the tinrc variable of the same name
419 tex2iso_conv
421 Identical to the tinrc variable of the same name
422 thread_arts
424 Identical to the tinrc variable thread_articles
425 thread_perc
427 Identical to the tinrc variable thread_perc
428 x_body A piece of text that will be added at the start of a mes‐
430 sage body. If this string starts with a / or ~ then it is
431 assumed to be the name of a file containing the text to
432 insert.
433 x_comment_to
435 Insert ''X-Comment-To:''-header, this is only useful in
436 FIDO groups.
437 x_headers
439 A string including header-name and the contents of the
440 header that will be automatically added when posting. If
441 the string starts with a / or ~ then it is assumed to be
442 the name of a file containing the header and its content
443 to be inserted. If the string starts with a ! then what
444 follows is assumed to be the path to a program to be exe‐
445 cuted to generate the header and its content.
446 quick_kill_scope
448 A comma-separated list of newsgroup patterns (wildmat-
449 style) to which groups the filter rule added by QuickFil‐
450 terKill will be applied. If unset the default from the
451 tinrc variable default_filter_kill_global will be used.
452 quick_kill_expire
454 Identical to the tinrc variable default_fil‐
455 ter_kill_expire
456 quick_kill_case
458 Identical to the tinrc variable default_filter_kill_case
459 quick_kill_header
461 Identical to the tinrc variable default_fil‐
462 ter_kill_header
463 quick_select_scope
465 A comma-separated list of newsgroup patterns (wildmat-
466 style) to which groups the filter rule added by QuickFil‐
467 terSelect will be applied. If unset the default from the
468 tinrc variable default_filter_select_global will be used.
469 quick_select_expire
471 Identical to the tinrc variable default_fil‐
472 ter_select_expire
473 quick_select_case
475 Identical to the tinrc variable default_fil‐
476 ter_select_case
477 quick_select_header
479 Identical to the tinrc variable default_fil‐
480 ter_select_header
481 ispell Path and options for ispell(1)-like spell-checker, e.g.
483 "aspell --mode=email --dont-backup check"
484 mm_network_charset
486 Identical to the tinrc variable of the same name
487 undeclared_charset
489 Assume (broken) articles without MIME charset declaration
490 have this charset - default is US-ASCII. This attribute
491 works only on systems with working iconv(3), others might
492 have to compile tin(1) with --dis‐
493 able-mime-strict-charset.
494 Example:
496 # include extra headers
497 # assume ISO-8859-1 as charset if no charset is declared
498 scope=*
499 x_headers=~/.tin/headers
500 undeclared_charset=ISO-8859-1
501 # in *sources* set post process type to shar only
503 scope=*sources*
504 post_proc_type=1
505 # in *binaries* turn on full post processing,
507 # remove tmp files and set Followup-To: poster
508 scope=*binaries*
509 post_proc_type=2
510 delete_tmp_files=ON
511 followup_to=poster
512 # in fido.* newsgroups change quote_chars
514 # and add X-Comment-To: line
515 scope=fido.*
516 quote_chars=%s>_
517 x_comment_to=ON
518 # in *.test newsgroups, don't append signature
520 # and preset Subject
521 scope=*.test
522 sigfile=--none
523 x_headers=Subject: test - ignore - no reply
524 # assume ISO-2022-JP-2 as charset
526 scope=fj.*,japan.*
527 undeclared_charset=ISO-2022-JP-2
528 ${TIN_HOMEDIR-"$HOME"}/.tin/filter
530 The filter file is used to assign scores to certain articles.
532 Based on the score an article can be filtered out (hidden) or
533 marked hot. Empty lines or lines beginning with a '#' are
534 ignored.
535 comment
537 Every entry (rule) in the filter file might get a com‐
538 ment. Multiple lines are allowed (but only for comments
539 yet). Every line must start with the "comment="-keyword.
540 Comments must appear first in the rule. Comment lines
541 placed within a rule will be moved to the begin of the
542 next rule. This might be changed in the future. Don't use
543 '#' to mark comments as those lines are ignored and your
544 comments will get lost on the next write of the file.
545 group A comma-separated list of newsgroup patterns (wildmat-
547 style) to which groups the filter rule will be applied.
548 This line is mandatory!
549 case 0=case-sensitive, 1=case-insensitive
551 score Score value of the rule; can also be one of the magic
553 words "kill" or "hot".
554 subj Match against ''Subject:''
556 from Match against ''From:''. tin(1) converts the contents of
558 the ''From:''-header to an old style e-mail address, e.g.
559 ''some@body.example (John Doe)'' instead of ''John Doe
560 <some@body.example>'', before trying to match the pat‐
561 terns in the filter rule.
562 msgid Match against ''Message-ID:'' and full ''References:''
564 msgid_last
566 Match against ''Message-ID:'' and last ''References:''
567 entry only
568 msgid_only
570 Match against ''Message-ID:''
571 refs_only
573 Match against ''References:''
574 lines Match against ''Lines:'', <num matches less than, >num
576 matches more than.
577 gnksa Match against ''From:''-address parser return codes.
579 xref Match against ''Xref:''-line. Before any matching is done
581 the line is turned into the same format ''Newsgroups:''
582 has that is it is turned into a comma separated newsgoup
583 list with all other informations (i.e. the article
584 counter) removed.
585 time time_t value when rule expires
587 Example:
589 comment=mark all articles about tin, rtin,
590 comment=tind, ktin or cdtin as hot
591 group=*
592 type=1
593 case=1
594 score=hot
595 subj=\b(cd|[rk]?)?tin(d|pre)?[-.0-9]*\b
596 /etc/tin/keymap${${LC_ALL-"${LC_CTYPE-"${LC_MES‐
598 SAGES-"$LANG"}"}"}:+".${LC_ALL-"${LC_CTYPE-"${LC_MES‐
599 SAGES-"$LANG"}"}"}"}
600 ${TIN_HOMEDIR-"$HOME"}/.tin/keymap${${LC_ALL-"${LC_CTYPE-"${LC_MES‐
601 SAGES-"$LANG"}"}"}:+".${LC_ALL-"${LC_CTYPE-"${LC_MES‐
602 SAGES-"$LANG"}"}"}"}
603 Keymap-file, containing "keyname value [value]" pairs seperated
605 by spaces or tabs. Below is a list of all rebindable keynames
606 and their defaults. If a keynames is bound to NULL it is unas‐
607 signed.
608 PageDown3 SPACE
610 ShellEscape !
611 SetRange #
612 LastPage $
613 ToggleColor &
614 LastViewed -
615 SearchRepeat \
616 SearchSubjF /
617 SearchSubjB ?
618 SearchAuthB A
619 SearchBody B
620 CatchupNextUnread C
621 EditFilter E
622 ToggleHelpDisplay H
623 ToggleInverseVideo I
624 LookupMessage L
625 OptionMenu M
626 Postponed O ^O
627 QuitTin Q
628 BugReport R
629 DisplayPostHist W
630 MarkThrUnread Z
631 FirstPage ^
632 SearchAuthF a
633 Catchup c
634 Help h
635 ToggleInfoLastLine i
636 Down j ^N
637 Up k ^P
638 Print o
639 Quit q
640 Version v
641 Post w
642 MarkArtUnread z
643 QuickFilterSelect [
644 QuickFilterKill ]
645 Pipe |
646 ScrollUp <
647 ScrollDown >
648 PageUp b ^B ^U
649 PageDown ^D ^F
650 RedrawScr ^L
651 Postponed ^O
652 MenuFilterSelect ^A
653 MenuFilterKill ^K
654 ConfigSelect ^J ^M
656 ConfigLastPage G
657 ConfigNoSave Q
658 ConfigFirstPage g
659 FeedTag T
661 FeedArt a
662 FeedHot h
663 FeedPat p
664 FeedRepost r
665 FeedSupersede s
666 FeedThd t
667 FilterEdit e
669 FilterSave s
670 GroupNextUnreadArtOrGrp TAB
672 GroupReadBasenote ^J ^M
673 GroupSelThd *
674 GroupDoAutoSel +
675 GroupToggleThdSel .
676 GroupSelThdIfUnreadSelected ;
677 GroupSelPattern =
678 GroupReverseSel @
679 GroupToggleGetartLimit G
680 GroupMarkThdRead K
681 GroupNextUnreadArt N
682 GroupPrevUnreadArt P
683 GroupAutoSave S
684 GroupTagParts T
685 GroupUntag U
686 GroupMarkUnselArtRead X
687 GroupToggleSubjDisplay d
688 GroupGoto g
689 GroupListThd l
690 GroupMail m
691 GroupNextGroup n
692 GroupPrevGroup p
693 GroupToggleReadUnread r
694 GroupSave s
695 GroupTag t
696 GroupToggleThreading u
697 GroupRepost x
698 GroupUndoSel ~
699 HelpLastPage G
701 HelpFirstPage g
702 PageReplyQuoteHeaders ^E
704 PagePGPCheckArticle ^G
705 PageToggleHeaders ^H
706 PageNextUnread TAB
707 PageNextThd ^J ^M
708 PageToggleTabs ^T
709 PageFollowupQuoteHeaders ^W
710 PageToggleTex2iso "
711 PageToggleRot %
712 PageToggleUue (
713 PageReveal )
714 PageSkipIncludedText :
715 PageTopThd <
716 PageBotThd >
717 PageCancel D
718 PageFollowup F
719 PageLastPage G
720 PageKillThd K
721 PageNextUnreadArt N
722 PagePrevUnreadArt P
723 PageReply R
724 PageAutoSave S
725 PageGroupSel T
726 PageViewUrl U
727 PageViewAttach V
728 PageToggleHighlight _
729 PageEditArticle e
730 PageFollowupQuote f
731 PageFirstPage g
732 PageListThd l
733 PageMail m
734 PageNextArt n
735 PagePrevArt p
736 PageReplyQuote r
737 PageSave s
738 PageTag t
739 PageGotoParent u
740 PageRepost x
741 PgpEncSign b
743 PgpEncrypt e
744 PgpIncludekey i
745 PgpSign s
746 PostAbort a
748 PostContinue c
749 PostCancel d
750 PostEdit e
751 PostPGP g
752 PostIspell i
753 PostIgnore i
754 PostMail m
755 PostPostpone o
756 PostPost p y
757 PostSupersede s
758 PostSend s y
759 PostponeOverride Y
761 PostponeAll A
762 PromptYes y Y
764 PromptNo n N
765 SaveAppendFile a
767 SaveOverwriteFile o
768 PProcNone n
770 PProcShar s
771 PProcYes y
772 SelectEnterNextUnreadGrp TAB n
774 SelectReadGrp ^J ^M
775 SelectResetNewsrc ^R
776 SelectSortActive .
777 SelectNextUnreadGrp N
778 SelectSubscribePat S
779 SelectUnsubscribePat U
780 SelectQuitNoWrite X
781 SelectSyncWithActive Y
782 SelectToggleDescriptions d
783 SelectGoto g
784 SelectMoveGrp m
785 SelectToggleReadDisplay r
786 SelectSubscribe s
787 SelectUnsubscribe u
788 SelectYankActive y
789 SelectMarkGrpUnread z Z
790 ThreadReadNextArtOrThread TAB
792 ThreadReadArt ^J ^M
793 ThreadSelArt *
794 ThreadToggleArtSel .
795 ThreadReverseSel @
796 ThreadMarkArtRead K
797 ThreadAutoSave S
798 ThreadUntag U
799 ThreadToggleSubjDisplay d
800 ThreadMail m
801 ThreadSave s
802 ThreadTag t
803 ThreadUndoSel ~
804 ${TIN_HOMEDIR-"$HOME"}/.tin/mailgroups
806 This file provides short descriptions of each mailgroup.
808 (requires tin(1) to be build with mh-mail-handling support).
809 Each line consist of two tab-separated fields "mailgroupname
810 one-line description".
811 mailgroupname
813 is the name of the newsgroup
814 description
816 is a short single-line description of the group
817 ${TIN_HOMEDIR-"$HOME"}/.tin/newsrctable
819 "nntpserver newsrc [shortname [...]]" pairs to use with the
821 ''-g'' command-line switch.
822 nntpserver
824 full qualified domain name of the newsserver.
825 newsrc related newsrc.
827 shortname
829 nickname(s) for the nntpserver.
830 Example:
832 # sample newsrctable file
833 news.tin.org .newsrc-tin.org tinorg
834 news.ka.nu /tmp/nrc-nu kanu nu
835 ${TIN_HOMEDIR-"$HOME"}/.tin/posted
837 posting history
839 ${TIN_HOMEDIR-"$HOME"}/Mail/posted
841 Copy of all posted articles in mbox(5) format. The filename can
843 be changed by setting posted_articles_file.
844 ${TIN_HOMEDIR-"$HOME"}/.tin/postponed.articles
846 Pool of postponed articles. This file is in mbox(5) format.
848 ${TIN_HOMEDIR-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT+":$NNTPPORT"}/news‐
850 groups
851 This file a copy of the servers newsgroups file which provides
853 short descriptions of each newsgroup. It is automatically
854 updated on startup except when using the ''-X''or ''-q'' com‐
855 mand-line option and an old copy exists. Each line consist of
856 two tab-separated fields "group.name one-line
857 description".
858 group.name
860 is the name of the newsgroup
861 one-line description
863 is a short single-line description of the group
864 ${TIN_HOMEDIR-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT+":$NNTP‐
866 PORT"}/serverrc
867 File to store $NNTPSERVER and $NNTPPORT related data via a list
869 of "variable=value" pairs. Currently there are only two vari‐
870 ables, both are not meant to be changed by the user.
871 version
873 Internal version number.
874 last_newnews
876 Internal timestamp used by tin(1) to keep track of new
877 newsgroups on the server.
878 /etc/tin/tinrc
880 ${TIN_HOMEDIR-"$HOME"}/.tin/tinrc
881 At startup, tin(1) reads in the configuration file. This con‐
883 tains a list of "variable=value" pairs that can be used to con‐
884 figure the way tin(1) works. If it exists, the global configura‐
885 tion file, ${TIN_LIBDIR}-NEWSLIBDIR}/tinrc is read first. After
886 that, the users own configuration file ${TIN_HOME‐
887 DIR-"$HOME"}/.tin/tinrc is read. The global file is useful for
888 distributing system-wide defaults to new users who have no pri‐
889 vate tinrc yet (see also /etc/tin/tin.defaults).
890 add_posted_to_filter
892 If ON add posted articles which start a new thread to
893 filter for highlighting follow-ups. Default is ON.
894 advertising
896 Turn ON advertising in header (''User-Agent:''). Default
897 is ON.
898 alternative_handling
900 If ON strip multipart/alternative messages automatically.
901 Default is ON.
902 art_marked_deleted
904 The character used to show that an article was deleted.
905 Default is 'D'.
906 art_marked_inrange
908 The character used to show that an article is in a range.
909 Default is '#'.
910 art_marked_return
912 The character used to show that an article will return as
913 an unread article when the group is next entered. Default
914 is '-'.
915 art_marked_selected
917 The character used to show that an article/thread is
918 auto-selected (hot). Default is '*'.
919 art_marked_recent
921 The character used to show that an article/thread is
922 recent (not older than X days). See also recent_time.
923 Default is 'o'.
924 art_marked_unread
926 The character used to show that an article has not been
927 read. Default is '+'.
928 art_marked_read
930 The character used to show that an article was read.
931 Default is ' '.
932 art_marked_killed
934 The character used to show that an article was killed.
935 Default is 'K'. kill_level must be set accordingly.
936 art_marked_read_selected
938 The character used to show that an article was hot before
939 it was read. Default is ':'. kill_level must be set
940 accordingly.
941 Ask before using MIME viewer (ask_for_metamail)
943 If ON tin(1) will ask before using a MIME viewer (meta‐
944 mail_prog) to display MIME messages. This only occurs if
945 a MIME viewer is set. Default is OFF.
946 auto_bcc
948 If ON automatically put your name in the ''Bcc:'' field
949 when mailing an article. Default is OFF.
950 auto_cc
952 If ON automatically put your name in the ''Cc:'' field
953 when mailing an article. Default is OFF.
954 auto_list_thread
956 If ON automatically list thread when entering it using
957 right arrow key. Default is ON.
958 auto_reconnect
960 Reconnect to server automatically. Default is OFF.
961 auto_save
963 If ON articles/threads with ''Archive-name:'' in header
964 will be automatically saved with the Archive-name &
965 part/patch no and post processed if post_process_type is
966 set to something other than 'No'. Default is OFF.
967 batch_save
969 If set ON articles/threads will be saved in batch mode
970 when save ''-S'' or mail ''-M, -N'' is specified on the
971 command line. Default is ON.
972 beginner_level
974 If set ON a mini menu of the most useful commands will be
975 displayed at the bottom of the screen for each level.
976 Also a short posting etiquette will be displayed after
977 composing an article. Default is ON.
978 cache_overview_files
980 If ON, create local copies of NNTP overview files. This
981 can be used to considerably speed up accessing large
982 groups when using a slow connection. Default is OFF.
983 catchup_read_groups
985 If set ON the user is asked when quitting if all groups
986 read during the current session should be marked read.
987 Default is OFF.
988 col_back
990 Standard background color
991 col_from
993 Color of sender (From:)
994 col_head
996 Color of header-lines
997 col_help
999 Color of help pages
1000 col_invers_bg
1002 Color of background for inverse text
1003 col_invers_fg
1005 Color of foreground for inverse text
1006 col_markdash
1008 Color of words emphasized like _this_. See also
1009 word_h_display_marks and word_highlight.
1010 col_markslash
1012 Color of words emphasized like /this/. See also
1013 word_h_display_marks and word_highlight.
1014 col_markstar
1016 Color of words emphasized like *this*. See also
1017 word_h_display_marks and word_highlight.
1018 col_markstroke
1020 Color of words emphasized like -this-. See also
1021 word_h_display_marks and word_highlight.
1022 col_minihelp
1024 Color of mini help menu
1025 col_newsheaders
1027 Color of actual news header fields
1028 col_normal
1030 Standard foreground color
1031 col_quote
1033 Color of quoted lines
1034 col_quote2
1036 Color of twice quoted lines
1037 col_quote3
1039 Color of >=3 times quoted lines
1040 col_response
1042 Color of response counter. This is the text that says
1043 'Response x of y' in the article viewer.
1044 col_signature
1046 Color of signatures
1047 col_urls
1049 Color of urls highlight
1050 col_subject
1052 Color of article subject
1053 col_text
1055 Color of text-lines
1056 col_title
1058 Color of help/main sign
1059 confirm_choice
1061 tin(1) can ask for manual confirmation to protect the
1062 user. Available choices:
1063 commands: Ask for confirmation before executing cer‐
1064 tain dangerous commands (e.g., Catchup ('c')). Com‐
1065 mands that this affects are marked in this manual
1066 with '[after confirmation]'.
1067 quit: You'll be asked to confirm that you wish to
1069 exit tin(1) when you use the Quit ('q') command.
1070 select: Ask for confirmation before marking all not
1072 selected (with GroupMarkUnselArtRead ('X') command)
1073 articles as read.
1074 Default is commands & quit.
1075 date_format
1077 Format string used for date representation. A description
1078 of the different format options can be found at strf‐
1079 time(3). tin(1). uses strftime(3) when available and
1080 supports most format options in his fallback code.
1081 Default is "%a, %d %b %Y %H:%M:%S".
1082 default_art_search
1084 default_author_search
1086 default_config_search
1088 The last article/author/config option that was searched
1089 for.
1090 default_editor_format
1092 The format string used to create the editor start command
1093 with parameters. Default is '%E +%N %F' (e.g., /bin/vi
1094 +7 .article).
1095 default_filter_days
1097 Default is 28.
1098 default_filter_kill_case
1100 Default for quick (1 key) kill filter case. ON = filter
1101 case sensitive, OFF = ignore case. Default is OFF.
1102 default_filter_kill_expire
1104 Default for quick (1 key) kill filter expire. ON = limit
1105 to 'default_filter_days', OFF = don't ever expire.
1106 Default is OFF.
1107 default_filter_kill_global
1109 Default for quick (1 key) kill filter global. ON=apply to
1110 all groups, OFF=apply to current group. Default is ON.
1111 default_filter_kill_header
1113 Default for quick (1 key) kill filter header.
1114 0,1
1116 ''Subject:''
1117 2,3
1119 ''From:''
1120 4
1122 ''Message-ID:'' & full ''References:'' line
1123 5
1125 ''Message-ID:'' & last ''References:'' entry only
1126 6
1128 ''Message-ID:'' entry only
1129 7
1131 ''Lines:''
1132 default_filter_select_case
1134 Default for quick (1 key) auto-selection filter case.
1135 ON=filter case sensitive, OFF=ignore case. Default is
1136 OFF.
1137 default_filter_select_expire
1139 Default for quick (1 key) auto-selection filter expire.
1140 ON = limit to 'default_filter_days', OFF = don't ever
1141 expire. Default is OFF.
1142 default_filter_select_global
1144 Default for quick (1 key) auto-selection filter global.
1145 ON=apply to all groups, OFF=apply to current group.
1146 Default is ON.
1147 default_filter_select_header
1149 Default for quick (1 key) auto-selection filter header.
1150 0,1
1152 ''Subject:''
1153 2,3
1155 ''From:''
1156 4
1158 ''Message-ID:'' & full ''References:'' line
1159 5
1161 ''Message-ID:'' & last ''References:'' entry only
1162 6
1164 ''Message-ID:'' entry only
1165 7
1167 ''Lines:''
1168 default_goto_group
1170 default_group_search
1172 default_mail_address
1174 default_maildir
1176 The directory where articles/threads are to be saved in
1177 mbox(5) format. This feature is mainly for use with the
1178 elm(1) mail program. It allows the user to save arti‐
1179 cles/threads/groups simply by giving '=' as the filename
1180 to save to. Default is ${TIN_HOMEDIR-"$HOME"}/Mail.
1181 default_mailer_format
1183 The format string used to create the mailer command with
1184 parameters that is used for mailing articles to other
1185 people. Default is '%M "%T" < %F' (e.g., /bin/mail "iain"
1186 < .article). The flexible format allows other mailers
1187 with different command line parameters to be used such as
1188 'elm -s "%S" "%T" < "%F"' (e.g., elm -s "subject" "iain"
1189 < .article) or 'sendmail -oem -t < %F' (e.g. sendmail
1190 -oem -t < .article).
1191 default_move_group
1193 default_pattern
1195 default_pipe_command
1197 default_post_newsgroups
1199 default_post_subject
1201 default_printer
1203 The printer program with options that is to be used to
1204 print articles. The default is lpr(1) for BSD machines
1205 and lp(1) for SysV machines. Printing from tin(1) may
1206 have been disabled by the System Administrator.
1207 default_range_group
1209 default_range_select
1211 default_range_thread
1213 default_repost_group
1215 default_save_file
1217 default_save_mode
1219 default_savedir
1221 Directory where articles/threads are saved. Default is
1222 ${TIN_HOMEDIR-"$HOME"}/News.
1223 default_select_pattern
1225 default_shell_command
1227 default_sigfile
1229 The path that specifies the signature file to use when
1230 posting, following up to or replying to an article. If
1231 the path is a directory then the signature will be ran‐
1232 domly generated from files that are in the specified
1233 directory. If the path starts with a ! the program the
1234 path points to will be executed to generate a signature.
1235 tin(1) will pass the name of the current newsgroup as
1236 argument to the program. --none will suppress any signa‐
1237 ture. Default is ${TIN_HOMEDIR-"$HOME"}/.Sig.
1238 default_subject_search
1240 draw_arrow
1242 Allows groups/articles to be selected by an arrow '->' if
1243 set ON or by an highlighted bar if set OFF.
1244 force_screen_redraw
1246 Specifies whether a screen redraw should always be done
1247 after certain external commands. Default is OFF.
1248 getart_limit
1250 If getart_limit is > 0 not more than getart_limit arti‐
1251 cles/group are fetched from the server. If getart_limit
1252 is < 0 tin(1) will start fetching articles from your
1253 first unread minus absolute value of getart_limit.
1254 Default is 0, which means no limit.
1255 group_catchup_on_exit
1257 If ON catchup group when leaving with the left arrow key.
1258 Default is ON.
1259 groupname_max_length
1261 Maximum length of the names of newsgroups to be displayed
1262 so that more of the newsgroup description can be dis‐
1263 played. Default is 32.
1264 hide_uue
1266 If set to 'No' then raw uuencoded data is displayed. If
1267 set to 'Yes' then sections of uuencoded data will be
1268 shown with a single tag line showing the size and file‐
1269 name (much the same as a MIME attachment). If set to
1270 'Hide all' then any line that looks like uuencoded data
1271 will be folded into a tag line. This is useful when uuen‐
1272 coded data is split across more than one article but can
1273 also lead to false positives. This setting can also be
1274 toggled in the article viewer. Default is 'No'.
1275 inews_prog
1277 Path, name and options of external inews(1). If you are
1278 reading via NNTP the default value is "--internal" (use
1279 built-in NNTP inews), else it is "inews -h". The article
1280 is passed to inews_prog on STDIN via '< article'.
1281 info_in_last_line
1283 If ON, show current group description or article subject
1284 in the last line (not in the pager and global menu) -
1285 ToggleInfoLastLine ('i' toggles setting). This facility
1286 is useful as the full width of the screen is available to
1287 display long subjects. Default is OFF.
1288 interactive_mailer
1290 If greater than 0 your mailreader will be invoked earlier
1291 for reply so you can use more of its features (e.g. MIME,
1292 pgp, ...). 1 means include headers, 2 means don't include
1293 headers (old use_mailreader_i=ON option). 0 turns off
1294 usage. This option has to suit default_mailer_format.
1295 Default is 0.
1296 inverse_okay
1298 If ON use inverse video for page headers and URL high‐
1299 lighting. Default is ON.
1300 keep_dead_articles
1302 If ON keep all failed postings in ${TIN_HOME‐
1303 DIR-"$HOME"}/dead.articles besides keeping the last
1304 failed posting in ${TIN_HOMEDIR-"$HOME"}/dead.article.
1305 Default is ON.
1306 kill_level
1308 This option controls the processing and display of arti‐
1309 cles that are killed. There are 3 options:
1310 0 Kill only unread arts is the 'traditional' behavior of
1312 tin(1). Only unread articles are killed once only by
1313 marking them read. As filtering only happens on unread
1314 articles with kill_level set to 0, art_marked_killed and
1315 art_marked_read_selected are only shown once. When you
1316 reenter the group the mark will be gone.
1317 1 Kill all arts & show with K will process all articles in
1319 the group and therefore there is a processing overhead
1320 when using this option. Killed articles are threaded as
1321 normal but they will be marked with art_marked_killed.
1322 2 Kill all arts and never show will process all articles
1324 in the group and therefore there is a processing over‐
1325 head when using this option. Killed articles simply does
1326 not get displayed at all.
1327 Default is 0 (Kill only unread arts).
1328 mail_8bit_header
1330 Allows 8bit characters unencoded in the header of mail
1331 message. Default is OFF. Turning it ON is effective only
1332 if mail_mime_encoding is also set to 8bit. Leaving it OFF
1333 is safe for most users and compliant to Internet Mail
1334 Standard (RFC2822 and RFC2047). Default is OFF.
1335 mail_address
1337 User's mail address (and full name), if not user‐
1338 name@host. This is used when creating articles, sending
1339 mail and when pgp(1) signing.
1340 mail_mime_encoding
1342 MIME encoding of the body in mail message, if necessary
1343 (8bit, base64, quoted-printable, 7bit). Default is 8bit
1344 and no encoding (or charset conversion) is performed
1345 (i.e., local charset is used as it is).
1346 mail_quote_format
1348 Format of quote line when replying (via mail) to an arti‐
1349 cle (%A=Address, %D=Date, %F=Fullname+Address, %G=Group‐
1350 name, %M=Message-ID, %N=Fullname, %C=Firstname, %I=Ini‐
1351 tials). Default is "In article %M you wrote:"
1352 mailbox_format
1354 Select one of the following mailbox-formats: MBOXO
1355 (default, except on SCO), MBOXRD or MMDF (default on
1356 SCO). See mbox(5) for more details on MBOXO and MBOXRD
1357 and mmdf(5) for more details about MMDF.
1358 mark_saved_read
1360 If ON mark articles that are saved as read. Default is
1361 ON.
1362 mark_ignore_tags
1364 When this is ON, the GroupMarkThdRead, ThreadMarkArtRead
1365 functions ('K') mark just the current article or thread,
1366 ignoring other tagged, unread articles. When OFF, the
1367 same function presents a menu with choices of the current
1368 thread or article, all tagged, unread articles, or noth‐
1369 ing.
1370 metamail_prog
1372 Path, name and options of external metamail(1) program
1373 used to view non-textual parts of articles. To use the
1374 built-in viewer, set to --internal. This is the default
1375 value when metamail(1) is not installed. Leave it blank
1376 if you don't want any automatic viewing of non-textual
1377 attachments. The 'V' command can always be used to manu‐
1378 ally view any attachments. See also ask_for_metamail.
1379 mm_charset
1381 Charset supported locally, which is also used for MIME
1382 header (charset parameter and charset name in header
1383 encoding) in mail and news postings. If
1384 MIME_STRICT_CHARSET is defined at the compile time, text
1385 in charset other than the value of this parameter is con‐
1386 sidered not displayable and represented as '?'. Other‐
1387 wise, all character sets are regarded as compatible with
1388 the display. If it's not set, the value of the environ‐
1389 ment variable $MM_CHARSET is used. US-ASCII or compile-
1390 time default is used in case neither of them is defined.
1391 If your system supports iconv(3), this option is disabled
1392 and you should use mm_network_charset instead.
1393 mm_network_charset
1395 Charset used for posting and MIME headers; replaces
1396 mm_charset. Conversion between mm_network_charset and
1397 local charset (determined via nl_langinfo(3)) is done via
1398 iconv(3), if this function is not available on your sys‐
1399 tem this option is disabled and you have to use
1400 mm_charset instead. mm_network_charset is limited to one
1401 of the following charsets:
1402 US-ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16},
1403 KOI8-{R,U,RU} EUC-{CN,JP,KR,TW}, ISO-2022-{CN,CN-
1404 EXT,JP,JP-1,JP-2}, Big5, UTF-8
1405 Not all values might work on your system, see
1406 iconv_open(3) for more details. If it's not set, the
1407 value of the environment variable $MM_CHARSET is used.
1408 US-ASCII or compile-time default is used in case neither
1409 of them is defined.
1410 mono_markdash
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_markslash
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 mono_markstar
1422 Character attribute of words emphasized like *this*. It
1423 is depending on your terminal which attributes are
1424 usable. See also word_h_display_marks and word_highlight.
1425 mono_markstroke
1427 Character attribute of words emphasized like -this-. It
1428 is depending on your terminal which attributes are
1429 usable. See also word_h_display_marks and word_highlight.
1430 newnews
1432 These are internal timers used by tin(1) to keep track of
1433 new newsgroups. Do not change them unless you understand
1434 what they are for.
1435 news_headers_to_display
1437 Which news headers you wish to see. If you want to see
1438 _all_ the headers, place an '*' as this value. This is
1439 the only way a wildcard can be used. If you enter 'X-'
1440 as the value, you will see all headers beginning with
1441 'X-' (like X-Alan or X-Pape). You can list more than one
1442 by delimiting with spaces. Not defining anything turns
1443 off this option.
1444 news_headers_to_not_display
1446 Same as news_headers_to_display except it denotes the
1447 opposite. An example of using both options might be if
1448 you thought X- headers were A Good Thing(tm), but thought
1449 Alan and Pape were miscreants... well then you would do
1450 something like this: news_headers_to_display=X-
1451 news_headers_to_not_display=X-Alan X-Pape Not defining
1452 anything turns off this option.
1453 news_quote_format
1455 Format of quote line when posting/following up an article
1456 (%A=Address, %D=Date, %F=Fullname+Address, %G=Groupname,
1457 %M=Message-ID, %N=Fullname, %C=Firstname, %I=Initials).
1458 Default is "%F wrote:".
1459 normalization_form
1461 The normalization form which should be used to normalize
1462 unicode input. The possible values are:
1463 0 None: no normalization
1465 1 NFKC: Compatibility Decomposition, followed by Canonical
1467 Composition
1468 2 NFKD: Compatibility Decomposition
1470 3 NFC: Canonical Decomposition, followed by Canonical Com‐
1472 position
1473 4 NFD: Canonical Decomposition
1475 Some normalization modes are only available if they are sup‐
1476 ported by the library tin(1) uses to do the normalization.
1477 Default is NFKC.
1478 pgdn_goto_next
1480 If ON the PageDown keys will go to the next unread arti‐
1481 cle when pressed at the end of a message. Default is ON.
1482 pos_first_unread
1484 If ON put cursor at first unread article in group other‐
1485 wise at last article. Default is ON.
1486 post_8bit_header
1488 Allows 8bit characters unencoded in the header of a news
1489 article, if set this also disables the generation of
1490 MIME-headers when they are usualy required. Default is
1491 OFF. Only enacted if post_mime_encoding is also set to
1492 8bit. In a number of local hierarchies where 8bit charac‐
1493 ters are used, using unencoded (raw) 8bit characters in
1494 header is acceptable and sometimes even recommended so
1495 that you need to check the convention adopted in the
1496 local hierarchy of your interest to determine what to do
1497 with this and post_mime_encoding.
1498 post_mime_encoding
1500 MIME encoding of the body in news message, if necessary.
1501 (8bit, base64, quoted-printable, 7bit) Default is 8bit,
1502 which leads to no encoding. base64 and quoted-printable
1503 are usually undesired on usenet.
1504 post_process_view
1506 If ON, then tin(1) will start an appropriate viewer pro‐
1507 gram to display any files that were post processed and
1508 uudecoded. The program is determined using the mailcap
1509 file. Default is ON.
1510 post_process_type
1512 This specifies whether to perform post processing on
1513 saved articles. Because the shell archive may contain
1514 commands you may not want to be executed, be careful when
1515 extracting shell archives. The following values are
1516 allowed:
1517 0 No (default), no post processing is done.
1519 1 Shell archives, unpacking of multi-part shar(1) files
1521 only. Because the shell archive may contain commands
1522 you may not want to be executed, be careful with this
1523 option.
1524 2 Yes, binary attachments and data will be decoded and
1526 saved.
1527 posted_articles_file
1529 Keep posted articles in ${TIN_HOME‐
1530 DIR-"$HOME"}/Mail/posted_articles_file. If no filename
1531 is set then postings will not be saved. Default is
1532 'posted'.
1533 print_header
1535 If ON, then the full article header is sent to the
1536 printer. Otherwise only the ''Subject:'' and ''From:''
1537 fields are output. Default is OFF.
1538 process_only_unread
1540 If ON only save/print/pipe/mail unread articles (tagged
1541 articles excepted). Default is OFF.
1542 prompt_followupto
1544 If ON show empty ''Followup-To:'' header when editing an
1545 article. Default is OFF.
1546 quote_chars
1548 The character used in quoting included text to article
1549 followups and mail replies. The '_' character represents
1550 a blank character and is replaced with ' ' when read.
1551 Default is '>_'.
1552 quote_style
1554 This bit coded integer value controls how articles are to
1555 be quoted when following up or replying to them. Any of
1556 the following options can be combined by adding all rele‐
1557 vant values. Default is 5, which means that quote charac‐
1558 ters are compressed and empty lines are quoted.
1559 1 Compress quotes Compress quote characters together when
1561 quoting multiple times (for example, '> > >' will be
1562 turned into '>>>'). This option is on by default.
1563 2 Quote Signatures This option is off by default. Signa‐
1565 tures are always quoted regardless of this option when
1566 you are viewing an article in raw mode PageToggleHeaders
1567 ('^H') and followup or reply to it.
1568 4 Quote empty lines This option is on by default.
1570 quote_regex
1572 A regular expression that will be applied when reading
1573 articles. All matching lines are shown in col_quote. If
1574 quote_regex is blank, then tin(1) uses a built-in
1575 default.
1576 quote_regex2
1578 A regular expression that will be applied when reading
1579 articles. All matching lines are shown in col_quote2. If
1580 quote_regex2 is blank, then tin(1) uses a built-in
1581 default.
1582 quote_regex3
1584 A regular expression that will be applied when reading
1585 articles. All matching lines are shown in col_quote3. If
1586 quote_regex3 is blank, then tin(1) uses a built-in
1587 default.
1588 recent_time
1590 If set to 0, this feature is deactivated, otherwise it
1591 means the number of days. Default is 2.
1592 render_bidi
1594 If ON tin does the rendering of bi-directional text. If
1595 OFF tin leaves the rendering of bi-directional text to
1596 the terminal. Default is OFF.
1597 reread_active_file_secs
1599 The news ${TIN_LIBDIR-NEWSLIBDIR}"/"${TIN_ACTIVE‐
1600 FILE-active} file is reread at regular intervals to show
1601 if any new news has arrived. Default is 1200. Setting
1602 this to 0 will disable this feature.
1603 score_limit_kill
1605 If the score of an article is below or equal this value
1606 the article gets marked as killed.
1607 score_limit_select
1609 If the score of an article is above or equal this value
1610 the article gets marked as hot.
1611 score_kill
1613 Score of an article which should be killed, this must be
1614 <= score_limit_kill.
1615 score_select
1617 Score of an article which should be marked hot, this must
1618 be >= score_limit_select.
1619 scroll_lines
1621 The number of lines that will be scrolled up/down in the
1622 article pager when using cursor-up/down. The default is 1
1623 (line-by-line). Set to 0 to get traditional page-by-page
1624 scrolling. Set to -1 to get page-by-page scrolling where
1625 the top/bottom line is carried over onto the next page.
1626 This setting supersedes show_last_line_prev_page=ON. Set
1627 to -2 to get half-page scrolling. This setting supersedes
1628 full_page_scroll=OFF.
1629 show_author
1631 Which information about the author should be shown.
1632 Default is 2, authors full name.
1633 0 None, only the ''Subject:'' line will be displayed.
1635 1 Address, ''Subject:'' line & the address part of the
1637 ''From:'' line are displayed.
1638 2 Full Name, ''Subject:'' line & the authors full name
1640 part of the ''From:'' line are displayed (default).
1641 3 Address and Name, ''Subject:'' line & all of the
1643 ''From:'' line are displayed.
1644 show_description
1646 If ON show a short group description text after newsgroup
1647 name at the group selection level. The ''-d'' command-
1648 line flag will override the setting and turn descriptions
1649 off. The text used is taken from the ${TIN_LIB‐
1650 DIR-NEWSLIBDIR}/newsgroups file and if supported
1651 (requires tin(1) to be build with mh-mail-handling sup‐
1652 port) from ${TIN_HOMEDIR-"$HOME"}/.tin/mailgroups for
1653 mailgroups. Default is ON.
1654 show_info
1656 Which information about the thread or article should be
1657 shown. Default is 1, show only the line count.
1658 0 None, no information will be displayed.
1660 1 Lines, in article listing the line count of an article
1662 will be displayed and in thread listing the line count
1663 of first (unread) article will be displayed.
1664 2 Score, in article listing the score of an article will
1666 be displayed and in thread listing the score of the
1667 thread will be displayed - see also thread_score.
1668 3 Lines & Score, display line count and score.
1670 show_only_unread_arts
1672 If ON show only new/unread articles otherwise show all
1673 articles. Default is ON.
1674 show_only_unread_groups
1676 If ON show only subscribed groups that contain unread
1677 articles. Default is OFF.
1678 show_signatures
1680 If OFF don't show signatures when displaying articles.
1681 Default is ON.
1682 sigdashes
1684 If ON prepend the signature with sigdashes. Default is
1685 ON.
1686 signature_repost
1688 If ON add signature to reposted articles. Default is ON.
1689 slashes_regex
1691 A regular expression that will be applied when reading
1692 articles. All matching words are shown in col_markslash
1693 or mono_markslash. If slashes_regex is blank, then tin(1)
1694 uses a built-in default.
1695 sort_article_type
1697 This specifies how articles should be sorted.Sort by
1698 ascending Date (6) is the default. The following sort
1699 types are allowed:
1700 0 Nothing, don't sort articles.
1702 1 Subject: (descending), sort articles by ''Subject:''
1704 field descending.
1705 2 Subject: (ascending), sort articles by ''Subject:''
1707 field ascending.
1708 3 From: (descending), sort articles by ''From:'' field
1710 descending.
1711 4 From: (ascending), sort articles by ''From:'' field
1713 ascending.
1714 5 Date: (descending), sort articles by ''Date:'' field
1716 descending.
1717 6 Date: (ascending), sort articles by ''Date:'' field
1719 ascending (default).
1720 7 Score (descending), sort articles by filtering score
1722 descending.
1723 8 Score (ascending), sort articles by filtering score
1725 ascending.
1726 9 Lines: (descending), sort articles by ''Lines:'' field
1728 descending.
1729 10 Lines: (ascending), sort articles by ''Lines:'' field
1731 ascending.
1732 sort_threads_type
1734 This specifies how threads will be sorted. Sort by
1735 descending Score (1) is the default. The following sort
1736 types are allowed:
1737 0 Nothing, don't sort threads.
1739 1 Score (descending), sort threads by filtering score
1741 descending (default).
1742 2 Score (ascending), sort threads by filtering score
1744 ascending.
1745 space_goto_next_unread
1747 SPACE normally acts as a PageDown key and has no effect
1748 at the end of an article. If this option is turned ON the
1749 SPACE command will go to the next unread article when the
1750 end of the article is reached (rn (1)-style pager).
1751 spamtrap_warning_addresses
1753 Set this option to a list of comma-separated strings to
1754 be warned if you are replying to an article by mail where
1755 the e-mail address contains one of these strings. The
1756 matching is case-insensitive.
1757 stars_regex
1759 A regular expression that will be applied when reading
1760 articles. All matching words are shown in col_markstar or
1761 mono_markstar. If stars_regex is blank, then tin(1) uses
1762 a built-in default.
1763 start_editor_offset
1765 Set ON if the editor used for posting, follow-ups and bug
1766 reports has the capability of starting and positioning
1767 the cursor at a specified line within a file. Default is
1768 ON.
1769 strip_blanks
1771 Strips the blanks from the end of each line therefore
1772 speeding up the display when reading on a slow terminal
1773 or via modem. Default is ON.
1774 strip_bogus
1776 Bogus groups are groups that are present in your
1777 ${TIN_HOMEDIR-"$HOME"}/.newsrc file that no longer exist
1778 on the news server. There are 3 options. 0 means do noth‐
1779 ing & always keep bogus groups. 1 means bogus groups
1780 will be permanently removed. 2 means that bogus groups
1781 will appear on the Group Selection Menu, prefixed with a
1782 'D'. This allows you to unsubscribe from them as and when
1783 you wish. Default is 0 (Always Keep).
1784 strip_newsrc
1786 If ON, then unsubscribed groups will be permanently
1787 removed from your ${TIN_HOMEDIR-"$HOME"}/.newsrc file.
1788 Default is OFF.
1789 strokes_regex
1791 A regular expression that will be applied when reading
1792 articles. All matching words are shown in col_markstroke
1793 or mono_markstroke. If strokes_regex is blank, then
1794 tin(1) uses a built-in default.
1795 tab_goto_next_unread
1797 If enabled pressing PageNextUnread ('<TAB>') at the arti‐
1798 cle viewer level will go to the next unread article imme‐
1799 diately instead of first paging through the current one.
1800 Default is ON.
1801 tex2iso_conv
1803 Decode German style TeX umlaut codes to ISO If ON, show
1804 "a as Umlaut-a, etc. Default is OFF. This behavior can
1805 also be toggled in the article viewer via PageToggle‐
1806 Tex2iso ('"').
1807 thread_articles
1809 Defines which threading method to use. The choices are:
1810 0) Don't thread, 1) Thread on Subject only 2) Thread on
1811 References only, 3) Thread on References then Subject
1812 (default) 4) Thread multipart articles on Subject. 5)
1813 Thread on Percentage Match of the Subjects It's also pos‐
1814 sible to set the threading type on a per group basis by
1815 setting the group attribute variable thread_arts to 0 - 5
1816 in the file ${TIN_HOMEDIR-"$HOME"}/.tin/attributes.
1817 thread_perc
1819 Defines how close the subjects must match while threading
1820 by Percentage Match for threads to be considered part of
1821 a single thread. This value is in the range 0 to 100. The
1822 default is 75.
1823 thread_catchup_on_exit
1825 If ON catchup group/thread when leaving with the left
1826 arrow key. Default is ON.
1827 thread_score
1829 How the total score of a thread is computed. Default is
1830 0, the maximum score in this thread.
1831 0 Max, the maximum score in this thread.
1833 1 Sum, the sum of all scores in this thread.
1835 2 Average, the average score in this thread.
1837 translit
1839 If ON append //TRANSLIT to the first argument of
1840 iconv_open(3) to enable transliteration. This means that
1841 when a character cannot be represented in the target
1842 character set, it can be approximated through one or sev‐
1843 eral similarly looking characters. On systems where this
1844 extension doesn't exist, this option is disabled. Default
1845 is OFF.
1846 underscores_regex
1848 A regular expression that will be applied when reading
1849 articles. All matching words are shown in col_markdash or
1850 mono_markdash. If undescores_regex is blank, then tin(1)
1851 uses a built-in default.
1852 unlink_article
1854 If ON remove ${TIN_HOMEDIR-"$HOME"}/.article after post‐
1855 ing. Default is ON.
1856 url_handler
1858 The program that will be run when launching URLs in the
1859 article viewer using PageViewUrl ('U'). The actual URL
1860 will be appended to this. Default is url_handler.sh %s.
1861 url_highlight
1863 Enable highlighting URLs in message body. Default is ON.
1864 use_color
1866 If enabled tin(1) uses ANSI-colors. Default is OFF.
1867 use_keypad
1869 Use scroll keys on keypad. Default is OFF.
1870 use_mouse
1872 Allows the mouse key support in a xterm(1x) to be
1873 enabled/disabled. Default is OFF.
1874 use_slrnface
1876 If enabled slrnface(1) will be used to interpret the
1877 ''X-Face:'' header. For this option to have any effect,
1878 tin(1) must be running in an xterm(1x) and slrnface(1)
1879 must be in your $PATH. Default is OFF.
1880 wildcard
1882 Allows you to select how tin(1) matches strings. The
1883 default is 0 and uses the wildmat notation, which is how
1884 this has traditionally been handled. Setting this to 1
1885 allows you to use perl(1) compatible regular expressions
1886 pcre(3). You will probably want to update your filter
1887 file if you use this regularly. NB: Newsgroup names will
1888 always be matched using the wildmat notation.
1889 word_h_display_marks
1891 Should the leading and ending stars, slashes, strokes and
1892 dashes also be displayed, even when they are highlighting
1893 marks?
1894 0 no
1896 1 yes, display mark
1898 2 print a space instead
1900 word_highlight
1902 Enable word highlighting. See word_h_display_marks for
1903 the options available. If use_color is enabled the colors
1904 specified in col_markdash, col_markslash, col_markstar
1905 and col_markstroke are used for word highlighting else
1906 the character attributes specified in mono_markdash,
1907 mono_markslash, mono_markstar and mono_markstroke are
1908 used.
1909 wrap_column
1911 Sets the column at which a displayed article body should
1912 be wrapped. If this value is equal to 0, it defaults to
1913 the current screen width. If this value is greater than
1914 your current screen width the part off-screen is not dis‐
1915 played. Thus setting this option to a large value can be
1916 used to disable wrapping. If this value is negative the
1917 wrap margin is the current screen width plus the given
1918 value (as long as the result is still positive, otherwise
1919 it will fall back to the current screen width). Default
1920 is 0, wrapping at the current screen width.
1921 wrap_on_next_unread
1923 If enabled a search for the next unread article will wrap
1924 around all articles to find also previous unread arti‐
1925 cles. If disabled the search stops at the end of the
1926 thread list. Default is ON.
1927 xpost_quote_format
1929 Format is the same as for news_quote_format, this is used
1930 when answering to a crossposting to several groups with
1931 no ''Followup-To:'' set.
1932 /etc/tin/tin.defaults
1934 Yet another global configuration file with "variable=value"
1936 pairs. This one is for the more general options which usually
1937 can't be controlled via ${TIN_LIBDIR-NEWSLIBDIR}/tinrc and/or
1938 ${TIN_HOMEDIR-"$HOME"}/.tin/tinrc like resetting (to override
1939 the built-in default) the newslibdir.
1940 domainname
1942 Sets a global domain name used in From lines
1943 organization
1945 Defines the name of your organization. $ORGANIZATION
1946 overrides any specified value.
1947 newslibdir
1949 Defines the default place for some configuration files,
1950 common values are /usr/lib/news, /var/lib/news,
1951 /usr/local/lib/news or /news/db. $TIN_LIBDIR overrides
1952 any specified value.
1953 bugaddress
1955 Defines the email address to which users can send bug
1956 reports using a built-in function. The default points to
1957 a developers mailing list located at tin.org. You might
1958 want to change this address to one of your local adminis‐
1959 tration if you want to deal with your lusers problems on
1960 your own.
1961 inewsdir
1963 Defines the directory containing of the inews(1) exe‐
1964 cutable
1965 mm_charset
1967 Default charset to be used in MIME's Content-Type header.
1968 $MM_CHARSET overrides any specified value.
1969 post_mime_encoding
1971 Default encoding scheme use in MIME articles. 8bit might
1972 be the best value.
1973 mail_mime_encoding
1975 Default encoding scheme use in MIME letters. quoted-
1976 printable is a good choice here.
1977 disable_gnksa_domain_check
1979 Allow unregistered top level domains
1980 disable_sender
1982 Don't generate a ''Sender:''-header. This has no effect
1983 if inews_prog is not set to --internal.
1984 spooldir
1986 Base of your newsspool (Bnews, Cnews and INN traditional
1987 spool style), common values are /var/spool/news,
1988 /usr/spool/news, /news/spool. $TIN_SPOOLDIR overrides
1989 any specified value.
1990 overviewdir
1992 Base of your NOV database newsoverview(5) (tradspool
1993 style; might be the same dir as spooldir), common values
1994 are /var/spool/overview, /usr/spool/overview, /news/over‐
1995 view. $TIN_NOVROOTDIR overrides any specified value.
1996 overviewfile
1998 Name of a single overview file, common values are .over‐
1999 view, over.view.
2000 activefile
2002 Full pathname of your newssystem's active file; usually
2003 the active file resides in newslibdir and is named
2004 active, so you only have to change this setting if your
2005 configuration differs. $TIN_ACTIVEFILE overrides any
2006 specified value.
2007 activetimesfile
2009 Full pathname of your newssystem's active.times file;
2010 usually the active.times file is newslibdir, so you only
2011 have to change this setting if your configuration dif‐
2012 fers.
2013 newsgroupsfile
2015 Full pathname of your newssystem's newsgroups file; usu‐
2016 ally the newsgroups file is in newslibdir, so you only
2017 have to change this setting if your configuration dif‐
2018 fers.
2019 subscriptionsfile
2021 Full pathname of your newssystem's subscriptions file;
2022 usually the subscriptions file is in newslibdir, so you
2023 only have to change this setting if your configuration
2024 differs.
2025 /usr/local/share/locale/${LC_MESSAGES}/LC_MESSAGES/tin.mo
2027 translation into language specified in $LC_ALL, $LC_MESSAGES or
2029 $LANG
2030 ${TIN_LIBDIR-NEWSLIBDIR}"/"${TIN_ACTIVEFILE-active}
2032 This file lists the newsgroups that the local site receives.
2034 Each newsgroup should be listed only once. Each line specifies
2035 one group; within each newsgroup, articles are assigned unique
2036 names, which are monotonically increasing numbers.
2037 If an article is posted to newsgroups not mentioned in this
2039 file, those newsgroups are ignored. If no valid newsgroups are
2040 specified, the article is rejected.
2041 Each line consists of four space-separated fields "name highmark
2043 lowmark flags".
2044 name is the name of the newsgroup
2046 highmark
2048 is the highest article number that has been used in that
2049 newsgroup
2050 lowmark
2052 is the lowest article number in the group; this number is
2053 not guaranteed to be accurate, and should only be taken
2054 to be a hint. Note that because of article cancellations,
2055 there may be gaps in the numbering sequence. If the low‐
2056 est article number is greater then the highest article
2057 number, then there are no articles in the newsgroup.
2058 flags can be one of those
2060 y local postings are allowed
2062 n no local postings are allowed, only remote ones
2064 m the group is moderated and all postings must be
2066 approved
2067 j articles in this group are not kept, but only
2069 passed on
2070 x articles cannot be posted to this newsgroup
2072 =foo.bar
2074 articles are locally filed into the ''foo.bar''
2075 group
2076 tin(1) only tries to read the file if you read directly from the
2078 local spool, if you read news via NNTP, tin(1) uses the
2079 LIST (RFC977) command instead.
2080 ${TIN_LIBDIR-NEWSLIBDIR}/active.times
2082 This file provides a chronological record of when newsgroups are
2084 created. It is normally updated by the local newsserver (e.g.
2085 innd(8)) whenever a new group is created. Each line consist of
2086 three space-separated fields "name time creator".
2087 name is the name of the newsgroup
2089 time is the time when the group was created, expressed as the
2091 number of seconds since the epoch.
2092 creator
2094 is the electronic mail address of the person who created
2095 the group.
2096 tin(1) only tries to read the file if you read directly from the
2098 local spool, if you read news via NNTP, tin(1) uses the
2099 NEWGROUPS (RFC977) command instead.
2100 ${TIN_LIBDIR-NEWSLIBDIR}/newsgroups
2102 This file provides short descriptions of each newsgroup. It is
2104 normally updated by the local newsserver (e.g. innd(8)) when‐
2105 ever a new group is created. Each line consist of two tab-sepa‐
2106 rated fields "group.name one-line description".
2107 group.name
2109 is the name of the newsgroup
2110 one-line description
2112 is a short single-line description of the group
2113 tin(1) only tries to read the file if you read directly from the
2115 local spool, if you read news via NNTP, tin(1) uses the
2116 LIST NEWSGROUPS (RFC2980) command instead.
2117 ${TIN_LIBDIR-NEWSLIBDIR}/organization
2119 This file specifies might hold a default organization to be used
2121 in the ''Organization:'' header. $ORGANIZATION has a higher pri‐
2122 ority if set.
2123 ${TIN_LIBDIR-NEWSLIBDIR}/overview.fmt
2125 This file specifies the organization of the news overview data‐
2127 base (see also newsoverview(5)). The order of lines in this
2128 file is important; it determines the order in which the fields
2129 will appear in the database. tin(1) currently only understands
2130 the order specified in RFC2980. See also overview.fmt(5).
2131 tin(1) only tries to read the file if you read directly from the
2132 local spool, if you read news via NNTP, tin(1) uses the LIST
2133 OVERVIEW.FMT (RFC2980) command instead.
2134 ${TIN_LIBDIR-NEWSLIBDIR}/subscriptions
2136 This file contains a list of newsgroups - one per line - which
2138 the client should subscribe to when the user has no ${TIN_HOME‐
2139 DIR-"$HOME"}/.newsrc for the newsserver. tin(1) only tries to
2140 read the file if you read directly from the local spool, if you
2141 read news via NNTP, tin(1) uses the LIST SUBSCRIPTIONS (RFC2980)
2142 command instead.
2143
2145 elm(1), inews(1), ispell(1), lp(1), lpr(1), metamail(1) perl(1),
2146 pgp(1), rn(1), shar(1), slrnface(1), tin(1), xterm(1x), iconv(3),
2147 iconv_open(3), nl_langinfo(3), pcre(3), strftime(3), system(3), mail‐
2148 cap(4), active(5), mbox(5), mmdf(5), newsoverview(5), overview.fmt(5),
2149 innd(8), RFC977, RFC1036, RFC1524, RFC2045, RFC2046, RFC2047, RFC2048,
2150 RFC2822, RFC2980
21511.8.2 April 25th, 2006 tin(5)