1tin(5) Usenet newsreader tin(5)
2
6 tin, rtin - related files
7
10 This man page describes the various (config) files and their formats
11 used by the tin(1) newsreader. All files are expected to have unix
12 style ('\n' aka LF) line endings.
13
16 $MAILCAPS
17 ~/.mailcap
18 /etc/mailcap
19 /usr/etc/mailcap
20 /usr/local/etc/mailcap
21 /etc/mail/mailcap
22 mailcap(5) files as defined in RFC1524. The mailcap files are
24 read by tin(1) to determine how to display non-text messages at
25 the local site. Any line that starts with "#" is a comment.
26 Blank lines are ignored. Otherwise, each line defines a single
27 mailcap entry for a single content type. Long lines may be con‐
28 tinued by ending them with a backslash character, "\".
29 Each individual mailcap entry consists of a content-type speci‐
31 fication, a command to execute, and (possibly) a set of optional
32 "flag" values.
33 The "type" field is simply any legal content type name. It is
35 the string that will be matched against the ''Content-Type:''
36 header to decide if this is the mailcap entry that matches the
37 current message. Additionally, the type field may specify a sub‐
38 type or a wildcard to match all subtypes.
39 The "command" field is any UNIX command and is used to specify
41 the interpreter for the given type of message. It will be passed
42 to the shell via the system(3) facility.
43 Semicolons and backslashes within the command or any flag field
45 must be quoted with backslashes. If the field contains "%s",
46 those two characters will be replaced by the name of a file that
47 contains the body of the message. If it contains "%t", those two
48 characters will be replaced by the content-type field, including
49 the subtype, if any. If it contains "%{" followed by a parameter
50 name and a closing "}", then all those characters will be
51 replaced by the value of the named parameter, if any, from the
52 ''Content-Type:'' header. Finally, if the field contains "\%",
53 those two characters will be replaced by a single "%" character.
54 Besides the type and command field the following "flags" are
56 defined:
57 compose
59 The "compose" field may be used to specify a program that
60 can be used to compose a new body or body part in the
61 given format. Its intended use is to support mail compos‐
62 ing agents that support the composition of multiple types
63 of mail using external composing agents. As with the
64 view-command, the semantics of program execution are
65 operating system dependent. The result of the composing
66 program may be data that is not yet suitable for mail
67 transport - that is, a Content-Transfer-Encoding may need
68 to be applied to the data.
69 composetyped
71 The "composetyped" field is similar to the "compose"
72 field, but is to be used when the composing program needs
73 to specify the ''Content-Type:'' header field to be
74 applied to the composed data. The "compose" field is sim‐
75 pler, and is preferred for use with existing (non-mail-
76 oriented) programs for composing data in a given format.
77 The "composetyped" field is necessary when the Con‐
78 tent-Type information must include auxiliary parameters,
79 and the composition program must then know enough about
80 mail formats to produce output that includes the mail
81 type information.
82 edit The "edit" field may be used to specify a program that
84 can be used to edit a body or body part in the given for‐
85 mat. In many cases, it may be identical in content to the
86 "compose" field, and shares the operating-system depen‐
87 dent semantics for program execution.
88 print The "print" field may be used to specify a program that
90 can be used to print a message or body part in the given
91 format. As with the view-command, the semantics of pro‐
92 gram execution are operating system dependent.
93 test The "test" field may be used to test some external condi‐
95 tion (e.g., the machine architecture, or the window sys‐
96 tem in use) to determine whether or not the mailcap line
97 applies. It specifies a program to be run to test some
98 condition. The semantics of execution and of the value
99 returned by the test program are operating system depen‐
100 dent. If the test fails, a subsequent mailcap entry
101 should be sought. Multiple test fields are not permitted
102 - since a test can call a program, it can already be
103 arbitrarily complex.
104 needsterminal
106 The "needsterminal" field indicates that the view-command
107 must be run on an interactive terminal. This is needed to
108 inform window-oriented user agents that an interactive
109 terminal is needed. (The decision is not left exclusively
110 to the view-command because in some circumstances it may
111 not be possible for such programs to tell whether or not
112 they are on interactive terminals.) The needsterminal
113 command should be assumed to apply to the compose and
114 edit commands, too, if they exist. Note that this is NOT
115 a test - it is a requirement for the environment in which
116 the program will be executed, and should typically cause
117 the creation of a terminal window when not executed on
118 either a real terminal or a terminal window.
119 copiousoutput
121 The "copiousoutput" field indicates that the output from
122 the view-command will be an extended stream of output,
123 and is to be interpreted as advice to the UA (User Agent
124 mail-reading program) that the output should be either
125 paged or made scroll-able. Note that it is probably a
126 mistake if needsterminal and copiousoutput are both spec‐
127 ified.
128 description
130 The "description" field simply provides a textual
131 description, optionally quoted, that describes the type
132 of data, to be used optionally by mail readers that wish
133 to describe the data before offering to display it.
134 textualnewlines
136 The "textualnewlines" field, if set to any non-zero
137 value, indicates that this type of data is line-oriented
138 and that, if encoded in base64, all newlines should be
139 converted to canonical form (CRLF) before encoding, and
140 will be in that form after decoding. In general, this
141 field is needed only if there is line-oriented data of
142 some type other than text/* or non-line- oriented data
143 that is a subtype of text.
144 x11-bitmap
146 The "x11-bitmap" field names a file, in X11 bitmap (xbm)
147 format, which points to an appropriate icon to be used to
148 visually denote the presence of this kind of data.
149 nametemplate
151 The "nametemplate" field gives a filename format, in
152 which %s will be replaced by a short unique string to
153 give the name of the temporary file to be passed to the
154 viewing command. This is only expected to be relevant in
155 environments where filename extensions are meaningful,
156 e.g., one could specify that a GIF file being passed to a
157 gif viewer should have a name ending in ".gif" by using
158 "nametemplate=%s.gif"
159 tin(1) currently only respects the "test", "description", "name‐
161 template" and partly the "needsterminal" flags, all other flags
162 are internally ignored. It also can't handle the "%F" and "%n"
163 expansions yet.
164 Example:
166 # mailcap file example
167 image/*;\
168 xv -8 -geometry +0 '%s';\
169 description=%{name} %t-Image;\
170 test=test "$DISPLAY" != "";\
171 nametemplate=%s.IMAGE
172 message/rfc822;\
174 ${PAGER:-"more"} '%s';\
175 edit=${EDITOR:-"vi"} '%s';\
176 compose=${EDITOR:-"vi"} '%s';\
177 print=a2ps '%s';\
178 needsterminal
179 /etc/nntpserver
181 default NNTP-server to read news from if not reading from the
183 local spool. '-g server', $NNTPSERVER have higher priority (in
184 that order), the default server given at compile time has lower
185 priority.
186 ${TIN_HOMEDIR:-"$HOME"}/.cancelsecret
188 secret to be used for cancel-locks if tin(1) is build with sup‐
190 port for it. An empty secret file disables the cancel-lock cre‐
191 ation in that case. This file should be readable only by the
192 user.
193 ${TIN_HOMEDIR:-"$HOME"}/.mime.types
195 /etc/mime.types
196 /etc/tin/mime.types
197 mime type / filename extension pairs
199 ${TIN_HOMEDIR:-"$HOME"}/.newsauth
201 "nntpserver password [user]" pairs for NNTP servers that require
203 authorization. If the password contains a space or a tab it must
204 be enclosed in double quotes ("). Usernames must not be enclosed
205 in double quotes and thus can't contain spaces or tabs. Any line
206 that starts with "#" is a comment. Blank lines are ignored. This
207 file should be readable only for the user as it contains the
208 user's unencrypted password for reading news!
209 nntpserver
211 full qualified domain name of the news server.
212 password
214 user's unencrypted password for reading news.
215 user username on the news server if it differs from the local
217 login. This field is optional.
218 Example:
220 # sample .newsauth file
221 news.example.org secret
222 news.example.net arcane guest
223 news.example.com "top secret" james.bond@example.com
224 ${TIN_HOMEDIR:-"$HOME"}/.newsrc
226 "newsgroupflag [article[,article | -article]...]" lines.
228 newsgroup
230 the name of the newsgroup.
231 flag a flag indicating if the group is subscribed ':' or not
233 '!'.
234 article
236 range of already read articles from that group; numbers
237 separated by commas with sequential numbers collapsed
238 with hyphens.
239 Example:
241 # sample .newsrc file
242 news.software.b! 1-666,669
243 news.software.nntp: 1-13245,13247,13249
244 news.software.readers: 1-19567,19571-19597
245 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/.oldnewsrc
247 backup of ${TIN_HOMEDIR:-"$HOME"}/.newsrc
249 ${TIN_HOMEDIR:-"$HOME"}/.signature
251 ${TIN_HOMEDIR:-"$HOME"}/.Sig
252 signature
254 ${TIN_HOMEDIR:-"$HOME"}/.sigfixed
256 fixed part of a randomly generated signature
258 ${TIN_HOMEDIR:-"$HOME"}/.tin/.inputhistory
260 history of last used strings
262 ${TIN_INDEX_MAILDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.mail/
264 mailgroups index files
266 ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news${NNTPSERVER:+"-$NNTPSERVER"}/
268 newsgroups index files
270 ${TIN_INDEX_SAVEDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.save/
272 saved newsgroups index files
274 ${TIN_HOMEDIR:-"$HOME"}/.tin/active.mail
276 active file ("mail_group_name maxnum minnum mailspool" quadru‐
278 ples) of user's mailgroups (requires tin(1) to be build with mh-
279 mail-handling support).
280 mail_group_name
282 must be the pathname of the mailbox relative to field #4
283 with / changed to .
284 maxnum just put a large number here, something higher than the
286 highest message in the mailbox
287 minnum put 0 here
289 mailspool
291 path of mail spool directory. This must be the full path‐
292 name to the root of the mail folder area.
293 Example:
295 Mail.inbox 12345 00000 /home/foo
296 Mail.outbox 23456 00000 /home/foo
297 This allows access to the 'inbox' and 'outbox' folders of user
299 foo. They are accessed via /home/foo/Mail/inbox and
300 /home/foo/Mail/outbox
301 ${TIN_HOMEDIR:-"$HOME"}/.tin/active.save
303 active file of user's saved newsgroups, used by tin -R.
305 /etc/tin/attributes
307 ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes
308 The group attributes files may be used to override some global
310 settings from ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc on a per group
311 basis. Order is important as last match counts; this allows one
312 to refine attributes for narrowed scopes. Note that the
313 scope=<grouplist> line has to be specified before the attributes
314 are specified for that list and each attribute can only be set
315 once per scope section. All attributes are set to a reasonable
316 default so you only have to specify the attribute that you want
317 to change. All toggle attributes are set by specifying ON/OFF.
318 Otherwise, they function exactly as their global equivalents.
319 The following group attributes are available:
320 scope This changes the list of groups to which the attributes
322 that follow will be applied. See the section NEWSGROUP
323 LISTS & WILDCARDS in tin(1) for the types of pattern that
324 can be used here.
325 add_posted_to_filter
327 Identical to the tinrc variable of the same name
328 advertising
330 Identical to the tinrc variable of the same name
331 alternative_handling
333 Identical to the tinrc variable of the same name
334 ask_for_metamail
336 Identical to the tinrc variable of the same name
337 auto_cc_bcc
339 Identical to the tinrc variable of the same name
340 auto_list_thread
342 Identical to the tinrc variable of the same name
343 auto_save
345 Identical to the tinrc variable of the same name
346 auto_select
348 Automatically perform the GroupMarkUnselArtRead ('X')
349 command after entering the group.
350 batch_save
352 Can be used to override the global setting in tinrc on a
353 per group basis. For more information read section AUTO‐
354 MATIC MAILING AND SAVING NEW NEWS in tin(1).
355 date_format
357 Identical to the tinrc variable of the same name
358 delete_tmp_files
360 If this is set to ON, then saved article files that have
361 been post-processed will be automatically deleted, other‐
362 wise the user will be asked whether to delete the post-
363 processed files. Automatic processing of marked articles
364 using GroupAutoSave ('S') will suppress prompting.
365 editor_format
367 Identical to the tinrc variable of the same name
368 extquote_handling
370 Identical to the tinrc variable of the same name
371 fcc Mailbox to save sent mails. The format of the mailbox is
373 controlled via the tinrc mailbox_format variable.
374 followup_to
376 Set ''Followup-To:'' header to the specified group(s).
377 from Identical to the tinrc variable mail_address
379 group_catchup_on_exit
381 Identical to the tinrc variable of the same name
382 group_format
384 Identical to the tinrc variable of the same name
385 mail_8bit_header
387 Identical to the tinrc variable of the same name
388 mail_mime_encoding
390 Identical to the tinrc variable of the same name
391 maildir
393 Identical to the tinrc variable of the same name
394 mailing_list
396 Used when a group is a mailing list. All responses to the
397 group will be directed to this email address instead
398 mark_ignore_tags
400 Identical to the tinrc variable of the same name
401 mark_saved_read
403 Identical to the tinrc variable of the same name
404 mime_forward
406 Determines whether usenet articles are forwarded as
407 attachment or inline. When set to OFF, the forwarded
408 article will be included in the body of the mail, while
409 setting this variable to ON will cause the article to be
410 attached as a separate MIME part. Enabling mime_forward
411 is particularly useful for articles consisting of multi‐
412 ple MIME parts such as PGP/MIME signed messages or being
413 encoded in a different character set than your local one.
414 It is also useful if the receiver should be able to oper‐
415 ate on the entire forwarded article (i.e., view or save
416 it without your comments). On the other hand, if you want
417 to forward only some parts of the article or to insert
418 'inline' annotations, you might want to disable this
419 option. Currently mime_forward is forced if the article
420 to be attached is a multipart MIME article, this may
421 change in a future version. Please note that for this
422 option to have effect, the tinrc variable interac‐
423 tive_mailer has to be set to 0 (which is the default).
424 mime_types_to_save
426 A comma separated list of MIME major/minor Content-Types
427 that will be saved when using the view/save and
428 save/autosave features. A single * can be used to wild‐
429 card the major and/or minor type and a ! as the first
430 character in an entry will negate it, eg:
431 image/*,!image/bmp,!text/html. Default is */*
432 news_headers_to_display
434 Identical to the tinrc variable of the same name
435 news_headers_to_not_display
437 Identical to the tinrc variable of the same name
438 news_quote_format
440 Identical to the tinrc variable of the same name
441 organization
443 This can be used to set the article header field ''Orga‐
444 nization:''. It overrides the setting (if any) of organi‐
445 zation in /etc/tin/tin.defaults and $ORGANIZATION (or
446 $NEWSORG on Apollo DomainOS). Note that some news servers
447 might still overwrite the ''Organization:'' header.
448 pos_first_unread
450 Identical to the tinrc variable of the same name
451 post_8bit_header
453 Identical to the tinrc variable of the same name
454 post_mime_encoding
456 Identical to the tinrc variable of the same name
457 post_process_type
459 Identical to the tinrc variable of the same name
460 post_process_view
462 Identical to the tinrc variable of the same name
463 print_header
465 Identical to the tinrc variable of the same name
466 process_only_unread
468 Identical to the tinrc variable of the same name
469 prompt_followupto
471 Identical to the tinrc variable of the same name
472 quote_chars
474 Identical to the tinrc variable of the same name
475 savedir
477 Identical to the tinrc variable of the same name
478 savefile
480 show_author
482 Identical to the tinrc variable of the same name
483 show_info
485 Identical to the tinrc variable of the same name
486 show_only_unread_arts
488 Identical to the tinrc variable of the same name
489 show_signatures
491 Identical to the tinrc variable of the same name
492 sigdashes
494 Identical to the tinrc variable of the same name
495 sigfile
497 Identical to the tinrc variable of the same name
498 signature_repost
500 Identical to the tinrc variable of the same name
501 sort_article_type
503 Identical to the tinrc variable sort_article_type
504 sort_threads_type
506 Identical to the tinrc variable of the same name
507 start_editor_offset
509 Identical to the tinrc variable of the same name
510 tex2iso_conv
512 Identical to the tinrc variable of the same name
513 thread_articles
515 Identical to the tinrc variable of the same name
516 thread_catchup_on_exit
518 Identical to the tinrc variable of the same name
519 thread_format
521 Identical to the tinrc variable of the same name
522 thread_perc
524 Identical to the tinrc variable of the same name
525 trim_article_body
527 Identical to the tinrc variable of the same name
528 verbatim_handling
530 Identical to the tinrc variable of the same name
531 wrap_on_next_unread
533 Identical to the tinrc variable of the same name
534 x_body A piece of text that will be added at the start of a mes‐
536 sage body. If this string starts with a / or ~ then it is
537 assumed to be the name of a file containing the text to
538 insert.
539 x_comment_to
541 Insert ''X-Comment-To:'' header, this is only useful in
542 FIDO groups.
543 x_headers
545 A string including header-name and the contents of the
546 header that will be automatically added when posting. If
547 the string starts with a / or ~ then it is assumed to be
548 the name of a file containing the header and its content
549 to be inserted. If the string starts with a ! then what
550 follows is assumed to be the path to a program to be exe‐
551 cuted to generate the header and its content.
552 quick_kill_scope
554 A comma-separated list of newsgroup patterns (wildmat-
555 style) to which groups the filter rule added by QuickFil‐
556 terKill will be applied. If unset the default from the
557 tinrc variable default_filter_kill_global will be used.
558 quick_kill_expire
560 Identical to the tinrc variable default_fil‐
561 ter_kill_expire
562 quick_kill_case
564 Identical to the tinrc variable default_filter_kill_case
565 quick_kill_header
567 Identical to the tinrc variable default_fil‐
568 ter_kill_header
569 quick_select_scope
571 A comma-separated list of newsgroup patterns (wildmat-
572 style) to which groups the filter rule added by QuickFil‐
573 terSelect will be applied. If unset the default from the
574 tinrc variable default_filter_select_global will be used.
575 quick_select_expire
577 Identical to the tinrc variable default_fil‐
578 ter_select_expire
579 quick_select_case
581 Identical to the tinrc variable default_fil‐
582 ter_select_case
583 quick_select_header
585 Identical to the tinrc variable default_fil‐
586 ter_select_header
587 ispell Path and options for ispell(1)-like spell-checker, e.g.
589 "aspell --mode=email --dont-backup check"
590 mm_network_charset
592 Identical to the tinrc variable of the same name
593 undeclared_charset
595 Assume (broken) articles without MIME charset declaration
596 have this charset - default is US-ASCII. This attribute
597 works only on systems with working iconv(3), others might
598 have to compile tin(1) with --dis‐
599 able-mime-strict-charset.
600 Example:
602 # include extra headers
603 # assume ISO-8859-1 as charset if no charset is declared
604 scope=*
605 x_headers=~/.tin/headers
606 undeclared_charset=ISO-8859-1
607 # in *sources* set post process type to shar only
609 scope=*sources*
610 post_process_type=1
611 # in *binaries* turn on full post processing,
613 # remove tmp files and set Followup-To: poster
614 scope=*binaries*
615 post_process_type=2
616 delete_tmp_files=ON
617 followup_to=poster
618 # in fido.* newsgroups change quote_chars
620 # and add X-Comment-To: line
621 scope=fido.*
622 quote_chars=%s>_
623 x_comment_to=ON
624 # in *.test newsgroups, don't append signature
626 # and preset Subject
627 scope=*.test
628 sigfile=--none
629 x_headers=Subject: test - ignore - no reply
630 # assume ISO-2022-JP-2 as charset
632 scope=fj.*,japan.*
633 undeclared_charset=ISO-2022-JP-2
634 ${TIN_HOMEDIR:-"$HOME"}/.tin/filter
636 The filter file is used to assign scores to certain articles.
638 Based on the score an article can be filtered out (hidden) or
639 marked hot. Empty lines or lines beginning with a '#' are
640 ignored.
641 comment
643 Every entry (rule) in the filter file might get a com‐
644 ment. Multiple lines are allowed (but only for comments
645 yet). Every line must start with the "comment=" keyword.
646 Comments must appear first in the rule. Comment lines
647 placed within a rule will be moved to the begin of the
648 next rule. This might be changed in the future. Don't use
649 '#' to mark comments as those lines are ignored and your
650 comments will get lost on the next write of the file.
651 group A comma-separated list of newsgroup patterns (wildmat-
653 style) to which groups the filter rule will be applied.
654 This line is mandatory!
655 case 0=case-sensitive, 1=case-insensitive
657 score Score value of the rule; can also be one of the magic
659 words "kill" or "hot".
660 subj Match against ''Subject:''
662 from Match against ''From:''. tin(1) converts the contents of
664 the ''From:'' header to an old style e-mail address, e.g.
665 ''some@body.example (John Doe)'' instead of ''John Doe
666 <some@body.example>'', before trying to match the pat‐
667 terns in the filter rule.
668 msgid Match against ''Message-ID:'' and full ''References:''
670 msgid_last
672 Match against ''Message-ID:'' and last ''References:''
673 entry only
674 msgid_only
676 Match against ''Message-ID:''
677 refs_only
679 Match against ''References:''
680 lines Match against ''Lines:'', <num matches less than, >num
682 matches more than.
683 gnksa Match against ''From:'' address parser return codes.
685 xref Match against ''Xref:'' line. Before any matching is done
687 the line is turned into the same format ''Newsgroups:''
688 has that is it is turned into a comma separated newsgroup
689 list with all other information (i.e. the article
690 counter) removed.
691 time time_t value when rule expires
693 Example:
695 comment=mark all articles about tin, rtin,
696 comment=tind, ktin or cdtin as hot
697 group=*
698 case=1
699 score=hot
700 subj=\b(cd|[rk]?)?tin(d|pre)?[-.0-9]*\b
701 /etc/tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
703 ${TIN_HOMEDIR:-"$HOME"}/.tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
704 Keymap-file, containing "keyname value [value]" pairs separated
706 by spaces or tabs. Below is a list of all rebindable keynames
707 and their defaults. If a keyname is bound to NULL it is unas‐
708 signed.
709 ShellEscape !
711 SetRange #
712 LastPage $
713 ToggleColor &
714 LastViewed -
715 SearchRepeat \
716 SearchSubjF /
717 SearchSubjB ?
718 SearchAuthB A
719 SearchBody B
720 CatchupNextUnread C
721 EditFilter E
722 ToggleHelpDisplay H
723 ToggleInverseVideo I
724 LookupMessage L
725 OptionMenu M
726 Postponed O ^O
727 QuitTin Q
728 BugReport R
729 DisplayPostHist W
730 MarkThrUnread Z
731 FirstPage ^
732 SearchAuthF a
733 Catchup c
734 Help h
735 ToggleInfoLastLine i
736 Down j ^N
737 Up k ^P
738 Print o
739 Quit q
740 Version v
741 Post w
742 MarkArtUnread z
743 QuickFilterSelect [
744 QuickFilterKill ]
745 Pipe |
746 ScrollUp <
747 ScrollDown >
748 PageUp b ^B ^U
749 PageDown ^D ^F SPACE
750 RedrawScr ^L
751 Postponed ^O
752 MenuFilterSelect ^A
753 MenuFilterKill ^K
754 MarkFeedRead ^X
755 MarkFeedUnread ^W
756 AttachSelect ^J ^M
758 AttachPipe p
759 AttachSave s
760 AttachTag t
761 AttachUntag U
762 AttachTagPattern =
763 AttachToggleTagged @
764 ConfigToggleAttrib TAB
766 ConfigSelect ^J ^M
767 ConfigLastPage G
768 ConfigNoSave Q
769 ConfigScopeMenu S
770 ConfigFirstPage g
771 ConfigResetAttrib r
772 FeedTag T
774 FeedArt a
775 FeedHot h
776 FeedPat p
777 FeedRepost r
778 FeedSupersede s
779 FeedThd t
780 FilterEdit e
782 FilterSave s
783 GroupNextUnreadArtOrGrp TAB
785 GroupReadBasenote ^J ^M
786 GroupSelThd *
787 GroupDoAutoSel +
788 GroupToggleThdSel .
789 GroupSelThdIfUnreadSelected ;
790 GroupSelPattern =
791 GroupReverseSel @
792 GroupCancel D
793 GroupToggleGetartLimit G
794 GroupMarkThdRead K
795 GroupNextUnreadArt N
796 GroupPrevUnreadArt P
797 GroupAutoSave S
798 GroupTagParts T
799 GroupUntag U
800 GroupMarkUnselArtRead X
801 GroupToggleSubjDisplay d
802 GroupGoto g
803 GroupListThd l
804 GroupMail m
805 GroupNextGroup n
806 GroupPrevGroup p
807 GroupToggleReadUnread r
808 GroupSave s
809 GroupTag t
810 GroupToggleThreading u
811 GroupRepost x
812 GroupUndoSel ~
813 HelpLastPage G
815 HelpFirstPage g
816 PageReplyQuoteHeaders ^E
818 PagePGPCheckArticle ^G
819 PageToggleRaw ^H
820 PageNextUnread TAB
821 PageNextThd ^J ^M
822 PageToggleTabs ^T
823 PageFollowupQuoteHeaders ^W
824 PageToggleTex2iso "
825 PageToggleAllHeaders *
826 PageToggleRot %
827 PageToggleUue (
828 PageReveal )
829 PageSkipIncludedText :
830 PageTopThd <
831 PageBotThd >
832 PageCancel D
833 PageFollowup F
834 PageLastPage G
835 PageKillThd K
836 PageNextUnreadArt N
837 PagePrevUnreadArt P
838 PageReply R
839 PageAutoSave S
840 PageGroupSel T
841 PageViewUrl U
842 PageViewAttach V
843 PageToggleHighlight _
844 PageEditArticle e
845 PageFollowupQuote f
846 PageFirstPage g
847 PageListThd l
848 PageMail m
849 PageNextArt n
850 PagePrevArt p
851 PageReplyQuote r
852 PageSave s
853 PageTag t
854 PageGotoParent u
855 PageRepost x
856 PgpEncSign b
858 PgpEncrypt e
859 PgpIncludekey i
860 PgpSign s
861 PostAbort a
863 PostContinue c
864 PostCancel d
865 PostEdit e
866 PostPGP g
867 PostIspell i
868 PostIgnore i
869 PostMail m
870 PostPostpone o
871 PostPost p y
872 PostSupersede s
873 PostSend s y
874 PostponeOverride Y
876 PostponeAll A
877 PromptYes y Y
879 PromptNo n N
880 SaveAppendFile a
882 SaveOverwriteFile o
883 PProcNone n
885 PProcShar s
886 PProcYes y
887 SelectEnterNextUnreadGrp TAB n
889 SelectReadGrp ^J ^M
890 SelectResetNewsrc ^R
891 SelectSortActive .
892 SelectNextUnreadGrp N
893 SelectSubscribePat S
894 SelectUnsubscribePat U
895 SelectQuitNoWrite X
896 SelectSyncWithActive Y
897 SelectToggleDescriptions d
898 SelectGoto g
899 SelectMoveGrp m
900 SelectToggleReadDisplay r
901 SelectSubscribe s
902 SelectUnsubscribe u
903 SelectYankActive y
904 SelectMarkGrpUnread z Z
905 ScopeSelect ^J ^M
907 ScopeEditAttributesFile E
908 ScopeAdd a
909 ScopeDelete d
910 ScopeMove m
911 ScopeRename r
912 ThreadReadNextArtOrThread TAB
914 ThreadReadArt ^J ^M
915 ThreadSelArt *
916 ThreadToggleArtSel .
917 ThreadReverseSel @
918 ThreadCancel D
919 ThreadMarkArtRead K
920 ThreadAutoSave S
921 ThreadUntag U
922 ThreadToggleSubjDisplay d
923 ThreadMail m
924 ThreadSave s
925 ThreadTag t
926 ThreadUndoSel ~
927 UrlSelect ^J ^M
929 ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups
931 This file provides short descriptions of each mailgroup.
933 (requires tin(1) to be build with mh-mail-handling support).
934 Each line consist of two tab-separated fields "mailgroupname
935 one-line description".
936 mailgroupname
938 is the name of the newsgroup
939 description
941 is a short single-line description of the group
942 ${TIN_HOMEDIR:-"$HOME"}/.tin/newsrctable
944 "nntpserver newsrc [shortname [...]]" pairs to use with the
946 ''-g'' command-line switch.
947 nntpserver
949 full qualified domain name of the news server.
950 newsrc related newsrc.
952 shortname
954 nickname(s) for the nntpserver.
955 Example:
957 # sample newsrctable file
958 news.tin.org .newsrc-tin.org tinorg
959 news.example.org /tmp/nrc-ex example ex
960 ${TIN_HOMEDIR:-"$HOME"}/.tin/posted
962 posting history
964 ${TIN_HOMEDIR:-"$HOME"}/Mail/posted
966 Copy of all posted articles in mbox(5) format. The filename can
968 be changed by setting posted_articles_file.
969 ${TIN_HOMEDIR:-"$HOME"}/.tin/postponed.articles
971 Pool of postponed articles. This file is in mbox(5) format.
973 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/newsgroups
975 This file a copy of the servers newsgroups file which provides
977 short descriptions of each newsgroup. It is automatically
978 updated on startup except when using the ''-X''or ''-q'' com‐
979 mand-line option and an old copy exists. Each line consist of
980 two tab-separated fields "group.name one-line
981 description".
982 group.name
984 is the name of the newsgroup
985 one-line description
987 is a short single-line description of the group
988 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/serverrc
990 File to store $NNTPSERVER and $NNTPPORT related data via a list
992 of "variable=value" pairs. Currently there are only two vari‐
993 ables, both are not meant to be changed by the user.
994 version
996 Internal version number.
997 last_newnews
999 Internal timestamp used by tin(1) to keep track of new
1000 newsgroups on the server.
1001 /etc/tin/tinrc
1003 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc
1004 At startup, tin(1) reads in the configuration file. This con‐
1006 tains a list of "variable=value" pairs that can be used to con‐
1007 figure the way tin(1) works. If it exists, the global configura‐
1008 tion file, ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc is read first. After
1009 that, the user's own configuration file ${TIN_HOME‐
1010 DIR:-"$HOME"}/.tin/tinrc is read. The global file is useful for
1011 distributing system-wide defaults to new users who have no pri‐
1012 vate tinrc yet (see also /etc/tin/tin.defaults).
1013 abbreviate_groupname
1015 If ON abbreviate long newsgroup names at group selection
1016 level and article level (if necessary) like this:
1017 news.software.readers -> n.software.readers -> n.s.read‐
1018 ers -> n.s.r. Default is OFF.
1019 add_posted_to_filter
1021 If ON add posted articles which start a new thread to
1022 filter for highlighting follow-ups. Default is ON.
1023 advertising
1025 Turn ON advertising in header (''User-Agent:''). Default
1026 is ON.
1027 alternative_handling
1029 If ON strip multipart/alternative messages automatically.
1030 Default is ON.
1031 art_marked_deleted
1033 The character used to show that an article was deleted.
1034 Default is 'D'.
1035 art_marked_inrange
1037 The character used to show that an article is in a range.
1038 Default is '#'.
1039 art_marked_return
1041 The character used to show that an article will return as
1042 an unread article when the group is next entered. Default
1043 is '-'.
1044 art_marked_selected
1046 The character used to show that an article/thread is
1047 auto-selected (hot). Default is '*'.
1048 art_marked_recent
1050 The character used to show that an article/thread is
1051 recent (not older than X days). See also recent_time.
1052 Default is 'o'.
1053 art_marked_unread
1055 The character used to show that an article has not been
1056 read. Default is '+'.
1057 art_marked_read
1059 The character used to show that an article was read.
1060 Default is ' '.
1061 art_marked_killed
1063 The character used to show that an article was killed.
1064 Default is 'K'. kill_level must be set accordingly.
1065 art_marked_read_selected
1067 The character used to show that an article was hot before
1068 it was read. Default is ':'. kill_level must be set
1069 accordingly.
1070 Ask before using MIME viewer (ask_for_metamail)
1072 If ON tin(1) will ask before using a MIME viewer (meta‐
1073 mail_prog) to display MIME messages. This only occurs if
1074 a MIME viewer is set. Default is OFF.
1075 auto_cc_bcc
1077 Automatically put your name in the ''Cc:'' and/or
1078 ''Bcc:'' field when mailing an article. Default is No.
1079 auto_list_thread
1081 If ON automatically list thread when entering it using
1082 right arrow key. Default is ON.
1083 auto_reconnect
1085 Reconnect to server automatically. Default is OFF.
1086 auto_save
1088 If ON articles/threads with ''Archive-name:'' in header
1089 will be automatically saved with the Archive-name &
1090 part/patch no and post processed if post_process_type is
1091 set to something other than 'No'. Default is OFF.
1092 batch_save
1094 If set ON articles/threads will be saved in batch mode
1095 when save ''-S'' or mail ''-M, -N'' is specified on the
1096 command line. Default is ON.
1097 beginner_level
1099 If set ON a mini menu of the most useful commands will be
1100 displayed at the bottom of the screen for each level.
1101 Also a short posting etiquette will be displayed after
1102 composing an article. Default is ON.
1103 cache_overview_files
1105 If ON, create local copies of NNTP overview files. This
1106 can be used to considerably speed up accessing large
1107 groups when using a slow connection. Default is OFF.
1108 cancel_lock_algo
1110 Use this hash algorithm for cancel-locks. Only available
1111 when build with cancel-lock support. none disables the
1112 generation of cancel-locks. Valid values are none, sha1,
1113 sha256 and sha512. Default is sha1.
1114 catchup_read_groups
1116 If set ON the user is asked when quitting if all groups
1117 read during the current session should be marked read.
1118 Default is OFF.
1119 col_back
1121 Standard background color
1122 col_extquote
1124 Color of quoted text from external sources
1125 col_from
1127 Color of sender (From:)
1128 col_head
1130 Color of header-lines
1131 col_help
1133 Color of help pages
1134 col_invers_bg
1136 Color of background for inverse text
1137 col_invers_fg
1139 Color of foreground for inverse text
1140 col_markdash
1142 Color of words emphasized like _this_. See also
1143 word_h_display_marks and word_highlight.
1144 col_markslash
1146 Color of words emphasized like /this/. See also
1147 word_h_display_marks and word_highlight.
1148 col_markstar
1150 Color of words emphasized like *this*. See also
1151 word_h_display_marks and word_highlight.
1152 col_markstroke
1154 Color of words emphasized like -this-. See also
1155 word_h_display_marks and word_highlight.
1156 col_minihelp
1158 Color of mini help menu
1159 col_newsheaders
1161 Color of actual news header fields
1162 col_normal
1164 Standard foreground color
1165 col_quote
1167 Color of quoted lines
1168 col_quote2
1170 Color of twice quoted lines
1171 col_quote3
1173 Color of >=3 times quoted lines
1174 col_response
1176 Color of response counter. This is the text that says
1177 "Response x of y" in the article viewer.
1178 col_signature
1180 Color of signatures
1181 col_urls
1183 Color of urls highlight
1184 col_verbatim
1186 Color of verbatim blocks
1187 col_subject
1189 Color of article subject
1190 col_text
1192 Color of text-lines
1193 col_title
1195 Color of help/mail sign
1196 confirm_choice
1198 tin(1) can ask for manual confirmation to protect the
1199 user. Available choices:
1200 commands: Ask for confirmation before executing cer‐
1201 tain dangerous commands (e.g., Catchup ('c')). Com‐
1202 mands that this affects are marked in this manual
1203 with '[after confirmation]'.
1204 quit: You'll be asked to confirm that you wish to
1206 exit tin(1) when you use the Quit ('q') command.
1207 select: Ask for confirmation before marking all not
1209 selected (with GroupMarkUnselArtRead ('X') command)
1210 articles as read.
1211 Default is commands & quit.
1212 date_format
1214 Format string used for date representation. A description
1215 of the different format options can be found at
1216 strftime(3). tin(1) uses strftime(3) when available and
1217 supports most format options in his fallback code.
1218 Default is "%a, %d %b %Y %H:%M:%S".
1219 default_art_search
1221 default_author_search
1223 default_config_search
1225 The last article/author/config option that was searched
1226 for.
1227 default_filter_days
1229 Default is 28.
1230 default_filter_kill_case
1232 Default for quick (1 key) kill filter case. ON = filter
1233 case sensitive, OFF = ignore case. Default is OFF.
1234 default_filter_kill_expire
1236 Default for quick (1 key) kill filter expire. ON = limit
1237 to default_filter_days, OFF = don't ever expire. Default
1238 is OFF.
1239 default_filter_kill_global
1241 Default for quick (1 key) kill filter global. ON=apply
1242 to all groups, OFF=apply to current group. Default is ON.
1243 default_filter_kill_header
1245 Default for quick (1 key) kill filter header.
1246 0 ''Subject:'' (case sensitive)
1247 1 ''Subject:'' (ignore case)
1248 2 ''From:'' (case sensitive)
1249 3 ''From:'' (ignore case)
1250 4 ''Message-ID:'' & full ''References:'' line
1251 5 ''Message-ID:'' & last ''References:'' entry only
1252 6 ''Message-ID:'' entry only
1253 7 ''Lines:''
1254 default_filter_select_case
1256 Default for quick (1 key) auto-selection filter case.
1257 ON=filter case sensitive, OFF=ignore case. Default is
1258 OFF.
1259 default_filter_select_expire
1261 Default for quick (1 key) auto-selection filter expire.
1262 ON = limit to default_filter_days, OFF = don't ever
1263 expire. Default is OFF.
1264 default_filter_select_global
1266 Default for quick (1 key) auto-selection filter global.
1267 ON=apply to all groups, OFF=apply to current group.
1268 Default is ON.
1269 default_filter_select_header
1271 Default for quick (1 key) auto-selection filter header.
1272 0 ''Subject:'' (case sensitive)
1273 1 ''Subject:'' (ignore case)
1274 2 ''From:'' (case sensitive)
1275 3 ''From:'' (ignore case)
1276 4 ''Message-ID:'' & full ''References:'' line
1277 5 ''Message-ID:'' & last ''References:'' entry only
1278 6 ''Message-ID:'' entry only
1279 7 ''Lines:''
1280 default_goto_group
1282 default_group_search
1284 default_mail_address
1286 default_move_group
1288 default_pattern
1290 default_pipe_command
1292 default_post_newsgroups
1294 default_post_subject
1296 default_range_group
1298 default_range_select
1300 default_range_thread
1302 default_repost_group
1304 default_save_file
1306 default_save_mode
1308 default_select_pattern
1310 default_shell_command
1312 default_subject_search
1314 draw_arrow
1316 Allows groups/articles to be selected by an arrow '->' if
1317 set ON or by an highlighted bar if set OFF. Default is
1318 OFF.
1319 editor_format
1321 The format string used to create the editor start command
1322 with parameters. Default is '%E +%N %F' with %E=Editor,
1323 %N=Linenumber and %F=Filename (e.g., /bin/vi +7 .arti‐
1324 cle).
1325 extquote_handling
1327 If ON quotes from external sources will be detected.
1328 Default is OFF.
1329 extquote_regex
1331 A regular expression that will be applied when reading
1332 articles. All matching lines are shown in col_extquote.
1333 If extquote_regex is blank, then %tin(1) uses a built-in
1334 default.
1335 force_screen_redraw
1337 Specifies whether a screen redraw should always be done
1338 after certain external commands. Default is OFF.
1339 getart_limit
1341 If getart_limit is > 0 not more than the last
1342 getart_limit articles/group are fetched from the server.
1343 If getart_limit is < 0 tin(1) will start fetching arti‐
1344 cles from your first unread minus absolute value of
1345 getart_limit. Default is 0, which means no limit.
1346 goto_next_unread
1348 Which keys %tin(1) should accept to jump to the next
1349 unread article. Possible is any combination of PageDown
1350 and PageNextUnread. When PageDown is set %tin(1) jumps
1351 to the next article at the end of the current one. When
1352 PageNextUnread is set %tin(1) jumps immediately to the
1353 next article when PageNextUnread ('<TAB>') is pressed.
1354 Default is PageNextUnread.
1355 group_catchup_on_exit
1357 If ON catchup group when leaving with the left arrow key.
1358 Default is ON.
1359 group_format
1361 The format string used for the Group level. Default is
1362 "%n %m %R %L %s %F". The following substitutions are
1363 supported:
1364 %D date
1365 %F from, name and/or address
1366 %I initials
1367 %L line count
1368 %M message-id
1369 %R number of responses in thread
1370 %S score
1371 %m article marks
1372 %n current thread number
1373 %s subject
1374 %% %
1375 hide_uue
1377 If set to 'No' then raw uuencoded data is displayed. If
1378 set to 'Yes' then sections of uuencoded data will be
1379 shown with a single tag line showing the size and file‐
1380 name (much the same as a MIME attachment). If set to
1381 'Hide all' then any line that looks like uuencoded data
1382 will be folded into a tag line. This is useful when uuen‐
1383 coded data is split across more than one article but can
1384 also lead to false positives. This setting can also be
1385 toggled in the article viewer. Default is 'No'.
1386 inews_prog
1388 Path, name and options of external inews(1). If you are
1389 reading via NNTP the default value is "--internal" (use
1390 built-in NNTP inews), else it is "inews -h". The article
1391 is passed to inews_prog on STDIN via '< article'.
1392 info_in_last_line
1394 If ON, show current group description or article subject
1395 in the last line (not in the pager and global menu) -
1396 ToggleInfoLastLine ('i') toggles setting. This facility
1397 is useful as the full width of the screen is available to
1398 display long subjects. Default is OFF.
1399 interactive_mailer
1401 If greater than 0 your mailreader will be invoked earlier
1402 for reply so you can use more of its features (e.g. MIME,
1403 pgp, ...). 1 means include headers, 2 means don't include
1404 headers (old use_mailreader_i=ON option). 0 turns off
1405 usage. This option has to suit mailer_format. Default is
1406 0.
1407 inverse_okay
1409 If ON use inverse video for page headers and URL high‐
1410 lighting. Default is ON.
1411 keep_dead_articles
1413 If ON keep all failed postings in ${TIN_HOME‐
1414 DIR:-"$HOME"}/dead.articles besides keeping the last
1415 failed posting in ${TIN_HOMEDIR:-"$HOME"}/dead.article.
1416 Default is ON.
1417 kill_level
1419 This option controls the processing and display of arti‐
1420 cles that are killed. There are 3 options, default is 0
1421 (Kill only unread arts).
1422 0 Kill only unread arts is the 'traditional' behavior
1424 of tin(1). Only unread articles are killed once
1425 only by marking them read. As filtering only hap‐
1426 pens on unread articles with kill_level set to 0,
1427 art_marked_killed and art_marked_read_selected are
1428 only shown once. When you reenter the group the
1429 mark will be gone.
1430 1 Kill all arts & show with K will process all arti‐
1432 cles in the group and therefore there is a process‐
1433 ing overhead when using this option. Killed arti‐
1434 cles are threaded as normal but they will be marked
1435 with art_marked_killed.
1436 2 Kill all arts and never show will process all arti‐
1438 cles in the group and therefore there is a process‐
1439 ing overhead when using this option. Killed arti‐
1440 cles simply does not get displayed at all.
1441 mail_8bit_header
1443 Allows 8bit characters unencoded in the header of mail
1444 message. Default is OFF. Turning it ON is effective only
1445 if mail_mime_encoding is also set to 8bit. Leaving it OFF
1446 is safe for most users and compliant to Internet Mail
1447 Standard (RFC5322 and RFC2047). Default is OFF.
1448 mail_address
1450 User's mail address (and full name), if not user‐
1451 name@host. This is used when creating articles, sending
1452 mail and when pgp(1) signing.
1453 mail_mime_encoding
1455 MIME encoding of the body in mail message, if necessary
1456 (8bit, base64, quoted-printable, 7bit). Default is
1457 quoted-printable.
1458 mail_quote_format
1460 Format of quote line when replying (via mail) to an arti‐
1461 cle (%A=Address, %D=Date, %F=Fullname+Address, %G=Group‐
1462 name, %M=Message-ID, %N=Fullname, %C=Firstname, %I=Ini‐
1463 tials). Default is "In article %M you wrote:"
1464 mailbox_format
1466 Select one of the following mailbox-formats: MBOXO
1467 (default, except on SCO), MBOXRD or MMDF (default on
1468 SCO). See mbox(5) and RFC4155 for more details on MBOXO
1469 and MBOXRD and mmdf(5) for more details about MMDF.
1470 maildir
1472 The directory where articles/threads are to be saved in
1473 mbox(5) format. This feature is mainly for use with the
1474 elm(1) mail program. It allows the user to save arti‐
1475 cles/threads/groups simply by giving '=' as the filename
1476 to save to. Default is ${TIN_HOMEDIR:-"$HOME"}/Mail.
1477 mailer_format
1479 The format string used to create the mailer command with
1480 parameters that is used for mailing articles to other
1481 people. Default is '%M "%T" < %F' (e.g., /bin/mail "iain"
1482 < .article). The flexible format allows other mailers
1483 with different command line parameters to be used such as
1484 sendmail -oem -t < %F
1485 elm -s "%S" "%T" < "%F"
1486 claws-mail --compose "mailto:%T?subject=%S&insert=%F"
1487 interactive_mailer must be set adequate. The following
1488 substitutions are supported:
1489 %F filename
1490 %M default_mailer
1491 %S subject-field
1492 %T to-filed
1493 %U username
1494 %% %
1495 mark_saved_read
1497 If ON mark articles that are saved as read. Default is
1498 ON.
1499 mark_ignore_tags
1501 When this is ON, the GroupMarkThdRead ('K'), Thread‐
1502 MarkArtRead ('K'), MarkThdUnread ('Z') at Group level and
1503 MarkArtUnread ('z') at Thread level functions mark just
1504 the current article or thread, ignoring other tagged,
1505 (un)read articles. When OFF, the same function presents a
1506 menu with choices of the current thread or article, all
1507 tagged, unread articles, or nothing.
1508 metamail_prog
1510 Path, name and options of external metamail(1) program
1511 used to view non-textual parts of articles. To use the
1512 built-in viewer, set to --internal. This is the default
1513 value when metamail(1) is not installed. Leave it blank
1514 if you don't want any automatic viewing of non-textual
1515 attachments. The 'V' command can always be used to manu‐
1516 ally view any attachments. See also ask_for_metamail.
1517 mm_charset
1519 Charset supported locally, which is also used for MIME
1520 header (charset parameter and charset name in header
1521 encoding) in mail and news postings. If
1522 MIME_STRICT_CHARSET is defined at compile time, text in
1523 charset other than the value of this parameter is consid‐
1524 ered not displayable and represented as '?'. Otherwise,
1525 all character sets are regarded as compatible with the
1526 display. If it's not set, the value of the environment
1527 variable $MM_CHARSET is used. US-ASCII or compile-time
1528 default is used in case neither of them is defined. If
1529 your system supports iconv(3), this option is disabled
1530 and you should use mm_network_charset instead.
1531 mm_network_charset
1533 Charset used for posting and MIME headers; replaces
1534 mm_charset. Conversion between mm_network_charset and
1535 local charset (determined via nl_langinfo(3)) is done via
1536 iconv(3), if this function is not available on your sys‐
1537 tem this option is disabled and you have to use
1538 mm_charset instead. mm_network_charset is limited to one
1539 of the following charsets:
1540 US-ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16},
1541 KOI8-{R,U,RU} EUC-{CN,JP,KR,TW}, ISO-2022-{CN,CN-
1542 EXT,JP,JP-1,JP-2}, Big5, UTF-8
1543 Not all values might work on your system, see
1544 iconv_open(3) for more details. If it's not set, the
1545 value of the environment variable $MM_CHARSET is used.
1546 US-ASCII or compile-time default is used in case neither
1547 of them is defined.
1548 mono_markdash
1550 Character attribute of words emphasized like _this_. It
1551 depends on your terminal which attributes are usable. See
1552 also word_h_display_marks and word_highlight.
1553 mono_markslash
1555 Character attribute of words emphasized like /this/. It
1556 depends on your terminal which attributes are usable. See
1557 also word_h_display_marks and word_highlight.
1558 mono_markstar
1560 Character attribute of words emphasized like *this*. It
1561 depends on your terminal which attributes are usable. See
1562 also word_h_display_marks and word_highlight.
1563 mono_markstroke
1565 Character attribute of words emphasized like -this-. It
1566 depends on your terminal which attributes are usable. See
1567 also word_h_display_marks and word_highlight.
1568 newnews
1570 These are internal timers used by tin(1) to keep track of
1571 new newsgroups. Do not change them unless you understand
1572 what they are for.
1573 news_headers_to_display
1575 Which news headers you wish to see. If you want to see
1576 _all_ the headers, place an '*' as this value. This is
1577 the only way a wildcard can be used. If you enter 'X-'
1578 as the value, you will see all headers beginning with
1579 'X-' (like X-Alan or X-Pape). You can list more than one
1580 by delimiting with spaces. Not defining anything turns
1581 off this option.
1582 news_headers_to_not_display
1584 Same as news_headers_to_display except it denotes the
1585 opposite. An example of using both options might be if
1586 you thought 'X-' headers were A Good Thing(tm), but
1587 thought Alan and Pape were miscreants... well then you
1588 would do something like this: news_headers_to_display=X-
1589 news_headers_to_not_display=X-Alan X-Pape Not defining
1590 anything turns off this option.
1591 news_quote_format
1593 Format of quote line when posting/following up an article
1594 (%A=Address, %D=Date, %F=Fullname+Address, %G=Groupname,
1595 %M=Message-ID, %N=Fullname, %C=Firstname, %I=Initials).
1596 Default is "%F wrote:".
1597 nntp_read_timeout_secs
1599 Time in seconds to wait for a response from the server.
1600 Default is 120.
1601 normalization_form
1603 The normalization form which should be used to normalize
1604 unicode input. The possible values are:
1605 0 None: no normalization
1607 1 NFKC: Compatibility Decomposition, followed by
1609 Canonical Composition
1610 2 NFKD: Compatibility Decomposition
1612 3 NFC: Canonical Decomposition, followed by Canonical
1614 Composition
1615 4 NFD: Canonical Decomposition
1617 Some normalization modes are only available if they are sup‐
1618 ported by the library tin(1) uses to do the normalization. NFC
1619 should be used if possible.
1620 pos_first_unread
1622 If ON put cursor at first unread article in group other‐
1623 wise at last article. Default is ON.
1624 post_8bit_header
1626 Allows 8bit characters unencoded in the header of a news
1627 article, if set this also disables the generation of
1628 MIME-headers when they are usually required. Default is
1629 OFF. Only enacted if post_mime_encoding is also set to
1630 8bit. In a number of local hierarchies where 8bit charac‐
1631 ters are used, using unencoded (raw) 8bit characters in
1632 header is acceptable and sometimes even recommended so
1633 that you need to check the convention adopted in the
1634 local hierarchy of your interest to determine what to do
1635 with this and post_mime_encoding.
1636 post_mime_encoding
1638 MIME encoding of the body in news message, if necessary.
1639 (8bit, base64, quoted-printable, 7bit). Default is 8bit,
1640 which leads to no encoding. base64 and quoted-printable
1641 are usually undesired on usenet.
1642 post_process_view
1644 If ON, then tin(1) will start an appropriate viewer pro‐
1645 gram to display any files that were post processed and
1646 uudecoded. The program is determined using the mailcap(5)
1647 file. Default is ON.
1648 post_process_type
1650 This specifies whether to perform post processing on
1651 saved articles. Because the shell archive may contain
1652 commands you may not want to be executed, be careful when
1653 extracting shell archives. The following values are
1654 allowed:
1655 0 No (default), no post processing is done.
1657 1 Shell archives, unpacking of multi-part shar(1)
1659 files only. Because the shell archive may contain
1660 commands you may not want to be executed, be care‐
1661 ful with this option.
1662 2 Yes, binary attachments and data will be decoded
1664 and saved.
1665 posted_articles_file
1667 Keep posted articles in ${TIN_HOME‐
1668 DIR:-"$HOME"}/Mail/posted_articles_file. If no filename
1669 is set then postings will not be saved. Default is
1670 'posted'.
1671 print_header
1673 If ON, then the full article header is sent to the
1674 printer. Otherwise only the ''Subject:'' and ''From:''
1675 fields are output. Default is OFF.
1676 printer
1678 The printer program with options that is to be used to
1679 print articles. The default is lpr(1) for BSD machines
1680 and lp(1) for SysV machines. Printing from tin(1) may
1681 have been disabled by the System Administrator.
1682 process_only_unread
1684 If ON only save/print/pipe/mail unread articles (tagged
1685 articles excepted). Default is OFF.
1686 prompt_followupto
1688 If ON show empty ''Followup-To:'' header when editing an
1689 article. Default is OFF.
1690 quote_chars
1692 The character used in quoting included text to article
1693 followups and mail replies. The '_' character represents
1694 a blank character and is replaced with ' ' when read.
1695 Default is '>_'.
1696 quote_style
1698 This bit coded integer value controls how articles are to
1699 be quoted when following up or replying to them. Any of
1700 the following options can be combined by adding all rele‐
1701 vant values. Default is 5, which means that quote charac‐
1702 ters are compressed and empty lines are quoted.
1703 1 Compress quotes Compress quote characters together
1705 when quoting multiple times (for example, '> > >'
1706 will be turned into '>>>'). This option is on by
1707 default.
1708 2 Quote Signatures This option is off by default.
1710 Signatures are always quoted regardless of this
1711 option when you are viewing an article in raw mode
1712 PageToggleRaw ('^H') and followup or reply to it.
1713 Signatures are never quoted regardless of this
1714 option when show_signatures is off.
1715 4 Quote empty lines This option is on by default.
1717 quote_regex
1719 A regular expression that will be applied when reading
1720 articles. All matching lines are shown in col_quote. If
1721 quote_regex is blank, then tin(1) uses a built-in
1722 default.
1723 quote_regex2
1725 A regular expression that will be applied when reading
1726 articles. All matching lines are shown in col_quote2. If
1727 quote_regex2 is blank, then tin(1) uses a built-in
1728 default.
1729 quote_regex3
1731 A regular expression that will be applied when reading
1732 articles. All matching lines are shown in col_quote3. If
1733 quote_regex3 is blank, then tin(1) uses a built-in
1734 default.
1735 recent_time
1737 If set to 0, this feature is deactivated, otherwise it
1738 means the number of days. Default is 2.
1739 render_bidi
1741 If ON %tin(1) does the rendering of bi-directional text.
1742 If OFF %tin(1) leaves the rendering of bi-directional
1743 text to the terminal. Default is OFF.
1744 reread_active_file_secs
1746 The news ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE‐
1747 FILE:-active} file is reread at regular intervals to show
1748 if any new news has arrived. Default is 1200. Setting
1749 this to 0 will disable this feature.
1750 savedir
1752 Directory where articles/threads are saved. Default is
1753 ${TIN_HOMEDIR:-"$HOME"}/News.
1754 score_limit_kill
1756 If the score of an article is below or equal this value
1757 the article gets marked as killed.
1758 score_limit_select
1760 If the score of an article is above or equal this value
1761 the article gets marked as hot.
1762 score_kill
1764 Score of an article which should be killed, this must be
1765 <= score_limit_kill.
1766 score_select
1768 Score of an article which should be marked hot, this must
1769 be >= score_limit_select.
1770 scroll_lines
1772 The number of lines that will be scrolled up/down in the
1773 article pager when using cursor-up/down. The default is 1
1774 (line-by-line). Set to 0 to get traditional tin page-by-
1775 page scrolling. Set to -1 to get page-by-page scrolling
1776 where the top/bottom line is carried over onto the next
1777 page. This setting supersedes
1778 show_last_line_prev_page=ON. Set to -2 to get half-page
1779 scrolling. This setting supersedes full_page_scroll=OFF.
1780 select_format
1782 The format string used for the Selection level. Default
1783 is "%f %n %U %G %d". The following substitutions are
1784 supported:
1785 %G group name
1786 %U unread count
1787 %d description
1788 %f group flag
1789 %n current group number
1790 %% %
1791 sort_function
1793 Function used for sorting articles. Default is 0.
1794 0 Use qsort(3) for sorting.
1796 1 Use heapsort(3) for sorting. This might be faster in
1798 large groups with long threads (somewhat presorted
1799 data).
1800 show_author
1802 Which information about the author should be shown.
1803 Default is 2, authors full name.
1804 0 None, only the ''Subject:'' line will be displayed.
1806 1 Address, ''Subject:'' line & the address part of
1808 the ''From:'' line are displayed.
1809 2 Full Name, ''Subject:'' line & the authors full
1811 name part of the ''From:'' line are displayed
1812 (default).
1813 3 Address and Name, ''Subject:'' line & all of the
1815 ''From:'' line are displayed.
1816 show_description
1818 If ON show a short group description text after newsgroup
1819 name at the group selection level. The ''-d'' command-
1820 line flag will override the setting and turn descriptions
1821 off. The text used is taken from the ${TIN_LIB‐
1822 DIR:-NEWSLIBDIR}/newsgroups file and if supported
1823 (requires tin(1) to be build with mh-mail-handling sup‐
1824 port) from ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups for
1825 mailgroups. Default is ON.
1826 show_info
1828 Which information about the thread or article should be
1829 shown. Default is 1, show only the line count.
1830 0 None, no information will be displayed.
1832 1 Lines, in article listing the line count of an
1834 article will be displayed and in thread listing the
1835 line count of first (unread) article will be dis‐
1836 played.
1837 2 Score, in article listing the score of an article
1839 will be displayed and in thread listing the score
1840 of the thread will be displayed - see also
1841 thread_score.
1842 3 Lines & Score, display line count and score.
1844 show_only_unread_arts
1846 If ON show only new/unread articles otherwise show all
1847 articles. Default is ON.
1848 show_only_unread_groups
1850 If ON show only subscribed groups that contain unread
1851 articles. Default is OFF.
1852 show_signatures
1854 If OFF don't show signatures when displaying articles.
1855 Default is ON.
1856 sigdashes
1858 If ON prepend the signature with sigdashes. Default is
1859 ON.
1860 sigfile
1862 The path that specifies the signature file to use when
1863 posting, following up to or replying to an article. If
1864 the path is a directory then the signature will be ran‐
1865 domly generated from files that are in the specified
1866 directory. If the path starts with a ! the program the
1867 path points to will be executed to generate a signature.
1868 In order to pass the group name to the program, %G can be
1869 specified. This will be replaced by the name of the cur‐
1870 rent newsgroup. program. --none will suppress any signa‐
1871 ture. Default is ${TIN_HOMEDIR:-"$HOME"}/.Sig.
1872 signature_repost
1874 If ON add signature to reposted articles. Default is ON.
1875 slashes_regex
1877 A regular expression that will be applied when reading
1878 articles. All matching words are shown in col_markslash
1879 or mono_markslash. If slashes_regex is blank, then tin(1)
1880 uses a built-in default.
1881 sort_article_type
1883 This specifies how articles should be sorted. Sort by
1884 ascending Date (6) is the default. The following sort
1885 types are allowed:
1886 0 Nothing, don't sort articles.
1888 1 Subject: (descending), sort articles by ''Sub‐
1890 ject:'' field descending.
1891 2 Subject: (ascending), sort articles by ''Subject:''
1893 field ascending.
1894 3 From: (descending), sort articles by ''From:''
1896 field descending.
1897 4 From: (ascending), sort articles by ''From:'' field
1899 ascending.
1900 5 Date: (descending), sort articles by ''Date:''
1902 field descending.
1903 6 Date: (ascending), sort articles by ''Date:'' field
1905 ascending (default).
1906 7 Score (descending), sort articles by filtering
1908 score descending.
1909 8 Score (ascending), sort articles by filtering score
1911 ascending.
1912 9 Lines: (descending), sort articles by ''Lines:''
1914 field descending.
1915 10 Lines: (ascending), sort articles by ''Lines:''
1917 field ascending.
1918 sort_threads_type
1920 This specifies how threads will be sorted. Sort by
1921 descending Score (1) is the default. The following sort
1922 types are allowed:
1923 0 Nothing, don't sort threads.
1925 1 Score (descending), sort threads by filtering score
1927 descending (default).
1928 2 Score (ascending), sort threads by filtering score
1930 ascending.
1931 3 Last posting date (descending), sort threads by
1933 date of last posting descending.
1934 4 Last posting date (ascending), sort threads by date
1936 of last posting ascending.
1937 spamtrap_warning_addresses
1939 Set this option to a list of comma-separated strings to
1940 be warned if you are replying to an article by mail where
1941 the e-mail address contains one of these strings. The
1942 matching is case-insensitive. Example:
1943 spam,delete,remove
1945 stars_regex
1947 A regular expression that will be applied when reading
1948 articles. All matching words are shown in col_markstar or
1949 mono_markstar. If stars_regex is blank, then tin(1) uses
1950 a built-in default.
1951 start_editor_offset
1953 Set ON if the editor used for posting, follow-ups and bug
1954 reports has the capability of starting and positioning
1955 the cursor at a specified line within a file. Default is
1956 ON.
1957 strip_blanks
1959 Strips the blanks from the end of each line therefore
1960 speeding up the display when reading on a slow terminal
1961 or via modem. Default is ON.
1962 strip_bogus
1964 Bogus groups are groups that are present in your
1965 ${TIN_HOMEDIR:-"$HOME"}/.newsrc file that no longer exist
1966 on the news server. There are 3 options. 0 means do noth‐
1967 ing & always keep bogus groups. 1 means bogus groups
1968 will be permanently removed. 2 means that bogus groups
1969 will appear on the Group Selection Menu, prefixed with a
1970 'D'. This allows you to unsubscribe from them as and when
1971 you wish. Default is 0 (Always Keep).
1972 strip_newsrc
1974 If ON, then unsubscribed groups will be permanently
1975 removed from your ${TIN_HOMEDIR:-"$HOME"}/.newsrc file.
1976 Default is OFF.
1977 strokes_regex
1979 A regular expression that will be applied when reading
1980 articles. All matching words are shown in col_markstroke
1981 or mono_markstroke. If strokes_regex is blank, then
1982 tin(1) uses a built-in default.
1983 tex2iso_conv
1985 Decode German style TeX umlaut codes to ISO If ON, show
1986 "a as Umlaut-a, etc. Default is OFF. This behavior can
1987 also be toggled in the article viewer via PageToggle‐
1988 Tex2iso ('"').
1989 thread_articles
1991 Defines which threading method to use. The choices are:
1992 0) Don't thread, 1) Thread on Subject only 2) Thread on
1993 References only, 3) Thread on References then Subject
1994 (default) 4) Thread multipart articles on Subject. 5)
1995 Thread on Percentage Match of the Subjects It's also pos‐
1996 sible to set the threading type on a per group basis by
1997 setting the group attribute variable thread_articles to 0
1998 - 5 in the file ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes.
1999 thread_format
2001 The format string used for the Thread level. Default is
2002 "%n %m [%L] %T %F". The following substitutions are
2003 supported:
2004 %D date
2005 %F from, name and/or address
2006 %I initials
2007 %L line count
2008 %M message-id
2009 %S score
2010 %T thread tree
2011 %m article marks
2012 %n current article number
2013 %% %
2014 thread_perc
2016 Defines how close the subjects must match while threading
2017 by Percentage Match for threads to be considered part of
2018 a single thread. This value is in the range 0 to 100. The
2019 default is 75.
2020 thread_catchup_on_exit
2022 If ON catchup group/thread when leaving with the left
2023 arrow key. Default is ON.
2024 thread_score
2026 How the total score of a thread is computed. Default is
2027 0, the maximum score in this thread.
2028 0 Max, the maximum score in this thread.
2030 1 Sum, the sum of all scores in this thread.
2032 2 Average, the average score in this thread.
2034 translit
2036 If ON append //TRANSLIT to the first argument of
2037 iconv_open(3) to enable transliteration. This means that
2038 when a character cannot be represented in the target
2039 character set, it can be approximated through one or sev‐
2040 eral similarly looking characters. On systems where this
2041 extension doesn't exist, this option is disabled. Default
2042 is OFF.
2043 trim_article_body
2045 Allows you to select how %tin(1) treats blank lines in
2046 article bodies. Default is 0. This option does not
2047 affect lines within verbatim blocks.
2048 0 Don't trim article body, do nothing.
2050 1 Skip leading blank lines.
2052 2 Skip trailing blank lines.
2054 3 Skip leading and trailing blank l., skip leading
2056 and trailing blank lines.
2057 4 Compact multiple between text, replace multiple
2059 blank lines between textblocks with one blank line.
2060 5 Compact multiple and skip leading, 4 + 1
2062 6 Compact multiple and skip trailing, 4 + 2
2064 7 Compact mltpl., skip lead. & trai., 4 + 3
2066 underscores_regex
2068 A regular expression that will be applied when reading
2069 articles. All matching words are shown in col_markdash or
2070 mono_markdash. If underscores_regex is blank, then tin(1)
2071 uses a built-in default.
2072 unlink_article
2074 If ON remove ${TIN_HOMEDIR:-"$HOME"}/.article after post‐
2075 ing. Default is ON.
2076 url_handler
2078 The program that will be run when launching URLs in the
2079 article viewer using PageViewUrl ('U'). The actual URL
2080 will be appended to this. Default is url_handler.pl %s.
2081 url_highlight
2083 Enable highlighting URLs in message body. Default is ON.
2084 use_color
2086 If enabled tin(1) uses ANSI-colors. Default is OFF.
2087 use_keypad
2089 Use scroll keys on keypad. Default is OFF.
2090 use_mouse
2092 Allows the mouse button support in a xterm(1x) to be
2093 enabled/disabled. Default is OFF.
2094 use_slrnface
2096 If enabled slrnface(1) will be used to interpret the
2097 ''X-Face:'' header. For this option to have any effect,
2098 tin(1) must be running in a xterm(1x) and slrnface(1)
2099 must be in your $PATH. Default is OFF.
2100 utf8_graphics
2102 If ON use UTF-8 characters for indicator ('->'),
2103 thread/attachment tree and ellipsis ('...'). Default is
2104 OFF.
2105 verbatim_begin_regex
2107 A regular expression that tin will use to find the begin
2108 of a verbatim block. Default is #v+
2109 verbatim_end_regex
2111 A regular expression that tin will use to find the end of
2112 a verbatim block. Default is #v-
2113 verbatim_handling
2115 If ON verbatim blocks will be detected. Default is ON.
2116 wildcard
2118 Allows you to select how tin(1) matches strings. The
2119 default is 0 and uses the wildmat notation, which is how
2120 this has traditionally been handled. Setting this to 1
2121 allows you to use perl(1) compatible regular expressions
2122 pcre(3). (see also perlre(1) and pcrepattern(3)). You
2123 will probably want to update your filter file if you use
2124 this regularly. NB: Newsgroup names will always be
2125 matched using the wildmat notation.
2126 word_h_display_marks
2128 Should the leading and ending stars, slashes, strokes and
2129 dashes also be displayed, even when they are highlighting
2130 marks?
2131 0 no
2133 1 yes, display mark
2135 2 print a space instead
2137 word_highlight
2139 Enable word highlighting. See word_h_display_marks for
2140 the options available. If use_color is enabled the colors
2141 specified in col_markdash, col_markslash, col_markstar
2142 and col_markstroke are used for word highlighting else
2143 the character attributes specified in mono_markdash,
2144 mono_markslash, mono_markstar and mono_markstroke are
2145 used. Default is ON.
2146 wrap_column
2148 Sets the column at which a displayed article body should
2149 be wrapped. If this value is equal to 0, it defaults to
2150 the current screen width. If this value is greater than
2151 your current screen width the part off-screen is not dis‐
2152 played. Thus setting this option to a large value can be
2153 used to disable wrapping. If this value is negative the
2154 wrap margin is the current screen width plus the given
2155 value (as long as the result is still positive, otherwise
2156 it will fall back to the current screen width). Default
2157 is 0, wrapping at the current screen width.
2158 wrap_on_next_unread
2160 If enabled a search for the next unread article will wrap
2161 around all articles to find also previous unread arti‐
2162 cles. If disabled the search stops at the end of the
2163 thread list. Default is ON.
2164 xpost_quote_format
2166 Format is the same as for news_quote_format, this is used
2167 when answering to a crossposting to several groups with
2168 no ''Followup-To:'' set.
2169 /etc/tin/tin.defaults
2171 Yet another global configuration file with "variable=value"
2173 pairs. This one is for the more general options which usually
2174 can't be controlled via ${TIN_LIBDIR:-NEWSLIBDIR}/tinrc and/or
2175 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc like resetting (to override
2176 the built-in default) the newslibdir.
2177 domainname
2179 Sets a global domain name used in From lines
2180 organization
2182 Defines the name of your organization. $ORGANIZATION
2183 overrides any specified value.
2184 newslibdir
2186 Defines the default place for some configuration files,
2187 common values are /usr/lib/news, /var/lib/news,
2188 /usr/local/lib/news or /news/db. $TIN_LIBDIR overrides
2189 any specified value.
2190 bugaddress
2192 Defines the email address to which users can send bug
2193 reports using a built-in function. The default points to
2194 a developers mailing list located at tin.org. You might
2195 want to change this address to one of your local adminis‐
2196 tration if you want to deal with your lusers problems on
2197 your own.
2198 inewsdir
2200 Defines the directory containing of the inews(1) exe‐
2201 cutable
2202 mm_charset
2204 Default charset to be used in MIME's ''Content-Type:''
2205 header. $MM_CHARSET overrides any specified value.
2206 post_mime_encoding
2208 Default encoding scheme used in MIME articles. 8bit might
2209 be the best value.
2210 mail_mime_encoding
2212 Default encoding scheme used in MIME letters.
2213 quoted-printable is a good choice here.
2214 disable_gnksa_domain_check
2216 Allow unregistered top level domains. As the list of
2217 valid TLDs is no longer actively maintained the default
2218 was changed to ON starting with tin(1) version 2.1.5
2219 disable_sender
2221 Don't generate a ''Sender:'' header. This has an effect
2222 only if inews_prog is set to --internal.
2223 spooldir
2225 Base of your newsspool (Bnews, Cnews and INN traditional
2226 spool style), common values are /var/spool/news,
2227 /usr/spool/news, /news/spool. $TIN_SPOOLDIR overrides
2228 any specified value.
2229 overviewdir
2231 Base of your NOV database newsoverview(5) (tradspool
2232 style; might be the same dir as spooldir), common values
2233 are /var/spool/overview, /usr/spool/overview, /news/over‐
2234 view. $TIN_NOVROOTDIR overrides any specified value.
2235 overviewfile
2237 Name of a single overview file, common values are .over‐
2238 view, over.view. $TIN_NOVFILENAME overrides any specified
2239 value.
2240 overviewfmtfile
2242 Full pathname of your newssystem's overview.fmt file;
2243 usually the overview.fmt file is in newslibdir, so you
2244 only have to change this setting if your configuration
2245 differs.
2246 activefile
2248 Full pathname of your newssystem's active file; usually
2249 the active file resides in newslibdir and is named
2250 active, so you only have to change this setting if your
2251 configuration differs. $TIN_ACTIVEFILE overrides any
2252 specified value.
2253 activetimesfile
2255 Full pathname of your newssystem's active.times file;
2256 usually the active.times file is newslibdir, so you only
2257 have to change this setting if your configuration dif‐
2258 fers.
2259 newsgroupsfile
2261 Full pathname of your newssystem's newsgroups file; usu‐
2262 ally the newsgroups file is in newslibdir, so you only
2263 have to change this setting if your configuration dif‐
2264 fers.
2265 subscriptionsfile
2267 Full pathname of your newssystem's subscriptions file;
2268 usually the subscriptions file is in newslibdir, so you
2269 only have to change this setting if your configuration
2270 differs.
2271 /usr/local/share/locale/$LC_MESSAGES/LC_MESSAGES/tin.mo
2273 translation into language specified in $LC_ALL, $LC_MESSAGES or
2275 $LANG
2276 ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active}
2278 This file lists the newsgroups that the local site receives.
2280 Each newsgroup should be listed only once. Each line specifies
2281 one group; within each newsgroup, articles are assigned unique
2282 names, which are monotonically increasing numbers.
2283 If an article is posted to newsgroups not mentioned in this
2285 file, those newsgroups are ignored. If no valid newsgroups are
2286 specified, the article is rejected.
2287 Each line consists of four space-separated fields "name highmark
2289 lowmark flags".
2290 name is the name of the newsgroup
2292 highmark
2294 is the highest article number that has been used in that
2295 newsgroup
2296 lowmark
2298 is the lowest article number in the group; this number is
2299 not guaranteed to be accurate, and should only be taken
2300 to be a hint. Note that because of article cancellations,
2301 there may be gaps in the numbering sequence. If the low‐
2302 est article number is greater than the highest article
2303 number, then there are no articles in the newsgroup.
2304 flags can be one of those
2306 y local postings are allowed
2308 n no local postings are allowed, only remote ones
2310 m the group is moderated and all postings must be
2312 approved
2313 j articles in this group are not kept, but only
2315 passed on
2316 x articles cannot be posted to this newsgroup
2318 =foo.bar
2320 articles are locally filed into the ''foo.bar''
2321 group
2322 tin(1) only tries to read the file if you read directly from the
2324 local spool, if you read news via NNTP, tin(1) uses the
2325 LIST (RFC3977) or LIST COUNTS (RFC6048) command instead.
2326 ${TIN_LIBDIR:-NEWSLIBDIR}/active.times
2328 This file provides a chronological record of when newsgroups are
2330 created. It is normally updated by the local news server (e.g.
2331 innd(8)) whenever a new group is created. Each line consist of
2332 three space-separated fields "name time creator".
2333 name is the name of the newsgroup
2335 time is the time when the group was created, expressed as the
2337 number of seconds since the Epoch.
2338 creator
2340 is the electronic mail address of the person who created
2341 the group.
2342 tin(1) only tries to read the file if you read directly from the
2344 local spool, if you read news via NNTP, tin(1) uses the
2345 NEWGROUPS (RFC3977) command instead.
2346 ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups
2348 This file provides short descriptions of each newsgroup. It is
2350 normally updated by the local news server (e.g. innd(8)) when‐
2351 ever a new group is created. Each line consist of two tab-sepa‐
2352 rated fields "group.name one-line description".
2353 group.name
2355 is the name of the newsgroup
2356 one-line description
2358 is a short single-line description of the group
2359 tin(1) only tries to read the file if you read directly from the
2361 local spool, if you read news via NNTP, tin(1) uses the
2362 LIST NEWSGROUPS (RFC3977) command instead.
2363 ${TIN_LIBDIR:-NEWSLIBDIR}/organization
2365 This file might hold a default organization to be used in the
2367 ''Organization:'' header. $ORGANIZATION has a higher priority if
2368 set.
2369 ${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt
2371 This file specifies the organization of the news overview data‐
2373 base (see also newsoverview(5)). The order of lines in this
2374 file is important; it determines the order in which the fields
2375 will appear in the database. See also overview.fmt(5). tin(1)
2376 only tries to read the file if you read directly from the local
2377 spool, if you read news via NNTP, tin(1) uses the LIST OVER‐
2378 VIEW.FMT (RFC3977) command instead.
2379 ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions
2381 This file contains a list of newsgroups - one per line - which
2383 the client should subscribe to when the user has no ${TIN_HOME‐
2384 DIR:-"$HOME"}/.newsrc for the news server. tin(1) only tries to
2385 read the file if you read directly from the local spool, if you
2386 read news via NNTP, tin(1) uses the LIST SUBSCRIPTIONS (RFC6048)
2387 command instead.
2388
2390 elm(1), inews(1), ispell(1), lp(1), lpr(1), metamail(1), perl(1),
2391 perlre(1), pgp(1), rn(1), shar(1), slrnface(1), tin(1), xterm(1x),
2392 heapsort(3), iconv(3), iconv_open(3), nl_langinfo(3), pcre(3),
2393 pcrepattern(3), qsort(3), strftime(3), system(3), active(5),
2394 mailcap(5), mbox(5), mmdf(5), newsoverview(5), overview.fmt(5),
2395 innd(8), RFC1524, RFC2045, RFC2046, RFC2047, RFC2048, RFC2231, RFC2980,
2396 RFC3977, RFC4155, RFC4643, RFC5322, RFC5536, RFC5537, RFC6048
23972.4.2 December 24th, 2017 tin(5)