1tin(1) A Usenet newsreader tin(1)
2
6 tin, rtin - A Usenet newsreader
7
9 tin [[-h|-H|-V] | [[[-a] [-dlnq|-Q] [-ArzxX]] [[-R|-S] -s News-dir]
10 [-cuvZ] [-N|-M address] [-o|-w]] [-D debug_level] [-G article_limit]
11 [-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).
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 Batch mode (''-Z''):
43 0 No unread news
45 1 Usage, syntax, configuration file or network error.
47 2 Unread news
49
51 -a Toggle ANSI color (default is off).
52 -A Force authentication on initial connect.
54 -c Create/update index files for every group in ${TIN_HOME‐
56 DIR-"$HOME"}/.newsrc or file specified by the ''-f'' option
57 and mark all articles as read.
58 -d Don't load newsgroup descriptions (interactive mode).
60 -D debug-level
62 Enter debug-level (1 = NNTP, 2 = all, 3 = newsrc, 4 = mem‐
63 ory allocation).
64 -f file Use the specified file of subscribed to newsgroups in place
66 of ${TIN_HOMEDIR-"$HOME"}/.newsrc.
67 -g server Use the server and newsrc specified in ${TIN_HOME‐
69 DIR-"$HOME"}/.tin/newsrctable.
70 -G article-limit
72 Limit the number of articles/group to retrieve from the
73 server.
74 -h Help listing all command-line options.
76 -H Brief introduction to tin that is also shown the first time
78 it is started.
79 -I dir Directory in which to store newsgroup index files. Default
81 is ${TIN_INDEX_NEWSDIR-"${TIN_HOME‐
82 DIR-"$HOME"}/.tin"}/.news. This option has no effect if
83 tin retrieves its index files via NNTP and cache_over‐
84 view_files is turned off.
85 -l Get number of articles per group from the ${TIN_LIB‐
87 DIR-NEWSLIBDIR}"/"${TIN_ACTIVEFILE-active} file. If reading
88 via NNTP this is done with the LIST command (RFC977). This
89 might result in incorrect article counts but is usually
90 faster than the default which is to read the ${TIN_LIB‐
91 DIR-NEWSLIBDIR}"/"${TIN_ACTIVEFILE-active} file (either
92 directly or via LIST) and then check the article count via
93 NNTP GROUP command (RFC977) ''-ln''.
94 -m dir Mailbox directory to use. Default is ${TIN_HOME‐
96 DIR-"$HOME"}/Mail.
97 -M user Mail unread articles to specified user for later reading.
99 For more information read section "AUTOMATIC MAILING AND
100 SAVING NEW NEWS".
101 -n Only load groups from the ${TIN_LIBDIR-NEWSLIB‐
103 DIR}"/"${TIN_ACTIVEFILE-active} file that are subscribed to
104 in the user's ${TIN_HOMEDIR-"$HOME"}/.newsrc. This allows a
105 noticeable speedup when connecting via a slow line, but tin
106 can not tell which groups are moderated. See also ''-l''.
107 -N Mail unread articles to yourself for later reading. For
109 more information read section "AUTOMATIC MAILING AND SAVING
110 NEW NEWS".
111 -o Quick post all postponed articles and exit. In order for
113 this to be really quick, it should be used with ''-n'' if
114 possible.
115 -p port Port to use if reading via NNTP (default is 119). This also
117 overrides the environment variable $NNTPPORT if set.
118 -q Don't check for new newsgroups.
120 -Q Quick start. Start tin as quickly as possible. Currently
122 this is equivalent to ''-nqd''.
123 -r Read news remotely from the default NNTP server specified
125 in the environment variable $NNTPSERVER or contained in the
126 file /etc/nntpserver.
127 -R Read news saved by the ''-S'' option.
129 -s dir Save/read articles to/in directory. Default is ${TIN_HOME‐
131 DIR-"$HOME"}/News.
132 -S Save unread articles for later reading by the ''-R''
134 option. For more information read section "AUTOMATIC MAIL‐
135 ING AND SAVING NEW NEWS".
136 -u Create/update index files for every group in ${TIN_HOME‐
138 DIR-"$HOME"}/.newsrc or file specified by the ''-f''
139 option. This option is disabled if tin retrieves its index
140 files via a NNTP server and cache_overview_files is turned
141 off.
142 -v Verbose mode for ''-c'', ''-M'', ''-N'', ''-S'', ''-u'' and
144 ''-Z'' options.
145 -V Print version and date information.
147 -w Quick mode to post an article and then exit. In order for
149 this to be really quick, it should be used with ''-n'' if
150 possible.
151 -x No posting mode. You cannot post articles if you use this
153 option.
154 -X No overwrite mode. ${TIN_HOMEDIR-"$HOME"}/.newsrc and files
156 in ${TIN_HOMEDIR-"$HOME"}/.tin will not be overwritten but
157 may be created if they don't exist.
158 -z Only start tin if there is any new/unread news. If there is
160 news tin will position cursor at first group with unread
161 news. Useful for putting in login file.
162 -Z Check if there is any new/unread news and exit with appro‐
164 priate status. If ''-v'' option is specified the number of
165 unread articles in each group is printed. An exit code 0
166 indicates no news, 1 that an error occurred and 2 that
167 new/unread news exists. Useful for writing scripts.
168 tin can also dynamically change its options by the OptionMenu ('M')
170 command. Any changes are written to ${TIN_HOMEDIR-"$HOME"}/.tin/tinrc.
171 For more information see section "GLOBAL OPTIONS MENU AND TINRC CONFIG‐
172 URABLE VARIABLES" and tin(5).
173 A list of groups can be specified after the other command-line options.
175 This can be useful if you wish to yank in or subscribe to a hand-picked
176 subset of the active newsgroups. See the section "NEWSGROUP LISTS &
177 WILDCARDS" for the types of pattern that tin understands.
178 If you specify a single group-name, or a wildcard that matches a single
180 group, then you will automatically enter that group. Otherwise the nor‐
181 mal group selection screen will appear, but with all the matching
182 groups present too, as though you had yanked just those groups in.
183 Once you use SelectYankActive ('y') to yank in all active groups, or
185 SelectToggleReadDisplay ('r') to toggle the read/unread status, then
186 the command-line groups will be gone. You can use SelectSyncWithActive
187 ('Y') to reread the ${TIN_LIBDIR-NEWSLIBDIR}"/"${TIN_ACTIVEFILE-active}
188 file and get them back.
189 NB: With the ''-n'' flag, only unsubscribed groups in the ${TIN_HOME‐
191 DIR-"$HOME"}/.newsrc file (or the newsrc-file given by the ''-f'' com‐
192 mand-line switch or via ${TIN_HOMEDIR-"$HOME"}/.tin/newsrctable) can be
193 matched.
194
196 NEWS ADMINISTRATION
197 Maintaining Netnews on large networks of machines can be a pretty time
198 consuming job as I discovered when I was given the job of maintaining
199 our news system and news users.
200 A user starting tin for the first time can be automatically subscribed
202 to a list of newsgroups that are deemed appropriate by the news admin‐
203 istrator. The subscriptions file should be created in your news lib
204 directory (i.e., ${TIN_LIBDIR-NEWSLIBDIR}/subscriptions) and should
205 have file permissions set to 0644. If you read news via NNTP, then your
206 news server must support the LIST SUBSCRIPTIONS command. It is part of
207 the Common NNTP Extensions (RFC2980) and all modern servers should
208 understand it.
209 SCREEN FORMAT
211 tin has four separate levels of operation: Selection level, Group
212 level, Thread level and Article level.
213 At the Selection level the title displays (the name of the newsserver
215 and) the number of subscribed groups (containing new unread articles).
216 The newsgroups are displayed in the middle of the screen with the num‐
217 ber of unread articles displayed on the same line in front.
218 ->M 1 2 comp.security.announce Announcements from the CERT abou
220 M 2 1 news.admin.announce Announcements for news adminstra
221 3 22 news.software.misc News-related software other than
222 4 1475 news.software.nntp The Network News Transfer Protoc
223 X 5 124 news.software.readers Discussion of software used to r
224 There may also be a character prefixing the line. An explanation fol‐
226 lows:
227 u This group is unsubscribed. To see only your subscribed
229 groups use the SelectToggleReadDisplay ('r') or SelectYankAc‐
230 tive ('y') toggle keys.
231 M This is a moderated group. Any posts you make will have to be
233 approved by the group administrator before it will be made
234 public. tin will ask for confirmation before you post to a
235 moderated group.
236 N This is a new newsgroup which has been created since you last
238 used tin. New newsgroups are not subscribed to by default
239 (However, see the $AUTOSUBSCRIBE / $AUTOUNSUBSCRIBE environ‐
240 ment variables). Subscribe to it in the normal way if you
241 wish the group to continue to appear in your Selection Menu.
242 Simply ignore new newsgroups and they will be gone the next
243 time you start tin. You will have to yank in all the groups
244 to find them in a later session.
245 D This group no longer exists. If you no longer wish to see
247 this group then unsubscribe from it in the normal way. This
248 flag will only appear if you have set strip_bogus to "ask" in
249 the Options Menu.
250 X You may no longer make posts to this group. Often a group
252 will be superseded by a more appropriately named one.
253 = This group has been renamed and you may no longer post to it.
255 If you do, then you will receive an error from your
256 newsserver telling you the correct group to post to.
257 At the Group level the title contains the name of the group, the number
259 of conversation threads, the threading method, the limit of articles to
260 get, the total number of articles, the number of hot articles, the num‐
261 ber of recent articles and the number of killed articles. I.e.:
262 alt.sources (5B -50/23+ 0* 3o 0K).
264 The characters after the numbers are depending to the configuration and
266 if your are in show_only_unread_arts mode or not. Some numbers could be
267 missing if the specific option is not enabled. It might also contain an
268 'M', 'X' or '=' (see above; doesn't work with the ''-n'' command-line
269 switch!) if the group is moderated, set to no posting or postings to it
270 get redirected.
271 If a thread has unread articles in it it's marked with a
273 art_marked_unread in front of the total number of articles in the
274 thread. If there are recent articles within the thread it might be
275 marked with art_marked_recent in front of the total number of articles
276 in the thread - this is controlled by the recent_time option. If a
277 thread has hot articles in it (see also section "FILTERING ARTICLES")
278 it's marked with art_marked_selected in front of the total number of
279 articles in the thread. The number of lines of the first (unread) arti‐
280 cle in the thread might also be shown right before the subject - this
281 is controlled by the show_info option.
282 de.admin.net-abuse.announce (11B 13+ 1* 1o 0K) M
284 -> 1 + 3 108 bincancels in de.talk.sex Christopher Lueg <l
286 2 + 69 EMP/ECP gecancelt. xynx. BI= 10 Henning Weede <hwee
287 3 o 93 EMP gecancelt. SouthBeach/Palms Henning Weede <hwee
288 4 * 368 <1997-11-12> Fremdcancel-FAQ Thomas Roessler <ro
289 At the Thread level the screen usually (depends on the threading method
291 used) looks like this:
292 -> 1 [ 7] What is this funny tree in the thr Robert F. Simmig
294 2 [ 12] +-> Sephan Wagner <s
295 3 [ 230] | `->Tin thread-level (was: What is Bob Johnson <bob
296 4 [ 22] `->tin threading menu Brian Richardson
297 At the Article level the page header has the following format:
300 Sun, 28 Dec 1997 21:21:01 de.admin.news.groups Thread 20 of 86
302 Lines 50 Re: EINSPRUCH zu RESULT:de.comm.mobil.ALL RespNo 47 of 59
303 Urs Janssen <urs@akk.org> at Arbeitskreis Kultur und Kommunikati
304 article-body
306 COMMON MOVING KEYS
308 This table shows the common keys used for moving around all levels
309 within tin.
310 ANSI/vt100 Other Terminals
311 Beg. of list/article Home FirstPage (^)
312 End of list/article End LastPage ($)
313 Page Up PgUp PageUp (u, ^U or ^B)
314 Page Down PgDn PageDown (^D or ^F)
315 or PageDown3 (<SPACE>)
316 Line Up Up arrow Up (k or ^P)
317 Line Down Down arrow Down (j or ^N)
318 COMMON EDITING COMMANDS
320 An emacs style editing package allows the easy editing of input
321 strings. An history list allows the easy reuse of previously entered
322 strings. In addition to the cursor keys, the following commands are
323 available when editing a string:
324 ^A, ^E move to beginning or end of line, respectively.
326 ^F, ^B non-destructive move forward or back one location, respec‐
328 tively.
329 ^D delete the character currently under the cursor, or send EOF
331 if no characters in the buffer.
332 ^H, <DEL> delete character left of the cursor.
334 ^K delete from cursor to end of line.
336 ^P, ^N move through history, previous and next, respectively.
338 ^L, ^R redraw the current line.
340 <CR> places line on history list if non-blank, appends newline and
342 returns to the caller.
343 <ESC> aborts the present editing operation.
345 GLOBAL COMMANDS
347 The following commands are available at all 4 menu levels and always
348 have the same effect.
349 ShellEscape '!'
351 Shell escape. ShellEscape by itself will launch a shell,
352 ShellEscape <command> will run an external <command>. This
353 facility may have been disabled by the System Administrator.
354 ToggleColor '&'
356 Toggle use of ANSI color.
357 RedrawScr '^L'
359 Redraw the current screen.
360 ScrollUp '<'
362 Scroll screen up by one line.
363 ScrollDown '>'
365 Scroll screen down by one line.
366 Postponed 'O' '^O'
368 Reload postponed article. If your system blocks the Postponed
369 key you must quote it by pressing '^V' (CTRL-V) first. The
370 postpone-menu offers the following actions: PromptYes ('y') =
371 reload and spawn editor; PostponeOverride ('Y') = post arti‐
372 cle (without spawning editor); PostponeAll ('A') = post all
373 postponed articles (without spawning editor); PromptNo ('n')
374 = skip this article; Quit ('q') = quit postponed menu. Cur‐
375 rently there is no 'simple' way to delete a postponed article
376 from the postponed-file, you have to use the following com‐
377 mand sequence instead: reload it with Postponed, enter editor
378 with PromptYes, quit editor, discard posting with Quit
379 ('^O''y''q'). See also ''-o'' command-line switch.
380 Help 'h' Help screen of commands available on the current menu. You
382 can use SearchSubjF ('/'), SearchSubjB ('?') and SearchRepeat
383 ('\') to search on this screen. Quit ('q') returns to the
384 menu.
385 ToggleHelpDisplay 'H'
387 Toggle the display of help mini menu at the bottom of the
388 screen.
389 DisplayPostHist 'W'
391 List articles posted by user. The date posted, the newsgroup
392 and the subject are listed. You can use SearchSubjF ('/'),
393 SearchSubjB ('?') and SearchRepeat ('\') to search on this
394 screen. Quit ('q') returns to the menu.
395 Version 'v'
397 Print tin version information.
398 NEWSGROUP SELECTION COMMANDS
400 4 Select group 4.
401 SelectResetNewsrc '^R'
403 Reset ${TIN_HOMEDIR-"$HOME"}/.newsrc file. This will destroy
404 all records of which articles have been read, so use this
405 carefully.
406 SetRange '#'
408 Choose a range of articles to be affected by the next com‐
409 mand. See the section "RANGES" for more information.
410 SelectSortActive '.'
412 Sort the list of newsgroups.
413 SearchRepeat '\'
415 Repeat the previous search.
416 SearchSubjF '/'
418 Search for a group by name and description (if displayed).
419 SearchSubjB '?'
421 Backward search through the group names and descriptions.
422 SelectReadGrp '^J' '<CR>'
424 Read current group.
425 SelectEnterNextUnreadGrp '<TAB>' 'n'
427 Enter next group with unread news. Will wrap around to the
428 beginning of the group selection list looking for unread
429 groups.
430 Catchup 'c'
432 Make current group as all read [after confirmation] and move
433 to the next group in the group selection list.
434 CatchupNextUnread 'C'
436 Mark current group as all read [after confirmation] and enter
437 the next unread group in the group selection list.
438 SelectToggleDescriptions 'd'
440 Toggle display to show just the group name or the group name
441 and the group descriptions.
442 EditFilter 'E'
444 Edit the filter file and reload it afterwards.
445 SelectGoto 'g'
447 Choose a new group by name. This command can be used to
448 access any group, even those not currently yanked in.
449 ToggleInfoLastLine 'i'
451 Toggle the display of the description of the current news‐
452 group in the last line. This will not be available if tin was
453 started with the ''-d'' option.
454 ToggleInverseVideo 'I'
456 Toggle inverse video.
457 SelectMoveGrp 'm'
459 Move the current group within the group selection list. By
460 entering '1' the group will become the first displayed group
461 in the list, by entering '8' the eighth group in the list
462 etc. By entering '$' the group will be the last group dis‐
463 played.
464 OptionMenu 'M'
466 User configurable options menu (for more information see sec‐
467 tion "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES").
468 SelectNextUnreadGrp 'N'
470 Positions the cursor on the next group with unread articles
471 in it.
472 Quit 'q' Quit tin - ask the user to confirm if confirm_choice is set
474 accordingly.
475 QuitTin 'Q'
477 Quit tin - don't ask the user to confirm.
478 SelectToggleReadDisplay 'r'
480 Toggle display of all subscribed to groups and just those
481 groups containing unread articles. Command has no effect if
482 groups were specified on the command-line when tin was
483 started.
484 BugReport 'R'
486 Mail a bug report or comment to <tin-bugs@tin.org>. This is
487 the best way of getting bugs fixed and features
488 added/changed.
489 SelectSubscribe 's'
491 Subscribe to current group.
492 SelectSubscribePat 'S'
494 Subscribe to groups matching user specified pattern. See the
495 section "NEWSGROUP LISTS & WILDCARDS" for the types of pat‐
496 tern that tin understands.
497 SelectUnsubscribe 'u'
499 Unsubscribe to current group. This can be used to remove
500 bogus groups. See strip_bogus in the "GLOBAL OPTIONS MENU
501 AND TINRC CONFIGURABLE VARIABLES" section.
502 SelectUnsubscribePat 'U'
504 Unsubscribe to groups matching user specified pattern. See
505 the section "NEWSGROUP LISTS & WILDCARDS" for the types of
506 pattern that tin understands.
507 Post 'w' Post an article to current group. If posting fails for some
509 reason, you'll get the chance to PostEdit ('e') the article
510 again, PostPostpone ('o') it for later processing (see also
511 ''-o'' command-line switch) or discard it via Quit ('q').
512 SelectQuitNoWrite 'X'
514 Quit tin without saving any changes to the configuration.
515 SelectYankActive 'y'
517 Yanks in all groups. Toggles the displayed groups between all
518 the groups in the ${TIN_LIBDIR-NEWSLIBDIR}"/"${TIN_ACTIVE‐
519 FILE-active} file and just those that are subscribed to in
520 ${TIN_HOMEDIR-"$HOME"}/.newsrc.
521 SelectSyncWithActive 'Y'
523 Reread the ${TIN_LIBDIR-NEWSLIBDIR}"/"${TIN_ACTIVE‐
524 FILE-active} file to see if any new news has arrived since
525 starting tin.
526 SelectMarkGrpUnread 'z' 'Z'
528 Mark all articles in the current group as unread.
529 GROUP INDEX COMMANDS
531 4 Select article 4.
532 MenuFilterSelect '^A'
534 Auto select article(s) using a menu. Read the section "FIL‐
535 TERING ARTICLES" for more information.
536 MenuFilterKill '^K'
538 Kill article(s) using a menu. Read the section "FILTERING
539 ARTICLES" for more information.
540 SetRange '#'
542 Choose a range of articles to be affected by the next com‐
543 mand. See the section "RANGES" for more information.
544 LastViewed '-'
546 Re-enter the last message that was viewed.
547 SearchRepeat '\'
549 Repeat the previous search
550 SearchSubjF '/'
552 Search forward for specified subject.
553 SearchSubjB '?'
555 Search backward for specified subject.
556 GroupSelThd '*'
558 Select current thread for later processing.
559 GroupDoAutoSel '+'
561 Selects all threads in current group. It is a shortcut for
562 calling GroupSelPattern with a pattern of ''*''.
563 GroupToggleThdSel '.'
565 Toggle selection of current thread. If at least one unread
566 article, (but not every unread article) in the current thread
567 is selected, then all unread articles become selected.
568 GroupSelThdIfUnreadSelected ';'
570 For each thread in current group, if it at least one unread
571 article is selected, all unread articles become selected.
572 This is useful for auto-selection on author where reader
573 wants to see entire thread.
574 GroupSelPattern '='
576 Prompts for a pattern with which to match on. All threads
577 whose subjects match the pattern will be marked selected. A
578 pattern of ''*'' will match all subjects. Entering just
579 '<CR>' will re-use the last pattern that was entered.
580 GroupReverseSel '@'
582 Reverse all selections on all articles.
583 GroupUndoSel '~'
585 Undo all selections on all articles. It clears the toggle
586 effect of GroupMarkUnselArtRead ('X') command. Thus after
587 first doing a GroupMarkUnselArtRead, one can then do GroupUn‐
588 doSel to reset articles. Thus, one can iteratively whittle
589 down uninteresting threads.
590 Pipe '|' Pipe current article / thread / auto-selected (hot) articles
592 / articles matching pattern / tagged articles into command.
593 See the section "MAILING PIPING PRINTING REPOSTING AND SAVING
594 ARTICLES" for more information.
595 QuickFilterSelect '['
597 Auto select article(s) with a single key [after confirma‐
598 tion]. The defaults used for selection are based upon the
599 following four tinrc config variables: default_fil‐
600 ter_select_case, default_filter_select_expire, default_fil‐
601 ter_select_global and default_filter_select_header. Read the
602 section "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARI‐
603 ABLES" for a full explanation of these variables and "FILTER‐
604 ING ARTICLES" for more information on filtering.
605 QuickFilterKill ']'
607 Kill article(s) with a single key [after confirmation]. The
608 defaults used for killing are based upon the following four
609 tinrc config variables: default_filter_kill_case,
610 default_filter_kill_expire, default_filter_kill_global and
611 default_filter_kill_header. Read the section "GLOBAL OPTIONS
612 MENU AND TINRC CONFIGURABLE VARIABLES" for a full explanation
613 of these variables and "FILTERING ARTICLES" for more informa‐
614 tion on filtering.
615 GroupReadBasenote '^J' '<CR>'
617 Read current article.
618 GroupNextUnreadArtOrGrp '<TAB>'
620 View next unread article or group.
621 SearchAuthF 'a'
623 Author forward search. This searches for articles with a spe‐
624 cific ''From:'' line.
625 SearchAuthB 'A'
627 Author backward search. Otherwise, see SearchAuthF ('a')
628 above.
629 SearchBody 'B'
631 Search the body of all articles in group (can be slow). You
632 can abort the search using Quit ('q').
633 Catchup 'c'
635 Mark all articles as read [after confirmation] then return to
636 the group selection list. Move cursor to next group.
637 CatchupNextUnread 'C'
639 Mark all articles as read [after confirmation] and enter the
640 next group with unread news.
641 GroupToggleSubjDisplay 'd'
643 Cycle the display of the author through all the possible
644 options for the tinrc variable show_author.
645 EditFilter 'E'
647 Edit the filter file and reload it afterwards.
648 GroupGoto 'g'
650 Choose a new group by name. This command can be used to
651 access any group, even those not currently yanked in.
652 GroupToggleGetartLimit 'G'
654 Toggle article/group limit.
655 ToggleInfoLastLine 'i'
657 Display the subject of the first article in the current
658 thread in the last line.
659 ToggleInverseVideo 'I'
661 Toggle inverse video.
662 GroupMarkThdRead 'K'
664 Mark article/thread as read and move onto the next unread
665 article/thread.
666 GroupListThd 'l'
668 Open the thread under the current cursor position.
669 LookupMessage 'L'
671 Look up article by ''Message-ID:''.
672 GroupMail 'm'
674 Mail current article / thread / auto-selected (hot) articles
675 / articles matching pattern / tagged articles to someone. See
676 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
677 ARTICLES" for more information.
678 OptionMenu 'M'
680 User configurable options menu (for more information see sec‐
681 tion "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES").
682 GroupNextGroup 'n'
684 Go to next group.
685 GroupNextUnreadArt 'N'
687 Go to next unread article.
688 Print 'o' Send current article / thread / auto-selected (hot) articles
690 / articles matching pattern / tagged articles to printer. See
691 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
692 ARTICLES" for more information.
693 GroupPrevGroup 'p'
695 Go to previous group.
696 GroupPrevUnreadArt 'P'
698 Go to previous unread article.
699 Quit 'q' Return to previous level.
701 QuitTin 'Q'
703 Quit tin - don't ask the user to confirm.
704 GroupToggleReadUnread 'r'
706 Toggle the display between all articles and unread articles.
707 BugReport 'R'
709 Mail a bug report or comment to <tin-bugs@tin.org>. This is
710 the best way of getting bugs fixed and features
711 added/changed.
712 GroupSave 's'
714 Save current article / thread / auto-selected (hot) articles
715 / articles matching pattern / tagged articles. See the sec‐
716 tion "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
717 for more information.
718 GroupAutoSave 'S'
720 Save marked articles automatically without further prompting.
721 GroupTag 't'
723 Toggle tag-status of current article / thread for GroupMail
724 ('m') / Pipe ('|') / Print ('o') / GroupSave ('s') / GroupRe‐
725 post ('x').
726 GroupTagParts 'T'
728 Automatically tag in order all the parts of the current
729 multi-part message.
730 GroupToggleThreading 'u'
732 Cycle the threading mode through no threading, threading by
733 subject, threading by references, threading on both subject
734 and references, group multipart articles into a thread
735 (''Subject:'' based).
736 GroupUntag 'U'
738 Untag all articles that were tagged.
739 Post 'w' Post an article to current group. If posting fails for some
741 reason, you'll get the chance to edit the article again via
742 PostEdit ('e'), postpone it via PostPostpone ('o') for later
743 processing (see also ''-o'' command-line switch) or discard
744 it via Quit ('q').
745 GroupRepost 'x'
747 Repost an already posted article / thread / auto-selected
748 (hot) articles / articles matching pattern / tagged articles
749 to another newsgroup(s). Useful for reposting from global to
750 local newsgroups. Do not use this to cross-post your own
751 articles.
752 GroupMarkUnselArtRead 'X'
754 Mark all unread articles that have not been selected as read,
755 redraw screen to reflect changes and put index at the first
756 thread to begin reading. Pressing GroupMarkUnselArtRead
757 ('X') again will toggle back to the way it was before. See
758 GroupUndoSel ('~') command for clearing the toggle effect,
759 leaving the group will also clear the toggle effect and make
760 the changes permanent.
761 MarkArtUnread 'z'
763 Mark current article as unread.
764 MarkThdUnread 'Z'
766 Mark current thread as unread.
767 THREAD LISTING COMMANDS
769 4 Select article 4 within thread.
770 MenuFilterSelect '^A'
772 Auto select article(s) using a menu. Read the section "FIL‐
773 TERING ARTICLES" for more information.
774 MenuFilterKill '^K'
776 Kill article(s) using a menu. Read the section "FILTERING
777 ARTICLES" for more information.
778 SetRange '#'
780 Choose a range of articles to be affected by the next com‐
781 mand. See the section "RANGES" for more information.
782 LastViewed '-'
784 Re-enter the last message that was viewed.
785 SearchRepeat '\'
787 Repeat the previous search.
788 SearchSubjF '/'
790 Search forward for a specified subject.
791 SearchSubjB '?'
793 Search backwards for a specified subject.
794 ThreadSelArt '*'
796 Select the current thread for later processing.
797 ThreadToggleArtSel '.'
799 Toggle selection of current article.
800 ThreadReverseSel '@'
802 Reverse article selections.
803 ThreadUndoSel '~'
805 Undo all selections on current thread.
806 Pipe '|' Pipe current article / thread / auto-selected (hot) articles
808 / articles matching pattern / tagged articles into command.
809 See the section "MAILING PIPING PRINTING REPOSTING AND SAVING
810 ARTICLES" for more information.
811 ThreadReadArt '^J' '<CR>'
813 Read current article within thread.
814 ThreadReadNextArtOrThread '<TAB>'
816 View next unread article within thread.
817 SearchAuthF 'a'
819 Author forward search. This searches for articles with a spe‐
820 cific ''From:'' line. The search will wrap over into the next
821 thread if nothing is found in the current one.
822 SearchAuthB 'A'
824 Author backward search. Otherwise, see SearchAuthF ('a')
825 above.
826 SearchBody 'B'
828 Search the body of all articles in group (can be slow). You
829 can abort the search using Quit ('q').
830 Catchup 'c'
832 Mark thread as read [after confirmation] and return to the
833 group index page. Move cursor to next thread.
834 CatchupNextUnread 'C'
836 Mark thread as read [after confirmation] and enter the next
837 thread containing unread news.
838 ThreadToggleSubjDisplay 'd'
840 Cycle the display of the author through all the possible
841 options for the tinrc variable show_author.
842 EditFilter 'E'
844 Edit the filter file and reload it afterwards.
845 ToggleInfoLastLine 'i'
847 Display the subject of the current article in the last line.
848 ToggleInverseVideo 'I'
850 Toggle inverse video.
851 ThreadMarkArtRead 'K'
853 Mark article as read and move onto the next unread article.
854 LookupMessage 'L'
856 Look up article by ''Message-ID:''.
857 ThreadMail 'm'
859 Mail current article / thread / auto-selected (hot) articles
860 / articles matching pattern / tagged articles to someone. See
861 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
862 ARTICLES" for more information.
863 Print 'o' Send current article / thread / auto-selected (hot) articles
865 / articles matching pattern / tagged articles to printer. See
866 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
867 ARTICLES" for more information.
868 Quit 'q' Return to previous level.
870 QuitTin 'Q'
872 Quit tin - don't ask the user to confirm.
873 BugReport 'R'
875 Mail a bug report or comment to <tin-bugs@tin.org>. This is
876 the best way of getting bugs fixed and features
877 added/changed.
878 ThreadSave 's'
880 Save current article / thread / auto-selected (hot) articles
881 / articles matching pattern / tagged articles. See the sec‐
882 tion "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
883 for more information.
884 ThreadAutoSave 'S'
886 Save marked articles automatically without further prompting.
887 ThreadTag 't'
889 Toggle tag status of current article for mailing, piping,
890 printing, saving or reposting.
891 ThreadUntag 'U'
893 Untag all tagged threads.
894 Post 'w' Post an article to current group. If posting fails for some
896 reason, you'll get the chance to edit the article again via
897 PostEdit ('e'), postpone it for later processing via Post‐
898 Postpone ('o') (see also ''-o'' command-line switch) or dis‐
899 card it via Quit ('q').
900 MarkArtUnread 'z'
902 Mark current article in thread as unread.
903 MarkThdUnread 'Z'
905 Mark all articles in thread as unread.
906 ARTICLE VIEWER COMMANDS
908 0 Read the first (base) article in this thread.
909 4 Read response 4 in this thread.
911 MenuFilterSelect '^A'
913 Auto select article(s) using a menu. Read the section "FIL‐
914 TERING ARTICLES" for more information.
915 PageReplyQuoteHeaders '^E'
917 Reply through mail to the author of the current article with
918 a copy of the article with all headers included.
919 PagePGPCheckArticle '^G'
921 Perform pgp(1) operations on article.
922 PageToggleHeaders '^H'
924 Toggles the display mode (raw including all headers vs.
925 cooked)
926 MenuFilterKill '^K'
928 Kill article(s) using a menu. Read the section "FILTERING
929 ARTICLES" for more information.
930 PageToggleTabs '^T'
932 Toggle the TAB width between 4 and 8 characters.
933 PageFollowupQuoteHeaders '^W'
935 Post a followup to the current article with a copy of the
936 article with all headers included.
937 PageToggleTex2iso '"'
939 Toggle TeX to ISO decoding for current article. The default
940 behavior is taken from the tex2iso_conv variable in the tinrc
941 file.
942 PageToggleRot '%'
944 Toggle ROT-13 decoding for this article.
945 PageToggleUue '('
947 Toggle the display of uuencoded sections. The default behav‐
948 ior is taken from the hide_uue variable in the tinrc file.
949 PageReveal ')'
951 The formfeed character (^L) is often used to hide 'spoilers'
952 that the reader may not initially wish to see when viewing an
953 article. Any text after a formfeed is not displayed. This
954 key-press acts like a reveal key and turns the hidden text
955 back on. Scrolling down will also reveal the text, scrolling
956 up will hide it again.
957 LastViewed '-'
959 Re-enter the last message that was viewed.
960 SearchRepeat '\'
962 Repeat the previous search.
963 SearchSubjF '/'
965 Forward search the text of this article.
966 SearchSubjB '?'
968 Backward search the text of this article.
969 PageSkipIncludedText ':'
971 Skip to the end of the quoted text-block in this article.
972 Quoted text is everything which matches quote_regex,
973 quote_regex2 or quote_regex3.
974 PageTopThd '<'
976 Goto the first article in the current thread.
977 PageBotThd '>'
979 Goto the last article in the current thread.
980 PageToggleHighlight '_'
982 Toggle word highlighting on/off.
983 Pipe '|' Pipe current article / thread / auto-selected (hot) articles
985 / articles matching pattern / tagged articles into command.
986 See the section "MAILING PIPING PRINTING REPOSTING AND SAVING
987 ARTICLES" for more information.
988 QuickFilterSelect '['
990 Auto select article(s) with a single key. The defaults used
991 for selection are set based upon the following four tinrc
992 config variables: default_filter_select_case, default_fil‐
993 ter_select_expire, default_filter_select_global and
994 default_filter_select_header Read the section "GLOBAL OPTIONS
995 MENU AND TINRC CONFIGURABLE VARIABLES" for a full explanation
996 of these variables and "FILTERING ARTICLES" for more informa‐
997 tion on filtering.
998 QuickFilterKill ']'
1000 Kill article(s) with a single key. The defaults used for
1001 killing are based upon the following four tinrc config vari‐
1002 ables: default_filter_kill_case, default_filter_kill_expire,
1003 default_filter_kill_global and default_filter_kill_header.
1004 Read the section "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE
1005 VARIABLES" for a full explanation of these variables and
1006 "FILTERING ARTICLES" for more information on filtering.
1007 PageNextThd '^J' '<CR>'
1009 Goto next base article.
1010 PageNextUnread '<TAB>'
1012 Goto next unread article. If the tinrc variable
1013 tab_goto_next_unread is set to OFF, then this key will first
1014 page through the current article.
1015 SearchAuthF 'a'
1017 Author forward search.
1018 SearchAuthB 'A'
1020 Author backward search.
1021 SearchBody 'B'
1023 Search the body of all articles in group (can be slow). You
1024 can abort the search using Quit ('q').
1025 Catchup 'c'
1027 Mark the current thread as read [after confirmation] and
1028 return to the previous menu. Move cursor to next item.
1029 CatchupNextUnread 'C'
1031 Mark the rest of the current thread as read [after confirma‐
1032 tion] and enter the next thread with unread articles.
1033 PageCancel 'D'
1035 Cancel (delete) or supersede (overwrite) the current article.
1036 It must have been posted by the same user. The cancel message
1037 can be seen in the newsgroup 'control' or 'control.cancel'.
1038 PageEditArticle 'e'
1040 Edit the current article. This is restricted to mailgroups
1041 and saved news.
1042 EditFilter 'E'
1044 Edit the filter file and reload it afterwards.
1045 PageFollowupQuote 'f'
1047 Post a followup to the current article with a copy of the
1048 article included.
1049 PageFollowup 'F'
1051 Post a followup to the current article without including a
1052 copy of the article.
1053 PageFirstPage 'g'
1055 Goto the start of the article.
1056 PageLastPage 'G'
1058 Goto the end of the article.
1059 ToggleInfoLastLine 'i'
1061 Display the subject of the current article in the last line.
1062 ToggleInverseVideo 'I'
1064 Toggle inverse video.
1065 PageKillThd 'K'
1067 Mark rest of thread as read and move onto the next unread
1068 thread.
1069 PageListThd 'l'
1071 Show the thread menu that the current article is a part of.
1072 LookupMessage 'L'
1074 Look up article by ''Message-ID:''.
1075 PageMail 'm'
1077 Mail current article / thread / auto-selected (hot) articles
1078 / articles matching pattern / tagged articles to someone. See
1079 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
1080 ARTICLES" for more information.
1081 OptionMenu 'M'
1083 User configurable options menu (for more information see sec‐
1084 tion "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES").
1085 PageNextArt 'n'
1087 Go to the next article.
1088 PageNextUnreadArt 'N'
1090 Go to the next unread article.
1091 Print 'o' Send current article / thread / auto-selected (hot) articles
1093 / articles matching pattern / tagged articles to printer. See
1094 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
1095 ARTICLES" for more information.
1096 PagePrevArt 'p'
1098 Go to the previous article.
1099 PagePrevUnreadArt 'P'
1101 Go to the previous unread article.
1102 Quit 'q' Return to the previous level.
1104 QuitTin 'Q'
1106 Quit tin - don't ask the user to confirm.
1107 PageReplyQuote 'r'
1109 Reply through mail to the author of the current article with
1110 a copy of the article included.
1111 PageReply 'R'
1113 Reply through mail to the author of the current article with‐
1114 out including the original article.
1115 PageSave 's'
1117 Save current article / thread / auto-selected (hot) articles
1118 / articles matching pattern / tagged articles. See the sec‐
1119 tion "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
1120 for more information.
1121 PageAutoSave 'S'
1123 Save marked articles automatically without further prompting.
1124 PageTag 't'
1126 Toggle tag status of current article for mailing, piping,
1127 printing, saving or reposting.
1128 PageGroupSel 'T'
1130 Return to group selection level.
1131 PageGotoParent 'u'
1133 Goto parent article.
1134 PageViewUrl 'U'
1136 Browse URLs in article. All URLs will be prompted in turn and
1137 opened using the url_handler. '<ESC>' or no input will skip
1138 the URL.
1139 PageViewAttach 'V'
1141 View or save multimedia attachments.
1142 Post 'w' Post an article to the current group. If posting fails for
1144 some reason, you'll get the chance to edit the article again
1145 via PostEdit ('e'), postpone it for later processing via
1146 PostPostpone ('o') (see also ''-o'' command-line switch) or
1147 discard it via Quit ('q').
1148 PageRepost 'x'
1150 Repost an already posted article / thread / auto-selected
1151 (hot) articles / articles matching pattern / tagged articles
1152 to another newsgroup(s). Useful for reposting from global to
1153 local newsgroups. Do not use this to crosspost your own arti‐
1154 cles.
1155 MarkArtUnread 'z'
1157 Mark article as unread.
1158 MarkThdUnread 'Z'
1160 Mark the current thread as unread.
1161 GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES
1163 At startup, tin reads in the configuration files (see also tin(5)).
1164 They contain a list of variables that can be used to configure the way
1165 tin works. If it exists, the global configuration file, ${TIN_LIB‐
1166 DIR-NEWSLIBDIR}/tinrc is read. After that, the user's own configuration
1167 file is read from ${TIN_HOMEDIR-"$HOME"}/.tin/tinrc. The global file is
1168 useful for distributing system-wide defaults to new users who have no
1169 private tinrc yet.
1170 The variables are user configurable by editing ${TIN_HOME‐
1172 DIR-"$HOME"}/.tin/tinrc directly. Most of them can also be set in the
1173 GLOBAL OPTIONS MENU which is accessed by pressing OptionMenu ('M') at
1174 all levels. It allows the user to customize the behavior of tin. The
1175 options are saved to the file ${TIN_HOMEDIR-"$HOME"}/.tin/tinrc when
1176 you exit tin so don't edit the file directly whilst tin is running.
1177 In the options menu use the cursor keys in the usual way to move
1179 around. Use ConfigSelect ('^J' or '<CR>') to 'open' the option you wish
1180 to change. You will need to enter a new value or use '<SPACE>' to tog‐
1181 gle the available options. ConfigSelect will save the new value,
1182 '<ESC>' will abort without saving changes.
1183 As with the other menus, RedrawScr ('^L') will redraw the screen. You
1185 can use SearchSubjF ('/'), SearchSubjB ('?') and SearchRepeat ('\') to
1186 search for a specific option. Use Quit ('q') to exit the option menu
1187 and keep your changes. Use QuitTin ('Q') to exit without keeping your
1188 changes.
1189 Here is a full list of all the available variables. The name in braces
1191 is the name of the corresponding setting in ${TIN_HOME‐
1192 DIR-"$HOME"}/.tin/tinrc.
1193 Add posted articles to filter (add_posted_to_filter)
1195 If ON add posted articles which start a new thread to filter for
1196 highlighting follow-ups. Default is ON.
1197 Insert 'User-Agent:'-header (advertising)
1199 Turn ON advertising in header (''User-Agent:''). Default is ON.
1200 Skip multipart/alternative parts (alternative_handling)
1202 If ON strip multipart/alternative messages automatically. Default
1203 is ON.
1204 Character to show deleted articles (art_marked_deleted)
1206 The character used to show that an article was deleted. Default is
1207 'D'.
1208 Character to show inrange articles (art_marked_inrange)
1210 The character used to show that an article is in a range. Default
1211 is '#'.
1212 Character to show returning arts (art_marked_return)
1214 The character used to show that an article will return as an unread
1215 article when the group is next entered. Default is '-'.
1216 Character to show selected articles (art_marked_selected)
1218 The character used to show that an article/thread is auto-selected
1219 (hot). Default is '*'.
1220 Character to show recent articles (art_marked_recent)
1222 The character used to show that an article/thread is recent (not
1223 older than X days). See also recent_time. Default is 'o'.
1224 Character to show unread articles (art_marked_unread)
1226 The character used to show that an article has not been read.
1227 Default is '+'.
1228 Character to show read articles (art_marked_read)
1230 The character used to show that an article was read. Default is '
1231 '.
1232 Character to show read articles (art_marked_killed)
1234 The character used to show that an article was killed. Default is
1235 'K'. kill_level must be set accordingly.
1236 Character to show read selected arts (art_marked_read_selected)
1238 The character used to show that an article was hot before it was
1239 read. Default is ':'. kill_level must be set accordingly.
1240 Ask before using MIME viewer (ask_for_metamail)
1242 If ON tin will ask before using a MIME viewer (metamail_prog) to
1243 display MIME messages. This only occurs if a MIME viewer is set.
1244 Default is OFF.
1245 Send you a blind cc automatically (auto_bcc)
1247 If ON automatically put your name in the ''Bcc:'' field when mail‐
1248 ing an article. Default is OFF.
1249 Send you a cc automatically (auto_cc)
1251 If ON automatically put your name in the ''Cc:'' field when mailing
1252 an article. Default is OFF.
1253 List thread using right arrow key (auto_list_thread)
1255 If ON automatically list thread when entering it using right arrow
1256 key. Default is ON.
1257 Reconnect to server automatically (auto_reconnect)
1259 Default is OFF.
1260 Use Archive-name: header for save (auto_save)
1262 If ON articles/threads with ''Archive-name:'' in header will be
1263 automatically saved with the Archive-name & part/patch no and post
1264 processed if post_process_type is set to something other than 'No'.
1265 Default is OFF.
1266 Save articles in batch mode (batch_save)
1268 If set ON articles/threads will be saved in batch mode when save
1269 ''-S'' or mail ''-M, -N'' is specified on the command line. Default
1270 is ON.
1271 Show mini menu & posting etiquette (beginner_level)
1273 If set ON a mini menu of the most useful commands will be displayed
1274 at the bottom of the screen for each level. Also a short posting
1275 etiquette will be displayed after composing an article. Default is
1276 ON.
1277 Cache NNTP overview files locally (cache_overview_files)
1279 If ON, create local copies of NNTP overview files. This can be used
1280 to considerably speed up accessing large groups when using a slow
1281 connection. See also "INDEX FILES". Default is OFF.
1282 Catchup read groups when quitting (catchup_read_groups)
1284 If set ON the user is asked when quitting if all groups read during
1285 the current session should be marked read. Default is OFF.
1286 Standard background color (col_back)
1288 Standard background color
1289 Color of sender (From:) (col_from)
1291 Color of sender (From:)
1292 Color of article header lines (col_head)
1294 Color of header-lines
1295 Color of help text (col_help)
1297 Color of help pages
1298 Color for inverse text (background) (col_invers_bg)
1300 Color of background for inverse text
1301 Color for inverse text (foreground) (col_invers_fg)
1303 Color of foreground for inverse text
1304 Color of highlighting with _dash_ (col_markdash)
1306 Color of words emphasized like _this_. See also word_h_dis‐
1307 play_marks and word_highlight.
1308 Color of highlighting with /slash/ (col_markslash)
1310 Color of words emphasized like /this/. See also word_h_dis‐
1311 play_marks and word_highlight.
1312 Color of highlighting with *stars* (col_markstar)
1314 Color of words emphasized like *this*. See also word_h_dis‐
1315 play_marks and word_highlight.
1316 Color of highlighting with -stroke- (col_markstroke)
1318 Color of words emphasized like -this-. See also word_h_dis‐
1319 play_marks and word_highlight.
1320 Color of mini help menu (col_minihelp)
1322 Color of mini help menu
1323 Color of actual news header fields (col_newsheaders)
1325 Color of actual news header fields
1326 Standard foreground color (col_normal)
1328 Standard foreground color
1329 Color of quoted lines (col_quote)
1331 Color of quoted lines
1332 Color of twice quoted line (col_quote2)
1334 Color of twice quoted lines
1335 Color of =>3 times quoted line (col_quote3)
1337 Color of >=3 times quoted lines
1338 Color of response counter (col_response)
1340 Color of response counter. This is the text that says "Response x
1341 of y" in the article viewer.
1342 Color of signatures (col_signature)
1344 Color of signatures
1345 Color of urls highlight (col_urls)
1347 Color of urls highlight
1348 Color of article subject lines (col_subject)
1350 Color of article subject
1351 Color of text lines (col_text)
1353 Color of text-lines
1354 Color of help/mail sign (col_title)
1356 Color of help/mail sign
1357 Which actions require confirmation (confirm_choice)
1359 Ask for manual confirmation to protect the user.
1360 · commands Ask for confirmation before executing certain danger‐
1362 ous commands (e.g., Catchup ('c')). Commands that this affects
1363 are marked in this manual with '[after confirmation]'. Default
1364 is commands & quit.
1365 · quit You'll be asked to confirm that you wish to exit tin when
1367 you use the Quit ('q') command.
1368 · select Ask for confirmation before marking all not selected
1370 (with GroupMarkUnselArtRead ('X') command) articles as read.
1371 Format string for display of dates (date_format)
1373 Format string tin uses for date representation. A description of
1374 the different format options can be found at strftime(3). tin uses
1375 strftime(3) when available and supports most format options in his
1376 fallback code. Default is "%a, %d %b %Y %H:%M:%S".
1377 (default_art_search)
1379 (default_author_search)
1381 (default_config_search)
1383 The last article/author/config option that was searched for.
1384 Invocation of your editor (default_editor_format)
1386 The format string used to create the editor start command with
1387 parameters. Default is "%E +%N %F" (i.e., /bin/vi +7 .article).
1388 (default_filter_days)
1390 Default is 28.
1391 (default_filter_kill_case)
1393 Default for quick (1 key) kill filter case. ON = filter case sen‐
1394 sitive, OFF = ignore case. Default is OFF.
1395 (default_filter_kill_expire)
1397 Default for quick (1 key) kill filter expire. ON = limit to
1398 default_filter_days, OFF = don't ever expire. Default is OFF.
1399 (default_filter_kill_global)
1401 Default for quick (1 key) kill filter global. ON=apply to all
1402 groups, OFF=apply to current group. Default is ON.
1403 (default_filter_kill_header)
1405 Default for quick (1 key) kill filter header.
1406 0,1
1408 ''Subject:''
1409 2,3
1411 ''From:''
1412 4
1414 ''Message-ID:'' & full ''References:'' line
1415 5
1417 ''Message-ID:'' & last ''References:'' entry only
1418 6
1420 ''Message-ID:'' entry only
1421 7
1423 ''Lines:''
1424 (default_filter_select_case)
1426 Default for quick (1 key) auto-selection filter case. ON=filter
1427 case sensitive, OFF=ignore case. Default is OFF.
1428 (default_filter_select_expire)
1430 Default for quick (1 key) auto-selection filter expire. ON = limit
1431 to default_filter_days, OFF = don't ever expire. Default is OFF.
1432 (default_filter_select_global)
1434 Default for quick (1 key) auto-selection filter global. ON=apply
1435 to all groups OFF=apply to current group. Default is ON.
1436 (default_filter_select_header)
1438 Default for quick (1 key) auto-selection filter header.
1439 0,1
1441 ''Subject:''
1442 2,3
1444 ''From:''
1445 4
1447 ''Message-ID:'' & full ''References:'' line
1448 5
1450 ''Message-ID:'' & last ''References:'' entry only
1451 6
1453 ''Message-ID:'' entry only
1454 7
1456 ''Lines:''
1457 (default_goto_group)
1459 (default_group_search)
1461 (default_mail_address)
1463 Mail directory (default_maildir)
1465 The directory where articles/threads are to be saved in mbox(5)
1466 format. This feature is mainly for use with the elm(1) mail pro‐
1467 gram. It allows the user to save articles/threads/groups simply by
1468 giving '=' as the filename to save to. Default is ${TIN_HOME‐
1469 DIR-"$HOME"}/Mail.
1470 Invocation of your mail command (default_mailer_format)
1472 The format string used to create the mailer command with parameters
1473 that is used for mailing articles to other people. Default is '%M
1474 "%T" < %F' (e.g., /bin/mail "iain" < .article). The flexible format
1475 allows other mailers with different command-line parameters to be
1476 used such as 'elm -s "%S" "%T" < "%F"' (e.g., elm -s "subject"
1477 "iain" < .article) or 'sendmail -oi -oem -t < %F' (e.g. sendmail
1478 -oi -oem -t < .article).
1479 (default_move_group)
1481 (default_pattern)
1483 (default_pipe_command)
1485 (default_post_newsgroups)
1487 (default_post_subject)
1489 Printer program with options (default_printer)
1491 The printer program with options that is to be used to print arti‐
1492 cles. The default is lpr(1) for BSD machines and lp(1) for SysV
1493 machines. Printing from tin may have been disabled by the System
1494 Administrator.
1495 (default_range_group)
1497 (default_range_select)
1499 (default_range_thread)
1501 (default_repost_group)
1503 (default_save_file)
1505 (default_save_mode)
1507 Directory to save arts/threads in (default_savedir)
1509 Directory where articles/threads are saved. Default is ${TIN_HOME‐
1510 DIR-"$HOME"}/News.
1511 (default_select_pattern)
1513 (default_shell_command)
1515 Create signature from path/command (default_sigfile)
1517 The path that specifies the signature file to use when posting,
1518 following up to or replying to an article. If the path is a direc‐
1519 tory then the signature will be randomly generated from files that
1520 are in the specified directory. If the path starts with a ! the
1521 program the path points to will be executed to generate a signa‐
1522 ture. tin will pass the name of the current newsgroup as argument
1523 to the program. --none will suppress any signature. Default is
1524 ${TIN_HOMEDIR-"$HOME"}/.Sig.
1525 (default_subject_search)
1527 Draw -> instead of highlighted bar (draw_arrow)
1529 Allows groups/articles to be selected by an arrow '->' if set ON or
1530 by an highlighted bar if set OFF. Default is OFF.
1531 Force redraw after certain commands (force_screen_redraw)
1533 Specifies whether a screen redraw should always be done after cer‐
1534 tain external commands. Default is OFF.
1535 Number of articles to get (getart_limit)
1537 If getart_limit is > 0 not more than getart_limit articles/group
1538 are fetched from the server. If getart_limit is < 0 tin will start
1539 fetching articles from your first unread minus absolute value of
1540 getart_limit. Default is 0, which means no limit.
1541 Catchup group using left key (group_catchup_on_exit)
1543 If ON catchup group when leaving with the left arrow key. Default
1544 is ON.
1545 Max. length of group names shown (groupname_max_length)
1547 Maximum length of the names of newsgroups to be displayed so that
1548 more of the newsgroup description can be displayed. Default is 32.
1549 Display uue data as an attachment (hide_uue)
1551 If set to 'No' then raw uuencoded data is displayed. If set to
1552 'Yes' then sections of uuencoded data will be shown with a single
1553 tag line showing the size and filename (much the same as a MIME
1554 attachment). If set to 'Hide all' then any line that looks like
1555 uuencoded data will be folded into a tag line. This is useful when
1556 uuencoded data is split across more than one article but can also
1557 lead to false positives. This setting can also be toggled in the
1558 article viewer. Default is 'No'.
1559 External inews (inews_prog)
1561 Path, name and options of external inews(1). If you are reading
1562 via NNTP the default value is --internal (use built-in NNTP inews),
1563 else it is "inews -h". The article is passed to inews_prog on STDIN
1564 via '< article'.
1565 (info_in_last_line)
1567 If ON, show current group description or article subject in the
1568 last line (not in the pager and global menu) - ToggleInfoLastLine
1569 ('i') toggles setting. This facility is useful as the full width of
1570 the screen is available to display long subjects. Default is OFF.
1571 Use interactive mail reader (interactive_mailer)
1573 Interactive mailreader: if greater than 0 your mailreader will be
1574 invoked earlier for reply so you can use more of its features (e.g.
1575 MIME, pgp, ...). 1 means include headers, 2 means don't include
1576 headers (old use_mailreader_i=ON option). 0 turns off usage. This
1577 option has to suit default_mailer_format. Default is 0.
1578 Use inverse video for page headers (inverse_okay)
1580 If ON use inverse video for page headers and URL highlighting.
1581 Default is ON.
1582 Keep failed arts in ~/dead.articles (keep_dead_articles)
1584 If ON keep all failed postings in ${TIN_HOMEDIR-"$HOME"}/dead.arti‐
1585 cles besides keeping the last failed posting in ${TIN_HOME‐
1586 DIR-"$HOME"}/dead.article. Default is ON.
1587 Filter which articles (kill_level)
1589 This option controls the processing and display of articles that
1590 are killed. There are 3 options:
1591 0 Kill only unread arts is the 'traditional' behavior of tin.
1593 Only unread articles are killed once only by marking them read.
1594 As filtering only happens on unread articles with kill_level
1595 set to 0, art_marked_killed and art_marked_read_selected are
1596 only shown once. When you reenter the group the mark will be
1597 gone.
1598 1 Kill all arts & show with K will process all articles in the
1600 group and therefore there is a processing overhead when using
1601 this option. Killed articles are threaded as normal but they
1602 will be marked with art_marked_killed.
1603 2 Kill all arts and never show will process all articles in the
1605 group and therefore there is a processing overhead when using
1606 this option. Killed articles simply does not get displayed at
1607 all.
1608 Default is 0 (Kill only unread arts).
1609 Use 8bit characters in mail headers (mail_8bit_header)
1611 Allows 8bit characters unencoded in the header of mail message.
1612 Default is OFF. Turning it ON is effective only if mail_mime_encod‐
1613 ing is also set to 8bit. Leaving it OFF is safe for most users and
1614 compliant to Internet Mail Standard (RFC2822 and RFC2047). Default
1615 is OFF.
1616 Mail address (mail_address)
1618 User's mail address (and full name), if not username@host. This is
1619 used when creating articles, sending mail and when pgp(1) signing.
1620 MIME encoding in mail messages (mail_mime_encoding)
1622 MIME encoding of the body in mail message, if necessary (8bit,
1623 base64, quoted-printable, 7bit) Default is 8bit and no encoding (or
1624 charset conversion) is performed (i.e., local charset is used as it
1625 is).
1626 Quote line when mailing (mail_quote_format)
1628 Format of quote line when replying (via mail) to an article
1629 (%A=Address, %D=Date, %F=Fullname+Address, %G=Groupname, %M=Mes‐
1630 sage-ID, %N=Fullname, %C=Firstname, %I=Initials). Default is "In
1631 article %M you wrote:"
1632 Format of the mailbox (mailbox_format)
1634 Select one of the following mailbox-formats: MBOXO (default, except
1635 for SCO), MBOXRD or MMDF (default on SCO). See mbox(5) for more
1636 details on MBOXO and MBOXRD and mmdf(5) for more details about
1637 MMDF.
1638 'Mark article read' ignores tags (mark_ignore_tags)
1640 When this is ON, the GroupMarkThdRead, ThreadMarkArtRead functions
1641 ('K') mark just the current article or thread, ignoring other
1642 tagged, unread articles. When OFF, the same function presents a
1643 menu with choices of the current thread or article, all tagged,
1644 unread articles, or nothing.
1645 Mark saved articles/threads as read (mark_saved_read)
1647 If ON mark articles that are saved as read. Default is ON.
1648 Viewer program for MIME articles (metamail_prog)
1650 Path, name and options of external metamail(1) program used to view
1651 non-textual parts of articles. To use the built-in viewer, set to
1652 --internal. This is the default value when metamail(1) is not
1653 installed. Leave it blank if you don't want any automatic viewing
1654 of non-textual attachments. The 'V' command can always be used to
1655 manually view any attachments. See also ask_for_metamail.
1656 MM_CHARSET (mm_charset)
1658 Charset supported locally, which is also used for MIME header
1659 (charset parameter and charset name in header encoding) in mail and
1660 news postings. If MIME_STRICT_CHARSET is defined at compile time,
1661 text in charset other than the value of this parameter is consid‐
1662 ered not displayable and represented as '?'. Otherwise, all charac‐
1663 ter sets are regarded as compatible with the display. If it's not
1664 set, the value of the environment variable $MM_CHARSET is used. US-
1665 ASCII or compile-time default is used in case neither of them is
1666 defined. If your system supports iconv(3), this option is disabled
1667 and you should use mm_network_charset instead.
1668 MM_NETWORK_CHARSET (mm_network_charset)
1670 Charset used for posting and MIME headers; replaces mm_charset.
1671 Conversion between mm_network_charset and local charset (determined
1672 via nl_langinfo(3)) is done via iconv(3), if this function is not
1673 available on your system this option is disabled and you have to
1674 use mm_charset instead. mm_network_charset is limited to one of the
1675 following charsets:
1676 US-ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16}, KOI8-{R,U,RU}
1677 EUC-{CN,JP,KR,TW}, ISO-2022-{CN,CN-EXT,JP,JP-1,JP-2}, Big5,
1678 UTF-8
1679 Not all values might work on your system, see iconv_open(3) for
1680 more details. If it's not set, the value of the environment vari‐
1681 able $MM_CHARSET is used. US-ASCII or compile-time default is used
1682 in case neither of them is defined.
1683 Attribute of highlighting with _dash_ (mono_markdash)
1685 Character attribute of words emphasized like _this_. It depends on
1686 your terminal which attributes are usable. See also word_h_dis‐
1687 play_marks and word_highlight.
1688 Attribute of highlighting with /slash/ (mono_markslash)
1690 Character attribute of words emphasized like /this/. It depends on
1691 your terminal which attributes are usable. See also word_h_dis‐
1692 play_marks and word_highlight.
1693 Attribute of highlighting with *stars* (mono_markstar)
1695 Character attribute of words emphasized like *this*. It depends on
1696 your terminal which attributes are usable. See also word_h_dis‐
1697 play_marks and word_highlight.
1698 Attribute of highlighting with -stroke- (mono_markstroke)
1700 Character attribute of words emphasized like -this-. It depends on
1701 your terminal which attributes are usable. See also word_h_dis‐
1702 play_marks and word_highlight.
1703 (newnews)
1705 These are internal timers used by tin to keep track of new news‐
1706 groups. Do not change them unless you understand what they are
1707 for.
1708 Display these header fields (or *) (news_headers_to_display)
1710 Which news headers you wish to see. If you want to see _all_ the
1711 headers, place an '*' as this value. This is the only way a wild‐
1712 card can be used. If you enter 'X-' as the value, you will see all
1713 headers beginning with 'X-' (like X-Alan or X-Pape). You can list
1714 more than one by delimiting with spaces. Not defining anything
1715 turns off this option.
1716 Do not display these header fields (news_headers_to_not_display)
1718 Same as news_headers_to_display except it denotes the opposite. An
1719 example of using both options might be if you thought X- headers
1720 were A Good Thing(tm), but thought Alan and Pape were miscreants...
1721 well then you would do something like this: news_headers_to_dis‐
1722 play=X- news_headers_to_not_display=X-Alan X-Pape. Not defining
1723 anything turns off this option.
1724 Quote line when following up (news_quote_format)
1726 Format of quote line when posting/following up an article
1727 (%A=Address, %D=Date, %F=Fullname+Address, %G=Groupname, %M=Mes‐
1728 sage-ID, %N=Fullname, %C=Firstname, %I=Initials). Default is "%F
1729 wrote:".
1730 Unicode normalization form (normalization_form)
1732 The normalization form tin should use to normalize unicode input.
1733 The possible values are:
1734 0 None: no normalization
1736 1 NFKC: Compatibility Decomposition, followed by Canonical Compo‐
1738 sition
1739 2 NFKD: Compatibility Decomposition
1741 3 NFC: Canonical Decomposition, followed by Canonical Composition
1743 4 NFD: Canonical Decomposition
1745 Some normalization modes are only available if they are supported by
1746 the library tin uses to do the normalization. Default is NFKC.
1747 PgDn goes to next unread article (pgdn_goto_next)
1749 If ON the Page Down keys will go to the next unread article when
1750 pressed at the end of a message. Default is ON.
1751 Goto first unread article in group (pos_first_unread)
1753 If ON put cursor at first unread article in group otherwise at last
1754 article. Default is ON.
1755 Use 8bit characters in news headers (post_8bit_header)
1757 Allows 8bit characters unencoded in the header of a news article,
1758 if set this also disables the generation of MIME-headers when they
1759 are usualy required. Default is OFF. Only enacted if
1760 post_mime_encoding is also set to 8bit. In a number of local hier‐
1761 archies where 8bit characters are used, using unencoded (raw) 8bit
1762 characters in header is acceptable and sometimes even recommended
1763 so that you need to check the convention adopted in the local hier‐
1764 archy of your interest to determine what to do with this and
1765 post_mime_encoding.
1766 MIME encoding in news messages (post_mime_encoding)
1768 MIME encoding of the body in news message, if necessary. (8bit,
1769 base64, quoted-printable, 7bit) Default is 8bit, which leads to no
1770 encoding. base64 and quoted-printable are usually undesired on
1771 usenet.
1772 View post-processed files (post_process_view)
1774 If ON, then tin will start an appropriate viewer program to display
1775 any files that were post processed and uudecoded. The program is
1776 determined using the mailcap file. Default is ON.
1777 Post process saved articles (post_process_type)
1779 This specifies whether to perform post processing on saved arti‐
1780 cles. The following values are allowed:
1781 0 No (default), no post processing is done.
1783 1 Shell archives, unpacking of multi-part shar(1) files only.
1785 2 Yes, binary attachments and data will be decoded and saved.
1787 Filename to be used for storing posted articles (posted_articles_file)
1789 Keep posted articles in ${TIN_HOMEDIR-"$HOME"}/Mail/posted_arti‐
1790 cles_file. If no filename is set then postings will not be saved.
1791 Default is 'posted'.
1792 Print all headers when printing (print_header)
1794 If ON, then the full article header is sent to the printer. Other‐
1795 wise only the ''Subject:'' and ''From:'' fields are output. Default
1796 is OFF.
1797 Process only unread articles (process_only_unread)
1799 If ON only save/print/pipe/mail unread articles (tagged articles
1800 excepted). Default is OFF.
1801 Show empty Followup-To in editor (prompt_followupto)
1803 If ON show empty ''Followup-To:'' header when editing an article.
1804 Default is OFF.
1805 Characters used as quote-marks (quote_chars)
1807 The character used in quoting included text to article followups
1808 and mail replies. The '_' character represents a blank character
1809 and is replaced with ' ' when read. Default is '>_'.
1810 Quoting behavior (quote_style)
1812 How articles should be quoted when following up or replying to
1813 them. There are a number of things that can be done: empty lines
1814 can be quoted, signatures can be quoted and quote_chars can be com‐
1815 pressed when quoting multiple times (for example, '> > >' will be
1816 turned into '>>>'). The default is to compress quotes, and to quote
1817 empty lines.
1818 When you are viewing an article in raw mode ('^H'), and follow up
1819 or reply to it, the signature will be quoted even if it would oth‐
1820 erwise not be.
1821 Regex used to show quoted lines (quote_regex)
1823 A regular expression that will be applied when reading articles.
1824 All matching lines are shown in col_quote. If quote_regex is blank,
1825 then tin uses a built-in default.
1826 Regex used to show twice quoted l. (quote_regex2)
1828 A regular expression that will be applied when reading articles.
1829 All matching lines are shown in col_quote2. If quote_regex2 is
1830 blank, then tin uses a built-in default.
1831 Regex used to show >= 3 times q.l. (quote_regex3)
1833 A regular expression that will be applied when reading articles.
1834 All matching lines are shown in col_quote3. If quote_regex3 is
1835 blank, then tin uses a built-in default.
1836 Article recentness time limit (recent_time)
1838 If set to 0, this feature is deactivated, otherwise it means the
1839 number of days. Default is 2.
1840 Render BiDi (render_bidi)
1842 If ON tin does the rendering of bi-directional text. If OFF tin
1843 leaves the rendering of bi-directional text to the terminal.
1844 Default is OFF.
1845 Interval in seconds to reread active (reread_active_file_secs)
1847 The news ${TIN_LIBDIR-NEWSLIBDIR}"/"${TIN_ACTIVEFILE-active} file
1848 is reread at regular intervals to show if any new news has arrived.
1849 Default is 1200. Setting this to 0 will disable this feature.
1850 Score limit (kill) (score_limit_kill)
1852 If the score of an article is below or equal this value the article
1853 gets marked as killed.
1854 Score limit (select) (score_limit_select)
1856 If the score of an article is above or equal this value the article
1857 gets marked as hot.
1858 Default score to kill articles (score_kill)
1860 Score of an article which should be killed, this must be <=
1861 score_limit_kill.
1862 Default score to select articles (score_select)
1864 Score of an article which should be marked hot, this must be >=
1865 score_limit_select.
1866 Number of lines to scroll in pager (scroll_lines)
1868 The number of lines that will be scrolled up/down in the article
1869 pager when using cursor-up/down. The default is 1 (line-by-line).
1870 Set to 0 to get traditional tin page-by-page scrolling. Set to -1
1871 to get page-by-page scrolling where the top/bottom line is carried
1872 over onto the next page. This setting supersedes
1873 show_last_line_prev_page=ON. Set to -2 to get half-page scrolling.
1874 This setting supersedes full_page_scroll=OFF.
1875 In group menu, show author by (show_author)
1877 Which information about the author should be shown. Default is 2,
1878 authors full name.
1879 0 None, only the ''Subject:'' line will be displayed.
1881 1 Address, ''Subject:'' line & the address part of the ''From:''
1883 line are displayed.
1884 2 Full Name, ''Subject:'' line & the authors full name part of
1886 the ''From:'' line are displayed (default).
1887 3 Address and Name, ''Subject:'' line & all of the ''From:'' line
1889 are displayed.
1890 Show description of each newsgroup (show_description)
1892 If ON show a short group description text after newsgroup name at
1893 the group selection level. The ''-d'' command-line flag will over‐
1894 ride the setting and turn descriptions off. The text used is taken
1895 from the ${TIN_LIBDIR-NEWSLIBDIR}/newsgroups file and if supported
1896 (requires tin to be build with mh-mail-handling support) from
1897 ${TIN_HOMEDIR-"$HOME"}/.tin/mailgroups for mailgroups. Default is
1898 ON.
1899 Show lines/score in listings (show_info)
1901 Which information about the thread or article should be shown.
1902 Default is 1, show only the line count.
1903 0 None, no information will be displayed.
1905 1 Lines, in article listing the line count of an article will be
1907 displayed and in thread listing the line count of first
1908 (unread) article will be displayed.
1909 2 Score, in article listing the score of an article will be dis‐
1911 played and in thread listing the score of the thread will be
1912 displayed - see also thread_score.
1913 3 Lines & Score, display line count and score.
1915 Show only unread articles (show_only_unread_arts)
1917 If ON show only new/unread articles otherwise show all articles.
1918 Default is ON.
1919 Show only groups with unread arts (show_only_unread_groups)
1921 If ON show only subscribed groups that contain unread articles.
1922 Default is OFF.
1923 Display signatures (show_signatures)
1925 If OFF don't show signatures when displaying articles. Default is
1926 ON.
1927 Prepend signature with '\n-- \n' (sigdashes)
1929 If ON prepend the signature with sigdashes. Default is ON.
1930 Add signature when reposting (signature_repost)
1932 If ON add signature to reposted articles. Default is ON.
1933 Regex used to highlight /slashes/ (slashes_regex)
1935 A regular expression that will be applied when reading articles.
1936 All matching words are shown in col_markslash or mono_markslash. If
1937 slashes_regex is blank, then tin uses a built-in default.
1938 Sort articles by (sort_article_type)
1940 This specifies how articles should be sorted. Sort by ascending
1941 Date (6) is the default. The following sort types are allowed:
1942 0 Nothing, don't sort articles.
1944 1 Subject: (descending), sort articles by ''Subject:'' field
1946 descending.
1947 2 Subject: (ascending), sort articles by ''Subject:'' field
1949 ascending.
1950 3 From: (descending), sort articles by ''From:'' field descend‐
1952 ing.
1953 4 From: (ascending), sort articles by ''From:'' field ascending.
1955 5 Date: (descending), sort articles by ''Date:'' field descend‐
1957 ing.
1958 6 Date: (ascending), sort articles by ''Date:'' field ascending
1960 (default).
1961 7 Score (descending), sort articles by filtering score descend‐
1963 ing.
1964 8 Score (ascending), sort articles by filtering score ascending.
1966 9 Lines: (descending), sort articles by ''Lines:'' field descend‐
1968 ing.
1969 10 Lines: (ascending), sort articles by ''Lines:'' field ascend‐
1971 ing.
1972 Sort threads by (sort_threads_type)
1974 This specifies how threads will be sorted. Sort by descending Score
1975 (1) is the default. The following sort types are allowed:
1976 0 Nothing, don't sort threads.
1978 1 Score (descending), sort threads by filtering score descending
1980 (default).
1981 2 Score (ascending), sort threads by filtering score ascending.
1983 Spamtrap warning address parts (spamtrap_warning_addresses)
1985 Set this option to a list of comma-separated strings to be warned
1986 if you are replying to an article by mail where the e-mail address
1987 contains one of these strings. The matching is case-insensitive.
1988 Example:
1989 spam,delete,remove
1991 Space goes to next unread article (space_goto_next_unread)
1993 <SPACE> normally acts as a Page Down key and has no effect at the
1994 end of an article. If this option is turned ON the <SPACE> command
1995 will go to the next unread article when the end of the article is
1996 reached (rn-style pager). Default is OFF.
1997 Regex used to highlight *stars* (stars_regex)
1999 A regular expression that will be applied when reading articles.
2000 All matching words are shown in col_markstar or mono_markstar. If
2001 stars_regex is blank, then tin uses a built-in default.
2002 Start editor with line offset (start_editor_offset)
2004 Set ON if the editor used for posting, follow-ups and bug reports
2005 has the capability of starting and positioning the cursor at a
2006 specified line within a file. Default is ON.
2007 Strip blanks of end of lines (strip_blanks)
2009 Strips the blanks from the end of each line therefore speeding up
2010 the display when reading on a slow terminal or via modem. Default
2011 is ON.
2012 Remove bogus groups from newsrc (strip_bogus)
2014 Bogus groups are groups that are present in your ${TIN_HOME‐
2015 DIR-"$HOME"}/.newsrc file that no longer exist on the news server.
2016 There are 3 options. 0 means do nothing & always keep bogus groups.
2017 1 means bogus groups will be permanently removed. 2 means that
2018 bogus groups will appear on the Group Selection Menu, prefixed with
2019 a 'D'. This allows you to unsubscribe from them as and when you
2020 wish. Default is 0 (Always Keep).
2021 No unsubscribed groups in newsrc (strip_newsrc)
2023 If ON, then unsubscribed groups will be permanently removed from
2024 your ${TIN_HOMEDIR-"$HOME"}/.newsrc file. Default is OFF.
2025 Regex used to highlight -strokes- (strokes_regex)
2027 A regular expression that will be applied when reading articles.
2028 All matching words are shown in col_markstroke or mono_markstroke.
2029 If strokes_regex is blank, then tin uses a built-in default.
2030 Tab goes to next unread article (tab_goto_next_unread)
2032 If enabled pressing PageNextUnread ('<TAB>') at the Article level
2033 will go to the next unread article immediately instead of first
2034 paging through the current one. Default is ON.
2035 Wrap around threads on next unread (wrap_on_next_unread)
2037 If enabled a search for the next unread article will wrap around
2038 all articles to find also previous unread articles. If disabled the
2039 search stops at the end of the thread list. Default is ON.
2040 Display "a as Umlaut-a (tex2iso_conv)
2042 If ON, show "a as Umlaut-a, etc. Default is OFF. This behavior can
2043 also be toggled in the article viewer via PageToggleTex2iso ('"').
2044 Thread articles by (thread_articles)
2046 Defines which threading method to use. It's possible to set the
2047 threading type on a per group basis by setting the group attribute
2048 variable thread_arts to 0 - 4 in the file ${TIN_HOME‐
2049 DIR-"$HOME"}/.tin/attributes. (See also "GROUP ATTRIBUTES".) The
2050 default is Both Subject and References. The choices are:
2051 0 None, don't thread.
2053 1 Subject, thread on ''Subject:'' only.
2055 2 References, thread on ''References:'' only.
2057 3 Both Subject and References, thread on ''References:'' then
2059 ''Subject:'' (default).
2060 4 Multipart Subject, thread multipart articles on ''Subject:''.
2062 5 Percentage Match, thread base upon a partial character match on
2064 ''Subject:''.
2065 Catchup thread by using left key (thread_catchup_on_exit)
2067 If ON catchup group/thread when leaving with the left arrow key.
2068 Default is ON.
2069 Matchingness of a thread (thread_perc)
2071 How closely the subjects must match for two threads to be consid‐
2072 ered part of the same thread. This is a percentage and the default
2073 if 75%.
2074 Score of a thread (thread_score)
2076 How the total score of a thread is computed. Default is 0, the max‐
2077 imum score in this thread.
2078 0 Max, the maximum score in this thread.
2080 1 Sum, the sum of all scores in this thread.
2082 2 Average, the average score in this thread.
2084 Transliteration (translit)
2086 If ON append //TRANSLIT to the first argument of iconv_open(3) to
2087 enable transliteration. This means that when a character cannot be
2088 represented in the target character set, it can be approximated
2089 through one or several similarly looking characters. On systems
2090 where this extension doesn't exist, this option is disabled.
2091 Default is OFF.
2092 Regex used to highlight _underline_ (underscores_regex)
2094 A regular expression that will be applied when reading articles.
2095 All matching words are shown in col_markdash or mono_markdash. If
2096 underscores_regex is blank, then tin uses a built-in default.
2097 Remove ~/.article after posting (unlink_article)
2099 If ON remove ~/.article after posting. Default is ON.
2100 Program that opens URL's (url_handler)
2102 The program that will be run when launching URL's in the article
2103 viewer using PageViewUrl ('U'). The actual URL will be appended to
2104 this. Default is url_handler.sh %s.
2105 URL highlighting in message body (url_highlight)
2107 Enable highlighting URLs in message body. Default is ON.
2108 Use ANSI color (use_color)
2110 If enabled tin uses ANSI-colors. Default is OFF.
2111 Use scroll keys on keypad (use_keypad)
2113 Default is OFF.
2114 Use mouse in xterm (use_mouse)
2116 Allows the mouse key support in a xterm(1x) to be enabled/disabled.
2117 Default is OFF.
2118 Use slrnface to show ''X-Face:''s (use_slrnface)
2120 If enabled tin uses slrnface(1) to interpret the ''X-Face:''
2121 header. For this option to have any effect, tin must be running in
2122 an xterm(1x) and slrnface(1) must be in your $PATH. Default is OFF.
2123 Wildcard matching (wildcard)
2125 Allows you to select how tin matches strings. The default is 0 and
2126 uses the wildmat notation, which is how this has traditionally been
2127 handled. Setting this to 1 allows you to use perl(1) compatible
2128 regular expressions pcre(3) (see also perlre(1) and pcrepat‐
2129 tern(3)). You will probably want to update your filter file if you
2130 use this regularly. NB: Newsgroup names will always be matched
2131 using the wildmat notation.
2132 What to display instead of mark (word_h_display_marks)
2134 Should the leading and ending stars, slashes, strokes and dashes
2135 also be displayed, even when they are highlighting marks?
2136 0 no
2138 1 yes, display mark
2140 2 print a space instead
2142 Word highlighting in message body (word_highlight)
2144 Enable word highlighting. See word_h_display_marks for the options
2145 available. If use_color is enabled the colors specified in
2146 col_markdash, col_markslash, col_markstar and col_markstroke are
2147 used for word highlighting else the character attributes specified
2148 in mono_markdash, mono_markslash, mono_markstar and mono_markstroke
2149 are used. Default is ON.
2150 Page line wrap column (wrap_column)
2152 Sets the column at which a displayed article body should be
2153 wrapped. If this value is equal to 0, it defaults to the current
2154 screen width. If this value is greater than your current screen
2155 width the part off-screen is not displayed. Thus setting this
2156 option to a large value can be used to disable wrapping. If this
2157 value is negative the wrap margin is the current screen width plus
2158 the given value (as long as the result is still positive, otherwise
2159 it will fall back to the current screen width). Default is 0, wrap‐
2160 ping at the current screen width.
2161 Quote line when cross-posting (xpost_quote_format)
2163 Format is the same as for news_quote_format, this is used when
2164 answering to a crossposting to several groups with no ''Fol‐
2165 lowup-To:'' set.
2166 GROUP ATTRIBUTES
2168 tin allows certain attributes to be set on a per group basis. If it
2169 exists, the global attributes file, ${TIN_LIBDIR-NEWSLIBDIR}/attributes
2170 is read. After that, the user's own attributes file ${TIN_HOME‐
2171 DIR-"$HOME"}/.tin/attributes is read. The global attributes file is
2172 useful for distributing system-wide defaults to new users who have no
2173 private attributes file yet. A later version will provide a menu inter‐
2174 face to set all the attributes. At present you will have to edit the
2175 file with your editor.
2176 Note that the scope=<grouplist> line has to be specified before the
2178 attributes are specified for that list. All attributes are set to a
2179 reasonable default so you only have to specify the attribute that you
2180 want to change (e.g., savedir). All toggle attributes are set by speci‐
2181 fying ON/OFF. Otherwise, these function exactly the same as their
2182 global equivalents. For more details see tin(5).
2183 FILTERING ARTICLES
2185 When there is a subject or an author which you are either very inter‐
2186 ested in, or find completely uninteresting, you can easily instruct tin
2187 to auto-select or auto-kill articles that match rules that you specify.
2188 This can be anything from the name of the author to the number of lines
2189 in an article.
2190 When tin starts up the user's kill-file ${TIN_HOME‐
2192 DIR-"$HOME"}/.tin/filter (see also tin(5)) is read. Each time a news‐
2193 group is entered the rules are applied and articles killed or selected
2194 when they meet certain criteria.
2195 The degree to which rules are applied depend on the kill_level tinrc
2197 setting. By default killed articles will only be marked read. Adjust
2198 kill_level for more aggressive processing. Articles that match an auto-
2199 selection rule are marked with a ''*''.
2200 Filtering rules can be manually entered into ${TIN_HOME‐
2202 DIR-"$HOME"}/.tin/filter (but don't do this whilst running tin else you
2203 will lose your changes) or by using an on-screen menu within tin.
2204 The filtering capabilities of tin have been significantly enhanced over
2206 previous versions to include scoring and better pattern matching. It is
2207 recommended that you read the file filtering in the tin documentation
2208 directory.
2209 The on-screen filtering menu is accessed by pressing '^K' at the Group
2211 and Article levels. It allows the user to kill or select an article
2212 that matches the current ''Subject:'' line, ''From:'' line or a string
2213 entered by the user. The user entered string can be applied to the
2214 ''Subject:'' or ''From:'' lines of an article. The kill description can
2215 be limited to the current newsgroup or it can apply to all newsgroups.
2216 Once entered the user can abort the command and not save the kill
2217 description, edit the kill file or save the kill description.
2218 POSTING ARTICLES
2220 tin allows posting of articles, follow-up to already posted articles
2221 and replying direct through mail to the author of an article.
2222 Use the Post ('w') command to post an article to a newsgroup. After
2224 entering the post subject the default editor (i.e., vi(1)) or the edi‐
2225 tor specified by the $VISUAL or $EDITOR environment variable will be
2226 started and the article can be entered. To crosspost articles simply
2227 add a comma and the name of the newsgroup(s) to the end of the ''News‐
2228 groups:'' line at the beginning of the article. After saving and exit‐
2229 ing the editor you are asked if you wish to a)bort posting the article,
2230 e)dit the article again or p)ost the article to the specified news‐
2231 group(s).
2232 Use the DisplayPostHist ('W') command to display a history of the arti‐
2234 cles you have posted. The date the article was posted, which newsgroups
2235 the article was posted to and the articles subject line are displayed.
2236 Use the PageFollowupQuote ('f'), PageFollowup ('F') or PageFol‐
2238 lowupQuoteHeaders ('^W') command to post a follow-up article to an
2239 already posted article. The PageFollowupQuote command will copy the
2240 text of the original article into the editor. The PageFollowupQuote‐
2241 Headers command will copy the text and all headers of the original
2242 article into the editor. The editing procedure is the same as when
2243 posting an article with the Post ('w') command.
2244 Use the PageReplyQuote ('r'), PageReply ('R') or PageReplyQuoteHeaders
2246 ('^E') command to reply direct through mail to the author of an already
2247 posted article. The PageReplyQuote command will copy the text of the
2248 original article into the editor. The PageReplyQuoteHeaders command
2249 will copy the text and all headers of the original article into the
2250 editor. The editing procedure is the same as when posting an article
2251 with the Post ('w') command. After saving and exiting the editor you
2252 are asked if you wish to abort sending the article via PostAbort ('a'),
2253 edit the article again via PostEdit ('e') or send the article to the
2254 author via PostSend ('s').
2255 CUSTOMIZING THE ARTICLE QUOTE STRING
2257 When posting a followup to an article or replying direct to the author
2258 of an article via email the text of the article can be quoted. The
2259 beginning of the quoted text can contain information about the quoted
2260 article (e.g., Name and the Message-ID of the article). To allow for
2261 different situations certain information from the article can be used
2262 in the quoted string. The following variables are expanded if found in
2263 the tinrc variables mail_quote_format, news_quote_format or
2264 xpost_quote_format:
2265 %A Address (Email)
2266 %D Date
2267 %F Full address (%N <%A>)
2268 %G Groupname
2269 %M Message-ID
2270 %N Fullname of author
2271 %C Firstname of author
2272 %I Initials of author
2273 e.g.,
2274 mail_quote_format=On %D in %G you wrote:
2275 news_quote_format=In %M, %F wrote:
2276 would expand to:
2277 On 21 Sep 1993 09:45:51 -0400 in alt.sources you wrote:
2278 In <abcINN123@example.org>, Joe Bar <joe@example.org> wrote:
2279 The quoted text section of an article is marked by a preceding quote
2280 string at the beginning of each quoted line. The default quote string
2281 is set to '>_'. The default can be changed by setting the tinrc vari‐
2282 able quote_chars to ones own preference. (Note that '_' underline is
2283 used to represent a space).
2284 MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES
2286 The command interface to GroupMail, PageMail, PostMail or ThreadMail
2287 ('m'), Pipe ('|'), Print ('o'), PageRepost or GroupRepost ('x') and
2288 GroupSave, PageSave or ThreadSave ('s' and GroupAutoSave, PageAutoSave
2289 or ThreadAutoSave 'S') articles is the same for ease of use.
2290 Auto-saving with *AutoSave ('S') is a special case and operates only on
2292 marked articles. They will processed without any further prompting
2293 according to the default save parameters defined in tinrc or by any
2294 attributes set for the current group.
2295 Otherwise, the initial prompt will ask you to select which article,
2297 thread, hot (auto-selected), regex pattern, tagged articles you wish to
2298 mail, pipe etc.
2299 Tagged articles must have already been tagged with a *Tag ('t') com‐
2301 mand. All tagged articles can be untagged by a *Untag ('U') untag com‐
2302 mand.
2303 If a regex pattern is selected you are asked to enter a pattern (e.g.,
2305 to match all articles subject lines containing 'net News' you enter
2306 "net News"). Any articles that match the entered expression will be
2307 mailed, piped etc. See also the wildcard tinrc variable for advanced
2308 pattern matching options.
2309 Various expansion characters are recognized when entering the directory
2311 and file to save to. Environment variables (prefixed with '$') and user
2312 home directories (prefixed by '~' or '~username') can be specified.
2313 Environment variables can themselves contain other special characters.
2314 To save articles to a mailbox enter '=<mailbox name>' when asked for
2316 the save filename. If you enter just '=' then articles will be saved to
2317 a mailbox with the name of the current newsgroup (eg, alt.sources).
2318 See default_maildir.
2319 To save in savedir/<news.group.name>/<filename> format enter '+<file‐
2321 name>'. Environment variables are allowed within a filename (e.g.,
2322 $SOURCES/dir/filename). See default_savedir.
2323 When saving articles you can specify whether the saved files should be
2325 post processed. A default process type can be set via
2326 post_process_type.
2327 AUTOMATIC MAILING AND SAVING NEW NEWS
2329 tin allows new/unread news articles to be mailed (''-M'' and ''-N''
2330 option) or saved (''-S'' option) in batch mode for later reading. Use‐
2331 ful when going on holiday and you don't want to return and find that
2332 expire has removed a whole load of unread articles. Best to run via
2333 cron(1) everyday while away, after which you will be mailed a report of
2334 which articles were mailed/saved from which newsgroups and the total
2335 number of articles mailed/saved. Articles are saved in a private news
2336 structure under your <savedir> directory (default is ${TIN_HOME‐
2337 DIR-"$HOME"}/News). Be careful of using this option if you read a lot
2338 of groups because you could overflow your file system.
2339 If you only want to save some of your groups use the batch_save tinrc
2341 variable. Set to ON or OFF in tinrc to enable/disable saving of all
2342 groups and then use the batch_save attribute to fine tune which groups
2343 you want to have saved. For example, if you want to save most of your
2344 groups, then set batch_save to ON in tinrc and selectively turn off the
2345 ones you don't want using attributes.
2346 tin -M iain -c -f newsrc.mail
2348 (mail any unread articles in newsgroups specified
2349 in file newsrc.mail to the local user iain and mark
2350 them as read)
2351 tin -S -c -f newsrc.save
2353 (save any unread articles in newsgroups specified
2354 in file newsrc.save and mark them as read)
2355 tin -R (read any articles saved by tin -S)
2357 RANGES
2359 A range is simply a group of items marked using the SetRange ('#') key.
2360 Certain tin commands will operate on a range if one exists rather than
2361 just the current item. A range is an expression of the form
2362 <min>-<max>, e.g. 10-15 will highlight items 10 through 15 on the cur‐
2363 rent screen. Other than absolute numeric positions, '.' can be used in
2364 place of the current cursor position and '$' can be used to mean the
2365 highest number available. Currently the only commands that understand
2366 ranges are GroupMarkThdRead ('K'), MarkArtUnread ('z') and MarkThdUn‐
2367 read ('Z').
2368 NEWSGROUP LISTS & WILDCARDS
2370 Several places in tin allow you to specify a list of newsgroups. These
2371 include command-line groups, (un)subscribe groups, the AUTO[UN]SUB‐
2372 SCRIBE mechanism. The scope= attributes file tag and the filter file
2373 group= tag also use the same syntax. tin interprets this variable simi‐
2374 larly to rn(1). It contains a list of patterns, separated by commas
2375 and possibly prefixed with exclamation points. An exclamation point
2376 negates the meaning of a match on this pattern, and can be used to can‐
2377 cel certain matches. Some examples:
2378 alt.config news.*,!news.test
2380 Matches alt.config and everything in the 'news' hierarchy except
2382 news.test
2383 See the explanation for the $AUTOSUBSCRIBE variables for further exam‐
2385 ples.
2386 SIGNATURES
2388 tin will recognize a signature in either ${TIN_HOMEDIR-"$HOME"}/.signa‐
2389 ture or ${TIN_HOMEDIR-"$HOME"}/.Sig. If ${TIN_HOMEDIR-"$HOME"}/.signa‐
2390 ture exists, then the signature will be pulled into the editor for mail
2391 commands only. A signature in ${TIN_HOMEDIR-"$HOME"}/.signature will
2392 not be pulled into the editor for posting commands since inews(1) will
2393 append the signature itself.
2394 A signature in ${TIN_HOMEDIR-"$HOME"}/.Sig will be pulled into the edi‐
2396 tor for both posting and mailing commands.
2397 The following is an example of a .Sig file:
2399 NAMES Joe Bar <joe@example.org>
2400 SNAIL Musterweg 12, 99999 Notreal, Germany
2401 tin also has the capability to generate random signatures on a per
2403 newsgroup basis if so desired. The way to accomplish this is to specify
2404 the default signature or the group attribute sigfile as a directory. If
2405 for example the sigfile path is /usr/iain/.sigs and .sigs is a direc‐
2406 tory then tin will select a random signature from any file that is in
2407 the directory .sigs (note: one signature per numbered file). A random
2408 signature can also consist of a fixed part signature that can contain
2409 your name, address etc. followed by the random sig. The fixed part of
2410 the random sig is read from the file $HOME/.sigfixed.
2411 TIPS AND TRICKS
2413 tin can be pretty much be navigated by using the four cursor keys. The
2414 left arrow key goes up a level, the right arrow key goes down a level,
2415 the up arrow key goes up a line and the down arrow key goes down a
2416 line.
2417 The following newsgroups provide useful information concerning news
2419 software:
2420 —news.software.readers (info. about news user agents tin, rn, nn,
2421 slrn etc.)
2422 —news.software.nntp (info. about NNTP)
2423 —news.answers (Frequently Asked Questions (FAQ) about many differ‐
2424 ent themes)
2425 Many prompts within tin offer a default choice that the cursor is posi‐
2427 tioned on. By pressing '<CR>' the default value is taken. Most prompts
2428 can be aborted by pressing '<ESC>'.
2429 When tin is run in an xterm(1x) it will resize itself each time the
2431 xterm(1x) is resized.
2432 tin will reread the ${TIN_LIBDIR-NEWSLIBDIR}"/"${TIN_ACTIVEFILE-active}
2434 file at set intervals (reread_active_file_secs) to show any newly
2435 arrived news.
2436 If you find large number of new newsgroups cluttering up your screen,
2438 pressing SelectToggleReadDisplay ('r') will make them go away.
2439 XTERM BUTTONS
2441 If the environment variable $TERM is set to xterm(1x), then button
2442 pressing can be used to select groups and articles. In this discussion,
2443 the buttons are assumed to be assigned conventionally (i.e., Button1 is
2444 the left button).
2445 In general (i.e., for the group, thread and article menus),
2447 Button1 (left)
2449 enters next (lower) level if you click on an article, other‐
2450 wise pages down.
2451 Button2 (center)
2453 returns to the previous (upper) level if you click on an
2454 article, otherwise pages up.
2455 Button3 (right)
2457 positions on the article line under mouse cursor, or pages
2458 down if you've clicked outside the list of articles.
2459 In the group selection menu, if the mouse is pointing at a group then:
2461 left button
2463 moves to and selects the group pointed at, just like Selec‐
2464 tReadGrp ('<CR>').
2465 center button
2467 quits the program, just like Quit ('q').
2468 right button
2470 moves to the group pointed at.
2471 In the article menu, if the mouse is pointing at an article (or thread)
2473 then:
2474 left button
2476 reads the article pointed at, just like GroupReadBasenote
2477 ('<CR>'), or the thread, just like GroupListThd ('l').
2478 center button
2480 exits the menu, catching up on the group if you have
2481 group_catchup_on_exit set in your configuration, just like
2482 Quit ('q').
2483 right button
2485 moves to the article (or thread) pointed at.
2486 In the thread menu, if the mouse is pointing at an article then:
2488 left button
2490 reads article pointed at, just like ThreadReadArt ('<CR>').
2491 center button
2493 exits the menu, catching up on the thread if you have
2494 thread_catchup_on_exit set in your configuration, just like
2495 Quit ('q').
2496 right button
2498 moves to the article pointed at.
2499 In other menus and areas button pressing reverts back to usual cut and
2501 paste of xterm(1x), but after one click of any button.
2502 INDEX FILES
2504 If your news server supports NOV index files (see newsoverview(5), most
2505 modern installations will) and you have a fast connection to your news
2506 server then this section can be ignored.
2507 If your news server doesn't support NOV index files or you have a very
2509 slow connection to your news server then tin can cache the index for
2510 each newsgroup if cache_overview_files is set to ON. Note that this
2511 cache can use up large amounts of diskspace if you read a lot of groups
2512 and/or high traffic groups.
2513 Each user creates/updates his/her own index files that are stored in
2515 ${TIN_INDEX_NEWSDIR-"${TIN_HOMEDIR-"$HOME"}/.tin"}/.news/. If you are
2516 reading via NNTP then the news server name will be appended to keep the
2517 indexes for different servers separate. If you are reading off the
2518 local spool and local overview files already exist then turning on
2519 caching will have no effect. Likewise unless you see significant delays
2520 entering a group when reading via NNTP then turning on caching will
2521 have little or no effect.
2522 Entering a group the first time tends to be slow because the index file
2524 must be built from scratch. To alleviate the slowness start tin to cre‐
2525 ate all index files for the groups you subscribe to with tin -u -v and
2526 go for a coffee. Subsequent readings of a group will only need to do
2527 incremental updating of the index file and will be much faster as only
2528 new articles will need to be cached.
2529 As indexing might take some time you may want to run tin form the sys‐
2531 tem batcher cron(1) with the ''-u'' option:
2532 30 6 * * * /usr/local/bin/tin -u
2534 If you are low on local disk space you should consider using
2536 getart_limit to limit the size of cached indexes and also manually
2537 purge cached data for groups you are not reading anymore with something
2538 like:
2539 find ${TIN_INDEX_NEWSDIR-"${TIN_HOMEDIR-"$HOME"}/.tin"}/.news* \
2541 -type f -name "[0-9]*.[0-9]" -atime +28 | xargs rm -f
2542
2544 For a detailed description see tin(5).
2545 $MAILCAPS
2547 ${TIN_HOMEDIR-"$HOME"}/.mailcap
2548 /etc/mailcap
2549 /usr/etc/mailcap
2550 /usr/local/etc/mailcap
2551 /etc/mail/mailcap
2552 /etc/nntpserver
2554 ${TIN_HOMEDIR-"$HOME"}/.cancelsecret
2556 ${TIN_HOMEDIR-"$HOME"}/.mime.types
2558 /etc/mime.types
2559 /etc/tin/mime.types
2560 ${TIN_HOMEDIR-"$HOME"}/.newsauth
2562 ${TIN_HOMEDIR-"$HOME"}/.newsrc
2564 ${TIN_HOMEDIR-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT+":$NNTPPORT"}/.old‐
2566 newsrc
2567 ${TIN_HOMEDIR-"$HOME"}/.signature
2569 ${TIN_HOMEDIR-"$HOME"}/.Sig
2570 ${TIN_HOMEDIR-"$HOME"}/.sigfixed
2572 ${TIN_HOMEDIR-"$HOME"}/.tin/.inputhistory
2574 ${TIN_INDEX_MAILDIR-"${TIN_HOMEDIR-"$HOME"}/.tin"}/.mail/
2576 ${TIN_INDEX_NEWSDIR-"${TIN_HOME‐
2578 DIR-"$HOME"}/.tin"}/.news${NNTPSERVER+"-$NNTPSERVER"}/
2579 ${TIN_INDEX_SAVEDIR-"${TIN_HOMEDIR-"$HOME"}/.tin"}/.save/
2581 ${TIN_HOMEDIR-"$HOME"}/.tin/active.mail
2583 ${TIN_HOMEDIR-"$HOME"}/.tin/active.save
2585 /etc/tin/attributes
2587 ${TIN_HOMEDIR-"$HOME"}/.tin/attributes
2588 ${TIN_HOMEDIR-"$HOME"}/.tin/filter
2590 /etc/tin/keymap${${LC_ALL-"${LC_CTYPE-"${LC_MES‐
2592 SAGES-"$LANG"}"}"}:+".${LC_ALL-"${LC_CTYPE-"${LC_MES‐
2593 SAGES-"$LANG"}"}"}"}
2594 ${TIN_HOMEDIR-"$HOME"}/.tin/keymap${${LC_ALL-"${LC_CTYPE-"${LC_MES‐
2595 SAGES-"$LANG"}"}"}:+".${LC_ALL-"${LC_CTYPE-"${LC_MES‐
2596 SAGES-"$LANG"}"}"}"}
2597 ${TIN_HOMEDIR-"$HOME"}/.tin/mailgroups
2599 ${TIN_HOMEDIR-"$HOME"}/.tin/newsrctable
2601 ${TIN_HOMEDIR-"$HOME"}/.tin/posted
2603 ${TIN_HOMEDIR-"$HOME"}/Mail/posted
2605 ${TIN_HOMEDIR-"$HOME"}/.tin/postponed.articles
2607 ${TIN_HOMEDIR-"$HOME"}/.tin/$NNTPSERVER:${NNTPPORT+":$NNTPPORT"}/news‐
2609 groups
2610 ${TIN_HOMEDIR-"$HOME"}/.tin/$NNTPSERVER:${NNTPPORT+":$NNTP‐
2612 PORT"}/serverrc
2613 /etc/tin/tinrc
2615 ${TIN_HOMEDIR-"$HOME"}/.tin/tinrc
2616 /etc/tin/tin.defaults
2618 /usr/local/share/locale/${LC_MESSAGES}/LC_MESSAGES/tin.mo
2620 ${TIN_LIBDIR-NEWSLIBDIR}"/"${TIN_ACTIVEFILE-active}
2622 ${TIN_LIBDIR-NEWSLIBDIR}/active.times
2624 ${TIN_LIBDIR-NEWSLIBDIR}/newsgroups
2626 ${TIN_LIBDIR-NEWSLIBDIR}/organization
2628 ${TIN_LIBDIR-NEWSLIBDIR}/overview.fmt
2630 ${TIN_LIBDIR-NEWSLIBDIR}/subscriptions
2632
2634 TINRC Define this variable if you want to specify command-line options
2635 that tin should be started with to save typing them each time it
2636 is started. The contents of the environment variable are added
2637 to the front of the command-line options before it is parsed
2638 therefore allowing an option specified on the command-line to
2639 override the same option specified in the environment.
2640 TIN_HOMEDIR
2642 Define this variable if you do not want the .tin directory in
2643 $HOME/. E.g., if you want all tin's private files in /tmp/.tin
2644 you would set $TIN_HOMEDIR to /tmp.
2645 TIN_INDEX_NEWSDIR
2647 Define this variable if you do not want the .news directory in
2648 ${TIN_HOMEDIR-"$HOME"}/.tin/. E.g., if you want all tin's news
2649 index files in /tmp/.news you would set $TIN_INDEX_NEWSDIR to
2650 /tmp.
2651 TIN_INDEX_MAILDIR
2653 Define this variable if you do not want the .mail directory in
2654 ${TIN_HOMEDIR-"$HOME"}/.tin/. E.g., if you want all tin's mail
2655 index files in /tmp/.mail you would set $TIN_INDEX_MAILDIR to
2656 /tmp.
2657 TIN_INDEX_SAVEDIR
2659 Define this variable if you do not want the .save directory in
2660 ${TIN_HOMEDIR-"$HOME"}/.tin/. E.g., if you want all tin's save
2661 index files in /tmp/.save you would set $TIN_INDEX_SAVEDIR to
2662 /tmp.
2663 TIN_LIBDIR
2665 Define this variable if you want to override the NEWSLIBDIR path
2666 that was compiled into the tin binary, default is /usr/lib/news.
2667 If tin is running in NNTP mode setting this variable has no
2668 effect.
2669 TIN_SPOOLDIR
2671 Define this variable if you want to override the SPOOLDIR path
2672 that was compiled into the tin binary, default is
2673 /var/spool/news. If tin is running in NNTP mode setting this
2674 variable has no effect.
2675 TIN_NOVROOTDIR
2677 Define this variable if you want to override the NOVROOTDIR path
2678 that was compiled into the tin binary, default is SPOOLDIR (see
2679 above). If tin is running in NNTP mode setting this variable has
2680 no effect.
2681 TIN_ACTIVEFILE
2683 Define this variable if you want to override the NEWSLIB‐
2684 DIR/active path that was compiled into the tin binary. If tin is
2685 running in NNTP mode setting this variable has no effect. If
2686 $TIN_LIBDIR is set it is prepended to $TIN_ACTIVEFILE.
2687 NNTPSERVER
2689 The default NNTP server to remotely read news from. This vari‐
2690 able only needs to be set if the ''-r'' command-line option is
2691 specified and the file /etc/nntpserver does not exist. The
2692 ''-g'' command line option overrides $NNTPSERVER.
2693 NNTPPORT
2695 The NNTP TCP-port to read news from. This variable only needs to
2696 be set if the TCP-port is not 119 (the default). The ''-p''
2697 command-line option overrides $NNTPPORT.
2698 DISTRIBUTION
2700 Set the article header field ''Distribution:'' to the contents
2701 of the variable instead of the system default.
2702 ISO2ASC
2704 Set the ISO to ASCII charset decoding table character to use in
2705 decoding an article text. Values can range from 0 to 6.
2706 ORGANIZATION
2708 Set the article header field ''Organization:'' to the contents
2709 of the variable instead of the system default. If reading news
2710 on an Apollo DomainOS machine the environment variable $NEWSORG
2711 has to be used instead of $ORGANIZATION.
2712 NEWSORG (DomainOS)
2714 DomainOS specific, same as $ORGANIZATION on other OSs (see
2715 above).
2716 REPLYTO
2718 Set the article header field ''Reply-To:'' to the return address
2719 specified by the variable. This is useful if you wish to receive
2720 replies at a different address.
2721 NAME Overrides the full name given in the gecos-files in /etc/passwd,
2723 see also mail_address.
2724 REALNAME
2726 Same as $NAME.
2727 HOME Pathname of the user's home directory. See environ(5) for more
2729 infos.
2730 MAILER This variable has precedence over the default mailer that is
2732 used in all mailing operations within tin. If reading news on
2733 VMS use $TIN_MAILER instead.
2734 TIN_MAILER (VMS)
2736 VMS specific, same as $MAILER on other OSs (see above).
2737 MAIL Full path to the users mailbox.
2739 VISUAL This variable has precedence over the default editor (i.e.,
2741 vi(1)) that is used in all editing operations within tin (e.g.,
2742 posting, replying, follow-ups, ...). Evaluation order is ${VIS‐
2743 UAL-"${EDITOR-vi}"}. See environ(5) for more infos.
2744 EDITOR If $VISUAL is unset, then this variable is looked up for a
2746 default editor. If $EDITOR and $VISUAL are both unset, tin will
2747 uses the systems default editor (i.e. vi(1)) on UNIX-systems).
2748 See environ(5) for more infos.
2749 AUTOSUBSCRIBE
2751 A new group is checked against the list of patterns; if it
2752 matches, tin subscribes the user to the group without further
2753 query. See the section "NEWSGROUP LISTS & WILDCARDS" for an
2754 explanation of the valid syntax. For example, setting
2755 AUTOSUBSCRIBE=comp.os.unix.*,talk.*,!talk.politics.*
2757 will automatically subscribe the user to all new groups in the
2759 comp.os.unix hierarchy, and all talk groups other than talk.pol‐
2760 itics groups (which will be queried for as usual). Of course
2761 this does not work if tin is started with the ''-X'' command-
2762 line switch.
2763 AUTOUNSUBSCRIBE
2765 Is handled like the $AUTOSUBSCRIBE variable, but groups matching
2766 the list are unsubscribed from without further query. For exam‐
2767 ple, setting
2768 AUTOUNSUBSCRIBE=alt.flame.*,u*,!uk.*
2770 will automatically unsubscribe the user from all new alt.flame
2772 groups and all groups starting with u (university groups) other
2773 than UK groups (which will be queried for as usual).
2774 TMPDIR A pathname of a directory made available for tin to create tem‐
2776 porary files.
2777 MAILCAPS
2779 This variable can be used to override the default path search
2780 for mailcap files. See also tin(5).
2781 NOMETAMAIL
2783 Set this variable to disable the use of metamail(1) or a
2784 replacement (e.g. metamutt).
2785 MM_CHARSET
2787 ISPELL Set this variable to point to ispell(1) or a replacement and its
2789 cmd-line options.
2790 PGPOPTS
2792 Define any additional options that you wish to pass to your
2793 pgp(1) or gpg(1) program.
2794 PGPPATH
2796 Override the name of the pgp(1) directory in $HOME that holds
2797 your keys etc..
2798 GNUPGHOME
2800 Override the name of the gpg(1) directory in $HOME that holds
2801 your keys etc..
2802 LC_CTYPE
2804 This variable determines the locale(5) category for character
2805 handling functions. Usually it determines the character classes
2806 for pattern matching character classification and case conver‐
2807 sion. Currently this is not true for tin (which temporary unsets
2808 $LC_CTYPE right before any match is done to avoid confusion).
2809 It's value should be of the form language[_territory][.code‐
2810 set][@modifier]. See environ(5) for more information.
2811 LC_MESSAGES
2813 Formats of informative and diagnostic messages and interactive
2814 responses. It's value should be of the form language[_terri‐
2815 tory][.codeset][@modifier]. See locale(5) and environ(5) for
2816 more information.
2817 LC_TIME
2819 Date and time formats. It's value should be of the form lan‐
2820 guage[_territory][.codeset][@modifier]. See locale(5) and envi‐
2821 ron(5) for more information.
2822 LC_ALL This variable overrides the value of the $LANG variable and any
2824 other $LC_ variable. It's value should be of the form lan‐
2825 guage[_territory][.codeset]. See locale(5) and environ(5) for
2826 more information.
2827 LANG This variable determines the locale(5) category for any category
2829 not specifically selected with a variable starting with $LC_.
2830 It's value should be of the form language[_territory][.codeset].
2831 See environ(5) for more information.
2832 COLUMNS
2834 A decimal integer > 0 used to indicate the user's preferred
2835 width in column positions for the terminal screen or window. If
2836 this variable is unset or null, the implementation determines
2837 the number of columns, appropriate for the terminal or window.
2838 When $COLUMNS is set, any terminal-width information implied by
2839 $TERM will be overridden. Users and portable applications should
2840 not set $COLUMNS unless they wish to override the system selec‐
2841 tion and produce output unrelated to the terminal characteris‐
2842 tics.
2843 LINES A decimal integer > 0 used to indicate the user's preferred num‐
2845 ber of lines on a page or the vertical screen or window size in
2846 lines. A line in this case is a vertical measure large enough to
2847 hold the tallest character in the character set being displayed.
2848 If this variable is unset or null, the implementation determines
2849 the number of lines, appropriate for the terminal or window.
2850 When $LINES is set, any terminal-height information implied by
2851 $TERM will be overridden. Users and portable applications should
2852 not set $LINES unless they wish to override the system selec‐
2853 tion.
2854 TERM The type of terminal in use. This is used when looking up term‐
2856 cap sequences. See environ(5) for more information.
2857
2859 tin does conform to the Base Definitions volume of IEEE Std
2860 1003.1-2001, Section 12, Utility Conventions (Utility Argument Syntax,
2861 Utility Syntax Guidelines).
2862
2864 Regular expression support is provided by the PCRE library package
2865 pcre(3), which is open source software, written by Philip Hazel, and
2866 copyright by the University of Cambridge, England.
2867 ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/
2868
2870 CNews NNTPd, noffle(1) (<= V1.0-pre5) and NewsCache (<= V1.1.91) can't
2871 handle simultaneous GROUP commands. If you run into trouble with any of
2872 the mentioned servers define NUM_SIMULTANEOUS_GROUP_COMMAND to 1 in
2873 active.c and recompile. See also the TODO-file which comes with the
2874 source.
2875 Before mailing a bug-report to <tin-bugs@tin.org> please check if you
2876 are using the latest (stable) release, and if not, please upgrade
2877 first! Have a look a the doc/TODO file for known bugs. If you still
2878 think you've found a bug, please use the BugReport ('R') function and
2879 write in English. Please do NOT enclose a core-file in your bugreport
2880 until we request it.
2881
2883 tin is based on the tass(1) newsreader that was developed by Rich
2884 Skrenta and posted to alt.sources in March 1991; its first version was
2885 released on August 23rd 1991. tass(1) itself was heavily influenced by
2886 notesfiles a public domain UNIX version of PLATO Notes, developed at
2887 the University of Illinois by Ray Essick and Rob Kolstad in 1982. For a
2888 version overview see <http://www.tin.org/history.html>
2889
2891 Rich Skrenta
2892 author of tass(1) v3.2 which this newsreader used as its base.
2893 Bill Davidsen
2895 author of envarg.c environment variable reading routine.
2896 Mike Gleason
2898 author of sigfile.c random signature generation routines.
2899 Markus Kuhn <Markus.Kuhn@cl.cam.ac.uk>
2901 author of langinfo.c, charset.c and iso2asc.txt ISO-8859-1 docu‐
2902 mentation.
2903 Arnold Robbins
2905 author of strftime.c date formatting routine.
2906 Rich Salz
2908 author of wildmat.c pattern matching and parsdate.y date parsing
2909 routines.
2910 Dave Taylor
2912 author of curses.c from the elm(1) mailreader.
2913 Chris Thewalt
2915 author of getline.c emacs(1) style editing routine.
2916 Steven Madsen
2918 for adding pgp(1) (Pretty Good Privacy) support.
2919 Philip Hazel <ph10@cam.ac.uk>
2921 for pcre(3) (Perl-compatible regular expression library).
2922 Patrick Powell <papowell@astart.com>
2924 for snprintf(3) and vsnprintf(3) fallbacks.
2925 Andrew Greer
2927 for originally porting tin to the VAX/VMS operating system.
2928
2930 Iain Lea <iain@bricbrac.de>
2931
2933 Urs Janssen <urs@tin.org>
2934
2936 cron(1) elm(1), emacs(1), gpg(1), inews(1), ispell(1), lp(1), lpr(1),
2937 metamail(1), noffle(1), perl(1), perlre(1), pgp(1), rn(1), sendmail(1),
2938 shar(1), slrnface(1), tass(1), unshar(1), uudecode(1), vi(1),
2939 xterm(1x), iconv(3), iconv_open(3), nl_langinfo(3), pcre(3), pcrepat‐
2940 tern(3), snprintf(3), strftime(3), vsnprintf(3), wildmat(3), envi‐
2941 ron(5), locale(5), mbox(5), mmdf(5), newsoverview(5), tin(5), RFC977,
2942 RFC1036, RFC1524, RFC2045, RFC2046, RFC2047, RFC2048, RFC2822, RFC2980
29431.8.2 April 25th, 2006 tin(1)