1tin(1) Usenet newsreader tin(1)
2
6 tin, rtin - Usenet newsreader
7
9 tin [[-h|-H|-V] | [[[-a] [-dlnq|-Q] [-ArzxX]] [[-R|-S] -s News_dir]
10 [-cuvZ] [-4|-6] [-N|-M address] [-o|-w]] [-D debug_level] [-G arti‐
11 cle_limit] [-f newsrc_file] [-g server] [-m Mail_dir] [-p port] [-I
12 index_dir] [newsgroup[,...]]]
13
15 tin is a full-screen easy to use Usenet newsreader. It can read news
16 locally (e.g., /var/spool/news) or remotely (rtin or tin -r option) via
17 a NNTP (Network News Transport Protocol) server. It will automatically
18 utilize NOV newsoverview(5) style index files if available locally or
19 via the NNTP [X]OVER command (RFC2980, RFC3977).
20 tin has four separate levels of operation: Selection level, Group
22 level, Thread level and Article level. Use the Help ('h') command to
23 view a list of the commands available at a particular level.
24 On startup tin will show a list of the newsgroups found in ${TIN_HOME‐
26 DIR:-"$HOME"}/.newsrc. An arrow '->' or highlighted bar will point to
27 the first newsgroup. Move to a group by using the terminal arrow keys
28 (terminal dependent) or Down ('j') and Up ('k'). Use PgUp/PgDn (termi‐
29 nal dependent) or PageUp ('^U') (CTRL-U) and PageDown ('^D') (CTRL-D)
30 to page up/down. Enter a newsgroup by pressing '<CR>'.
31 The GroupNextUnreadArtOrGrp ('<TAB>') key enters the next newsgroup
33 with unread articles.
34
36 Interactive mode:
37 0 Successful program execution.
39 1 Usage, syntax, configuration file or network error.
41 2 NNTP error.
43 Batch mode (''-Z''):
45 0 No unread news
47 1 Usage, syntax, configuration file or network error.
49 2 Unread news
51
53 -4 Force connecting via IPv4 to the remote NNTP server. Only
54 available when build with IPv6 support.
55 -6 Force connecting via IPv6 to the remote NNTP server. Only
57 available when build with IPv6 support.
58 -a Toggle ANSI color (default is off).
60 -A Force authentication on initial connect. Only available
62 when reading via NNTP.
63 -c Create/update index files for every group in ${TIN_HOME‐
65 DIR:-"$HOME"}/.newsrc or file specified by the ''-f''
66 option and mark all articles as read.
67 -d Don't load newsgroup descriptions and servers message of
69 the day (interactive mode).
70 -D debug-level
72 Enter debug-level (1 = NNTP, 2 = filter, 4 = newsrc, 8 =
73 threading, 16 = memory, 32 = attributes, 64 = misc, 128 =
74 remove existing debug files).
75 -f file Use the specified file of subscribed to newsgroups in place
77 of ${TIN_HOMEDIR:-"$HOME"}/.newsrc.
78 -g server Use the server and newsrc specified in ${TIN_HOME‐
80 DIR:-"$HOME"}/.tin/newsrctable. Only available when reading
81 via NNTP.
82 -G article-limit
84 Limit the number of articles/group to retrieve from the
85 server.
86 -h Help listing all command-line options.
88 -H Brief introduction to tin that is also shown the first time
90 it is started.
91 -I dir Directory in which to store newsgroup index files. Default
93 is ${TIN_INDEX_NEWSDIR:-"${TIN_HOME‐
94 DIR:-"$HOME"}/.tin"}/.news. This option has no effect if
95 tin retrieves its index files via NNTP and cache_over‐
96 view_files is turned off.
97 -l Get number of articles per group from the ${TIN_LIB‐
99 DIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active} file. If read‐
100 ing via NNTP this is done with the LIST command (RFC3977 ).
101 This might result in incorrect article counts but is usu‐
102 ally faster than the default which is to read the
103 ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active} file
104 (either directly or via LIST) and then check the article
105 count via NNTP GROUP command (RFC3977 ) ''-ln''. If reading
106 via NNTP and LIST COUNTS (RFC6048 ) is available that is
107 used instead as it gives more accurate article counts.
108 -m dir Mailbox directory to use. Default is ${TIN_HOME‐
110 DIR:-"$HOME"}/Mail.
111 -M user Mail unread articles to specified user for later reading.
113 For more information read section "AUTOMATIC MAILING AND
114 SAVING NEW NEWS".
115 -n Only load groups from the ${TIN_LIBDIR:-NEWSLIB‐
117 DIR}"/"${TIN_ACTIVEFILE:-active} file that are subscribed
118 to in the user's ${TIN_HOMEDIR:-"$HOME"}/.newsrc. This
119 allows a noticeable speedup when connecting via a slow
120 line, but tin may not be able detect which groups are mod‐
121 erated. See also ''-l''.
122 -N Mail unread articles to yourself for later reading. For
124 more information read section "AUTOMATIC MAILING AND SAVING
125 NEW NEWS".
126 -o Quick post all postponed articles and exit. In order for
128 this to be really quick, it should be used with ''-n'' if
129 possible.
130 -p port Port to use if reading via NNTP (default is 119). This also
132 overrides the environment variable $NNTPPORT if set. Only
133 available when reading via NNTP.
134 -q Don't check for new newsgroups and skip loading the servers
136 message of the day.
137 -Q Quick start. Start tin as quickly as possible. Currently
139 this is equivalent to ''-nqd''.
140 -r Read news remotely from the default NNTP server specified
142 in the environment variable $NNTPSERVER or contained in the
143 file /etc/nntpserver.
144 -R Read news saved by the ''-S'' option.
146 -s dir Save/read articles to/in directory. Default is ${TIN_HOME‐
148 DIR:-"$HOME"}/News.
149 -S Save unread articles for later reading by the ''-R''
151 option. For more information read section "AUTOMATIC MAIL‐
152 ING AND SAVING NEW NEWS".
153 -u Create/update index files for every group in ${TIN_HOME‐
155 DIR:-"$HOME"}/.newsrc or file specified by the ''-f''
156 option. This option is disabled if tin retrieves its index
157 files via a NNTP server and cache_overview_files is turned
158 off.
159 -v Verbose mode for ''-c'', ''-M'', ''-N'', ''-S'', ''-u'' and
161 ''-Z'' options.
162 -V Print version and date information.
164 -w Quick mode to post an article and then exit. This option
166 implies ''-d''. In order for this to be really quick, it
167 should be used with ''-n'' if possible.
168 -x No-posting mode. You cannot post articles if you use this
170 option.
171 -X No overwrite mode. ${TIN_HOMEDIR:-"$HOME"}/.newsrc and
173 files in ${TIN_HOMEDIR:-"$HOME"}/.tin will not be overwrit‐
174 ten but may be created if they don't exist.
175 -z Only start tin if there is any new/unread news. If there is
177 news tin will position cursor at first group with unread
178 news. Useful for putting in login file.
179 -Z Check if there is any new/unread news and exit with appro‐
181 priate status. If ''-v'' option is specified the number of
182 unread articles in each group is printed. An exit code 0
183 indicates no news, 1 that an error occurred and 2 that
184 new/unread news exists. Useful for writing scripts.
185 tin can also dynamically change its options by the OptionMenu ('M')
187 command. Any changes are written to ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc.
188 For more information see section "GLOBAL OPTIONS MENU AND TINRC CONFIG‐
189 URABLE VARIABLES" and tin(5).
190 A list of groups can be specified after the other command-line options.
192 This can be useful if you wish to yank in or subscribe to a hand-picked
193 subset of the active newsgroups. See the section "NEWSGROUP LISTS &
194 WILDCARDS" for the types of pattern that tin understands.
195 If you specify a single group-name, or a wildcard that matches a single
197 group, then you will automatically enter that group. Otherwise the nor‐
198 mal group selection screen will appear, but with all the matching
199 groups present too, as though you had yanked just those groups in.
200 With the ''-w'' flag a given group-name is used as default group to
202 post to. If more than one group or a wildcard is specified only the
203 first group respectively the first group that matches is used.
204 Once you use SelectYankActive ('y') to yank in all active groups, or
206 SelectToggleReadDisplay ('r') to toggle the read/unread status, then
207 the command-line groups will be gone. You can use SelectSyncWithActive
208 ('Y') to reread the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE‐
209 FILE:-active} file and get them back.
210 NB: With the ''-n'' flag, only unsubscribed groups in the ${TIN_HOME‐
212 DIR:-"$HOME"}/.newsrc file (or the newsrc-file given by the ''-f'' com‐
213 mand-line switch or via ${TIN_HOMEDIR:-"$HOME"}/.tin/newsrctable) can
214 be matched.
215 Command-line options have higher priority than attributes and tinrc
217 options. Thus, command-line option takes precedence over configured
218 values.
219
221 NEWS ADMINISTRATION
222 Maintaining Netnews on large networks of machines can be a pretty time
223 consuming job as I discovered when I was given the job of maintaining
224 our news system and news users.
225 A user starting tin for the first time can be automatically subscribed
227 to a list of newsgroups that are deemed appropriate by the news admin‐
228 istrator. The subscriptions file should be created in your news lib
229 directory (i.e., ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions) and should
230 have file permissions set to 0644. If you read news via NNTP, then your
231 news server must support the LIST SUBSCRIPTIONS command. It is part of
232 the NNTP List Extensions (RFC6048 ) and all modern servers should
233 understand it.
234 SCREEN FORMAT
236 tin has four separate levels of operation: Selection level, Group
237 level, Thread level and Article level.
238 At the Selection level the title displays (the name of the news server
240 and) the number of subscribed groups (containing new unread articles).
241 The newsgroups are displayed in the middle of the screen usually with
242 the number of unread articles displayed on the same line in front, but
243 it can be customized via select_format.
244 ->M 1 2 comp.security.announce Announcements from the CERT abou
246 M 2 1 news.admin.announce Announcements for news adminstra
247 3 22 news.software.misc News-related software other than
248 4 1475 news.software.nntp The Network News Transfer Protoc
249 X 5 124 news.software.readers Discussion of software used to r
250 There may also be a character prefixing the line. An explanation fol‐
252 lows:
253 u This group is unsubscribed. To see only your subscribed
255 groups use the SelectToggleReadDisplay ('r') or SelectYankAc‐
256 tive ('y') toggle keys.
257 M This is a moderated group. Any posts you make will have to be
259 approved by the group administrator before it will be made
260 public. tin will ask for confirmation before you post to a
261 moderated group.
262 N This is a new newsgroup which has been created since you last
264 used tin. New newsgroups are not subscribed to by default
265 (However, see the $AUTOSUBSCRIBE / $AUTOUNSUBSCRIBE environ‐
266 ment variables). Subscribe to it in the normal way if you
267 wish the group to continue to appear in your Selection Menu.
268 Simply ignore new newsgroups and they will be gone the next
269 time you start tin. You will have to yank in all the groups
270 to find them in a later session.
271 D This group no longer exists. If you no longer wish to see
273 this group then unsubscribe from it in the normal way. This
274 flag will only appear if you have set strip_bogus to "ask" in
275 the Options Menu.
276 X You may no longer make posts to this group. Often a group
278 will be superseded by a more appropriately named one.
279 = This group has been renamed and you may no longer post to it.
281 If you do, then you will receive an error from your news
282 server telling you the correct group to post to.
283 At the Group level the title contains the name of the group, the number
285 of conversation threads, the abbreviated threading method (thread_arti‐
286 cles), the limit of articles to get (if set; getart_limit), the total
287 number of (unread) articles (art_marked_read or art_marked_unread), the
288 number of hot articles art_marked_selected, the number of read hot
289 articles (if any; art_marked_read_selected), the number of recent arti‐
290 cles (art_marked_recent) and the number of killed articles
291 (art_marked_killed). I.e.:
292 alt.sources (5B -50/23+ 0* 3o 0K)
294 The characters after the numbers are depending to the configuration and
296 if your are in show_only_unread_arts mode or not. Some numbers could be
297 missing if the specific option is not enabled. It might also contain an
298 'M', 'X' or '=' (see above; doesn't work with the ''-n'' command-line
299 switch!) if the group is moderated, set to no posting or postings to it
300 get redirected.
301 If a thread has unread articles it is marked with art_marked_unread in
303 front of the total number of articles in the thread. If there are
304 recent articles within the thread it might be marked with
305 art_marked_recent in front of the total number of articles in the
306 thread - this is controlled by the recent_time option. If a thread has
307 hot articles in it (see also section "FILTERING ARTICLES") it's marked
308 with art_marked_selected in front of the total number of articles in
309 the thread. The number of lines of the first (unread) article in the
310 thread might also be shown right before the subject - this is con‐
311 trolled by the show_info option. The display can be customized via
312 group_format.
313 de.admin.net-abuse.announce (11B 13+ 1* 1o 0K) M
315 -> 1 + 3 108 bincancels in de.talk.sex Christopher Lueg <l
317 2 + 69 EMP/ECP gecancelt. xynx. BI= 10 Henning Weede <hwee
318 3 o 93 EMP gecancelt. SouthBeach/Palms Henning Weede <hwee
319 4 * 368 <1997-11-12> Fremdcancel-FAQ Thomas Roessler <ro
320 At the Thread level the screen usually (depends on the threading method
322 used) looks like this, but can be customized via thread_format:
323 -> 1 [ 7] What is this funny tree in the thr Robert F. Simmig
325 2 [ 12] +-> Sephan Wagner <s
326 3 [ 230] | `->Tin thread-level (was: What is Bob Johnson <bob
327 4 [ 22] `->tin threading menu Brian Richardson
328 At the Article level the page header has the following format:
331 Sun, 28 Dec 1997 21:21:01 de.admin.news.groups Thread 20 of 86
333 Lines 50 Re: EINSPRUCH zu RESULT:de.comm.mobil.ALL Article 47 of 59
334 Urs Janssen <urs@akk.org> at Arbeitskreis Kultur und Kommunikati
335 article-body
337 The look of the Selection, Group and Thread level can be customized.
339 See the section "CUSTOMIZING THE SCREEN FORMAT".
340 COMMON MOVING KEYS
342 This table shows the common keys used for moving around all levels
343 within tin.
344 ANSI/vt100 Other Terminals
345 Beg. of list/article Home FirstPage (^)
346 End of list/article End LastPage ($)
347 Page Up PgUp PageUp (u, ^U or ^B)
348 Page Down PgDn PageDown (^D or ^F or <SPACE>)
349 Line Up Up arrow Up (k or ^P)
350 Line Down Down arrow Down (j or ^N)
351 COMMON EDITING COMMANDS
353 An emacs(1) style editing package allows the easy editing of input
354 strings. A history list allows the easy reuse of previously entered
355 strings. In addition to the cursor keys, the following commands are
356 available when editing a string:
357 ^A, ^E move to beginning or end of line, respectively.
359 ^F, ^B non-destructive move forward or back one location, respec‐
361 tively.
362 ^D delete the character currently under the cursor, or send EOF
364 if no characters in the buffer.
365 ^H, <DEL> delete character left of the cursor.
367 ^K delete from cursor to end of line.
369 ^P, ^N move through history, previous and next, respectively.
371 ^L, ^R redraw the current line.
373 <CR> places line on history list if non-blank, appends newline and
375 returns to the caller.
376 <ESC> aborts the present editing operation.
378 GLOBAL COMMANDS
380 The following commands are available at all 4 menu levels and always
381 have the same effect.
382 ShellEscape '!'
384 Shell escape. ShellEscape by itself will launch a shell,
385 ShellEscape <command> will run an external <command>. This
386 facility may have been disabled by the System Administrator.
387 ToggleColor '&'
389 Toggle use of ANSI color.
390 RedrawScr '^L'
392 Redraw the current screen.
393 ScrollUp '<'
395 Scroll screen up by one line.
396 ScrollDown '>'
398 Scroll screen down by one line.
399 Postponed 'O' '^O'
401 Reload postponed article. If your system blocks the Postponed
402 key you must quote it by pressing '^V' (CTRL-V) first. The
403 postpone-menu offers the following actions: PromptYes ('y') =
404 reload and spawn editor; PostponeOverride ('Y') = post arti‐
405 cle (without spawning editor); PostponeAll ('A') = post all
406 postponed articles (without spawning editor); PromptNo ('n')
407 = skip this article; Quit ('q') = quit postponed menu. Cur‐
408 rently there is no 'simple' way to delete a postponed article
409 from the postponed-file, you have to use the following com‐
410 mand sequence instead: reload it with Postponed, enter editor
411 with PromptYes, quit editor, discard posting with Quit
412 ('^O''y''q'). See also ''-o'' command-line switch.
413 Help 'h' Help screen of commands available on the current menu. You
415 can use SearchSubjF ('/'), SearchSubjB ('?') and SearchRepeat
416 ('\') to search on this screen. Quit ('q') returns to the
417 menu.
418 ToggleHelpDisplay 'H'
420 Toggle the display of help mini menu at the bottom of the
421 screen.
422 DisplayPostHist 'W'
424 List articles posted by user. The date posted, the newsgroup
425 and the subject are listed. You can use SearchSubjF ('/'),
426 SearchSubjB ('?') and SearchRepeat ('\') to search on this
427 screen. Quit ('q') returns to the menu.
428 Version 'v'
430 Print tin version information.
431 NEWSGROUP SELECTION COMMANDS
433 4 Select group 4.
434 SelectResetNewsrc '^R'
436 Reset ${TIN_HOMEDIR:-"$HOME"}/.newsrc file. This will destroy
437 all records of which articles have been read, so use this
438 carefully.
439 SetRange '#'
441 Choose a range of articles to be affected by the next com‐
442 mand. See the section "RANGES" for more information.
443 SelectSortActive '.'
445 Sort the list of newsgroups.
446 SearchRepeat '\'
448 Repeat the previous search.
449 SearchSubjF '/'
451 Search for a group by name and description (if displayed).
452 SearchSubjB '?'
454 Backward search through the group names and descriptions.
455 SelectReadGrp '^J' '<CR>'
457 Read current group.
458 SelectEnterNextUnreadGrp '<TAB>' 'n'
460 Enter next group with unread news. Will wrap around to the
461 beginning of the group selection list looking for unread
462 groups.
463 Catchup 'c'
465 Make current group as all read [after confirmation] and move
466 to the next group in the group selection list.
467 CatchupNextUnread 'C'
469 Mark current group as all read [after confirmation] and enter
470 the next unread group in the group selection list.
471 SelectToggleDescriptions 'd'
473 Toggle display to show just the group name or the group name
474 and the group descriptions.
475 EditFilter 'E'
477 Edit the filter file and reload it afterwards.
478 SelectGoto 'g'
480 Choose a new group by name. This command can be used to
481 access any group, even those not currently yanked in.
482 ToggleInfoLastLine 'i'
484 Toggle the display of the description of the current news‐
485 group in the last line. This will not be available if tin was
486 started with the ''-d'' option.
487 ToggleInverseVideo 'I'
489 Toggle inverse video.
490 LookupMessage 'L'
492 Look up article by ''Message-ID:''. If none of the groups
493 listed in the ''Newsgroups:''-header of the referenced arti‐
494 cle is available, just the contents of the ''News‐
495 groups:''-header will be displayed in the last line. At this
496 level this command only works if reading via NNTP and the
497 server supports [X]HDR (RFC2980, RFC3977) or XPAT (RFC2980).
498 SelectMoveGrp 'm'
500 Move the current group within the group selection list. By
501 entering '1' the group will become the first displayed group
502 in the list, by entering '8' the eighth group in the list
503 etc. By entering '$' the group will be the last group dis‐
504 played.
505 OptionMenu 'M'
507 User configurable options menu (for more information see sec‐
508 tion "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES").
509 SelectNextUnreadGrp 'N'
511 Positions the cursor on the next group with unread articles
512 in it.
513 Quit 'q' Quit tin - ask the user to confirm if confirm_choice is set
515 accordingly.
516 QuitTin 'Q'
518 Quit tin - don't ask the user to confirm.
519 SelectToggleReadDisplay 'r'
521 Toggle display of all subscribed to groups and just those
522 groups containing unread articles. Command has no effect if
523 groups were specified on the command-line when tin was
524 started.
525 BugReport 'R'
527 Mail a bug report or comment to <tin-bugs@tin.org>. This is
528 the best way of getting bugs fixed and features
529 added/changed.
530 SelectSubscribe 's'
532 Subscribe to current group.
533 SelectSubscribePat 'S'
535 Subscribe to groups matching user specified pattern. See the
536 section "NEWSGROUP LISTS & WILDCARDS" for the types of pat‐
537 tern that tin understands.
538 SelectUnsubscribe 'u'
540 Unsubscribe to current group. This can be used to remove
541 bogus groups. See strip_bogus in the "GLOBAL OPTIONS MENU
542 AND TINRC CONFIGURABLE VARIABLES" section.
543 SelectUnsubscribePat 'U'
545 Unsubscribe to groups matching user specified pattern. See
546 the section "NEWSGROUP LISTS & WILDCARDS" for the types of
547 pattern that tin understands.
548 Post 'w' Post an article to current group. If posting fails for some
550 reason, you'll get the chance to PostEdit ('e') the article
551 again, PostPostpone ('o') it for later processing (see also
552 ''-o'' command-line switch) or discard it via Quit ('q').
553 SelectQuitNoWrite 'X'
555 Quit tin without saving any changes to the configuration.
556 SelectYankActive 'y'
558 Yanks in all groups. Toggles the displayed groups between all
559 the groups in the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE‐
560 FILE:-active} file and just those that are subscribed to in
561 ${TIN_HOMEDIR:-"$HOME"}/.newsrc.
562 SelectSyncWithActive 'Y'
564 Reread the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE‐
565 FILE:-active} file to see if any new news has arrived since
566 starting tin.
567 SelectMarkGrpUnread 'z' 'Z'
569 Mark all articles in the current group as unread.
570 GROUP INDEX COMMANDS
572 All searches in this level are limited to unread articles if in
573 show_only_unread_arts mode. GroupToggleReadUnread ('r') can be use tog‐
574 gle the setting right before/after the search.
575 4 Select article 4.
577 MenuFilterSelect '^A'
579 Auto select article(s) using a menu. Read the section "FIL‐
580 TERING ARTICLES" for more information.
581 MenuFilterKill '^K'
583 Kill article(s) using a menu. Read the section "FILTERING
584 ARTICLES" for more information.
585 MarkFeedRead '^X'
587 Mark current article, thread, range, auto-selected (hot)
588 articles, articles matching pattern or tagged articles as
589 read. A prompt asks which type should be marked.
590 MarkFeedUnread '^W'
592 Mark current article, thread, range, auto-selected (hot)
593 articles, articles matching pattern or tagged articles as
594 unread. A prompt asks which type should be marked.
595 SetRange '#'
597 Choose a range of articles to be affected by the next com‐
598 mand. See the section "RANGES" for more information.
599 LastViewed '-'
601 Re-enter the last message that was viewed.
602 SearchRepeat '\'
604 Repeat the previous search.
605 SearchSubjF '/'
607 Search forward for specified subject.
608 SearchSubjB '?'
610 Search backwards for specified subject.
611 GroupSelThd '*'
613 Select current thread for later processing.
614 GroupDoAutoSel '+'
616 Selects all threads in current group. It is a shortcut for
617 calling GroupSelPattern with a pattern of ''*''.
618 GroupToggleThdSel '.'
620 Toggle selection of current thread. If at least one unread
621 article, (but not every unread article) in the current thread
622 is selected, then all unread articles become selected.
623 GroupSelThdIfUnreadSelected ';'
625 For each thread in current group, if it at least one unread
626 article is selected, all unread articles become selected.
627 This is useful for auto-selection on author where reader
628 wants to see entire thread.
629 GroupSelPattern '='
631 Prompts for a pattern with which to match on. All threads
632 whose subjects match the pattern will be marked selected. A
633 pattern of ''*'' will match all subjects. Entering just
634 '<CR>' will re-use the last pattern that was entered.
635 GroupReverseSel '@'
637 Reverse all selections on all articles.
638 GroupUndoSel '~'
640 Undo all selections on all articles. It clears the toggle
641 effect of GroupMarkUnselArtRead ('X') command. Thus after
642 first doing a GroupMarkUnselArtRead, one can then do GroupUn‐
643 doSel to reset articles. Thus, one can iteratively whittle
644 down uninteresting threads.
645 Pipe '|' Pipe current article / thread / auto-selected (hot) articles
647 / articles matching pattern / tagged articles into command.
648 See the section "MAILING PIPING PRINTING REPOSTING AND SAVING
649 ARTICLES" for more information.
650 QuickFilterSelect '['
652 Auto select article(s) with a single key [after confirma‐
653 tion]. The defaults used for selection are based upon the
654 following four tinrc config variables: default_fil‐
655 ter_select_case, default_filter_select_expire, default_fil‐
656 ter_select_global and default_filter_select_header. Read the
657 section "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARI‐
658 ABLES" for a full explanation of these variables and "FILTER‐
659 ING ARTICLES" for more information on filtering.
660 QuickFilterKill ']'
662 Kill article(s) with a single key [after confirmation]. The
663 defaults used for killing are based upon the following four
664 tinrc config variables: default_filter_kill_case,
665 default_filter_kill_expire, default_filter_kill_global and
666 default_filter_kill_header. Read the section "GLOBAL OPTIONS
667 MENU AND TINRC CONFIGURABLE VARIABLES" for a full explanation
668 of these variables and "FILTERING ARTICLES" for more informa‐
669 tion on filtering.
670 GroupReadBasenote '^J' '<CR>'
672 Read current article.
673 GroupNextUnreadArtOrGrp '<TAB>'
675 View next unread article or group.
676 SearchAuthF 'a'
678 Author forward search. This searches for articles with a spe‐
679 cific ''From:'' line.
680 SearchAuthB 'A'
682 Author backward search. Otherwise, see SearchAuthF ('a')
683 above.
684 SearchBody 'B'
686 Search the body of all articles in group (can be slow). You
687 can abort the search using Quit ('q').
688 Catchup 'c'
690 Mark all articles as read [after confirmation] then return to
691 the group selection list. Move cursor to next group.
692 CatchupNextUnread 'C'
694 Mark all articles as read [after confirmation] and enter the
695 next group with unread news.
696 GroupToggleSubjDisplay 'd'
698 Cycle the display of the author through all the possible
699 options for the tinrc variable show_author.
700 GroupCancel 'D'
702 Cancel (delete) or supersede (overwrite) the current article.
703 It must have been posted by the same user. The cancel message
704 can be seen in the newsgroup 'control' or 'control.cancel'.
705 EditFilter 'E'
707 Edit the filter file and reload it afterwards.
708 GroupGoto 'g'
710 Choose a new group by name. This command can be used to
711 access any group, even those not currently yanked in.
712 GroupToggleGetartLimit 'G'
714 Toggle article/group limit.
715 ToggleInfoLastLine 'i'
717 Display the subject of the first article in the current
718 thread in the last line.
719 ToggleInverseVideo 'I'
721 Toggle inverse video.
722 GroupMarkThdRead 'K'
724 Mark article/thread as read and move onto the next unread
725 article/thread. If a range of articles/threads is set, the
726 range will be marked as read instead of the current arti‐
727 cle/thread. When tagged articles/threads are present, a
728 prompt asks how to proceed.
729 GroupListThd 'l'
731 Open the thread under the current cursor position.
732 LookupMessage 'L'
734 Look up article by ''Message-ID:''.
735 GroupMail 'm'
737 Mail current article / thread / auto-selected (hot) articles
738 / articles matching pattern / tagged articles to someone. See
739 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
740 ARTICLES" for more information.
741 OptionMenu 'M'
743 User configurable options menu (for more information see sec‐
744 tion "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES").
745 GroupNextGroup 'n'
747 Go to next group.
748 GroupNextUnreadArt 'N'
750 Go to the next unread article.
751 Print 'o' Send current article / thread / auto-selected (hot) articles
753 / articles matching pattern / tagged articles to printer. See
754 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
755 ARTICLES" for more information.
756 GroupPrevGroup 'p'
758 Go to previous group.
759 GroupPrevUnreadArt 'P'
761 Go to previous unread article.
762 Quit 'q' Return to previous level.
764 QuitTin 'Q'
766 Quit tin - don't ask the user to confirm.
767 GroupToggleReadUnread 'r'
769 Toggle the display between all articles and unread articles.
770 BugReport 'R'
772 Mail a bug report or comment to <tin-bugs@tin.org>. This is
773 the best way of getting bugs fixed and features
774 added/changed.
775 GroupSave 's'
777 Save current article / thread / auto-selected (hot) articles
778 / articles matching pattern / tagged articles. See the sec‐
779 tion "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
780 for more information.
781 GroupAutoSave 'S'
783 Save marked articles automatically without further prompting.
784 GroupTag 't'
786 Toggle tag-status of current article / thread for GroupMail
787 ('m') / Pipe ('|') / Print ('o') / GroupSave ('s') / GroupRe‐
788 post ('x').
789 GroupTagParts 'T'
791 Automatically tag in order all the parts of the current
792 multi-part message.
793 GroupToggleThreading 'u'
795 Cycle the threading mode through no threading, threading by
796 subject, threading by references, threading on both subject
797 and references, group multipart articles into a thread
798 (''Subject:'' based).
799 GroupUntag 'U'
801 Untag all articles that were tagged.
802 Post 'w' Post an article to the current group. If posting fails for
804 some reason, you'll get the chance to edit the article again
805 via PostEdit ('e'), postpone it for later processing via
806 PostPostpone ('o') (see also ''-o'' command-line switch) or
807 discard it via Quit ('q').
808 GroupRepost 'x'
810 Repost an already posted article / thread / auto-selected
811 (hot) articles / articles matching pattern / tagged articles
812 to another newsgroup(s). Useful for reposting from global to
813 local newsgroups. Do not use this to crosspost your own arti‐
814 cles.
815 GroupMarkUnselArtRead 'X'
817 Mark all unread articles that have not been selected as read,
818 redraw screen to reflect changes and put index at the first
819 thread to begin reading. Pressing GroupMarkUnselArtRead
820 ('X') again will toggle back to the way it was before. See
821 GroupUndoSel ('~') command for clearing the toggle effect,
822 leaving the group will also clear the toggle effect and make
823 the changes permanent.
824 MarkArtUnread 'z'
826 Mark current article as unread.
827 MarkThdUnread 'Z'
829 Mark current thread as unread. If a range of threads is set,
830 the range will be marked as unread instead of the current
831 thread. When tagged threads are present, a prompt asks how to
832 proceed.
833 THREAD LISTING COMMANDS
835 4 Select article 4 within thread.
836 MenuFilterSelect '^A'
838 Auto select article(s) using a menu. Read the section "FIL‐
839 TERING ARTICLES" for more information.
840 MenuFilterKill '^K'
842 Kill article(s) using a menu. Read the section "FILTERING
843 ARTICLES" for more information.
844 MarkFeedRead '^X'
846 Mark current article, thread, range, auto-selected (hot)
847 articles, articles matching pattern or tagged articles as
848 read. A prompt asks which type should be marked.
849 MarkFeedUnread '^W'
851 Mark current article, thread, range, auto-selected (hot)
852 articles, articles matching pattern or tagged articles as
853 unread. A prompt asks which type should be marked.
854 SetRange '#'
856 Choose a range of articles to be affected by the next com‐
857 mand. See the section "RANGES" for more information.
858 LastViewed '-'
860 Re-enter the last message that was viewed.
861 SearchRepeat '\'
863 Repeat the previous search.
864 SearchSubjF '/'
866 Search forward for specified subject.
867 SearchSubjB '?'
869 Search backwards for specified subject.
870 ThreadSelArt '*'
872 Select current thread for later processing.
873 ThreadToggleArtSel '.'
875 Toggle selection of current article.
876 ThreadReverseSel '@'
878 Reverse article selections.
879 ThreadUndoSel '~'
881 Undo all selections on current thread.
882 Pipe '|' Pipe current article / thread / auto-selected (hot) articles
884 / articles matching pattern / tagged articles into command.
885 See the section "MAILING PIPING PRINTING REPOSTING AND SAVING
886 ARTICLES" for more information.
887 ThreadReadArt '^J' '<CR>'
889 Read current article within thread.
890 ThreadReadNextArtOrThread '<TAB>'
892 View next unread article within thread.
893 SearchAuthF 'a'
895 Author forward search. This searches for articles with a spe‐
896 cific ''From:'' line. The search will wrap over into the next
897 thread if nothing is found in the current one.
898 SearchAuthB 'A'
900 Author backward search. Otherwise, see SearchAuthF ('a')
901 above.
902 SearchBody 'B'
904 Search the body of all articles in group (can be slow). You
905 can abort the search using Quit ('q').
906 Catchup 'c'
908 Mark thread as read [after confirmation] and return to the
909 group index page. Move cursor to next thread.
910 CatchupNextUnread 'C'
912 Mark thread as read [after confirmation] and enter the next
913 thread containing unread news.
914 ThreadToggleSubjDisplay 'd'
916 Cycle the display of the author through all the possible
917 options for the tinrc variable show_author.
918 ThreadCancel 'D'
920 Cancel (delete) or supersede (overwrite) the current article.
921 It must have been posted by the same user. The cancel message
922 can be seen in the newsgroup 'control' or 'control.cancel'.
923 EditFilter 'E'
925 Edit the filter file and reload it afterwards.
926 ToggleInfoLastLine 'i'
928 Display the subject of the current article in the last line.
929 ToggleInverseVideo 'I'
931 Toggle inverse video.
932 ThreadMarkArtRead 'K'
934 Mark article as read and move onto the next unread article.
935 If a range of articles is set, the range will be marked as
936 read instead of the current article. When tagged articles are
937 present, a prompt asks how to proceed.
938 LookupMessage 'L'
940 Look up article by ''Message-ID:''.
941 ThreadMail 'm'
943 Mail current article / thread / auto-selected (hot) articles
944 / articles matching pattern / tagged articles to someone. See
945 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
946 ARTICLES" for more information.
947 Print 'o' Send current article / thread / auto-selected (hot) articles
949 / articles matching pattern / tagged articles to printer. See
950 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
951 ARTICLES" for more information.
952 Quit 'q' Return to previous level.
954 QuitTin 'Q'
956 Quit tin - don't ask the user to confirm.
957 BugReport 'R'
959 Mail a bug report or comment to <tin-bugs@tin.org>. This is
960 the best way of getting bugs fixed and features
961 added/changed.
962 ThreadSave 's'
964 Save current article / thread / auto-selected (hot) articles
965 / articles matching pattern / tagged articles. See the sec‐
966 tion "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
967 for more information.
968 ThreadAutoSave 'S'
970 Save marked articles automatically without further prompting.
971 ThreadTag 't'
973 Toggle tag status of current article for mailing, piping,
974 printing, saving or reposting.
975 ThreadUntag 'U'
977 Untag all tagged threads.
978 Post 'w' Post an article to the current group. If posting fails for
980 some reason, you'll get the chance to edit the article again
981 via PostEdit ('e'), postpone it for later processing via
982 PostPostpone ('o') (see also ''-o'' command-line switch) or
983 discard it via Quit ('q').
984 MarkArtUnread 'z'
986 Mark current article in thread as unread. If a range of arti‐
987 cles is set, the range will be marked as unread instead of
988 the current article. When tagged articles are present, a
989 prompt asks how to proceed.
990 MarkThdUnread 'Z'
992 Mark all articles in thread as unread.
993 ARTICLE VIEWER COMMANDS
995 0 Read the first (base) article in this thread.
996 4 Read response 4 in this thread.
998 MenuFilterSelect '^A'
1000 Auto select article(s) using a menu. Read the section "FIL‐
1001 TERING ARTICLES" for more information.
1002 PageReplyQuoteHeaders '^E'
1004 Reply through mail to the author of the current article with
1005 a copy of the article with all headers included.
1006 PagePGPCheckArticle '^G'
1008 Perform pgp(1) operations on article.
1009 PageToggleRaw '^H'
1011 Toggles the display mode (raw including all headers vs.
1012 cooked).
1013 MenuFilterKill '^K'
1015 Kill article(s) using a menu. Read the section "FILTERING
1016 ARTICLES" for more information.
1017 PageToggleTabs '^T'
1019 Toggle the TAB width between 4 and 8 characters.
1020 PageFollowupQuoteHeaders '^W'
1022 Post a followup to the current article with a copy of the
1023 article with all headers included.
1024 PageToggleTex2iso '"'
1026 Toggle TeX to ISO decoding for current article. The default
1027 behavior is taken from the tex2iso_conv variable in the tinrc
1028 file.
1029 PageToggleAllHeaders '*'
1031 Toggles the display of all headers vs. headers in news_head‐
1032 ers_to_display.
1033 PageToggleRot '%'
1035 Toggle ROT-13 decoding for this article.
1036 PageToggleUue '('
1038 Toggle the display of uuencoded sections. The default behav‐
1039 ior is taken from the hide_uue variable in the tinrc file.
1040 PageReveal ')'
1042 The formfeed character (^L) is often used to hide 'spoilers'
1043 that the reader may not initially wish to see when viewing an
1044 article. Any text after a formfeed is not displayed. This
1045 key-press acts like a reveal key and turns the hidden text
1046 back on. Scrolling down will also reveal the text, scrolling
1047 up will hide it again.
1048 LastViewed '-'
1050 Re-enter the last message that was viewed.
1051 SearchRepeat '\'
1053 Repeat the previous search.
1054 SearchSubjF '/'
1056 Forward search the text of this article.
1057 SearchSubjB '?'
1059 Backward search the text of this article.
1060 PageSkipIncludedText ':'
1062 Skip to the end of the next quoted text-block in this arti‐
1063 cle. Quoted text is everything which matches quote_regex,
1064 quote_regex2 or quote_regex3.
1065 PageTopThd '<'
1067 Go to the first article in the current thread.
1068 PageBotThd '>'
1070 Go to the last article in the current thread.
1071 PageToggleHighlight '_'
1073 Toggle word highlighting on/off.
1074 Pipe '|' Pipe current article / thread / auto-selected (hot) articles
1076 / articles matching pattern / tagged articles into command.
1077 See the section "MAILING PIPING PRINTING REPOSTING AND SAVING
1078 ARTICLES" for more information.
1079 QuickFilterSelect '['
1081 Auto select article(s) with a single key. The defaults used
1082 for selection are set based upon the following four tinrc
1083 config variables: default_filter_select_case, default_fil‐
1084 ter_select_expire, default_filter_select_global and
1085 default_filter_select_header Read the section "GLOBAL OPTIONS
1086 MENU AND TINRC CONFIGURABLE VARIABLES" for a full explanation
1087 of these variables and "FILTERING ARTICLES" for more informa‐
1088 tion on filtering.
1089 QuickFilterKill ']'
1091 Kill article(s) with a single key. The defaults used for
1092 killing are based upon the following four tinrc config vari‐
1093 ables: default_filter_kill_case, default_filter_kill_expire,
1094 default_filter_kill_global and default_filter_kill_header.
1095 Read the section "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE
1096 VARIABLES" for a full explanation of these variables and
1097 "FILTERING ARTICLES" for more information on filtering.
1098 PageNextThd '^J' '<CR>'
1100 Go to next base article.
1101 PageNextUnread '<TAB>'
1103 Go to next unread article. If the tinrc variable
1104 goto_next_unread doesn't contain PageNextUnread, then this
1105 key will first page through the current article.
1106 SearchAuthF 'a'
1108 Author forward search.
1109 SearchAuthB 'A'
1111 Author backward search.
1112 SearchBody 'B'
1114 Search the body of all articles in group (can be slow). You
1115 can abort the search using Quit ('q').
1116 Catchup 'c'
1118 Mark the current thread as read [after confirmation] and
1119 return to the previous menu. Move cursor to next item.
1120 CatchupNextUnread 'C'
1122 Mark the rest of the current thread as read [after confirma‐
1123 tion] and enter the next thread with unread articles.
1124 PageCancel 'D'
1126 Cancel (delete) or supersede (overwrite) the current article.
1127 It must have been posted by the same user. The cancel message
1128 can be seen in the newsgroup 'control' or 'control.cancel'.
1129 PageEditArticle 'e'
1131 Edit the current article. This is restricted to mailgroups
1132 and saved news.
1133 EditFilter 'E'
1135 Edit the filter file and reload it afterwards.
1136 PageFollowupQuote 'f'
1138 Post a followup to the current article with a copy of the
1139 article included.
1140 PageFollowup 'F'
1142 Post a followup to the current article without including a
1143 copy of the article.
1144 PageFirstPage 'g'
1146 Go to the start of the article.
1147 PageLastPage 'G'
1149 Go to the end of the article.
1150 ToggleInfoLastLine 'i'
1152 Display the subject of the current article in the last line.
1153 ToggleInverseVideo 'I'
1155 Toggle inverse video.
1156 PageKillThd 'K'
1158 Mark rest of thread as read and move onto the next unread
1159 thread.
1160 PageListThd 'l'
1162 Show the thread menu that the current article is a part of.
1163 LookupMessage 'L'
1165 Look up article by ''Message-ID:''.
1166 PageMail 'm'
1168 Mail current article / thread / auto-selected (hot) articles
1169 / articles matching pattern / tagged articles to someone. See
1170 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
1171 ARTICLES" for more information.
1172 OptionMenu 'M'
1174 User configurable options menu (for more information see sec‐
1175 tion "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES").
1176 PageNextArt 'n'
1178 Go to the next article.
1179 PageNextUnreadArt 'N'
1181 Go to the next unread article.
1182 Print 'o' Send current article / thread / auto-selected (hot) articles
1184 / articles matching pattern / tagged articles to printer. See
1185 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
1186 ARTICLES" for more information.
1187 PagePrevArt 'p'
1189 Go to the previous article.
1190 PagePrevUnreadArt 'P'
1192 Go to the previous unread article.
1193 Quit 'q' Return to the previous level.
1195 QuitTin 'Q'
1197 Quit tin - don't ask the user to confirm.
1198 PageReplyQuote 'r'
1200 Reply through mail to the author of the current article with
1201 a copy of the article included.
1202 PageReply 'R'
1204 Reply through mail to the author of the current article with‐
1205 out including the original article.
1206 PageSave 's'
1208 Save current article / thread / auto-selected (hot) articles
1209 / articles matching pattern / tagged articles. See the sec‐
1210 tion "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
1211 for more information.
1212 PageAutoSave 'S'
1214 Save marked articles automatically without further prompting.
1215 PageTag 't'
1217 Toggle tag status of current article for mailing, piping,
1218 printing, saving or reposting.
1219 PageGroupSel 'T'
1221 Return to group selection level.
1222 PageGotoParent 'u'
1224 Go to parent article.
1225 PageViewUrl 'U'
1227 Display a list of URLs in the current article. See the sec‐
1228 tion "URL LISTING" for more information.
1229 PageViewAttach 'V'
1231 Display a list of attachments of the current article. See the
1232 section "ATTACHMENT LISTING" for more information.
1233 Post 'w' Post an article to the current group. If posting fails for
1235 some reason, you'll get the chance to edit the article again
1236 via PostEdit ('e'), postpone it for later processing via
1237 PostPostpone ('o') (see also ''-o'' command-line switch) or
1238 discard it via Quit ('q').
1239 PageRepost 'x'
1241 Repost an already posted article / thread / auto-selected
1242 (hot) articles / articles matching pattern / tagged articles
1243 to another newsgroup(s). Useful for reposting from global to
1244 local newsgroups. Do not use this to crosspost your own arti‐
1245 cles.
1246 MarkArtUnread 'z'
1248 Mark article as unread.
1249 MarkThdUnread 'Z'
1251 Mark the current thread as unread.
1252 URL LISTING
1254 PageViewUrl ('U') displays a list of URLs in the current article.
1255 Besides the common moving keys, the following commands are available:
1256 UrlSelect '^J' '<CR>'
1258 The current URL will be prompted and opened using the
1259 url_handler. '<ESC>' or no input will skip the URL.
1260 SearchSubjF '/'
1262 URL forward search.
1263 SearchSubjB '?'
1265 URL backward search.
1266 SearchRepeat '\'
1268 Repeat the previous search.
1269 ShellEscape '!'
1271 Shell escape.
1272 ToggleInfoLastLine 'i'
1274 Toggle the display of the current URL in the last line.
1275 Help 'h' Help screen of commands available.
1277 ToggleHelpDisplay 'H'
1279 Toggle the display of help mini menu at the bottom of the
1280 screen.
1281 ATTACHMENT LISTING
1283 PageViewAttach ('V') displays a list of attachments of the current
1284 article. Besides the common moving keys, the following commands are
1285 available:
1286 AttachPipe 'p'
1288 Pipe attachment into command.
1289 AttachSave 's'
1291 Save current attachment / tagged attachments to disk.
1292 AttachSelect '^J' '<CR>'
1294 View attachment.
1295 AttachTag 't'
1297 Tag one or more attachments for saving.
1298 AttachTagPattern '='
1300 Prompts for a pattern to match. All attachments whose
1301 name/description or content type/transfer encoding match
1302 the pattern will be tagged.
1303 AttachToggleTagged '@'
1305 Reverse tagging of all attachments.
1306 AttachUntag 'U'
1308 Untag all tagged attachments.
1309 SearchSubjF '/'
1311 Attachment forward search.
1312 SearchSubjB '?'
1314 Attachment backward search.
1315 SearchRepeat '\'
1317 Repeat the previous search.
1318 GlobalPipe '|'
1320 Pipe attachment into command. Uses the raw attachment, no
1321 decoding is done.
1322 ShellEscape '!'
1324 Shell escape.
1325 ToggleInfoLastLine 'i'
1327 Toggle the display of the name/description of the current
1328 attachment in the last line.
1329 Help 'h' Help screen of commands available.
1331 ToggleHelpDisplay 'H'
1333 Toggle the display of help mini menu at the bottom of the
1334 screen.
1335 GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES
1337 At startup, tin reads in the configuration files (see also tin(5)).
1338 They contain a list of variables that can be used to configure the way
1339 tin works. If it exists, the global configuration file, /etc/tin/tinrc
1340 is read. After that, the user's own configuration file is read from
1341 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc. The global file is useful for dis‐
1342 tributing system-wide defaults to new users who have no private tinrc
1343 yet.
1344 The variables are user configurable by editing ${TIN_HOME‐
1346 DIR:-"$HOME"}/.tin/tinrc directly. Most of them can also be set in the
1347 GLOBAL OPTIONS MENU which is accessed by pressing OptionMenu ('M') at
1348 all levels. It allows the user to customize the behavior of tin. The
1349 options are saved to the file ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc when
1350 you exit tin so don't edit the file directly whilst tin is running.
1351 In the options menu use the cursor keys in the usual way to move
1353 around. Use ConfigSelect ('^J' or '<CR>') to 'open' the option you wish
1354 to change. You will need to enter a new value or use '<SPACE>' to tog‐
1355 gle the available options. ConfigSelect will save the new value,
1356 '<ESC>' will abort without saving changes.
1357 As with the other menus, RedrawScr ('^L') will redraw the screen. You
1359 can use SearchSubjF ('/'), SearchSubjB ('?') and SearchRepeat ('\') to
1360 search for a specific option. Use Quit ('q') to exit the option menu
1361 and keep your changes. Use QuitTin ('Q') to exit without keeping your
1362 changes.
1363 The options menu provides access to the attributes menu for the current
1365 group by the ConfigToggleAttrib ('<TAB>') command. Pressing ConfigTog‐
1366 gleAttrib again toggles back to the options menu. For more information
1367 see section "ATTRIBUTES MENU AND GROUP ATTRIBUTES".
1368 The ConfigScopeMenu ('S') command brings up the scopes menu. For more
1370 information see section "SCOPES MENU".
1371 Here is a full list of all the available variables. The name in braces
1373 is the name of the corresponding setting in ${TIN_HOME‐
1374 DIR:-"$HOME"}/.tin/tinrc.
1375 Abbreviate long newsgroup names (abbreviate_groupname)
1377 If ON abbreviate long newsgroup names at group selection level and
1378 article level (if necessary) like this: news.software.readers ->
1379 n.software.readers -> n.s.readers -> n.s.r. Default is OFF.
1380 Add posted articles to filter (add_posted_to_filter)
1382 If ON add posted articles which start a new thread to filter for
1383 highlighting follow-ups. Default is ON.
1384 Insert 'User-Agent:'-header (advertising)
1386 Turn ON advertising in header (''User-Agent:''). Default is ON.
1387 Skip multipart/alternative parts (alternative_handling)
1389 If ON strip multipart/alternative messages automatically. Default
1390 is ON.
1391 Character to show deleted articles (art_marked_deleted)
1393 The character used to show that an article was deleted. Default is
1394 'D'.
1395 Character to show inrange articles (art_marked_inrange)
1397 The character used to show that an article is in a range. Default
1398 is '#'.
1399 Character to show returning arts (art_marked_return)
1401 The character used to show that an article will return as an unread
1402 article when the group is next entered. Default is '-'.
1403 Character to show selected articles (art_marked_selected)
1405 The character used to show that an article/thread is auto-selected
1406 (hot). Default is '*'.
1407 Character to show recent articles (art_marked_recent)
1409 The character used to show that an article/thread is recent (not
1410 older than X days). See also recent_time. Default is 'o'.
1411 Character to show unread articles (art_marked_unread)
1413 The character used to show that an article has not been read.
1414 Default is '+'.
1415 Character to show read articles (art_marked_read)
1417 The character used to show that an article was read. Default is '
1418 '.
1419 Character to show killed articles (art_marked_killed)
1421 The character used to show that an article was killed. Default is
1422 'K'. kill_level must be set accordingly.
1423 Character to show read selected arts (art_marked_read_selected)
1425 The character used to show that an article was hot before it was
1426 read. Default is ':'. kill_level must be set accordingly.
1427 Ask before using MIME viewer (ask_for_metamail)
1429 If ON tin will ask before using a MIME viewer (metamail_prog) to
1430 display MIME messages. This only occurs if a MIME viewer is set.
1431 Default is OFF.
1432 Send you a cc and/or bcc automatically (auto_cc_bcc)
1434 Automatically put your name in the ''Cc:'' and/or ''Bcc:'' field
1435 when mailing an article. Default is No.
1436 List thread using right arrow key (auto_list_thread)
1438 If ON automatically list thread when entering it using right arrow
1439 key. Default is ON.
1440 Reconnect to server automatically (auto_reconnect)
1442 Default is OFF.
1443 Use Archive-name: header for save (auto_save)
1445 If ON articles/threads with ''Archive-name:'' in header will be
1446 automatically saved with the Archive-name & part/patch no and post
1447 processed if post_process_type is set to something other than 'No'.
1448 Default is OFF.
1449 Save articles in batch mode (batch_save)
1451 If set ON articles/threads will be saved in batch mode when save
1452 ''-S'' or mail ''-M, -N'' is specified on the command line. Default
1453 is ON.
1454 Show mini menu & posting etiquette (beginner_level)
1456 If set ON a mini menu of the most useful commands will be displayed
1457 at the bottom of the screen for each level. Also a short posting
1458 etiquette will be displayed after composing an article. Default is
1459 ON.
1460 Cache NNTP overview files locally (cache_overview_files)
1462 If ON, create local copies of NNTP overview files. This can be used
1463 to considerably speed up accessing large groups when using a slow
1464 connection. See also "INDEX FILES". Default is OFF.
1465 Hash algorithm for cancel-locks (cancel_lock_algo)
1467 Use this hash algorithm for cancel-locks. Only available when build
1468 with cancel-lock support. none disables the generation of cancel-
1469 locks. Valid values are none, sha1, sha256 and sha512. Default is
1470 sha1.
1471 Catchup read groups when quitting (catchup_read_groups)
1473 If set ON the user is asked when quitting if all groups read during
1474 the current session should be marked read. Default is OFF.
1475 Standard background color (col_back)
1477 Standard background color
1478 Color of quoted text from external sources (col_extquote)
1480 Color of quoted text from external sources
1481 Color of sender (From:) (col_from)
1483 Color of sender (From:)
1484 Color of article header lines (col_head)
1486 Color of header-lines
1487 Color of help text (col_help)
1489 Color of help pages
1490 Color for inverse text (background) (col_invers_bg)
1492 Color of background for inverse text
1493 Color for inverse text (foreground) (col_invers_fg)
1495 Color of foreground for inverse text
1496 Color of highlighting with _dash_ (col_markdash)
1498 Color of words emphasized like _this_. See also word_h_dis‐
1499 play_marks and word_highlight.
1500 Color of highlighting with /slash/ (col_markslash)
1502 Color of words emphasized like /this/. See also word_h_dis‐
1503 play_marks and word_highlight.
1504 Color of highlighting with *stars* (col_markstar)
1506 Color of words emphasized like *this*. See also word_h_dis‐
1507 play_marks and word_highlight.
1508 Color of highlighting with -stroke- (col_markstroke)
1510 Color of words emphasized like -this-. See also word_h_dis‐
1511 play_marks and word_highlight.
1512 Color of mini help menu (col_minihelp)
1514 Color of mini help menu
1515 Color of actual news header fields (col_newsheaders)
1517 Color of actual news header fields
1518 Standard foreground color (col_normal)
1520 Standard foreground color
1521 Color of quoted lines (col_quote)
1523 Color of quoted lines
1524 Color of twice quoted line (col_quote2)
1526 Color of twice quoted lines
1527 Color of =>3 times quoted line (col_quote3)
1529 Color of >=3 times quoted lines
1530 Color of response counter (col_response)
1532 Color of response counter. This is the text that says "Response x
1533 of y" in the article viewer.
1534 Color of signatures (col_signature)
1536 Color of signatures
1537 Color of urls highlight (col_urls)
1539 Color of urls highlight
1540 Color of verbatim blocks (col_verbatim)
1542 Color of verbatim blocks
1543 Color of article subject lines (col_subject)
1545 Color of article subject
1546 Color of text lines (col_text)
1548 Color of text-lines
1549 Color of help/mail sign (col_title)
1551 Color of help/mail sign
1552 Which actions require confirmation (confirm_choice)
1554 Ask for manual confirmation to protect the user.
1555 · commands Ask for confirmation before executing certain danger‐
1557 ous commands (e.g., Catchup ('c')). Commands that this affects
1558 are marked in this manual with '[after confirmation]'. Default
1559 is commands & quit.
1560 · quit You'll be asked to confirm that you wish to exit tin when
1562 you use the Quit ('q') command.
1563 · select Ask for confirmation before marking all not selected
1565 (with GroupMarkUnselArtRead ('X') command) articles as read.
1566 Format string for display of dates (date_format)
1568 Format string tin uses for date representation. A description of
1569 the different format options can be found at strftime(3). tin uses
1570 strftime(3) when available and supports most format options in his
1571 fallback code. Default is "%a, %d %b %Y %H:%M:%S".
1572 (default_art_search)
1574 (default_author_search)
1576 (default_config_search)
1578 The last article/author/config option that was searched for.
1579 (default_filter_days)
1581 Default is 28.
1582 (default_filter_kill_case)
1584 Default for quick (1 key) kill filter case. ON = filter case sen‐
1585 sitive, OFF = ignore case. Default is OFF.
1586 (default_filter_kill_expire)
1588 Default for quick (1 key) kill filter expire. ON = limit to
1589 default_filter_days, OFF = don't ever expire. Default is OFF.
1590 (default_filter_kill_global)
1592 Default for quick (1 key) kill filter global. ON=apply to all
1593 groups, OFF=apply to current group. Default is ON.
1594 (default_filter_kill_header)
1596 Default for quick (1 key) kill filter header.
1597 0
1599 ''Subject:'' (case sensitive)
1600 1
1602 ''Subject:'' (ignore case)
1603 2
1605 ''From:'' (case sensitive)
1606 3
1608 ''From:'' (ignore case)
1609 4
1611 ''Message-ID:'' & full ''References:'' line
1612 5
1614 ''Message-ID:'' & last ''References:'' entry only
1615 6
1617 ''Message-ID:'' entry only
1618 7
1620 ''Lines:''
1621 (default_filter_select_case)
1623 Default for quick (1 key) auto-selection filter case. ON=filter
1624 case sensitive, OFF=ignore case. Default is OFF.
1625 (default_filter_select_expire)
1627 Default for quick (1 key) auto-selection filter expire. ON = limit
1628 to default_filter_days, OFF = don't ever expire. Default is OFF.
1629 (default_filter_select_global)
1631 Default for quick (1 key) auto-selection filter global. ON=apply
1632 to all groups, OFF=apply to current group. Default is ON.
1633 (default_filter_select_header)
1635 Default for quick (1 key) auto-selection filter header.
1636 0
1638 ''Subject:'' (case sensitive)
1639 1
1641 ''Subject:'' (ignore case)
1642 2
1644 ''From:'' (case sensitive)
1645 3
1647 ''From:'' (ignore case)
1648 4
1650 ''Message-ID:'' & full ''References:'' line
1651 5
1653 ''Message-ID:'' & last ''References:'' entry only
1654 6
1656 ''Message-ID:'' entry only
1657 7
1659 ''Lines:''
1660 (default_goto_group)
1662 (default_group_search)
1664 (default_mail_address)
1666 (default_move_group)
1668 (default_pattern)
1670 (default_pipe_command)
1672 (default_post_newsgroups)
1674 (default_post_subject)
1676 (default_range_group)
1678 (default_range_select)
1680 (default_range_thread)
1682 (default_repost_group)
1684 (default_save_file)
1686 (default_save_mode)
1688 (default_select_pattern)
1690 (default_shell_command)
1692 (default_subject_search)
1694 Draw -> instead of highlighted bar (draw_arrow)
1696 Allows groups/articles to be selected by an arrow '->' if set ON or
1697 by an highlighted bar if set OFF. Default is OFF.
1698 Invocation of your editor (editor_format)
1700 The format string used to create the editor start command with
1701 parameters. Default is "%E +%N %F" (e.g., /bin/vi +7 .article).
1702 Detection of external quotes (extquote_handling)
1704 If ON quotes from external sources will be detected. Default is
1705 OFF.
1706 Regex used to show external quotes (extquote_regex)
1708 A regular expression that will be applied when reading articles.
1709 All matching lines are shown in col_extquote. If extquote_regex is
1710 blank, then tin uses a built-in default.
1711 Force redraw after certain commands (force_screen_redraw)
1713 Specifies whether a screen redraw should always be done after cer‐
1714 tain external commands. Default is OFF.
1715 Number of articles to get (getart_limit)
1717 If getart_limit is > 0 not more than the last getart_limit arti‐
1718 cles/group are fetched from the server. If getart_limit is < 0 tin
1719 will start fetching articles from your first unread minus absolute
1720 value of getart_limit. Default is 0, which means no limit.
1721 Catchup group using left key (group_catchup_on_exit)
1723 If ON catchup group when leaving with the left arrow key. Default
1724 is ON.
1725 Format string for the Group level (group_format)
1727 Format string tin uses for Group level representation. See the sec‐
1728 tion "CUSTOMIZING THE SCREEN FORMAT". Default is
1729 "%n %m %R %L %s %F".
1730 Go to the next unread article with (goto_next_unread)
1732 Which keys tin should accept to jump to the next unread article.
1733 Possible is any combination of PageDown and PageNextUnread. When
1734 PageDown is set tin jumps to the next article at the end of the
1735 current one. When PageNextUnread is set tin jumps immediately to
1736 the next article when PageNextUnread ('<TAB>') is pressed. Default
1737 is PageNextUnread.
1738 Display uue data as an attachment (hide_uue)
1740 If set to 'No' then raw uuencoded data is displayed. If set to
1741 'Yes' then sections of uuencoded data will be shown with a single
1742 tag line showing the size and filename (much the same as a MIME
1743 attachment). If set to 'Hide all' then any line that looks like
1744 uuencoded data will be folded into a tag line. This is useful when
1745 uuencoded data is split across more than one article but can also
1746 lead to false positives. This setting can also be toggled in the
1747 article viewer. Default is 'No'.
1748 External inews (inews_prog)
1750 Path, name and options of external inews(1). If you are reading
1751 via NNTP the default value is "--internal" (use built-in NNTP
1752 inews), else it is "inews -h". The article is passed to inews_prog
1753 on STDIN via '< article'.
1754 (info_in_last_line)
1756 If ON, show current group description or article subject in the
1757 last line (not in the pager and global menu) - ToggleInfoLastLine
1758 ('i') toggles setting. This facility is useful as the full width of
1759 the screen is available to display long subjects. Default is OFF.
1760 Use interactive mail reader (interactive_mailer)
1762 Interactive mailreader: if greater than 0 your mailreader will be
1763 invoked earlier for reply so you can use more of its features (e.g.
1764 MIME, pgp, ...). 1 means include headers, 2 means don't include
1765 headers (old use_mailreader_i=ON option). 0 turns off usage. This
1766 option has to suit mailer_format. Default is 0.
1767 Use inverse video for page headers (inverse_okay)
1769 If ON use inverse video for page headers and URL highlighting.
1770 Default is ON.
1771 Keep failed arts in ~/dead.articles (keep_dead_articles)
1773 If ON keep all failed postings in ${TIN_HOME‐
1774 DIR:-"$HOME"}/dead.articles besides keeping the last failed posting
1775 in ${TIN_HOMEDIR:-"$HOME"}/dead.article. Default is ON.
1776 Filter which articles (kill_level)
1778 This option controls the processing and display of articles that
1779 are killed. There are 3 options:
1780 0 Kill only unread arts is the 'traditional' behavior of tin.
1782 Only unread articles are killed once only by marking them read.
1783 As filtering only happens on unread articles with kill_level
1784 set to 0, art_marked_killed and art_marked_read_selected are
1785 only shown once. When you reenter the group the mark will be
1786 gone.
1787 1 Kill all arts & show with K will process all articles in the
1789 group and therefore there is a processing overhead when using
1790 this option. Killed articles are threaded as normal but they
1791 will be marked with art_marked_killed.
1792 2 Kill all arts and never show will process all articles in the
1794 group and therefore there is a processing overhead when using
1795 this option. Killed articles simply does not get displayed at
1796 all.
1797 Default is 0 (Kill only unread arts).
1798 Use 8bit characters in mail headers (mail_8bit_header)
1800 Allows 8bit characters unencoded in the header of mail message.
1801 Default is OFF. Turning it ON is effective only if mail_mime_encod‐
1802 ing is also set to 8bit. Leaving it OFF is safe for most users and
1803 compliant to Internet Mail Standard (RFC5322 and RFC2047). Default
1804 is OFF.
1805 Mail address (mail_address)
1807 User's mail address (and full name), if not username@host. This is
1808 used when creating articles, sending mail and when pgp(1) signing.
1809 MIME encoding in mail messages (mail_mime_encoding)
1811 MIME encoding of the body in mail message, if necessary (8bit,
1812 base64, quoted-printable, 7bit). Default is quoted-printable.
1813 Quote line when mailing (mail_quote_format)
1815 Format of quote line when replying (via mail) to an article
1816 (%A=Address, %D=Date, %F=Fullname+Address, %G=Groupname, %M=Mes‐
1817 sage-ID, %N=Fullname, %C=Firstname, %I=Initials). Default is "In
1818 article %M you wrote:"
1819 Format of the mailbox (mailbox_format)
1821 Select one of the following mailbox-formats: MBOXO (default, except
1822 on SCO), MBOXRD or MMDF (default on SCO). See mbox(5) and RFC4155
1823 for more details on MBOXO and MBOXRD and mmdf(5) for more details
1824 about MMDF.
1825 Mail directory (maildir)
1827 The directory where articles/threads are to be saved in mbox(5)
1828 format. This feature is mainly for use with the elm(1) mail pro‐
1829 gram. It allows the user to save articles/threads/groups simply by
1830 giving '=' as the filename to save to. Default is ${TIN_HOME‐
1831 DIR:-"$HOME"}/Mail.
1832 Invocation of your mail command (mailer_format)
1834 The format string used to create the mailer command with parameters
1835 that is used for mailing articles to other people. Default is '%M
1836 "%T" < %F' (e.g., /bin/mail "iain" < .article). The flexible format
1837 allows other mailers with different command line parameters to be
1838 used such as
1839 sendmail -oem -t < %F
1840 elm -s "%S" "%T" < "%F"
1841 claws-mail --compose "mailto:%T?subject=%S&insert=%F"
1842 interactive_mailer must be set adequate. The following substitu‐
1843 tions are supported:
1844 %F filename
1845 %M default_mailer
1846 %S subject-field
1847 %T to-filed
1848 %U username
1849 %% %
1850 'Mark as (un)read' ignores tags (mark_ignore_tags)
1852 When this is ON, the GroupMarkThdRead ('K'), ThreadMarkArtRead
1853 ('K'), MarkThdUnread ('Z') at Group level and MarkArtUnread ('z')
1854 at Thread level functions mark just the current article or thread,
1855 ignoring other tagged, (un)read articles. When OFF, the same func‐
1856 tion presents a menu with choices of the current thread or article,
1857 all tagged, unread articles, or nothing.
1858 Mark saved articles/threads as read (mark_saved_read)
1860 If ON mark articles that are saved as read. Default is ON.
1861 Viewer program for MIME articles (metamail_prog)
1863 Path, name and options of external metamail(1) program used to view
1864 non-textual parts of articles. To use the built-in viewer, set to
1865 --internal. This is the default value when metamail(1) is not
1866 installed. Leave it blank if you don't want any automatic viewing
1867 of non-textual attachments. The 'V' command can always be used to
1868 manually view any attachments. See also ask_for_metamail.
1869 MM_CHARSET (mm_charset)
1871 Charset supported locally, which is also used for MIME header
1872 (charset parameter and charset name in header encoding) in mail and
1873 news postings. If MIME_STRICT_CHARSET is defined at compile time,
1874 text in charset other than the value of this parameter is consid‐
1875 ered not displayable and represented as '?'. Otherwise, all charac‐
1876 ter sets are regarded as compatible with the display. If it's not
1877 set, the value of the environment variable $MM_CHARSET is used. US-
1878 ASCII or compile-time default is used in case neither of them is
1879 defined. If your system supports iconv(3), this option is disabled
1880 and you should use mm_network_charset instead.
1881 MM_NETWORK_CHARSET (mm_network_charset)
1883 Charset used for posting and MIME headers; replaces mm_charset.
1884 Conversion between mm_network_charset and local charset (determined
1885 via nl_langinfo(3)) is done via iconv(3), if this function is not
1886 available on your system this option is disabled and you have to
1887 use mm_charset instead. mm_network_charset is limited to one of the
1888 following charsets:
1889 US-ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16}, KOI8-{R,U,RU}
1890 EUC-{CN,JP,KR,TW}, ISO-2022-{CN,CN-EXT,JP,JP-1,JP-2}, Big5,
1891 UTF-8
1892 Not all values might work on your system, see iconv_open(3) for
1893 more details. If it's not set, the value of the environment vari‐
1894 able $MM_CHARSET is used. US-ASCII or compile-time default is used
1895 in case neither of them is defined.
1896 Attribute of highlighting with _dash_ (mono_markdash)
1898 Character attribute of words emphasized like _this_. It depends on
1899 your terminal which attributes are usable. See also word_h_dis‐
1900 play_marks and word_highlight.
1901 Attribute of highlighting with /slash/ (mono_markslash)
1903 Character attribute of words emphasized like /this/. It depends on
1904 your terminal which attributes are usable. See also word_h_dis‐
1905 play_marks and word_highlight.
1906 Attribute of highlighting with *stars* (mono_markstar)
1908 Character attribute of words emphasized like *this*. It depends on
1909 your terminal which attributes are usable. See also word_h_dis‐
1910 play_marks and word_highlight.
1911 Attribute of highlighting with -stroke- (mono_markstroke)
1913 Character attribute of words emphasized like -this-. It depends on
1914 your terminal which attributes are usable. See also word_h_dis‐
1915 play_marks and word_highlight.
1916 (newnews)
1918 These are internal timers used by tin to keep track of new news‐
1919 groups. Do not change them unless you understand what they are
1920 for.
1921 Display these header fields (or *) (news_headers_to_display)
1923 Which news headers you wish to see. If you want to see _all_ the
1924 headers, place an '*' as this value. This is the only way a wild‐
1925 card can be used. If you enter 'X-' as the value, you will see all
1926 headers beginning with 'X-' (like X-Alan or X-Pape). You can list
1927 more than one by delimiting with spaces. Not defining anything
1928 turns off this option.
1929 Do not display these header fields (news_headers_to_not_display)
1931 Same as news_headers_to_display except it denotes the opposite. An
1932 example of using both options might be if you thought 'X-' headers
1933 were A Good Thing(tm), but thought Alan and Pape were miscreants...
1934 well then you would do something like this: news_headers_to_dis‐
1935 play=X- news_headers_to_not_display=X-Alan X-Pape Not defining any‐
1936 thing turns off this option.
1937 Quote line when following up (news_quote_format)
1939 Format of quote line when posting/following up an article
1940 (%A=Address, %D=Date, %F=Fullname+Address, %G=Groupname, %M=Mes‐
1941 sage-ID, %N=Fullname, %C=Firstname, %I=Initials). Default is "%F
1942 wrote:".
1943 NNTP read timeout in seconds (nntp_read_timeout_secs)
1945 Time in seconds to wait for a response from the server. Default is
1946 120. Setting this to 0 means no timeout.
1947 Unicode normalization form (normalization_form)
1949 The normalization form tin should use to normalize unicode input.
1950 The possible values are:
1951 0 None: no normalization
1953 1 NFKC: Compatibility Decomposition, followed by Canonical Compo‐
1955 sition
1956 2 NFKD: Compatibility Decomposition
1958 3 NFC: Canonical Decomposition, followed by Canonical Composition
1960 4 NFD: Canonical Decomposition
1962 Some normalization modes are only available if they are supported by
1963 the library tin uses to do the normalization. NFC should be used if
1964 possible.
1965 Go to first unread article in group (pos_first_unread)
1967 If ON put cursor at first unread article in group otherwise at last
1968 article. Default is ON.
1969 Use 8bit characters in news headers (post_8bit_header)
1971 Allows 8bit characters unencoded in the header of a news article,
1972 if set this also disables the generation of MIME-headers when they
1973 are usually required. Default is OFF. Only enacted if
1974 post_mime_encoding is also set to 8bit. In a number of local hier‐
1975 archies where 8bit characters are used, using unencoded (raw) 8bit
1976 characters in header is acceptable and sometimes even recommended
1977 so that you need to check the convention adopted in the local hier‐
1978 archy of your interest to determine what to do with this and
1979 post_mime_encoding.
1980 MIME encoding in news messages (post_mime_encoding)
1982 MIME encoding of the body in news message, if necessary. (8bit,
1983 base64, quoted-printable, 7bit). Default is 8bit, which leads to no
1984 encoding. base64 and quoted-printable are usually undesired on
1985 usenet.
1986 View post-processed files (post_process_view)
1988 If ON, then tin will start an appropriate viewer program to display
1989 any files that were post processed and uudecoded. The program is
1990 determined using the mailcap(5) file. Default is ON.
1991 Post process saved articles (post_process_type)
1993 This specifies whether to perform post processing on saved arti‐
1994 cles. The following values are allowed:
1995 0 No (default), no post processing is done.
1997 1 Shell archives, unpacking of multi-part shar(1) files only.
1999 2 Yes, binary attachments and data will be decoded and saved.
2001 Filename to be used for storing posted articles (posted_articles_file)
2003 Keep posted articles in ${TIN_HOMEDIR:-"$HOME"}/Mail/posted_arti‐
2004 cles_file. If no filename is set then postings will not be saved.
2005 Default is 'posted'.
2006 Print all headers when printing (print_header)
2008 If ON, then the full article header is sent to the printer. Other‐
2009 wise only the ''Subject:'' and ''From:'' fields are output. Default
2010 is OFF.
2011 Printer program with options (printer)
2013 The printer program with options that is to be used to print arti‐
2014 cles. The default is lpr(1) for BSD machines and lp(1) for SysV
2015 machines. Printing from tin may have been disabled by the System
2016 Administrator.
2017 Process only unread articles (process_only_unread)
2019 If ON only save/print/pipe/mail unread articles (tagged articles
2020 excepted). Default is OFF.
2021 Show empty Followup-To in editor (prompt_followupto)
2023 If ON show empty ''Followup-To:'' header when editing an article.
2024 Default is OFF.
2025 Characters used as quote-marks (quote_chars)
2027 The character used in quoting included text to article followups
2028 and mail replies. The '_' character represents a blank character
2029 and is replaced with ' ' when read. Default is '>_'.
2030 Quoting behavior (quote_style)
2032 How articles should be quoted when following up or replying to
2033 them. There are a number of things that can be done: empty lines
2034 can be quoted, signatures can be quoted and quote_chars can be com‐
2035 pressed when quoting multiple times (for example, '> > >' will be
2036 turned into '>>>'). The default is to compress quotes, and to quote
2037 empty lines.
2038 When you are viewing an article in raw mode ('^H'), and follow up
2039 or reply to it, the signature will be quoted even if it would oth‐
2040 erwise not be. If show_signatures is off, then the signature will
2041 never be quoted.
2042 Regex used to show quoted lines (quote_regex)
2044 A regular expression that will be applied when reading articles.
2045 All matching lines are shown in col_quote. If quote_regex is blank,
2046 then tin uses a built-in default.
2047 Regex used to show twice quoted l. (quote_regex2)
2049 A regular expression that will be applied when reading articles.
2050 All matching lines are shown in col_quote2. If quote_regex2 is
2051 blank, then tin uses a built-in default.
2052 Regex used to show >= 3 times q.l. (quote_regex3)
2054 A regular expression that will be applied when reading articles.
2055 All matching lines are shown in col_quote3. If quote_regex3 is
2056 blank, then tin uses a built-in default.
2057 Article recentness time limit (recent_time)
2059 If set to 0, this feature is deactivated, otherwise it means the
2060 number of days. Default is 2.
2061 Render BiDi (render_bidi)
2063 If ON tin does the rendering of bi-directional text. If OFF tin
2064 leaves the rendering of bi-directional text to the terminal.
2065 Default is OFF.
2066 Interval in seconds to reread active (reread_active_file_secs)
2068 The news ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active} file
2069 is reread at regular intervals to show if any new news has arrived.
2070 Default is 1200. Setting this to 0 will disable this feature.
2071 Directory to save arts/threads in (savedir)
2073 Directory where articles/threads are saved. Default is ${TIN_HOME‐
2074 DIR:-"$HOME"}/News.
2075 Score limit (kill) (score_limit_kill)
2077 If the score of an article is below or equal this value the article
2078 gets marked as killed.
2079 Score limit (select) (score_limit_select)
2081 If the score of an article is above or equal this value the article
2082 gets marked as hot.
2083 Default score to kill articles (score_kill)
2085 Score of an article which should be killed, this must be <=
2086 score_limit_kill.
2087 Default score to select articles (score_select)
2089 Score of an article which should be marked hot, this must be >=
2090 score_limit_select.
2091 Number of lines to scroll in pager (scroll_lines)
2093 The number of lines that will be scrolled up/down in the article
2094 pager when using cursor-up/down. The default is 1 (line-by-line).
2095 Set to 0 to get traditional tin page-by-page scrolling. Set to -1
2096 to get page-by-page scrolling where the top/bottom line is carried
2097 over onto the next page. This setting supersedes
2098 show_last_line_prev_page=ON. Set to -2 to get half-page scrolling.
2099 This setting supersedes full_page_scroll=OFF.
2100 Format string for the Selection level (select_format)
2102 Format string tin uses for Selection level representation. See the
2103 section "CUSTOMIZING THE SCREEN FORMAT". Default is
2104 "%f %n %U %G %d".
2105 In group and thread level, show author by (show_author)
2107 Which information about the author should be shown. Default is 2,
2108 authors full name.
2109 0 None, only the ''Subject:'' line will be displayed.
2111 1 Address, ''Subject:'' line & the address part of the ''From:''
2113 line are displayed.
2114 2 Full Name, ''Subject:'' line & the authors full name part of
2116 the ''From:'' line are displayed (default).
2117 3 Address and Name, ''Subject:'' line & all of the ''From:'' line
2119 are displayed.
2120 Show description of each newsgroup (show_description)
2122 If ON show a short group description text after newsgroup name at
2123 the group selection level. The ''-d'' command-line flag will over‐
2124 ride the setting and turn descriptions off. The text used is taken
2125 from the ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups file and if supported
2126 (requires tin to be build with mh-mail-handling support) from
2127 ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups for mailgroups. Default is
2128 ON.
2129 Function for sorting articles (sort_function)
2131 Function used for sorting articles. Default is 0.
2132 0 Use qsort(3) for sorting.
2134 1 Use heapsort(3) for sorting. This might be faster in large
2136 groups with long threads (somewhat presorted data).
2137 Show lines/score in listings (show_info)
2139 Which information about the thread or article should be shown.
2140 Default is 1, show only the line count.
2141 0 None, no information will be displayed.
2143 1 Lines, in article listing the line count of an article will be
2145 displayed and in thread listing the line count of first
2146 (unread) article will be displayed.
2147 2 Score, in article listing the score of an article will be dis‐
2149 played and in thread listing the score of the thread will be
2150 displayed - see also thread_score.
2151 3 Lines & Score, display line count and score.
2153 Show only unread articles (show_only_unread_arts)
2155 If ON show only new/unread articles otherwise show all articles.
2156 Default is ON.
2157 Show only groups with unread arts (show_only_unread_groups)
2159 If ON show only subscribed groups that contain unread articles.
2160 Default is OFF.
2161 Display signatures (show_signatures)
2163 If OFF don't show signatures when displaying articles. Default is
2164 ON.
2165 Prepend signature with '\n-- \n' (sigdashes)
2167 If ON prepend the signature with sigdashes. Default is ON.
2168 Create signature from path/command (sigfile)
2170 The path that specifies the signature file to use when posting,
2171 following up to or replying to an article. If the path is a direc‐
2172 tory then the signature will be randomly generated from files that
2173 are in the specified directory. If the path starts with a ! the
2174 program the path points to will be executed to generate a signa‐
2175 ture. In order to pass the group name to the program, %G can be
2176 specified. This will be replaced by the name of the current news‐
2177 group. --none will suppress any signature. Default is ${TIN_HOME‐
2178 DIR:-"$HOME"}/.Sig.
2179 Add signature when reposting (signature_repost)
2181 If ON add signature to reposted articles. Default is ON.
2182 Regex used to highlight /slashes/ (slashes_regex)
2184 A regular expression that will be applied when reading articles.
2185 All matching words are shown in col_markslash or mono_markslash. If
2186 slashes_regex is blank, then tin uses a built-in default.
2187 Sort articles by (sort_article_type)
2189 This specifies how articles should be sorted. Sort by ascending
2190 Date (6) is the default. The following sort types are allowed:
2191 0 Nothing, don't sort articles.
2193 1 Subject: (descending), sort articles by ''Subject:'' field
2195 descending.
2196 2 Subject: (ascending), sort articles by ''Subject:'' field
2198 ascending.
2199 3 From: (descending), sort articles by ''From:'' field descend‐
2201 ing.
2202 4 From: (ascending), sort articles by ''From:'' field ascending.
2204 5 Date: (descending), sort articles by ''Date:'' field descend‐
2206 ing.
2207 6 Date: (ascending), sort articles by ''Date:'' field ascending
2209 (default).
2210 7 Score (descending), sort articles by filtering score descend‐
2212 ing.
2213 8 Score (ascending), sort articles by filtering score ascending.
2215 9 Lines: (descending), sort articles by ''Lines:'' field descend‐
2217 ing.
2218 10 Lines: (ascending), sort articles by ''Lines:'' field ascend‐
2220 ing.
2221 Sort threads by (sort_threads_type)
2223 This specifies how threads will be sorted. Sort by descending Score
2224 (1) is the default. The following sort types are allowed:
2225 0 Nothing, don't sort threads.
2227 1 Score (descending), sort threads by filtering score descending
2229 (default).
2230 2 Score (ascending), sort threads by filtering score ascending.
2232 3 Last posting date (descending), sort threads by date of last
2234 posting descending.
2235 4 Last posting date (ascending), sort threads by date of last
2237 posting ascending.
2238 Spamtrap warning address parts (spamtrap_warning_addresses)
2240 Set this option to a list of comma-separated strings to be warned
2241 if you are replying to an article by mail where the e-mail address
2242 contains one of these strings. The matching is case-insensitive.
2243 Example:
2244 spam,delete,remove
2246 Regex used to highlight *stars* (stars_regex)
2248 A regular expression that will be applied when reading articles.
2249 All matching words are shown in col_markstar or mono_markstar. If
2250 stars_regex is blank, then tin uses a built-in default.
2251 Start editor with line offset (start_editor_offset)
2253 Set ON if the editor used for posting, follow-ups and bug reports
2254 has the capability of starting and positioning the cursor at a
2255 specified line within a file. Default is ON.
2256 Strip blanks of end of lines (strip_blanks)
2258 Strips the blanks from the end of each line therefore speeding up
2259 the display when reading on a slow terminal or via modem. Default
2260 is ON.
2261 Remove bogus groups from newsrc (strip_bogus)
2263 Bogus groups are groups that are present in your ${TIN_HOME‐
2264 DIR:-"$HOME"}/.newsrc file that no longer exist on the news server.
2265 There are 3 options. 0 means do nothing & always keep bogus groups.
2266 1 means bogus groups will be permanently removed. 2 means that
2267 bogus groups will appear on the Group Selection Menu, prefixed with
2268 a 'D'. This allows you to unsubscribe from them as and when you
2269 wish. Default is 0 (Always Keep).
2270 No unsubscribed groups in newsrc (strip_newsrc)
2272 If ON, then unsubscribed groups will be permanently removed from
2273 your ${TIN_HOMEDIR:-"$HOME"}/.newsrc file. Default is OFF.
2274 Regex used to highlight -strokes- (strokes_regex)
2276 A regular expression that will be applied when reading articles.
2277 All matching words are shown in col_markstroke or mono_markstroke.
2278 If strokes_regex is blank, then tin uses a built-in default.
2279 Wrap around threads on next unread (wrap_on_next_unread)
2281 If enabled a search for the next unread article will wrap around
2282 all articles to find also previous unread articles. If disabled the
2283 search stops at the end of the thread list. Default is ON.
2284 Display "a as Umlaut-a (tex2iso_conv)
2286 If ON, show "a as Umlaut-a, etc. Default is OFF. This behavior can
2287 also be toggled in the article viewer via PageToggleTex2iso ('"').
2288 Thread articles by (thread_articles)
2290 Defines which threading method to use. It's possible to set the
2291 threading type on a per group basis by setting the group attribute
2292 variable thread_arts to 0 - 4 in the file ${TIN_HOME‐
2293 DIR:-"$HOME"}/.tin/attributes. (See also "GROUP ATTRIBUTES".) The
2294 default is Both Subject and References. The choices are:
2295 0 None, don't thread.
2297 1 Subject, thread on ''Subject:'' only.
2299 2 References, thread on ''References:'' only.
2301 3 Both Subject and References, thread on ''References:'' then
2303 ''Subject:'' (default).
2304 4 Multipart Subject, thread multipart articles on ''Subject:''.
2306 5 Percentage Match, thread base upon a partial character match on
2308 ''Subject:''.
2309 Catchup thread by using left key (thread_catchup_on_exit)
2311 If ON catchup group/thread when leaving with the left arrow key.
2312 Default is ON.
2313 Format string for the Thread level (thread_format)
2315 Format string tin uses for Thread level representation. See the
2316 section "CUSTOMIZING THE SCREEN FORMAT". Default is
2317 "%n %m [%L] %T %F".
2318 Matchingness of a thread (thread_perc)
2320 How closely the subjects must match for two threads to be consid‐
2321 ered part of the same thread. This is a percentage and the default
2322 if 75%.
2323 Score of a thread (thread_score)
2325 How the total score of a thread is computed. Default is 0, the max‐
2326 imum score in this thread.
2327 0 Max, the maximum score in this thread.
2329 1 Sum, the sum of all scores in this thread.
2331 2 Average, the average score in this thread.
2333 Transliteration (translit)
2335 If ON append //TRANSLIT to the first argument of iconv_open(3) to
2336 enable transliteration. This means that when a character cannot be
2337 represented in the target character set, it can be approximated
2338 through one or several similarly looking characters. On systems
2339 where this extension doesn't exist, this option is disabled.
2340 Default is OFF.
2341 How to treat blank lines (trim_article_body)
2343 Allows you to select how tin treats blank lines in article bodies.
2344 Default is 0. This option does not affect lines within verbatim
2345 blocks.
2346 0 Don't trim article body, do nothing.
2348 1 Skip leading blank lines.
2350 2 Skip trailing blank lines.
2352 3 Skip leading and trailing blank l., skip leading and trailing
2354 blank lines.
2355 4 Compact multiple between text, replace multiple blank lines
2357 between textblocks with one blank line.
2358 5 Compact multiple and skip leading, 4 + 1
2360 6 Compact multiple and skip trailing, 4 + 2
2362 7 Compact mltpl., skip lead. & trai., 4 + 3
2364 Regex used to highlight _underline_ (underscores_regex)
2366 A regular expression that will be applied when reading articles.
2367 All matching words are shown in col_markdash or mono_markdash. If
2368 underscores_regex is blank, then tin uses a built-in default.
2369 Remove ~/.article after posting (unlink_article)
2371 If ON remove ~/.article after posting. Default is ON.
2372 Program that opens URLs (url_handler)
2374 The program that will be run when launching URLs in the article
2375 viewer using PageViewUrl ('U'). The actual URL will be appended to
2376 this. Default is url_handler.pl %s.
2377 URL highlighting in message body (url_highlight)
2379 Enable highlighting URLs in message body. Default is ON.
2380 Use ANSI color (use_color)
2382 If enabled tin uses ANSI-colors. Default is OFF.
2383 Use scroll keys on keypad (use_keypad)
2385 Default is OFF.
2386 Use mouse in xterm (use_mouse)
2388 Allows the mouse button support in a xterm(1x) to be enabled/dis‐
2389 abled. Default is OFF.
2390 Use slrnface to show ''X-Face:''s (use_slrnface)
2392 If enabled tin uses slrnface(1) to interpret the ''X-Face:''
2393 header. For this option to have any effect, tin must be running in
2394 a xterm(1x) and slrnface(1) must be in your $PATH. Default is OFF.
2395 Use UTF-8 graphics (utf8_graphics)
2397 If ON use UTF-8 characters for indicator ('->'), thread/attachment
2398 tree and ellipsis ('...'). Default is OFF.
2399 Regex for begin of a verbatim block (verbatim_begin_regex)
2401 A regular expression that tin will use to find the begin of a ver‐
2402 batim block.
2403 Regex for end of a verbatim block (verbatim_end_regex)
2405 A regular expression that tin will use to find the end of a verba‐
2406 tim block.
2407 Detection of verbatim blocks (verbatim_handling)
2409 If ON verbatim blocks will be detected. Default is ON.
2410 Wildcard matching (wildcard)
2412 Allows you to select how tin matches strings. The default is 0 and
2413 uses the wildmat notation, which is how this has traditionally been
2414 handled. Setting this to 1 allows you to use perl(1) compatible
2415 regular expressions pcre(3) (see also perlre(1) and
2416 pcrepattern(3)). You will probably want to update your filter file
2417 if you use this regularly. NB: Newsgroup names will always be
2418 matched using the wildmat notation.
2419 What to display instead of mark (word_h_display_marks)
2421 Should the leading and ending stars, slashes, strokes and dashes
2422 also be displayed, even when they are highlighting marks?
2423 0 no
2425 1 yes, display mark
2427 2 print a space instead
2429 Word highlighting in message body (word_highlight)
2431 Enable word highlighting. See word_h_display_marks for the options
2432 available. If use_color is enabled the colors specified in
2433 col_markdash, col_markslash, col_markstar and col_markstroke are
2434 used for word highlighting else the character attributes specified
2435 in mono_markdash, mono_markslash, mono_markstar and mono_markstroke
2436 are used. Default is ON.
2437 Page line wrap column (wrap_column)
2439 Sets the column at which a displayed article body should be
2440 wrapped. If this value is equal to 0, it defaults to the current
2441 screen width. If this value is greater than your current screen
2442 width the part off-screen is not displayed. Thus setting this
2443 option to a large value can be used to disable wrapping. If this
2444 value is negative the wrap margin is the current screen width plus
2445 the given value (as long as the result is still positive, otherwise
2446 it will fall back to the current screen width). Default is 0, wrap‐
2447 ping at the current screen width.
2448 Quote line when crossposting (xpost_quote_format)
2450 Format is the same as for news_quote_format, this is used when
2451 answering to a crossposting to several groups with no ''Fol‐
2452 lowup-To:'' set.
2453 ATTRIBUTES MENU AND GROUP ATTRIBUTES
2455 tin allows certain attributes to be set on a per group basis. If it
2456 exists, the global attributes file, ${TIN_LIBDIR:-NEWSLIB‐
2457 DIR}/attributes is read. After that, the user's own attributes file
2458 ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes is read. The global attributes
2459 file is useful for distributing system-wide defaults to new users who
2460 have no private attributes file yet.
2461 Note that the scope=<grouplist> line has to be specified before the
2463 attributes are specified for that list. All attributes are set to a
2464 reasonable default so you only have to specify the attribute that you
2465 want to change (e.g., savedir). All toggle attributes are set by speci‐
2466 fying ON/OFF. Otherwise, these function exactly the same as their
2467 global equivalents. For more details see tin(5).
2468 Attributes can also be changed from the attributes menu which can be
2470 accessed by ConfigToggleAttrib ('<TAB>') from the options menu or
2471 ScopeSelect ('^J' or '<CR>') from the scopes menu. The attributes menu
2472 looks and behaves very similar to the options menu. The title shows the
2473 current scope. Attributes set in the current scope are marked with '+'
2474 to the left of the attributes number.
2475 Besides the keys for moving around and changing values known from the
2477 options menu the attributes menu provides the following command: Confi‐
2478 gResetAttrib ('r') which resets an attribute to a default value.
2479 SCOPES MENU
2481 The scopes menu (accessible from the options menu with ConfigScopeMenu
2482 ('S')) shows all scopes read from the global and local attributes file.
2483 Scopes from the global attributes file are marked with '!' to the left
2484 of the scope number. Delete/rename/move are not possible with those
2485 scopes.
2486 In addition to the common moving keys the following commands are avail‐
2488 able: ScopeSelect ('^J' or '<CR>') enter the attributes menu for the
2489 current scope, ScopeEditAttributesFile ('E') edit the local attributes
2490 file, ScopeAdd ('a') add a new scope, ScopeDelete ('d') delete the cur‐
2491 rent scope, ScopeMove ('m') move the current scope to a new position,
2492 ScopeRename ('r') rename the current scope. ToggleHelpDisplay ('H')
2493 toggles the help mini menu at the bottom of the screen.
2494 FILTERING ARTICLES
2496 When there is a subject or an author which you are either very inter‐
2497 ested in, or find completely uninteresting, you can easily instruct tin
2498 to auto-select or auto-kill articles that match rules that you specify.
2499 This can be anything from the name of the author to the number of lines
2500 in an article.
2501 When tin starts up the user's kill-file ${TIN_HOME‐
2503 DIR:-"$HOME"}/.tin/filter (see also tin(5)) is read. Each time a news‐
2504 group is entered the rules are applied and articles killed or selected
2505 when they meet certain criteria.
2506 The degree to which rules are applied depend on the kill_level tinrc
2508 setting. By default killed articles will only be marked read. Adjust
2509 kill_level for more aggressive processing. Articles that match an auto-
2510 selection rule are marked with a ''*''.
2511 Filtering rules can be manually entered into ${TIN_HOME‐
2513 DIR:-"$HOME"}/.tin/filter (but don't do this whilst running tin else
2514 you will lose your changes) or by using an on-screen menu within tin.
2515 The filtering capabilities of tin have been significantly enhanced over
2517 previous versions to include scoring and better pattern matching. It is
2518 recommended that you read the file filtering in the tin documentation
2519 directory. This file can also be read online at
2520 <http://www.tin.org/filtering.txt>.
2521 The on-screen filtering menu is accessed by pressing MenuFilterKill
2523 ('^K') or MenuFilterSelect ('^A') at the Group and Article levels. It
2524 allows the user to kill or select an article that matches the current
2525 ''Subject:'' line, ''From:'' line or a string entered by the user. The
2526 user entered string can be applied to the ''Subject:'' or ''From:''
2527 line of an article. The filter can be limited to the current newsgroup
2528 or it can apply to all newsgroups. Once entered the user can abort the
2529 command and not save the new filter, edit the full filter file or save
2530 filter.
2531 POSTING ARTICLES
2533 tin allows posting of articles, follow-up to already posted articles
2534 and replying direct through mail to the author of an article.
2535 Use the Post ('w') command to post an article to a newsgroup. After
2537 entering the post subject the default editor (i.e., vi(1)) or the edi‐
2538 tor specified by the $VISUAL or $EDITOR environment variable will be
2539 started and the article can be entered. To crosspost articles simply
2540 add a comma and the name of the newsgroup(s) to the end of the ''News‐
2541 groups:'' line at the beginning of the article. After saving and exit‐
2542 ing the editor you are asked if you wish to a)bort posting the article,
2543 e)dit the article again or p)ost the article to the specified news‐
2544 group(s).
2545 Use the DisplayPostHist ('W') command to display a history of the arti‐
2547 cles you have posted. The date the article was posted, which newsgroups
2548 the article was posted to and the articles subject line are displayed.
2549 Use the PageFollowupQuote ('f'), PageFollowup ('F') or PageFol‐
2551 lowupQuoteHeaders ('^W') command to post a follow-up article to an
2552 already posted article. The PageFollowupQuote command will copy the
2553 text of the original article into the editor. The PageFollowupQuote‐
2554 Headers command will copy the text and all headers of the original
2555 article into the editor. The editing procedure is the same as when
2556 posting an article with the Post ('w') command.
2557 Use the PageReplyQuote ('r'), PageReply ('R') or PageReplyQuoteHeaders
2559 ('^E') command to reply direct through mail to the author of an already
2560 posted article. The PageReplyQuote command will copy the text of the
2561 original article into the editor. The PageReplyQuoteHeaders command
2562 will copy the text and all headers of the original article into the
2563 editor. The editing procedure is the same as when posting an article
2564 with the Post ('w') command. After saving and exiting the editor you
2565 are asked if you wish to abort sending the article via PostAbort ('a'),
2566 edit the article again via PostEdit ('e') or send the article to the
2567 author via PostSend ('s').
2568 CUSTOMIZING THE ARTICLE QUOTE STRING
2570 When posting a followup to an article or replying direct to the author
2571 of an article via email the text of the article can be quoted. The
2572 beginning of the quoted text can contain information about the quoted
2573 article (e.g., Name and the Message-ID of the article). To allow for
2574 different situations certain information from the article can be used
2575 in the quoted string. The following variables are expanded if found in
2576 the tinrc variables mail_quote_format, news_quote_format or
2577 xpost_quote_format:
2578 %A Address (Email)
2579 %D Date (uses date_format)
2580 %F Full address (%N <%A>)
2581 %G Groupname
2582 %M Message-ID
2583 %N Fullname of author
2584 %C Firstname of author
2585 %I Initials of author
2586 e.g.,
2587 mail_quote_format=On %D in %G you wrote:
2588 news_quote_format=In %M, %F wrote:
2589 would expand to:
2590 On 21 Sep 1993 09:45:51 -0400 in alt.sources you wrote:
2591 In <abcINN123@example.org>, Joe Bar <joe@example.org> wrote:
2592 The quoted text section of an article is marked by a preceding quote
2593 string at the beginning of each quoted line. The default quote string
2594 is set to '>_'. The default can be changed by setting the tinrc vari‐
2595 able quote_chars to ones own preference. (Note that '_' underline is
2596 used to represent a space).
2597 MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES
2599 The command interface to GroupMail, PageMail, PostMail or ThreadMail
2600 ('m'), Pipe ('|'), Print ('o'), PageRepost or GroupRepost ('x') and
2601 GroupSave, PageSave or ThreadSave ('s' and GroupAutoSave, PageAutoSave
2602 or ThreadAutoSave 'S') articles is the same for ease of use.
2603 Auto-saving with *AutoSave ('S') is a special case and operates only on
2605 marked articles. They will processed without any further prompting
2606 according to the default save parameters defined in tinrc or by any
2607 attributes set for the current group.
2608 Otherwise, the initial prompt will ask you to select which article,
2610 thread, hot (auto-selected), regular expression pattern, tagged arti‐
2611 cles you wish to mail, pipe etc.
2612 Tagged articles must have already been tagged with a *Tag ('t') com‐
2614 mand. All tagged articles can be untagged by a *Untag ('U') untag com‐
2615 mand.
2616 If a regular expression pattern is selected you are asked to enter a
2618 pattern (e.g., to match all articles subject lines containing 'net
2619 News' you enter "net News"). Any articles that match the entered
2620 expression will be mailed, piped etc. See also the wildcard tinrc vari‐
2621 able for advanced pattern matching options.
2622 Various expansion characters are recognized when entering the directory
2624 and file to save to. Environment variables (prefixed with '$') and user
2625 home directories (prefixed by '~' or '~username') can be specified.
2626 Environment variables can themselves contain other special characters.
2627 To save articles to a mailbox enter '=<mailbox name>' when asked for
2629 the save filename. If you enter just '=' then articles will be saved to
2630 a mailbox with the name of the current newsgroup (eg, alt.sources).
2631 See maildir.
2632 To save in savedir/<news.group.name>/<filename> format enter '+<file‐
2634 name>'. Environment variables are allowed within a filename (e.g.,
2635 $SOURCES/dir/filename). See savedir.
2636 When saving articles you can specify whether the saved files should be
2638 post processed. A default process type can be set via
2639 post_process_type.
2640 AUTOMATIC MAILING AND SAVING NEW NEWS
2642 tin allows new/unread news articles to be mailed (''-M'' and ''-N''
2643 option) or saved (''-S'' option) in batch mode for later reading. Use‐
2644 ful when going on holiday and you don't want to return and find that
2645 expire has removed a whole load of unread articles. Best to run via
2646 cron(1) everyday while away, after which you will be mailed a report of
2647 which articles were mailed/saved from which newsgroups and the total
2648 number of articles mailed/saved. Articles are saved in a private news
2649 structure under your savedir directory (default is ${TIN_HOME‐
2650 DIR:-"$HOME"}/News). Be careful of using this option if you read a lot
2651 of groups because you could overflow your file system.
2652 When using ''-S'' together with a given directory to save to (''-s''
2654 option), the same directory must be specified when reading the articles
2655 by ''-R''.
2656 If you only want to save some of your groups use the batch_save tinrc
2658 variable. Set to ON or OFF in tinrc to enable/disable saving of all
2659 groups and then use the batch_save attribute to fine tune which groups
2660 you want to have saved. For example, if you want to save most of your
2661 groups, then set batch_save to ON in tinrc and selectively turn off the
2662 ones you don't want using attributes.
2663 tin -M iain -c -f newsrc.mail
2665 (mail any unread articles in newsgroups specified
2666 in file newsrc.mail to the local user iain and mark
2667 them as read)
2668 tin -S -c -f newsrc.save
2670 (save any unread articles in newsgroups specified
2671 in file newsrc.save and mark them as read)
2672 tin -R (read any articles saved by tin -S)
2674 RANGES
2676 A range is simply a group of items marked using the SetRange ('#') key.
2677 Certain tin commands will operate on a range if one exists rather than
2678 just the current item. A range is an expression of the form
2679 <min>-<max>, e.g. 10-15 will highlight items 10 through 15 on the cur‐
2680 rent screen. Other than absolute numeric positions, '.' can be used in
2681 place of the current cursor position and '$' can be used to mean the
2682 highest number available. Currently the only commands that understand
2683 ranges are GroupMarkThdRead ('K'), MarkArtUnread ('z') and MarkThdUn‐
2684 read ('Z').
2685 NEWSGROUP LISTS & WILDCARDS
2687 Several places in tin allow you to specify a list of newsgroups. These
2688 include command-line groups, (un)subscribe groups, the AUTO[UN]SUB‐
2689 SCRIBE mechanism. The scope= attributes file tag and the filter file
2690 group= tag also use the same syntax. tin interprets this variable simi‐
2691 larly to rn(1). It contains a list of patterns, separated by commas
2692 and possibly prefixed with exclamation points. An exclamation point
2693 negates the meaning of a match on this pattern, and can be used to can‐
2694 cel certain matches. Some examples:
2695 alt.config,news.*,!news.test
2697 Matches alt.config and everything in the 'news' hierarchy except
2699 news.test
2700 See the explanation for the $AUTOSUBSCRIBE variables for further exam‐
2702 ples.
2703 SIGNATURES
2705 tin will recognize a signature in either ${TIN_HOMEDIR:-"$HOME"}/.sig‐
2706 nature or ${TIN_HOMEDIR:-"$HOME"}/.Sig. If ${TIN_HOME‐
2707 DIR:-"$HOME"}/.signature exists, then the signature will be pulled into
2708 the editor for mail commands only. A signature in ${TIN_HOME‐
2709 DIR:-"$HOME"}/.signature will not be pulled into the editor for posting
2710 commands since inews(1) will append the signature itself.
2711 A signature in ${TIN_HOMEDIR:-"$HOME"}/.Sig will be pulled into the
2713 editor for both posting and mailing commands.
2714 The following is an example of a .Sig file:
2716 NAMES Joe Bar <joe@example.org>
2717 SNAIL Musterweg 12, 99999 Notreal, Germany
2718 tin also has the capability to generate random signatures on a per
2720 newsgroup basis if so desired. The way to accomplish this is to specify
2721 the default signature or the group attribute sigfile as a directory. If
2722 for example the sigfile path is /usr/iain/.sigs and .sigs is a direc‐
2723 tory then tin will select a random signature from any file that is in
2724 the directory .sigs (note: one signature per numbered file). A random
2725 signature can also consist of a fixed part signature that can contain
2726 your name, address etc. followed by the random sig. The fixed part of
2727 the random sig is read from the file $HOME/.sigfixed.
2728 CUSTOMIZING THE SCREEN FORMAT
2730 The look of the Selection, Group and Thread level can be customized via
2731 format strings. These format strings define the content and the posi‐
2732 tion of each element on the screen. Variables are used within the for‐
2733 mat strings as placeholders. The following variables are available:
2734 %D date
2736 %F from, name and/or address
2737 %G newsgroup name
2738 %I initials
2739 %L line count
2740 %M message-id
2741 %R number of responses in thread
2742 %S score
2743 %T thread tree
2744 %U unread count
2745 %d newsgroup description
2746 %f newsgroup flag
2747 %m article marks
2748 %n current group/thread/article number
2749 %s subject
2750 %% %
2751 Not all variables can be used in each level. The following table pro‐
2753 vides an overview:
2754 select_format group_format thread_format
2756 %D X X
2757 %F X X
2758 %G X
2759 %I X X
2760 %L X X
2761 %M X X
2762 %R X
2763 %S X X
2764 %T X
2765 %U X
2766 %d X
2767 %f X
2768 %m X X
2769 %n X X X
2770 %s X
2771 %% X X X
2772 Defaults for the format strings:
2774 select_format: "%f %n %U %G %d"
2776 group_format: "%n %m %R %L %s %F"
2777 thread_format: "%n %m [%L] %T %F"
2778 show_description controls whether the newsgroup description is shown or
2780 not. The description can also be toggled with SelectToggleDescriptions
2781 ('d').
2782 The information displayed with '%F' depends on the value of
2784 show_author. GroupToggleSubjDisplay resp. ThreadToggleSubjDisplay
2785 ('d') switches through all available options.
2786 For date representation '%D' uses date_format. It is possible to spec‐
2788 ify a different date format in round brackets (e.g. '%(%d %b %y
2789 %H:%M)D'). See date_format for more details.
2790 The length of each item (except '%%') can be defined with a positive
2792 number after the '%'. The following example displays the score in the
2793 thread level 10 characters wide: '%10S'.
2794 If the newsgroup name is displayed together with the newsgroup descrip‐
2796 tion, the width of the newsgroup name can be controlled via a optional
2797 comma separated second value (e.g. '%60,20G'). It is valid to omit the
2798 first value (e.g. ('%,20G')). If no second value is given, tin uses a
2799 default value of 32.
2800 Some variables do have a default width which may lead to truncation.
2802 Truncation for variables which contain only numbers happens by dividing
2803 the value with a sufficient power of ten and adding a SI suffix to the
2804 result, that is the variable holds a value of 54321 and the width for
2805 the variable is 4 the result will be "54 k". If that's undesired you
2806 have to specify a larger width manually, e.g. '%6n'. Here is an over‐
2807 view of the defaults:
2808 Variable width
2810 %I 3
2811 %L 4
2812 %M 10
2813 %R 3
2814 %S 6
2815 %U 5
2816 %n 4
2817 If no length is given for '%D', the length is determined by the format
2819 string for the date and the date of the current day. If the date format
2820 string contains weekdays or months names it may happen that the date is
2821 longer than determined in the first pass. In this case, the date is
2822 truncated before display. This occurs, for example, if the current
2823 month is May and the article to which the date is displayed was posted
2824 in December. In such cases it might useful to determine the maximum
2825 length manually and specify the length in the format string.
2826 In case the format string contains '%G' and '%d' and no length are
2828 given, tin determines the longest newsgroup name and uses this length
2829 for '%G'. The remaining space will used for '%d'.
2830 When the format string contains the specifier '%F' and '%s' resp. '%T'
2832 and no length are given, '%F' will use one third and '%s' resp. '%T'
2833 will use two third of the available space.
2834 In addition, a minimum screen width can be defined for each item
2836 (except '%%'). In this case, the item will only be displayed when the
2837 screen is wider than specified. This comes in handy to not overload a
2838 small screen but have maximum information on a large screen. The mini‐
2839 mum screen width has to be specified by a positive number preceded by
2840 an '>'. In the following example tin will display the score only if the
2841 screen is wider than 100 characters: '%>100S'.
2842 If both the length and the minimum screen width should be specified for
2844 an item, the length must be the first parameter and the minimum screen
2845 width must be the second one. The following example displays the score
2846 with a length of 10 characters only if the screen is wider than 100
2847 characters: '%10>100S'.
2848 TIPS AND TRICKS
2850 tin can be pretty much be navigated by using the four cursor keys. The
2851 left arrow key goes up a level, the right arrow key goes down a level,
2852 the up arrow key goes up a line and the down arrow key goes down a
2853 line.
2854 The following newsgroups provide useful information concerning news
2856 software:
2857 —news.software.readers (info. about news user agents tin, rn, nn,
2858 slrn etc.)
2859 —news.software.nntp (info. about NNTP)
2860 —news.answers (Frequently Asked Questions (FAQ) about many differ‐
2861 ent themes)
2862 Many prompts within tin offer a default choice that the cursor is posi‐
2864 tioned on. By pressing '<CR>' the default value is taken. Most prompts
2865 can be aborted by pressing '<ESC>'.
2866 When tin is run in a xterm(1x) it will resize itself each time the
2868 xterm(1x) is resized.
2869 tin will reread the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE‐
2871 FILE:-active} file at set intervals (reread_active_file_secs) to show
2872 any newly arrived news.
2873 If you find large number of new newsgroups cluttering up your screen,
2875 pressing SelectToggleReadDisplay ('r') will make them go away.
2876 XTERM BUTTONS
2878 If the environment variable $TERM is set to xterm(1x), then button
2879 pressing can be used to select groups and articles. In this discussion,
2880 the buttons are assumed to be assigned conventionally (i.e., Button1 is
2881 the left button).
2882 In general (i.e., for the group, thread and article menus),
2884 Button1 (left)
2886 enters next (lower) level if you click on an article, other‐
2887 wise pages down.
2888 Button2 (center)
2890 returns to the previous (upper) level if you click on an
2891 article, otherwise pages up.
2892 Button3 (right)
2894 positions on the article line under mouse cursor, or pages
2895 down if you've clicked outside the list of articles.
2896 In the group selection menu, if the mouse is pointing at a group then:
2898 left button
2900 moves to and selects the group pointed at, just like Selec‐
2901 tReadGrp ('<CR>').
2902 center button
2904 quits the program, just like Quit ('q').
2905 right button
2907 moves to the group pointed at.
2908 In the article menu, if the mouse is pointing at an article (or thread)
2910 then:
2911 left button
2913 reads the article pointed at, just like GroupReadBasenote
2914 ('<CR>'), or the thread, just like GroupListThd ('l').
2915 center button
2917 exits the menu, catching up on the group if you have
2918 group_catchup_on_exit set in your configuration, just like
2919 Quit ('q').
2920 right button
2922 moves to the article (or thread) pointed at.
2923 In the thread menu, if the mouse is pointing at an article then:
2925 left button
2927 reads article pointed at, just like ThreadReadArt ('<CR>').
2928 center button
2930 exits the menu, catching up on the thread if you have
2931 thread_catchup_on_exit set in your configuration, just like
2932 Quit ('q').
2933 right button
2935 moves to the article pointed at.
2936 In other menus and areas button pressing reverts back to usual cut and
2938 paste of xterm(1x), but after one click of any button.
2939 INDEX FILES
2941 If your news server supports NOV index files (see newsoverview(5), most
2942 modern installations will) and you have a fast connection to your news
2943 server then this section can be ignored.
2944 If your news server doesn't support NOV index files or you have a very
2946 slow connection to your news server then tin can cache the index for
2947 each newsgroup if cache_overview_files is set to ON. Note that this
2948 cache can use up large amounts of disk space if you read a lot of
2949 groups and/or high traffic groups.
2950 Each user creates/updates his/her own index files that are stored in
2952 ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news/. If you are
2953 reading via NNTP then the news server name will be appended to keep the
2954 indexes for different servers separate. If you are reading off the
2955 local spool and local overview files already exist then turning on
2956 caching will have no effect. Likewise unless you see significant delays
2957 entering a group when reading via NNTP then turning on caching will
2958 have little or no effect.
2959 Entering a group the first time tends to be slow because the index file
2961 must be built from scratch. To alleviate the slowness start tin to cre‐
2962 ate all index files for the groups you subscribe to with tin -u -v and
2963 go for a coffee. Subsequent readings of a group will only need to do
2964 incremental updating of the index file and will be much faster as only
2965 new articles will need to be cached.
2966 As indexing might take some time you may want to run tin form the sys‐
2968 tem batcher cron(1) with the ''-u'' option:
2969 30 6 * * * /usr/local/bin/tin -u
2971 If you are low on local disk space you should consider to manually
2973 purge cached data for groups you are not reading anymore with something
2974 like:
2975 find ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news* \
2977 -type f -name "[0-9]*.[0-9]" -atime +28 | xargs rm -f
2978
2980 For a detailed description see tin(5).
2981 $MAILCAPS
2983 ~/.mailcap
2984 /etc/mailcap
2985 /usr/etc/mailcap
2986 /usr/local/etc/mailcap
2987 /etc/mail/mailcap
2988 /etc/nntpserver
2990 ${TIN_HOMEDIR:-"$HOME"}/.cancelsecret
2992 ${TIN_HOMEDIR:-"$HOME"}/.mime.types
2994 /etc/mime.types
2995 /etc/tin/mime.types
2996 ${TIN_HOMEDIR:-"$HOME"}/.newsauth
2998 ${TIN_HOMEDIR:-"$HOME"}/.newsrc
3000 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/.oldnewsrc
3002 ${TIN_HOMEDIR:-"$HOME"}/.signature
3004 ${TIN_HOMEDIR:-"$HOME"}/.Sig
3005 ${TIN_HOMEDIR:-"$HOME"}/.sigfixed
3007 ${TIN_HOMEDIR:-"$HOME"}/.tin/.inputhistory
3009 ${TIN_INDEX_MAILDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.mail/
3011 ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news${NNTPSERVER:+"-$NNTPSERVER"}/
3013 ${TIN_INDEX_SAVEDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.save/
3015 ${TIN_HOMEDIR:-"$HOME"}/.tin/active.mail
3017 ${TIN_HOMEDIR:-"$HOME"}/.tin/active.save
3019 /etc/tin/attributes
3021 ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes
3022 ${TIN_HOMEDIR:-"$HOME"}/.tin/filter
3024 /etc/tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
3026 ${TIN_HOMEDIR:-"$HOME"}/.tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
3027 ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups
3029 ${TIN_HOMEDIR:-"$HOME"}/.tin/newsrctable
3031 ${TIN_HOMEDIR:-"$HOME"}/.tin/posted
3033 ${TIN_HOMEDIR:-"$HOME"}/Mail/posted
3035 ${TIN_HOMEDIR:-"$HOME"}/.tin/postponed.articles
3037 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER:${NNTPPORT:+":$NNTPPORT"}/newsgroups
3039 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER:${NNTPPORT:+":$NNTPPORT"}/serverrc
3041 /etc/tin/tinrc
3043 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc
3044 /etc/tin/tin.defaults
3046 /usr/local/share/locale/${LC_MESSAGES}/LC_MESSAGES/tin.mo
3048 ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active}
3050 ${TIN_LIBDIR:-NEWSLIBDIR}/active.times
3052 ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups
3054 ${TIN_LIBDIR:-NEWSLIBDIR}/organization
3056 ${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt
3058 ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions
3060
3062 TINRC Define this variable if you want to specify command-line options
3063 that tin should be started with to save typing them each time it
3064 is started. The contents of the environment variable are added
3065 to the front of the command-line options before it is parsed
3066 therefore allowing an option specified on the command-line to
3067 override the same option specified in the environment.
3068 TIN_HOMEDIR
3070 Define this variable if you do not want the .tin directory in
3071 $HOME/. E.g., if you want all tin's private files in /tmp/.tin
3072 you would set $TIN_HOMEDIR to /tmp.
3073 TIN_INDEX_NEWSDIR
3075 Define this variable if you do not want the .news directory in
3076 ${TIN_HOMEDIR:-"$HOME"}/.tin/. E.g., if you want all tin's news
3077 index files in /tmp/.news you would set $TIN_INDEX_NEWSDIR to
3078 /tmp.
3079 TIN_INDEX_MAILDIR
3081 Define this variable if you do not want the .mail directory in
3082 ${TIN_HOMEDIR:-"$HOME"}/.tin/. E.g., if you want all tin's mail
3083 index files in /tmp/.mail you would set $TIN_INDEX_MAILDIR to
3084 /tmp.
3085 TIN_INDEX_SAVEDIR
3087 Define this variable if you do not want the .save directory in
3088 ${TIN_HOMEDIR:-"$HOME"}/.tin/. E.g., if you want all tin's save
3089 index files in /tmp/.save you would set $TIN_INDEX_SAVEDIR to
3090 /tmp.
3091 TIN_LIBDIR
3093 Define this variable if you want to override the NEWSLIBDIR path
3094 that was compiled into the tin binary, default is /usr/lib/news.
3095 If tin is running in NNTP mode setting this variable has no
3096 effect.
3097 TIN_SPOOLDIR
3099 Define this variable if you want to override the SPOOLDIR path
3100 that was compiled into the tin binary, default is
3101 /var/spool/news. If tin is running in NNTP mode setting this
3102 variable has no effect.
3103 TIN_NOVROOTDIR
3105 Define this variable if you want to override the NOVROOTDIR path
3106 that was compiled into the tin binary, default is SPOOLDIR (see
3107 above). If tin is running in NNTP mode setting this variable has
3108 no effect.
3109 TIN_NOVFILENAME
3111 Define this variable if you want to override the OVERVIEW_FILE
3112 filename that was compiled into the tin binary, default is
3113 .overview. If tin is running in NNTP mode setting this variable
3114 has no effect.
3115 TIN_ACTIVEFILE
3117 Define this variable if you want to override the NEWSLIB‐
3118 DIR/active path that was compiled into the tin binary. If tin is
3119 running in NNTP mode setting this variable has no effect. If
3120 $TIN_LIBDIR is set it is prepended to $TIN_ACTIVEFILE.
3121 NNTPSERVER
3123 The default NNTP server to remotely read news from. This vari‐
3124 able only needs to be set if the ''-r'' command-line option is
3125 specified and the file /etc/nntpserver does not exist. The
3126 ''-g'' command line option overrides $NNTPSERVER.
3127 NNTPPORT
3129 The NNTP TCP-port to read news from. This variable only needs to
3130 be set if the TCP-port is not 119 (the default). The ''-p''
3131 command-line option overrides $NNTPPORT.
3132 DISTRIBUTION
3134 Set the article header field ''Distribution:'' to the contents
3135 of the variable instead of the system default.
3136 ISO2ASC
3138 Set the ISO to ASCII charset decoding table character to use in
3139 decoding an article text. Values can range from -1 to 6.
3140 -1 no conversion
3142 0 universal table for many languages
3144 1 single-spacing universal table
3146 2 table for Danish, Dutch, German, Norwegian and Swedish
3148 3 table for Danish, Finnish, Norwegian and Swedish using the
3150 appropriate ISO 646 variant
3151 4 table with RFC1345 codes in brackets
3153 5 table for printers that allow overstriking with backspace
3155 6 table for IBM PC character set (code page 437)
3157 ORGANIZATION
3159 Set the article header field ''Organization:'' to the contents
3160 of the variable instead of the system default. If reading news
3161 on an Apollo DomainOS machine the environment variable $NEWSORG
3162 has to be used instead of $ORGANIZATION.
3163 NEWSORG (DomainOS)
3165 DomainOS specific, same as $ORGANIZATION on other OSs (see
3166 above).
3167 REPLYTO
3169 Set the article header field ''Reply-To:'' to the return address
3170 specified by the variable. This is useful if you wish to receive
3171 replies at a different address.
3172 NAME Overrides the full name given in the gecos-files in /etc/passwd,
3174 see also mail_address.
3175 REALNAME
3177 Same as $NAME.
3178 HOME Pathname of the user's home directory. See environ(5) for more
3180 info.
3181 MAILER This variable has precedence over the default mailer that is
3183 used in all mailing operations within tin.
3184 MAIL Full path to the user's mailbox.
3186 VISUAL This variable has precedence over the default editor (i.e.,
3188 vi(1)) that is used in all editing operations within tin (e.g.,
3189 posting, replying, follow-ups, ...). Evaluation order is ${VIS‐
3190 UAL:-"${EDITOR:-vi}"}. See environ(5) for more info.
3191 EDITOR If $VISUAL is unset, then this variable is looked up for a
3193 default editor. If $EDITOR and $VISUAL are both unset, tin uses
3194 the systems default editor (i.e. vi(1)) on UNIX-systems). See
3195 environ(5) for more info.
3196 AUTOSUBSCRIBE
3198 A new group is checked against the list of patterns; if it
3199 matches, tin subscribes the user to the group without further
3200 query. See the section "NEWSGROUP LISTS & WILDCARDS" for an
3201 explanation of the valid syntax. For example, setting
3202 AUTOSUBSCRIBE=comp.os.unix.*,talk.*,!talk.politics.*
3204 will automatically subscribe the user to all new groups in the
3206 comp.os.unix hierarchy, and all talk groups other than talk.pol‐
3207 itics groups (which will be queried for as usual). Of course
3208 this does not work if tin is started with the ''-X'' command-
3209 line switch.
3210 AUTOUNSUBSCRIBE
3212 Is handled like the $AUTOSUBSCRIBE variable, but groups matching
3213 the list are unsubscribed from without further query. For exam‐
3214 ple, setting
3215 AUTOUNSUBSCRIBE=alt.flame.*,u*,!uk.*
3217 will automatically unsubscribe the user from all new alt.flame
3219 groups and all groups starting with u (university groups) other
3220 than UK groups (which will be queried for as usual).
3221 TMPDIR A pathname of a directory made available for tin to create tem‐
3223 porary files.
3224 MAILCAPS
3226 This variable can be used to override the default path search
3227 for mailcap(5) files. See also tin(5).
3228 NOMETAMAIL
3230 Set this variable to disable the use of metamail(1) or a
3231 replacement (e.g. metamutt).
3232 MM_CHARSET
3234 MIME character set used if not configured via the tinrc variable
3235 mm_charset.
3236 ISPELL Set this variable to point to ispell(1) or a replacement and its
3238 cmd-line options.
3239 PGPOPTS
3241 Define any additional options that you wish to pass to your
3242 pgp(1) or gpg(1) program.
3243 PGPPATH
3245 Override the name of the pgp(1) directory in $HOME that holds
3246 your keys etc..
3247 GNUPGHOME
3249 Override the name of the gpg(1) directory in $HOME that holds
3250 your keys etc..
3251 LC_CTYPE
3253 This variable determines the locale(5) category for character
3254 handling functions. Usually it determines the character classes
3255 for pattern matching character classification and case conver‐
3256 sion. Currently this is not true for tin (which temporary unsets
3257 $LC_CTYPE right before any match is done to avoid confusion).
3258 It's value should be of the form language[_territory][.code‐
3259 set][@modifier]. See environ(5) for more information.
3260 LC_MESSAGES
3262 Formats of informative and diagnostic messages and interactive
3263 responses. It's value should be of the form language[_terri‐
3264 tory][.codeset][@modifier]. See locale(5) and environ(5) for
3265 more information.
3266 LC_TIME
3268 Date and time formats. It's value should be of the form lan‐
3269 guage[_territory][.codeset][@modifier]. See locale(5) and
3270 environ(5) for more information.
3271 LC_ALL This variable overrides the value of the $LANG variable and any
3273 other $LC_ variable. It's value should be of the form lan‐
3274 guage[_territory][.codeset]. See locale(5) and environ(5) for
3275 more information.
3276 LANG This variable determines the locale(5) category for any category
3278 not specifically selected with a variable starting with $LC_.
3279 It's value should be of the form language[_territory][.codeset].
3280 See environ(5) for more information.
3281 LANGUAGE
3283 This variable defines a priority list for translations. Whenever
3284 a translation is not available in the language selected via
3285 $LC_ALL or $LANG the next language from the list is tried. It's
3286 value should be of the form language:language[:language]. See
3287 environ(5) for more information.
3288 COLUMNS
3290 A decimal integer > 0 used to indicate the user's preferred
3291 width in column positions for the terminal screen or window. If
3292 this variable is unset or null, the implementation determines
3293 the number of columns, appropriate for the terminal or window.
3294 When $COLUMNS is set, any terminal-width information implied by
3295 $TERM will be overridden. Users and portable applications should
3296 not set $COLUMNS unless they wish to override the system selec‐
3297 tion and produce output unrelated to the terminal characteris‐
3298 tics.
3299 LINES A decimal integer > 0 used to indicate the user's preferred num‐
3301 ber of lines on a page or the vertical screen or window size in
3302 lines. A line in this case is a vertical measure large enough to
3303 hold the tallest character in the character set being displayed.
3304 If this variable is unset or null, the implementation determines
3305 the number of lines, appropriate for the terminal or window.
3306 When $LINES is set, any terminal-height information implied by
3307 $TERM will be overridden. Users and portable applications should
3308 not set $LINES unless they wish to override the system selec‐
3309 tion.
3310 TERM The type of terminal in use. This is used when looking up term‐
3312 cap sequences. See environ(5) for more information.
3313 DISPLAY
3315 Display name, pointing to the X server; required for xface.
3316 WINDOWID
3318 Used for determining terminal's X window id; required for xface.
3319 Should be set by the terminal emulator.
3320 SHELL The pathname of the user's login shell. Used to set
3322 default_shell_command.
3323 XDG_RUNTIME_DIR
3325 The pathname of the user's dir to put non-essential run time
3326 files into.
3327
3329 tin handles a couple of signals:
3330 SIGHUP Terminate gracefully.
3332 SIGTERM
3334 Terminate gracefully.
3335 SIGUSR1
3337 Terminate gracefully but do not restore terminal (tty).
3338 SIGUSR2
3340 Write out ${TIN_HOMEDIR:-"$HOME"}/.newsrc-file.
3341
3343 If tin is started in debug mode (''-D n'') it will create world read‐
3344 able files in $TMPDIR which may contain the users NNTP password in
3345 cleartext. On multiuser-systems $TMPDIR should be set to a safe loca‐
3346 tion before starting tin in debug mode (e.g. TMPDIR=$HOME tin -D 1).
3347
3349 tin does conform to the Base Definitions volume of IEEE Std
3350 1003.1-2008, Section 12, Utility Conventions (Utility Argument Syntax,
3351 Utility Syntax Guidelines).
3352
3354 Regular expression support is provided by the PCRE library package
3355 pcre(3), which is open source software, written by Philip Hazel, and
3356 copyright by the University of Cambridge, England.
3357 <ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/>
3358
3360 CNews NNTPd, noffle(1) (<= V1.0-pre5) and NewsCache (<= V1.1.91) can't
3361 handle pipelined GROUP commands. If you run into trouble with any of
3362 the mentioned servers define DISABLE_PIPELINING in include/autoconf.h
3363 and recompile.
3364 Before mailing a bug-report to <tin-bugs@tin.org> please check if you
3365 are using the latest (stable) release, and if not, please upgrade
3366 first! Have a look at the doc/TODO file for known bugs. If you still
3367 think you've found a bug, please use the BugReport ('R') function and
3368 write in English. Please do NOT enclose a core-file in your bug-report
3369 until we request it.
3370
3372 tin is based on the tass(1) newsreader that was developed by Rich
3373 Skrenta and posted to alt.sources in March 1991; its first version was
3374 released on August 23rd 1991. tass(1) itself was heavily influenced by
3375 notesfiles a public domain UNIX version of PLATO Notes, developed at
3376 the University of Illinois by Ray Essick and Rob Kolstad in 1982. For a
3377 version overview see
3378 <http://www.tin.org/history.html>.
3379
3381 Rich Skrenta
3382 author of tass(1) v3.2 which this newsreader used as its base.
3383 Bill Davidsen
3385 author of envarg.c environment variable reading routine.
3386 Mike Gleason
3388 author of sigfile.c random signature generation routines.
3389 Markus Kuhn <Markus.Kuhn@cl.cam.ac.uk>
3391 author of langinfo.c, charset.c and iso2asc.txt ISO-8859-1 docu‐
3392 mentation.
3393 Arnold Robbins
3395 author of strftime.c date formatting routine.
3396 Rich Salz
3398 author of wildmat.c pattern matching and parsdate.y date parsing
3399 routines.
3400 Dave Taylor
3402 author of curses.c from the elm(1) mailreader.
3403 Chris Thewalt
3405 author of getline.c emacs(1) style editing routine.
3406 Steven Madsen
3408 for adding pgp(1) (Pretty Good Privacy) support.
3409 Philip Hazel <ph10@cam.ac.uk>
3411 for pcre(3) (Perl-compatible regular expression library).
3412 Patrick Powell <papowell@astart.com>
3414 for snprintf(3) and vsnprintf(3) fallbacks.
3415
3417 Iain Lea <iain@bricbrac.de>
3418
3420 Urs Janssen <urs@tin.org>
3421
3423 cron(1), elm(1), emacs(1), gpg(1), inews(1), ispell(1), lp(1), lpr(1),
3424 metamail(1), noffle(1), perl(1), perlre(1), pgp(1), rn(1), sendmail(1),
3425 shar(1), slrnface(1), tass(1), unshar(1), uudecode(1), vi(1),
3426 xterm(1x), heapsort(3), iconv(3), iconv_open(3), nl_langinfo(3),
3427 pcre(3), pcrepattern(3), qsort(3), snprintf(3), strftime(3),
3428 vsnprintf(3), wildmat(3), environ(5), locale(5), mailcap(5), mbox(5),
3429 mmdf(5), newsoverview(5), tin(5), RFC1345, RFC1524, RFC2045, RFC2046,
3430 RFC2047, RFC2048, RFC2231, RFC2980, RFC3977, RFC4155, RFC4643, RFC5322,
3431 RFC5536, RFC5537, RFC6048
34322.4.2 December 24th, 2017 tin(1)