1tin(1) Usenet newsreader tin(1)
2
6 tin, rtin - Usenet newsreader
7
9 tin [[-h|-H|-V] | [[[-a] [-dlnq|-Q] [-ArzxX]] [[-R|-S] -s News_dir]
10 [-cuvZ] [-4|-6] [-N|-M address] [-o|-w]] [-D debug_level] [-G arti‐
11 cle_limit] [-f newsrc_file] [-g server] [-m Mail_dir] [-p port] [-I in‐
12 dex_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 an NNTP (Network News Transport Protocol) server. It will automatically
18 utilize NOV newsoverview(5) style index files if available locally or
19 via the NNTP [X]OVER command (RFC2980, RFC3977).
20 tin has four separate levels of operation: Selection level, Group
22 level, Thread level and Article level. Use the Help ('h') command to
23 view a list of the commands available at a particular level.
24 On startup tin will show a list of the newsgroups found in ${TIN_HOME‐
26 DIR:-"$HOME"}/.newsrc. An arrow '->' or highlighted bar will point to
27 the first newsgroup. Move to a group by using the terminal arrow keys
28 (terminal dependent) or Down ('j') and Up ('k'). Use PgUp/PgDn (termi‐
29 nal dependent) or PageUp ('^U') (CTRL-U) and PageDown ('^D') (CTRL-D)
30 to page up/down. Enter a newsgroup by pressing '<CR>'.
31 The GroupNextUnreadArtOrGrp ('<TAB>') key enters the next newsgroup
33 with unread articles.
34
36 0 Successful program execution. No unread news available in batch
37 mode.
38 1 Usage, syntax, configuration file or network error.
40 2 Unread news available (batch mode (''-Z'') only).
42 3 NNTP error.
44
46 -4 Force connecting via IPv4 to the remote NNTP server. Only
47 available when build with IPv6 support.
48 -6 Force connecting via IPv6 to the remote NNTP server. Only
50 available when build with IPv6 support.
51 -a Toggle ANSI color (default is off).
53 -A Force authentication on initial connect. Only available
55 when reading via NNTP.
56 -c Create/update index files for every group in ${TIN_HOME‐
58 DIR:-"$HOME"}/.newsrc or file specified by the ''-f'' op‐
59 tion and mark all articles as read.
60 -d Don't load newsgroup descriptions and servers message of
62 the day (interactive mode).
63 -D debug-level
65 Enter debug-level (1 = NNTP, 2 = filter, 4 = newsrc, 8 =
66 threading, 16 = memory, 32 = attributes, 64 = misc, 128 =
67 remove existing debug files). For NNTP-level ''-v'' con‐
68 trols the verbosity of the output.
69 -f file Use the specified file of subscribed to newsgroups in place
71 of ${TIN_HOMEDIR:-"$HOME"}/.newsrc.
72 -g server Use the server and newsrc specified in ${TIN_HOME‐
74 DIR:-"$HOME"}/.tin/newsrctable. Only available when reading
75 via NNTP.
76 -G article-limit
78 Limit the number of articles/group to retrieve from the
79 server. If article-limit is > 0 not more than the last ar‐
80 ticle-limit articles/group are fetched from the server. If
81 article-limit is < 0 tin will start fetching articles from
82 your first unread minus absolute value of article-limit.
83 Default is 0, which means no limit.
84 -h Help listing all command-line options.
86 -H Brief introduction to tin that is also shown the first time
88 it is started.
89 -I dir Directory in which to store newsgroup index files. Default
91 is ${TIN_INDEX_NEWSDIR:-"${TIN_HOME‐
92 DIR:-"$HOME"}/.tin"}/.news. This option has no effect if
93 tin retrieves its index files via NNTP and cache_over‐
94 view_files is turned off.
95 -l Get number of articles per group from the ${TIN_LIB‐
97 DIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active} file. If read‐
98 ing via NNTP this is done with the LIST command (RFC3977).
99 This might result in incorrect article counts but is usu‐
100 ally faster than the default which is to read the
101 ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active} file
102 (either directly or via LIST) and then check the article
103 count via NNTP GROUP command (RFC3977) ''-ln''. If reading
104 via NNTP and LIST COUNTS (RFC6048) is available that is
105 used instead as it gives more accurate article counts.
106 -m dir Mailbox directory to use. Default is ${TIN_HOME‐
108 DIR:-"$HOME"}/Mail.
109 -M user Mail unread articles to specified user for later reading.
111 For more information read section "AUTOMATIC MAILING AND
112 SAVING NEW NEWS".
113 -n Only load groups from the ${TIN_LIBDIR:-NEWSLIB‐
115 DIR}"/"${TIN_ACTIVEFILE:-active} file that are subscribed
116 to in the user's ${TIN_HOMEDIR:-"$HOME"}/.newsrc. This al‐
117 lows a noticeable speedup when connecting via a slow line,
118 but tin may not be able detect which groups are moderated.
119 See also ''-l''.
120 -N Mail unread articles to yourself for later reading. For
122 more information read section "AUTOMATIC MAILING AND SAVING
123 NEW NEWS".
124 -o Quick post all postponed articles and exit. In order for
126 this to be really quick, it should be used with ''-n'' if
127 possible.
128 -p port Port to use if reading via NNTP (default is 119). This also
130 overrides the environment variable $NNTPPORT if set. Only
131 available when reading via NNTP.
132 -q Don't check for new newsgroups and skip loading the servers
134 message of the day.
135 -Q Quick start. Start tin as quickly as possible. Currently
137 this is equivalent to ''-dnq''.
138 -r Read news remotely from the default NNTP server specified
140 in the environment variable $NNTPSERVER or contained in the
141 file /etc/nntpserver.
142 -R Read news saved by the ''-S'' option.
144 -s dir Save/read articles to/in directory. Default is ${TIN_HOME‐
146 DIR:-"$HOME"}/News.
147 -S Save unread articles for later reading by the ''-R'' op‐
149 tion. For more information read section "AUTOMATIC MAILING
150 AND SAVING NEW NEWS".
151 -u Create/update index files for every group in ${TIN_HOME‐
153 DIR:-"$HOME"}/.newsrc or file specified by the ''-f'' op‐
154 tion. This option is disabled if tin retrieves its index
155 files via an NNTP server and cache_overview_files is turned
156 off.
157 -v Verbose mode for ''-c'', ''-D'', ''-M'', ''-N'', ''-S'',
159 ''-u'' and ''-Z'' options. Can be used multiple times to
160 increase verbosity.
161 -V Print version and date information.
163 -w Quick mode to post an article and then exit. This option
165 implies ''-d''. In order for this to be really quick, it
166 should be used with ''-n'' if possible.
167 -x No-posting mode. You cannot post articles if you use this
169 option.
170 -X No overwrite mode. ${TIN_HOMEDIR:-"$HOME"}/.newsrc and
172 files in ${TIN_HOMEDIR:-"$HOME"}/.tin will not be overwrit‐
173 ten but may be created if they don't exist.
174 -z Only start tin if there is any new/unread news. If there is
176 news tin will position cursor at first group with unread
177 news. Useful for putting in login file.
178 -Z Check if there is any new/unread news and exit with appro‐
180 priate status. If ''-v'' option is specified the number of
181 unread articles in each group is printed. An exit code 0
182 indicates no news, 1 that an error occurred and 2 that
183 new/unread news exists. Useful for writing scripts.
184 tin can also dynamically change its options by the OptionMenu ('M')
186 command. Any changes are written to ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc.
187 For more information see section "GLOBAL OPTIONS MENU AND TINRC CONFIG‐
188 URABLE VARIABLES" and tin(5).
189 A list of groups can be specified after the other command-line options.
191 This can be useful if you wish to yank in or subscribe to a hand-picked
192 subset of the active newsgroups. See the section "NEWSGROUP LISTS &
193 WILDCARDS" for the types of pattern that tin understands.
194 If you specify a single group-name, or a wildcard that matches a single
196 group, then you will automatically enter that group. Otherwise the nor‐
197 mal group selection screen will appear, but with all the matching
198 groups present too, as though you had yanked just those groups in.
199 With the ''-w'' flag a given group-name is used as default group to
201 post to. If more than one group or a wildcard is specified only the
202 first group respectively the first group that matches is used.
203 Once you use SelectYankActive ('y') to yank in all active groups, or
205 SelectToggleReadDisplay ('r') to toggle the read/unread status, then
206 the command-line groups will be gone. You can use SelectSyncWithActive
207 ('Y') to reread the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-ac‐
208 tive} file and get them back.
209 NB: With the ''-n'' flag, only unsubscribed groups in the ${TIN_HOME‐
211 DIR:-"$HOME"}/.newsrc file (or the newsrc-file given by the ''-f'' com‐
212 mand-line switch or via ${TIN_HOMEDIR:-"$HOME"}/.tin/newsrctable) can
213 be matched.
214 Command-line options have higher priority than attributes and tinrc op‐
216 tions. Thus, command-line option takes precedence over configured val‐
217 ues.
218
220 NEWS ADMINISTRATION
221 Maintaining Netnews on large networks of machines can be a pretty time
222 consuming job as I discovered when I was given the job of maintaining
223 our news system and news users.
224 A user starting tin for the first time can be automatically subscribed
226 to a list of newsgroups that are deemed appropriate by the news admin‐
227 istrator. The subscriptions file should be created in your news lib di‐
228 rectory (i.e., ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions) and should be
229 world readable. If you read news via NNTP, then your news server must
230 support the LIST SUBSCRIPTIONS command. It is part of the NNTP List Ex‐
231 tensions (RFC6048) and all modern servers should understand it.
232 SCREEN FORMAT
234 tin has four separate levels of operation: Selection level, Group
235 level, Thread level and Article level.
236 At the Selection level the title displays (the name of the news server
238 and) the number of subscribed groups (containing new unread articles).
239 The newsgroups are displayed in the middle of the screen usually with
240 the number of unread articles displayed on the same line in front, but
241 it can be customized via select_format.
242 ->M 1 2 comp.security.announce Announcements from the CERT abou
244 M 2 1 news.admin.announce Announcements for news adminstra
245 3 22 news.software.misc News-related software other than
246 4 1475 news.software.nntp The Network News Transfer Protoc
247 X 5 124 news.software.readers Discussion of software used to r
248 There may also be a character prefixing the line. An explanation fol‐
250 lows:
251 u This group is unsubscribed. To see only your subscribed
253 groups use the SelectToggleReadDisplay ('r') or SelectYankAc‐
254 tive ('y') toggle keys.
255 M This is a moderated group. Any posts you make will have to be
257 approved by the group administrator before it will be made
258 public. tin will ask for confirmation before you post to a
259 moderated group.
260 N This is a new newsgroup which has been created since you last
262 used tin. New newsgroups are not subscribed to by default
263 (However, see the $AUTOSUBSCRIBE / $AUTOUNSUBSCRIBE environ‐
264 ment variables). Subscribe to it in the normal way if you
265 wish the group to continue to appear in your Selection Menu.
266 Simply ignore new newsgroups and they will be gone the next
267 time you start tin. You will have to yank in all the groups
268 to find them in a later session.
269 D This group no longer exists. If you no longer wish to see
271 this group then unsubscribe from it in the normal way. This
272 flag will only appear if you have set strip_bogus to "ask" in
273 the Options Menu.
274 X You may no longer make posts to this group. Often a group
276 will be superseded by a more appropriately named one.
277 = This group has been renamed and you may no longer post to it.
279 If you do, then you will receive an error from your news
280 server telling you the correct group to post to.
281 At the Group level the title contains the name of the group, the number
283 of conversation threads, the abbreviated threading method (thread_arti‐
284 cles), the limit of articles to get (if set; getart_limit), the total
285 number of (unread) articles (art_marked_read or art_marked_unread), the
286 number of hot articles art_marked_selected, the number of read hot ar‐
287 ticles (if any; art_marked_read_selected), the number of recent arti‐
288 cles (art_marked_recent) and the number of killed articles
289 (art_marked_killed). I.e.:
290 alt.sources (5B -50/23+ 0* 3o 0K)
292 The characters after the numbers are depending to the configuration and
294 if your are in show_only_unread_arts mode or not. Some numbers could be
295 missing if the specific option is not enabled. It might also contain an
296 'M', 'X' or '=' (see above; doesn't work with the ''-n'' command-line
297 switch!) if the group is moderated, set to no posting or postings to it
298 get redirected.
299 If a thread has unread articles it is marked with art_marked_unread in
301 front of the total number of articles in the thread. If there are re‐
302 cent articles within the thread it might be marked with art_marked_re‐
303 cent in front of the total number of articles in the thread — this is
304 controlled by the recent_time option. If a thread has hot articles in
305 it (see also section "FILTERING ARTICLES") it's marked with
306 art_marked_selected in front of the total number of articles in the
307 thread. The number of lines of the first (unread) article in the thread
308 might also be shown right before the subject — this is controlled by
309 the show_info option. The display can be customized via group_format.
310 de.admin.net-abuse.announce (11B 13+ 1* 1o 0K) M
312 -> 1 + 3 108 bincancels in de.talk.sex Christopher Lueg <l
314 2 + 69 EMP/ECP gecancelt. xynx. BI= 10 Henning Weede <hwee
315 3 o 93 EMP gecancelt. SouthBeach/Palms Henning Weede <hwee
316 4 * 368 <1997-11-12> Fremdcancel-FAQ Thomas Roessler <ro
317 At the Thread level the screen usually (depends on the threading method
319 used) looks like this, but can be customized via thread_format:
320 -> 1 [ 7] What is this funny tree in the thr Robert F. Simmig
322 2 [ 12] +-> Sephan Wagner <s
323 3 [ 230] | `->Tin thread-level (was: What is Bob Johnson <bob
324 4 [ 22] `->tin threading menu Brian Richardson
325 At the Article level the page header has the following format:
328 Sun, 28 Dec 1997 21:21:01 de.admin.news.groups Thread 20 of 86
330 Lines 50 Re: EINSPRUCH zu RESULT:de.comm.mobil.ALL Article 47 of 59
331 Urs Janssen <urs@akk.org> at Arbeitskreis Kultur und Kommunikati
332 article-body
334 The look of the Selection, Group and Thread level can be customized.
336 See the section "CUSTOMIZING THE SCREEN FORMAT".
337 COMMON MOVING KEYS
339 This table shows the common keys used for moving around all levels
340 within tin.
341 ANSI/vt100 Other Terminals
342 Beg. of list/article Home FirstPage (^)
343 End of list/article End LastPage ($)
344 Page Up PgUp PageUp (u, ^U or ^B)
345 Page Down PgDn PageDown (^D or ^F or <SPACE>)
346 Line Up Up arrow Up (k or ^P)
347 Line Down Down arrow Down (j or ^N)
348 COMMON EDITING COMMANDS
350 An emacs(1) style editing package allows the easy editing of input
351 strings. A history list allows the easy reuse of previously entered
352 strings. In addition to the cursor keys, the following commands are
353 available when editing a string:
354 ^A, ^E move to beginning or end of line, respectively.
356 ^F, ^B non-destructive move forward or back one location, respec‐
358 tively.
359 ^D delete the character currently under the cursor, or send EOF
361 if no characters in the buffer.
362 ^H, <DEL> delete character left of the cursor.
364 ^K delete from cursor to end of line.
366 ^P, ^N move through history, previous and next, respectively.
368 ^L, ^R redraw the current line.
370 <CR> places line on history list if non-blank, appends newline and
372 returns to the caller.
373 <ESC> aborts the present editing operation.
375 GLOBAL COMMANDS
377 The following commands are available at all 4 menu levels and always
378 have the same effect.
379 ShellEscape '!'
381 Shell escape. ShellEscape by itself will launch a shell,
382 ShellEscape <command> will run an external <command>. This
383 facility may have been disabled by the System Administrator.
384 ToggleColor '&'
386 Toggle use of ANSI color.
387 RedrawScr '^L'
389 Redraw the current screen.
390 ScrollUp '<'
392 Scroll screen up by one line.
393 ScrollDown '>'
395 Scroll screen down by one line.
396 Postponed 'O' '^O'
398 Reload postponed article. If your system blocks the Postponed
399 key you must quote it by pressing '^V' (CTRL-V) first. The
400 postpone-menu offers the following actions: PromptYes ('y') =
401 reload and spawn editor; PostponeOverride ('Y') = post arti‐
402 cle (without spawning editor); PostponeAll ('A') = post all
403 postponed articles (without spawning editor); PromptNo ('n')
404 = skip this article; Quit ('q') = quit postponed menu. Cur‐
405 rently there is no 'simple' way to delete a postponed article
406 from the postponed-file, you have to use the following com‐
407 mand sequence instead: reload it with Postponed, enter editor
408 with PromptYes, quit editor, discard posting with Quit
409 ('^O''y''q'). See also ''-o'' command-line switch.
410 Help 'h' Help screen of commands available on the current menu. You
412 can use SearchSubjF ('/'), SearchSubjB ('?') and SearchRepeat
413 ('\') to search on this screen. Quit ('q') returns to the
414 menu.
415 ToggleHelpDisplay 'H'
417 Toggle the display of help mini menu at the bottom of the
418 screen and posting etiquette after composing an article (be‐
419 ginner_level).
420 DisplayPostHist 'W'
422 List articles posted by user. The date posted, the newsgroup
423 and the subject are listed. See the section "POSTING HISTORY
424 LISTING" for more information.
425 Version 'v'
427 Print tin version information.
428 NEWSGROUP SELECTION COMMANDS
430 4 Select group 4.
431 SelectResetNewsrc '^R'
433 Reset ${TIN_HOMEDIR:-"$HOME"}/.newsrc file. This will destroy
434 all records of which articles have been read, so use this
435 carefully.
436 SetRange '#'
438 Choose a range of articles to be affected by the next com‐
439 mand. See the section "RANGES" for more information.
440 SelectSortActive '.'
442 Sort the list of newsgroups.
443 SearchRepeat '\'
445 Repeat the previous search.
446 SearchSubjF '/'
448 Search for a group by name and description (if displayed).
449 SearchSubjB '?'
451 Backward search through the group names and descriptions.
452 SelectReadGrp '^J' '<CR>'
454 Read current group.
455 SelectEnterNextUnreadGrp '<TAB>' 'n'
457 Enter next group with unread news. Will wrap around to the
458 beginning of the group selection list looking for unread
459 groups.
460 Catchup 'c'
462 Make current group as all read [after confirmation] and move
463 to the next group in the group selection list.
464 CatchupNextUnread 'C'
466 Mark current group as all read [after confirmation] and enter
467 the next unread group in the group selection list.
468 SelectToggleDescriptions 'd'
470 Toggle display to show just the group name or the group name
471 and the group descriptions.
472 EditFilter 'E'
474 Edit the filter file and reload it afterwards.
475 SelectGoto 'g'
477 Choose a new group by name. This command can be used to ac‐
478 cess any group, even those not currently yanked in.
479 ToggleInfoLastLine 'i'
481 Toggle the display of the description of the current news‐
482 group in the last line. This will not be available if tin was
483 started with the ''-d'' option.
484 ToggleInverseVideo 'I'
486 Toggle inverse video.
487 LookupMessage 'L'
489 Look up article by ''Message-ID:''. If none of the groups
490 listed in the ''Newsgroups:''-header of the referenced arti‐
491 cle is available, just the contents of the ''News‐
492 groups:''-header will be displayed in the last line. At this
493 level this command only works if reading via NNTP and the
494 server supports [X]HDR (RFC2980, RFC3977) or XPAT (RFC2980).
495 SelectMoveGrp 'm'
497 Move the current group within the group selection list. By
498 entering '1' the group will become the first displayed group
499 in the list, by entering '8' the eighth group in the list
500 etc. By entering '$' the group will be the last group dis‐
501 played.
502 OptionMenu 'M'
504 User configurable options menu (for more information see sec‐
505 tion "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES").
506 SelectNextUnreadGrp 'N'
508 Positions the cursor on the next group with unread articles
509 in it.
510 Quit 'q' Quit tin — ask the user to confirm if confirm_choice is set
512 accordingly.
513 QuitTin 'Q'
515 Quit tin — don't ask the user to confirm.
516 SelectToggleReadDisplay 'r'
518 Toggle display of all subscribed to groups and just those
519 groups containing unread articles. Command has no effect if
520 groups were specified on the command-line when tin was
521 started.
522 BugReport 'R'
524 Mail a bug report or comment to <tin-bugs@tin.org>. This is
525 the best way of getting bugs fixed and features
526 added/changed.
527 SelectSubscribe 's'
529 Subscribe to current group.
530 SelectSubscribePat 'S'
532 Subscribe to groups matching user specified pattern. See the
533 section "NEWSGROUP LISTS & WILDCARDS" for the types of pat‐
534 tern that tin understands.
535 SelectUnsubscribe 'u'
537 Unsubscribe to current group. This can be used to remove bo‐
538 gus groups. See strip_bogus in the "GLOBAL OPTIONS MENU AND
539 TINRC CONFIGURABLE VARIABLES" section.
540 SelectUnsubscribePat 'U'
542 Unsubscribe to groups matching user specified pattern. See
543 the section "NEWSGROUP LISTS & WILDCARDS" for the types of
544 pattern that tin understands.
545 Post 'w' Post an article to current group. If posting fails for some
547 reason, you'll get the chance to PostEdit ('e') the article
548 again, PostPostpone ('o') it for later processing (see also
549 ''-o'' command-line switch) or discard it via Quit ('q').
550 SelectQuitNoWrite 'X'
552 Quit tin without saving any changes to the configuration.
553 SelectYankActive 'y'
555 Yanks in all groups. Toggles the displayed groups between all
556 the groups in the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE‐
557 FILE:-active} file and just those that are subscribed to in
558 ${TIN_HOMEDIR:-"$HOME"}/.newsrc.
559 SelectSyncWithActive 'Y'
561 Reread the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-ac‐
562 tive} file to see if any new news has arrived since starting
563 tin.
564 SelectMarkGrpUnread 'z' 'Z'
566 Mark all articles in the current group as unread.
567 GROUP INDEX COMMANDS
569 All searches in this level are limited to unread articles if in
570 show_only_unread_arts mode. GroupToggleReadUnread ('r') can be use tog‐
571 gle the setting right before/after the search.
572 4 Select article 4.
574 MenuFilterSelect '^A'
576 Auto select article(s) using a menu. Read the section "FIL‐
577 TERING ARTICLES" for more information.
578 MenuFilterKill '^K'
580 Kill article(s) using a menu. Read the section "FILTERING AR‐
581 TICLES" for more information.
582 MarkFeedRead '^X'
584 Mark current article, thread, range, auto-selected (hot) ar‐
585 ticles, articles matching pattern or tagged articles as read.
586 A prompt asks which type should be marked.
587 MarkFeedUnread '^W'
589 Mark current article, thread, range, auto-selected (hot) ar‐
590 ticles, articles matching pattern or tagged articles as un‐
591 read. A prompt asks which type should be marked.
592 SetRange '#'
594 Choose a range of articles to be affected by the next com‐
595 mand. See the section "RANGES" for more information.
596 LastViewed '-'
598 Re-enter the last message that was viewed.
599 SearchRepeat '\'
601 Repeat the previous search.
602 SearchSubjF '/'
604 Search forward for specified subject.
605 SearchSubjB '?'
607 Search backwards for specified subject.
608 GroupSelThd '*'
610 Select current thread for later processing.
611 GroupDoAutoSel '+'
613 Selects all threads in current group. It is a shortcut for
614 calling GroupSelPattern with a pattern of ''*''.
615 GroupToggleThdSel '.'
617 Toggle selection of current thread. If at least one unread
618 article, (but not every unread article) in the current thread
619 is selected, then all unread articles become selected.
620 GroupSelThdIfUnreadSelected ';'
622 For each thread in current group, if it at least one unread
623 article is selected, all unread articles become selected.
624 This is useful for auto-selection on author where reader
625 wants to see entire thread.
626 GroupSelPattern '='
628 Prompts for a pattern with which to match on. All threads
629 whose subjects match the pattern will be marked selected. A
630 pattern of ''*'' will match all subjects. Entering just
631 '<CR>' will re-use the last pattern that was entered.
632 GroupReverseSel '@'
634 Reverse all selections on all articles.
635 GroupUndoSel '~'
637 Undo all selections on all articles. It clears the toggle ef‐
638 fect of GroupMarkUnselArtRead ('X') command. Thus after first
639 doing a GroupMarkUnselArtRead, one can then do GroupUndoSel
640 to reset articles. Thus, one can iteratively whittle down un‐
641 interesting threads.
642 Pipe '|' Pipe current article / thread / auto-selected (hot) articles
644 / articles matching pattern / tagged articles into command.
645 See the section "MAILING PIPING PRINTING REPOSTING AND SAVING
646 ARTICLES" for more information.
647 QuickFilterSelect '['
649 Auto select article(s) with a single key [after confirma‐
650 tion]. The defaults used for selection are based upon the
651 following four tinrc config variables: default_filter_se‐
652 lect_case, default_filter_select_expire, default_filter_se‐
653 lect_global and default_filter_select_header. Read the sec‐
654 tion "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES"
655 for a full explanation of these variables and "FILTERING AR‐
656 TICLES" for more information on filtering.
657 QuickFilterKill ']'
659 Kill article(s) with a single key [after confirmation]. The
660 defaults used for killing are based upon the following four
661 tinrc config variables: default_filter_kill_case, de‐
662 fault_filter_kill_expire, default_filter_kill_global and de‐
663 fault_filter_kill_header. Read the section "GLOBAL OPTIONS
664 MENU AND TINRC CONFIGURABLE VARIABLES" for a full explanation
665 of these variables and "FILTERING ARTICLES" for more informa‐
666 tion on filtering.
667 GroupReadBasenote '^J' '<CR>'
669 Read current article.
670 GroupNextUnreadArtOrGrp '<TAB>'
672 View next unread article or group.
673 SearchAuthF 'a'
675 Author forward search. This searches for articles with a spe‐
676 cific ''From:'' line.
677 SearchAuthB 'A'
679 Author backward search. Otherwise, see SearchAuthF ('a')
680 above.
681 SearchBody 'B'
683 Search the body of all articles in group (can be slow). You
684 can abort the search using Quit ('q').
685 Catchup 'c'
687 Mark all articles as read [after confirmation] then return to
688 the group selection list. Move cursor to next group.
689 CatchupNextUnread 'C'
691 Mark all articles as read [after confirmation] and enter the
692 next group with unread news.
693 GroupToggleSubjDisplay 'd'
695 Cycle the display of the author through all the possible op‐
696 tions for the tinrc variable show_author.
697 GroupCancel 'D'
699 Cancel (delete) or supersede (overwrite) the current article.
700 It must have been posted by the same user. The cancel message
701 can be seen in the newsgroup 'control' or 'control.cancel'.
702 EditFilter 'E'
704 Edit the filter file and reload it afterwards.
705 GroupGoto 'g'
707 Choose a new group by name. This command can be used to ac‐
708 cess any group, even those not currently yanked in.
709 GroupToggleGetartLimit 'G'
711 Toggle article/group limit.
712 ToggleInfoLastLine 'i'
714 Display the subject of the first article in the current
715 thread in the last line.
716 ToggleInverseVideo 'I'
718 Toggle inverse video.
719 GroupMarkThdRead 'K'
721 Mark article/thread as read and move onto the next unread ar‐
722 ticle/thread. If a range of articles/threads is set, the
723 range will be marked as read instead of the current arti‐
724 cle/thread. When tagged articles/threads are present, a
725 prompt asks how to proceed.
726 GroupListThd 'l'
728 Open the thread under the current cursor position.
729 LookupMessage 'L'
731 Look up article by ''Message-ID:''.
732 GroupMail 'm'
734 Mail current article / thread / auto-selected (hot) articles
735 / articles matching pattern / tagged articles to someone. See
736 the section "MAILING PIPING PRINTING REPOSTING AND SAVING AR‐
737 TICLES" for more information.
738 OptionMenu 'M'
740 User configurable options menu (for more information see sec‐
741 tion "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES").
742 GroupNextGroup 'n'
744 Go to next group.
745 GroupNextUnreadArt 'N'
747 Go to the next unread article.
748 Print 'o' Send current article / thread / auto-selected (hot) articles
750 / articles matching pattern / tagged articles to printer. See
751 the section "MAILING PIPING PRINTING REPOSTING AND SAVING AR‐
752 TICLES" for more information.
753 GroupPrevGroup 'p'
755 Go to previous group.
756 GroupPrevUnreadArt 'P'
758 Go to previous unread article.
759 Quit 'q' Return to previous level.
761 QuitTin 'Q'
763 Quit tin — don't ask the user to confirm.
764 GroupToggleReadUnread 'r'
766 Toggle the display between all articles and unread articles.
767 BugReport 'R'
769 Mail a bug report or comment to <tin-bugs@tin.org>. This is
770 the best way of getting bugs fixed and features
771 added/changed.
772 GroupSave 's'
774 Save current article / thread / auto-selected (hot) articles
775 / articles matching pattern / tagged articles. See the sec‐
776 tion "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
777 for more information.
778 GroupAutoSave 'S'
780 Save marked articles automatically without further prompting.
781 GroupTag 't'
783 Toggle tag-status of current article / thread for GroupMail
784 ('m') / Pipe ('|') / Print ('o') / GroupSave ('s') / GroupRe‐
785 post ('x').
786 GroupTagParts 'T'
788 Automatically tag/untag all the parts of the current multi-
789 part message in order.
790 GroupToggleThreading 'u'
792 Cycle the threading mode through no threading, threading by
793 subject, threading by references, threading on both subject
794 and references, group multipart articles into a thread
795 (''Subject:'' based).
796 GroupUntag 'U'
798 Untag all articles that were tagged.
799 Post 'w' Post an article to the current group. If posting fails for
801 some reason, you'll get the chance to edit the article again
802 via PostEdit ('e'), postpone it for later processing via
803 PostPostpone ('o') (see also ''-o'' command-line switch) or
804 discard it via Quit ('q').
805 GroupRepost 'x'
807 Repost an already posted article / thread / auto-selected
808 (hot) articles / articles matching pattern / tagged articles
809 to another newsgroup(s). Useful for reposting from global to
810 local newsgroups. Do not use this to crosspost your own arti‐
811 cles.
812 GroupMarkUnselArtRead 'X'
814 Mark all unread articles that have not been selected as read,
815 redraw screen to reflect changes and put index at the first
816 thread to begin reading. Pressing GroupMarkUnselArtRead
817 ('X') again will toggle back to the way it was before. See
818 GroupUndoSel ('~') command for clearing the toggle effect,
819 leaving the group will also clear the toggle effect and make
820 the changes permanent.
821 MarkArtUnread 'z'
823 Mark current article as unread.
824 MarkThdUnread 'Z'
826 Mark current thread as unread. If a range of threads is set,
827 the range will be marked as unread instead of the current
828 thread. When tagged threads are present, a prompt asks how to
829 proceed.
830 THREAD LISTING COMMANDS
832 4 Select article 4 within thread.
833 MenuFilterSelect '^A'
835 Auto select article(s) using a menu. Read the section "FIL‐
836 TERING ARTICLES" for more information.
837 MenuFilterKill '^K'
839 Kill article(s) using a menu. Read the section "FILTERING AR‐
840 TICLES" for more information.
841 MarkFeedRead '^X'
843 Mark current article, thread, range, auto-selected (hot) ar‐
844 ticles, articles matching pattern or tagged articles as read.
845 A prompt asks which type should be marked.
846 MarkFeedUnread '^W'
848 Mark current article, thread, range, auto-selected (hot) ar‐
849 ticles, articles matching pattern or tagged articles as un‐
850 read. A prompt asks which type should be marked.
851 SetRange '#'
853 Choose a range of articles to be affected by the next com‐
854 mand. See the section "RANGES" for more information.
855 LastViewed '-'
857 Re-enter the last message that was viewed.
858 SearchRepeat '\'
860 Repeat the previous search.
861 SearchSubjF '/'
863 Search forward for specified subject.
864 SearchSubjB '?'
866 Search backwards for specified subject.
867 ThreadSelArt '*'
869 Select current thread for later processing.
870 ThreadToggleArtSel '.'
872 Toggle selection of current article.
873 ThreadReverseSel '@'
875 Reverse article selections.
876 ThreadUndoSel '~'
878 Undo all selections on current thread.
879 Pipe '|' Pipe current article / thread / auto-selected (hot) articles
881 / articles matching pattern / tagged articles into command.
882 See the section "MAILING PIPING PRINTING REPOSTING AND SAVING
883 ARTICLES" for more information.
884 ThreadReadArt '^J' '<CR>'
886 Read current article within thread.
887 ThreadReadNextArtOrThread '<TAB>'
889 View next unread article within thread.
890 SearchAuthF 'a'
892 Author forward search. This searches for articles with a spe‐
893 cific ''From:'' line. The search will wrap over into the next
894 thread if nothing is found in the current one.
895 SearchAuthB 'A'
897 Author backward search. Otherwise, see SearchAuthF ('a')
898 above.
899 SearchBody 'B'
901 Search the body of all articles in group (can be slow). You
902 can abort the search using Quit ('q').
903 Catchup 'c'
905 Mark thread as read [after confirmation] and return to the
906 group index page. Move cursor to next thread.
907 CatchupNextUnread 'C'
909 Mark thread as read [after confirmation] and enter the next
910 thread containing unread news.
911 ThreadToggleSubjDisplay 'd'
913 Cycle the display of the author through all the possible op‐
914 tions for the tinrc variable show_author.
915 ThreadCancel 'D'
917 Cancel (delete) or supersede (overwrite) the current article.
918 It must have been posted by the same user. The cancel message
919 can be seen in the newsgroup 'control' or 'control.cancel'.
920 EditFilter 'E'
922 Edit the filter file and reload it afterwards.
923 ToggleInfoLastLine 'i'
925 Display the subject of the current article in the last line.
926 ToggleInverseVideo 'I'
928 Toggle inverse video.
929 ThreadMarkArtRead 'K'
931 Mark article as read and move onto the next unread article.
932 If a range of articles is set, the range will be marked as
933 read instead of the current article. When tagged articles are
934 present, a prompt asks how to proceed.
935 LookupMessage 'L'
937 Look up article by ''Message-ID:''.
938 ThreadMail 'm'
940 Mail current article / thread / auto-selected (hot) articles
941 / articles matching pattern / tagged articles to someone. See
942 the section "MAILING PIPING PRINTING REPOSTING AND SAVING AR‐
943 TICLES" for more information.
944 Print 'o' Send current article / thread / auto-selected (hot) articles
946 / articles matching pattern / tagged articles to printer. See
947 the section "MAILING PIPING PRINTING REPOSTING AND SAVING AR‐
948 TICLES" for more information.
949 Quit 'q' Return to previous level.
951 QuitTin 'Q'
953 Quit tin — don't ask the user to confirm.
954 BugReport 'R'
956 Mail a bug report or comment to <tin-bugs@tin.org>. This is
957 the best way of getting bugs fixed and features
958 added/changed.
959 ThreadSave 's'
961 Save current article / thread / auto-selected (hot) articles
962 / articles matching pattern / tagged articles. See the sec‐
963 tion "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
964 for more information.
965 ThreadAutoSave 'S'
967 Save marked articles automatically without further prompting.
968 ThreadTag 't'
970 Toggle tag status of current article for mailing, piping,
971 printing, saving or reposting.
972 ThreadTagParts 'T'
974 Automatically tag/untag all the parts of the current multi-
975 part message in order.
976 ThreadUntag 'U'
978 Untag all tagged threads.
979 Post 'w' Post an article to the current group. If posting fails for
981 some reason, you'll get the chance to edit the article again
982 via PostEdit ('e'), postpone it for later processing via
983 PostPostpone ('o') (see also ''-o'' command-line switch) or
984 discard it via Quit ('q').
985 MarkArtUnread 'z'
987 Mark current article in thread as unread. If a range of arti‐
988 cles is set, the range will be marked as unread instead of
989 the current article. When tagged articles are present, a
990 prompt asks how to proceed.
991 MarkThdUnread 'Z'
993 Mark all articles in thread as unread.
994 ARTICLE VIEWER COMMANDS
996 0 Read the first (base) article in this thread.
997 4 Read response 4 in this thread.
999 MenuFilterSelect '^A'
1001 Auto select article(s) using a menu. Read the section "FIL‐
1002 TERING ARTICLES" for more information.
1003 PageReplyQuoteHeaders '^E'
1005 Reply through mail to the author of the current article with
1006 a copy of the article with all headers included.
1007 PagePGPCheckArticle '^G'
1009 Perform pgp(1) / gpg(1) operations on article. This expects
1010 inline pgp (RFC4880) and not MIME pgp (RFC3156).
1011 PageToggleRaw '^H'
1013 Toggles the display mode (raw including all headers vs.
1014 cooked).
1015 MenuFilterKill '^K'
1017 Kill article(s) using a menu. Read the section "FILTERING AR‐
1018 TICLES" for more information.
1019 PageToggleTabs '^T'
1021 Toggle the TAB width between 4 and 8 characters.
1022 PageFollowupQuoteHeaders '^W'
1024 Post a followup to the current article with a copy of the ar‐
1025 ticle with all headers included.
1026 PageToggleTex2iso '"'
1028 Toggle TeX to ISO decoding for current article. The default
1029 behavior is taken from the tex2iso_conv variable in the tinrc
1030 file.
1031 PageToggleAllHeaders '*'
1033 Toggles the display of all headers vs. headers in news_head‐
1034 ers_to_display.
1035 PageToggleRot '%'
1037 Toggle ROT-13 decoding for this article.
1038 PageToggleUue '('
1040 Toggle the display of uuencoded sections. The default behav‐
1041 ior is taken from the hide_uue variable in the tinrc file.
1042 PageReveal ')'
1044 The form feed character (^L) is often used to hide 'spoilers'
1045 that the reader may not initially wish to see when viewing an
1046 article. Any text after a formfeed is not displayed. This
1047 key-press acts like a reveal key and turns the hidden text
1048 back on. Scrolling down will also reveal the text, scrolling
1049 up will hide it again.
1050 LastViewed '-'
1052 Re-enter the last message that was viewed.
1053 SearchRepeat '\'
1055 Repeat the previous search.
1056 SearchSubjF '/'
1058 Forward search the text of this article.
1059 SearchSubjB '?'
1061 Backward search the text of this article.
1062 PageSkipIncludedText ':'
1064 Skip to the end of the next quoted text-block in this arti‐
1065 cle. Quoted text is everything which matches quote_regex,
1066 quote_regex2 or quote_regex3.
1067 PageTopThd '<'
1069 Go to the first article in the current thread.
1070 PageBotThd '>'
1072 Go to the last article in the current thread.
1073 PageToggleHighlight '_'
1075 Toggle word highlighting on/off.
1076 Pipe '|' Pipe current article / thread / auto-selected (hot) articles
1078 / articles matching pattern / tagged articles into command.
1079 See the section "MAILING PIPING PRINTING REPOSTING AND SAVING
1080 ARTICLES" for more information.
1081 QuickFilterSelect '['
1083 Auto select article(s) with a single key. The defaults used
1084 for selection are set based upon the following four tinrc
1085 config variables: default_filter_select_case, default_fil‐
1086 ter_select_expire, default_filter_select_global and de‐
1087 fault_filter_select_header Read the section "GLOBAL OPTIONS
1088 MENU AND TINRC CONFIGURABLE VARIABLES" for a full explanation
1089 of these variables and "FILTERING ARTICLES" for more informa‐
1090 tion on filtering.
1091 QuickFilterKill ']'
1093 Kill article(s) with a single key. The defaults used for
1094 killing are based upon the following four tinrc config vari‐
1095 ables: default_filter_kill_case, default_filter_kill_expire,
1096 default_filter_kill_global and default_filter_kill_header.
1097 Read the section "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE
1098 VARIABLES" for a full explanation of these variables and
1099 "FILTERING ARTICLES" for more information on filtering.
1100 PageNextThd '^J' '<CR>'
1102 Go to next base article.
1103 PageNextUnread '<TAB>'
1105 Go to next unread article. If the tinrc variable
1106 goto_next_unread doesn't contain PageNextUnread, then this
1107 key will first page through the current article.
1108 SearchAuthF 'a'
1110 Author forward search.
1111 SearchAuthB 'A'
1113 Author backward search.
1114 SearchBody 'B'
1116 Search the body of all articles in group (can be slow). You
1117 can abort the search using Quit ('q').
1118 Catchup 'c'
1120 Mark the current thread as read [after confirmation] and re‐
1121 turn to the previous menu. Move cursor to next item.
1122 CatchupNextUnread 'C'
1124 Mark the rest of the current thread as read [after confirma‐
1125 tion] and enter the next thread with unread articles.
1126 PageCancel 'D'
1128 Cancel (delete) or supersede (overwrite) the current article.
1129 It must have been posted by the same user. The cancel message
1130 can be seen in the newsgroup 'control' or 'control.cancel'.
1131 PageEditArticle 'e'
1133 Edit the current article. This is restricted to mailgroups
1134 and saved news.
1135 EditFilter 'E'
1137 Edit the filter file and reload it afterwards.
1138 PageFollowupQuote 'f'
1140 Post a followup to the current article with a copy of the ar‐
1141 ticle included.
1142 PageFollowup 'F'
1144 Post a followup to the current article without including a
1145 copy of the article.
1146 PageFirstPage 'g'
1148 Go to the start of the article.
1149 PageLastPage 'G'
1151 Go to the end of the article.
1152 ToggleInfoLastLine 'i'
1154 Display the subject of the current article in the last line.
1155 ToggleInverseVideo 'I'
1157 Toggle inverse video.
1158 PageKillThd 'K'
1160 Mark rest of thread as read and move onto the next unread
1161 thread.
1162 PageListThd 'l'
1164 Show the thread menu that the current article is a part of.
1165 LookupMessage 'L'
1167 Look up article by ''Message-ID:''.
1168 PageMail 'm'
1170 Mail current article / thread / auto-selected (hot) articles
1171 / articles matching pattern / tagged articles to someone. See
1172 the section "MAILING PIPING PRINTING REPOSTING AND SAVING AR‐
1173 TICLES" for more information.
1174 OptionMenu 'M'
1176 User configurable options menu (for more information see sec‐
1177 tion "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES").
1178 PageNextArt 'n'
1180 Go to the next article.
1181 PageNextUnreadArt 'N'
1183 Go to the next unread article.
1184 Print 'o' Send current article / thread / auto-selected (hot) articles
1186 / articles matching pattern / tagged articles to printer. See
1187 the section "MAILING PIPING PRINTING REPOSTING AND SAVING AR‐
1188 TICLES" for more information.
1189 PagePrevArt 'p'
1191 Go to the previous article.
1192 PagePrevUnreadArt 'P'
1194 Go to the previous unread article.
1195 Quit 'q' Return to the previous level.
1197 QuitTin 'Q'
1199 Quit tin — don't ask the user to confirm.
1200 PageReplyQuote 'r'
1202 Reply through mail to the author of the current article with
1203 a copy of the article included.
1204 PageReply 'R'
1206 Reply through mail to the author of the current article with‐
1207 out including the original article.
1208 PageSave 's'
1210 Save current article / thread / auto-selected (hot) articles
1211 / articles matching pattern / tagged articles. See the sec‐
1212 tion "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
1213 for more information.
1214 PageAutoSave 'S'
1216 Save marked articles automatically without further prompting.
1217 PageTag 't'
1219 Toggle tag status of current article for mailing, piping,
1220 printing, saving or reposting.
1221 PageGroupSel 'T'
1223 Return to group selection level.
1224 PageGotoParent 'u'
1226 Go to parent article.
1227 PageViewUrl 'U'
1229 Display a list of URLs in the current article. See the sec‐
1230 tion "URL LISTING" for more information.
1231 PageViewAttach 'V'
1233 Display a list of attachments of the current article. See the
1234 section "ATTACHMENT LISTING" for more information.
1235 Post 'w' Post an article to the current group. If posting fails for
1237 some reason, you'll get the chance to edit the article again
1238 via PostEdit ('e'), postpone it for later processing via
1239 PostPostpone ('o') (see also ''-o'' command-line switch) or
1240 discard it via Quit ('q').
1241 PageRepost 'x'
1243 Repost an already posted article / thread / auto-selected
1244 (hot) articles / articles matching pattern / tagged articles
1245 to another newsgroup(s). Useful for reposting from global to
1246 local newsgroups. Do not use this to crosspost your own arti‐
1247 cles.
1248 MarkArtUnread 'z'
1250 Mark article as unread.
1251 MarkThdUnread 'Z'
1253 Mark the current thread as unread.
1254 URL LISTING
1256 PageViewUrl ('U') displays a list of URLs in the current article. Be‐
1257 sides the common moving keys, the following commands are available:
1258 UrlSelect '^J' '<CR>'
1260 The current URL will be prompted and opened using the
1261 url_handler. '<ESC>' or no input will skip the URL.
1262 SearchSubjF '/'
1264 URL forward search.
1265 SearchSubjB '?'
1267 URL backward search.
1268 SearchRepeat '\'
1270 Repeat the previous search.
1271 ShellEscape '!'
1273 Shell escape.
1274 ToggleInfoLastLine 'i'
1276 Toggle the display of the current URL in the last line.
1277 Help 'h' Help screen of commands available.
1279 ToggleHelpDisplay 'H'
1281 Toggle the display of help mini menu at the bottom of the
1282 screen and posting etiquette after composing an article
1283 (beginner_level).
1284 ATTACHMENT LISTING
1286 PageViewAttach ('V') displays a list of attachments of the current ar‐
1287 ticle. Besides the common moving keys, the following commands are
1288 available:
1289 AttachPipe 'p'
1291 Pipe attachment into command.
1292 AttachSave 's'
1294 Save current attachment / tagged attachments to disk.
1295 AttachSelect '^J' '<CR>'
1297 View attachment.
1298 AttachTag 't'
1300 Tag one or more attachments for saving.
1301 AttachTagPattern '='
1303 Prompts for a pattern to match. All attachments whose
1304 name/description or content type/transfer encoding match
1305 the pattern will be tagged.
1306 AttachToggleTagged '@'
1308 Reverse tagging of all attachments.
1309 AttachUntag 'U'
1311 Untag all tagged attachments.
1312 SearchSubjF '/'
1314 Attachment forward search.
1315 SearchSubjB '?'
1317 Attachment backward search.
1318 SearchRepeat '\'
1320 Repeat the previous search.
1321 GlobalPipe '|'
1323 Pipe attachment into command. Uses the raw attachment, no
1324 decoding is done.
1325 ShellEscape '!'
1327 Shell escape.
1328 ToggleInfoLastLine 'i'
1330 Toggle the display of the name/description of the current
1331 attachment in the last line.
1332 Help 'h' Help screen of commands available.
1334 ToggleHelpDisplay 'H'
1336 Toggle the display of help mini menu at the bottom of the
1337 screen and posting etiquette after composing an article
1338 (beginner_level).
1339 POSTING HISTORY LISTING
1341 DisplayPostHist ('W') displays a list of all previous posted articles
1342 stored in ${TIN_HOMEDIR:-"$HOME"}/.tin/posted. The following informa‐
1343 tiosn are shown: a time stamp in "dd-mm-yy"-format, a single letter in‐
1344 dicating the action which initiated the message, the group names (evet‐
1345 ually shortened, see also abbreviate_groupname) or a mail address the
1346 message was sent to and the subject of the message. Besides the common
1347 moving keys, the following commands are available:
1348 PostedArticlesSelect '^J' '<CR>'
1350 The article with the current ''Message-ID:'' will be
1351 opened if available. Note that this requires that the
1352 ''Message-ID:'' of the article was recorded in
1353 ${TIN_HOMEDIR:-"$HOME"}/.tin/posted which may not always
1354 be the case. If using NNTP and the internal inews (in‐
1355 ews_prog set to "--internal") and either the server pro‐
1356 poses a ''Message-ID:'' during the POST (RFC3977) command
1357 or tin is build to generate ''Message-ID:'' this should
1358 be the case. With an external inews (and reading from lo‐
1359 cal spool) it is not.
1360 SearchSubjF '/'
1362 URL forward search.
1363 SearchSubjB '?'
1365 URL backward search.
1366 SearchRepeat '\'
1368 Repeat the previous search.
1369 ShellEscape '!'
1371 Shell escape.
1372 ToggleInfoLastLine 'i'
1374 Toggle the display of the current 'Message-ID:'' in the
1375 last line.
1376 Help 'h' Help screen of commands available.
1378 ToggleHelpDisplay 'H'
1380 Toggle the display of help mini menu at the bottom of the
1381 screen and posting etiquette after composing an article
1382 (beginner_level).
1383 GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES
1385 At startup, tin reads in the configuration files (see also tin(5)).
1386 They contain a list of variables that can be used to configure the way
1387 tin works. If it exists, the global configuration file, /etc/tin/tinrc
1388 is read. After that, the user's own configuration file is read from
1389 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc. The global file is useful for dis‐
1390 tributing system-wide defaults to new users who have no private tinrc
1391 yet.
1392 The variables are user configurable by editing ${TIN_HOME‐
1394 DIR:-"$HOME"}/.tin/tinrc directly. Most of them can also be set in the
1395 GLOBAL OPTIONS MENU which is accessed by pressing OptionMenu ('M') at
1396 all levels. It allows the user to customize the behavior of tin. The
1397 options are saved to the file ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc when
1398 you exit tin so don't edit the file directly whilst tin is running.
1399 In the options menu use the cursor keys in the usual way to move
1401 around. Use ConfigSelect ('^J' or '<CR>') to 'open' the option you wish
1402 to change. You will need to enter a new value or use '<SPACE>' to tog‐
1403 gle the available options. ConfigSelect will save the new value,
1404 '<ESC>' will abort without saving changes.
1405 As with the other menus, RedrawScr ('^L') will redraw the screen. You
1407 can use SearchSubjF ('/'), SearchSubjB ('?') and SearchRepeat ('\') to
1408 search for a specific option. Use Quit ('q') to exit the option menu
1409 and keep your changes. Use QuitTin ('Q') to exit without keeping your
1410 changes.
1411 The options menu provides access to the attributes menu for the current
1413 group by the ConfigToggleAttrib ('<TAB>') command. Pressing ConfigTog‐
1414 gleAttrib again toggles back to the options menu. For more information
1415 see section "ATTRIBUTES MENU AND GROUP ATTRIBUTES".
1416 The ConfigScopeMenu ('S') command brings up the scopes menu. For more
1418 information see section "SCOPES MENU".
1419 Here is a full list of all the available variables. The name in braces
1421 is the name of the corresponding setting in ${TIN_HOME‐
1422 DIR:-"$HOME"}/.tin/tinrc.
1423 Abbreviate long newsgroup names (abbreviate_groupname)
1425 If ON abbreviate long newsgroup names at group selection level and
1426 article level (if necessary) like this: news.software.readers ->
1427 n.software.readers -> n.s.readers -> n.s.r. Default is OFF.
1428 Add posted articles to filter (add_posted_to_filter)
1430 If ON add posted articles which start a new thread to filter for
1431 highlighting follow-ups. Default is ON.
1432 Insert 'User-Agent:'-header (advertising)
1434 Turn ON advertising in header (''User-Agent:''). Default is ON.
1435 Skip multipart/alternative parts (alternative_handling)
1437 If ON strip multipart/alternative messages automatically. Default
1438 is ON.
1439 Character to show deleted articles (art_marked_deleted)
1441 The character used to show that an article was deleted. Default is
1442 'D'.
1443 Character to show inrange articles (art_marked_inrange)
1445 The character used to show that an article is in a range. Default
1446 is '#'.
1447 Character to show returning arts (art_marked_return)
1449 The character used to show that an article will return as an unread
1450 article when the group is next entered. Default is '-'.
1451 Character to show selected articles (art_marked_selected)
1453 The character used to show that an article/thread is auto-selected
1454 (hot). Default is '*'.
1455 Character to show recent articles (art_marked_recent)
1457 The character used to show that an article/thread is recent (not
1458 older than X days). See also recent_time. Default is 'o'.
1459 Character to show unread articles (art_marked_unread)
1461 The character used to show that an article has not been read. De‐
1462 fault is '+'.
1463 Character to show read articles (art_marked_read)
1465 The character used to show that an article was read. Default is '
1466 '.
1467 Character to show killed articles (art_marked_killed)
1469 The character used to show that an article was killed. Default is
1470 'K'. kill_level must be set accordingly.
1471 Character to show read selected arts (art_marked_read_selected)
1473 The character used to show that an article was hot before it was
1474 read. Default is ':'. kill_level must be set accordingly.
1475 Ask before using MIME viewer (ask_for_metamail)
1477 If ON tin will ask before using a MIME viewer (metamail_prog) to
1478 display MIME messages. This only occurs if a MIME viewer is set.
1479 Default is OFF.
1480 Send you a cc and/or bcc automatically (auto_cc_bcc)
1482 Automatically put your name in the ''Cc:'' and/or ''Bcc:'' field
1483 when mailing an article. Default is No.
1484 List thread using right arrow key (auto_list_thread)
1486 If ON automatically list thread when entering it using right arrow
1487 key. Default is ON.
1488 Reconnect to server automatically (auto_reconnect)
1490 Default is OFF.
1491 Save articles in batch mode (batch_save)
1493 If set ON articles/threads will be saved in batch mode when save
1494 ''-S'' or mail ''-M, -N'' is specified on the command line. Default
1495 is ON.
1496 Show mini menu & posting etiquette (beginner_level)
1498 If set ON a mini menu of the most useful commands will be displayed
1499 at the bottom of the screen for each level. Also a short posting
1500 etiquette will be displayed after composing an article. Default is
1501 ON.
1502 Cache NNTP overview files locally (cache_overview_files)
1504 If ON, create local copies of NNTP overview files. This can be used
1505 to considerably speed up accessing large groups when using a slow
1506 connection. See also "INDEX FILES". Default is OFF.
1507 Hash algorithm for cancel-locks (cancel_lock_algo)
1509 Use this hash algorithm for cancel-locks. Only available when build
1510 with cancel-lock support. none disables the generation of cancel-
1511 locks. Valid values are none, sha1, sha256 and sha512. Default is
1512 sha1.
1513 Catchup read groups when quitting (catchup_read_groups)
1515 If set ON the user is asked when quitting if all groups read during
1516 the current session should be marked read. Default is OFF.
1517 Standard background color (col_back)
1519 Standard background color
1520 Color of quoted text from external sources (col_extquote)
1522 Color of quoted text from external sources
1523 Color of sender (From:) (col_from)
1525 Color of sender (From:)
1526 Color of article header lines (col_head)
1528 Color of header-lines
1529 Color of help text (col_help)
1531 Color of help pages
1532 Color for inverse text (background) (col_invers_bg)
1534 Color of background for inverse text
1535 Color for inverse text (foreground) (col_invers_fg)
1537 Color of foreground for inverse text
1538 Color of status messages (col_message)
1540 Color of status messages in last line
1541 Color of highlighting with _dash_ (col_markdash)
1543 Color of words emphasized like _this_. See also word_h_dis‐
1544 play_marks and word_highlight.
1545 Color of highlighting with /slash/ (col_markslash)
1547 Color of words emphasized like /this/. See also word_h_dis‐
1548 play_marks and word_highlight.
1549 Color of highlighting with *stars* (col_markstar)
1551 Color of words emphasized like *this*. See also word_h_dis‐
1552 play_marks and word_highlight.
1553 Color of highlighting with -stroke- (col_markstroke)
1555 Color of words emphasized like -this-. See also word_h_dis‐
1556 play_marks and word_highlight.
1557 Color of mini help menu (col_minihelp)
1559 Color of mini help menu
1560 Color of actual news header fields (col_newsheaders)
1562 Color of actual news header fields
1563 Standard foreground color (col_normal)
1565 Standard foreground color
1566 Color of quoted lines (col_quote)
1568 Color of quoted lines
1569 Color of twice quoted line (col_quote2)
1571 Color of twice quoted lines
1572 Color of =>3 times quoted line (col_quote3)
1574 Color of >=3 times quoted lines
1575 Color of response counter (col_response)
1577 Color of response counter. This is the text that says "Response x
1578 of y" in the article viewer.
1579 Color of signatures (col_signature)
1581 Color of signatures
1582 Color of urls highlight (col_urls)
1584 Color of urls highlight
1585 Color of verbatim blocks (col_verbatim)
1587 Color of verbatim blocks
1588 Color of article subject lines (col_subject)
1590 Color of article subject
1591 Color of text lines (col_text)
1593 Color of text-lines
1594 Color of help/mail sign (col_title)
1596 Color of help/mail sign
1597 Which actions require confirmation (confirm_choice)
1599 Ask for manual confirmation to protect the user.
1600 • commands Ask for confirmation before executing certain danger‐
1602 ous commands (e.g., Catchup ('c')). Commands that this affects
1603 are marked in this manual with '[after confirmation]'. Default
1604 is commands & quit.
1605 • quit You'll be asked to confirm that you wish to exit tin when
1607 you use the Quit ('q') command.
1608 • select Ask for confirmation before marking all not selected
1610 (with GroupMarkUnselArtRead ('X') command) articles as read.
1611 Format string for display of dates (date_format)
1613 Format string tin uses for date representation. A description of
1614 the different format options can be found at strftime(3). tin uses
1615 strftime(3) when available and supports most format options in his
1616 fallback code. Default is "%a, %d %b %Y %H:%M:%S".
1617 (default_art_search)
1619 (default_author_search)
1621 (default_config_search)
1623 The last article/author/config option that was searched for.
1624 (default_filter_days)
1626 Default is 28.
1627 (default_filter_kill_case)
1629 Default for quick (1 key) kill filter case. ON = filter case sen‐
1630 sitive, OFF = ignore case. Default is OFF.
1631 (default_filter_kill_expire)
1633 Default for quick (1 key) kill filter expire. ON = limit to de‐
1634 fault_filter_days, OFF = don't ever expire. Default is OFF.
1635 (default_filter_kill_global)
1637 Default for quick (1 key) kill filter global. ON=apply to all
1638 groups, OFF=apply to current group. Default is ON.
1639 (default_filter_kill_header)
1641 Default for quick (1 key) kill filter header.
1642 0
1644 ''Subject:'' (case sensitive)
1645 1
1647 ''Subject:'' (ignore case)
1648 2
1650 ''From:'' (case sensitive)
1651 3
1653 ''From:'' (ignore case)
1654 4
1656 ''Message-ID:'' & full ''References:'' line
1657 5
1659 ''Message-ID:'' & last ''References:'' entry only
1660 6
1662 ''Message-ID:'' entry only
1663 7
1665 ''Lines:''
1666 (default_filter_select_case)
1668 Default for quick (1 key) auto-selection filter case. ON=filter
1669 case sensitive, OFF=ignore case. Default is OFF.
1670 (default_filter_select_expire)
1672 Default for quick (1 key) auto-selection filter expire. ON = limit
1673 to default_filter_days, OFF = don't ever expire. Default is OFF.
1674 (default_filter_select_global)
1676 Default for quick (1 key) auto-selection filter global. ON=apply
1677 to all groups, OFF=apply to current group. Default is ON.
1678 (default_filter_select_header)
1680 Default for quick (1 key) auto-selection filter header.
1681 0
1683 ''Subject:'' (case sensitive)
1684 1
1686 ''Subject:'' (ignore case)
1687 2
1689 ''From:'' (case sensitive)
1690 3
1692 ''From:'' (ignore case)
1693 4
1695 ''Message-ID:'' & full ''References:'' line
1696 5
1698 ''Message-ID:'' & last ''References:'' entry only
1699 6
1701 ''Message-ID:'' entry only
1702 7
1704 ''Lines:''
1705 (default_goto_group)
1707 (default_group_search)
1709 (default_mail_address)
1711 (default_move_group)
1713 (default_pattern)
1715 (default_pipe_command)
1717 (default_post_newsgroups)
1719 (default_post_subject)
1721 (default_range_group)
1723 (default_range_select)
1725 (default_range_thread)
1727 (default_repost_group)
1729 (default_save_file)
1731 (default_save_mode)
1733 (default_select_pattern)
1735 (default_shell_command)
1737 (default_subject_search)
1739 Draw -> instead of highlighted bar (draw_arrow)
1741 Allows groups/articles to be selected by an arrow '->' if set ON or
1742 by a highlighted bar if set OFF. Default is OFF.
1743 Invocation of your editor (editor_format)
1745 The format string used to create the editor start command with pa‐
1746 rameters. Default is '%E +%N %F' with %E=Editor, %N=Linenumber and
1747 %F=Filename (e.g., /bin/vi +7 .article). See also $VISUAL and $EDI‐
1748 TOR under "ENVIRONMENT".
1749 Detection of external quotes (extquote_handling)
1751 If ON quotes from external sources will be detected. Default is
1752 OFF.
1753 Regex used to show external quotes (extquote_regex)
1755 A regular expression that will be applied when reading articles.
1756 All matching lines are shown in col_extquote. If extquote_regex is
1757 blank, then tin uses a built-in default.
1758 Force redraw after certain commands (force_screen_redraw)
1760 Specifies whether a screen redraw should always be done after cer‐
1761 tain external commands. Default is OFF.
1762 Number of articles to get (getart_limit)
1764 If getart_limit is > 0 not more than the last getart_limit arti‐
1765 cles/group are fetched from the server. If getart_limit is < 0 tin
1766 will start fetching articles from your first unread minus absolute
1767 value of getart_limit. Default is 0, which means no limit.
1768 Catchup group using left key (group_catchup_on_exit)
1770 If ON catchup group when leaving with the left arrow key. Default
1771 is ON.
1772 Format string for the Group level (group_format)
1774 Format string tin uses for Group level representation. See the sec‐
1775 tion "CUSTOMIZING THE SCREEN FORMAT". Default is
1776 "%n %m %R %L %s %F".
1777 Go to the next unread article with (goto_next_unread)
1779 Which keys tin should accept to jump to the next unread article.
1780 Possible is any combination of PageDown and PageNextUnread. When
1781 PageDown is set tin jumps to the next article at the end of the
1782 current one. When PageNextUnread is set tin jumps immediately to
1783 the next article when PageNextUnread ('<TAB>') is pressed. Default
1784 is PageNextUnread.
1785 Display uue data as an attachment (hide_uue)
1787 If set to 'No' then raw uuencoded data is displayed. If set to
1788 'Yes' then sections of uuencoded data will be shown with a single
1789 tag line showing the size and filename (much the same as a MIME at‐
1790 tachment). If set to 'Hide all' then any line that looks like
1791 uuencoded data will be folded into a tag line. This is useful when
1792 uuencoded data is split across more than one article but can also
1793 lead to false positives. This setting can also be toggled in the
1794 article viewer. Default is 'No'.
1795 External inews (inews_prog)
1797 Path, name and options of external inews(1). If you are reading
1798 via NNTP the default value is "--internal" (use built-in NNTP in‐
1799 ews), else it is "inews -h". The article is passed to inews_prog on
1800 STDIN via '< article'.
1801 (info_in_last_line)
1803 If ON, show current group description or article subject in the
1804 last line (not in the pager and global menu) — ToggleInfoLastLine
1805 ('i') toggles setting. This facility is useful as the full width of
1806 the screen is available to display long subjects. Default is OFF.
1807 Use interactive mail reader (interactive_mailer)
1809 Interactive mailreader: if greater than 0 your mailreader will be
1810 invoked earlier for reply so you can use more of its features (e.g.
1811 MIME, pgp, ...). 1 means include headers, 2 means don't include
1812 headers (old use_mailreader_i=ON option). 0 turns off usage. This
1813 option has to suit mailer_format. Default is 0.
1814 Use inverse video for page headers (inverse_okay)
1816 If ON use inverse video for page headers and URL highlighting. De‐
1817 fault is ON.
1818 Keep failed arts in ~/dead.articles (keep_dead_articles)
1820 If ON keep all failed postings in ${TIN_HOMEDIR:-"$HOME"}/dead.ar‐
1821 ticles besides keeping the last failed posting in ${TIN_HOME‐
1822 DIR:-"$HOME"}/dead.article. Default is ON.
1823 Filter which articles (kill_level)
1825 This option controls the processing and display of articles that
1826 are killed. There are 3 options:
1827 0 Kill only unread arts is the 'traditional' behavior of tin.
1829 Only unread articles are killed once only by marking them read.
1830 As filtering only happens on unread articles with kill_level
1831 set to 0, art_marked_killed and art_marked_read_selected are
1832 only shown once. When you reenter the group the mark will be
1833 gone.
1834 1 Kill all arts & show with K will process all articles in the
1836 group and therefore there is a processing overhead when using
1837 this option. Killed articles are threaded as normal but they
1838 will be marked with art_marked_killed.
1839 2 Kill all arts and never show will process all articles in the
1841 group and therefore there is a processing overhead when using
1842 this option. Killed articles simply does not get displayed at
1843 all.
1844 Default is 0 (Kill only unread arts).
1845 Use 8bit characters in mail headers (mail_8bit_header)
1847 Allows 8bit characters unencoded in the header of mail message. De‐
1848 fault is OFF. Turning it ON is effective only if mail_mime_encoding
1849 is also set to 8bit. Leaving it OFF is safe for most users and com‐
1850 pliant to Internet Mail Standard (RFC5322 and RFC2047). Default is
1851 OFF.
1852 Mail address (mail_address)
1854 User's mail address (and full name), if not username@host. This is
1855 used when creating articles, sending mail and when pgp(1) / gpg(1)
1856 signing (RFC4880).
1857 MIME encoding in mail messages (mail_mime_encoding)
1859 MIME encoding of the body in mail message, if necessary (8bit,
1860 base64, quoted-printable, 7bit). Default is quoted-printable.
1861 Quote line when mailing (mail_quote_format)
1863 Format of quote line when replying (via mail) to an article (%A=Ad‐
1864 dress, %D=Date, %F=Fullname+Address, %G=Groupname, %M=Message-ID,
1865 %N=Fullname, %C=Firstname, %I=Initials). Default is "In article %M
1866 you wrote:"
1867 Format of the mailbox (mailbox_format)
1869 Select one of the following mailbox-formats: MBOXO (default, except
1870 on SCO), MBOXRD or MMDF (default on SCO). See mbox(5) and RFC4155
1871 for more details on MBOXO and MBOXRD and mmdf(5) for more details
1872 about MMDF.
1873 Mail directory (maildir)
1875 The directory where articles/threads are to be saved in mbox(5)
1876 format. This feature is mainly for use with the mutt(1) mail pro‐
1877 gram. It allows the user to save articles/threads/groups simply by
1878 giving '=' as the filename to save to. Default is ${TIN_HOME‐
1879 DIR:-"$HOME"}/Mail.
1880 Invocation of your mail command (mailer_format)
1882 The format string used to create the mailer command with parameters
1883 that is used for mailing articles to other people. Default is '%M
1884 "%T" < %F' (e.g., /bin/mail "iain" < .article). The flexible format
1885 allows other mailers with different command line parameters to be
1886 used such as
1887 sendmail -oem -t < %F
1888 mutt -s "%S" -- "%T" < "%F"
1889 claws-mail --compose "mailto:%T?subject=%S&insert=%F"
1890 interactive_mailer must be set adequate. The following substitu‐
1891 tions are supported:
1892 %F filename
1893 %M default_mailer
1894 %S subject-field
1895 %T to-filed
1896 %U username
1897 %% %
1898 'Mark as (un)read' ignores tags (mark_ignore_tags)
1900 When this is ON, the GroupMarkThdRead ('K'), ThreadMarkArtRead
1901 ('K'), MarkThdUnread ('Z') at Group level and MarkArtUnread ('z')
1902 at Thread level functions mark just the current article or thread,
1903 ignoring other tagged, (un)read articles. When OFF, the same func‐
1904 tion presents a menu with choices of the current thread or article,
1905 all tagged, unread articles, or nothing.
1906 Mark saved articles/threads as read (mark_saved_read)
1908 If ON mark articles that are saved as read. Default is ON.
1909 Viewer program for MIME articles (metamail_prog)
1911 Path, name and options of external metamail(1) program used to view
1912 non-textual parts of articles. To use the built-in viewer, set to
1913 --internal. This is the default value when metamail(1) is not in‐
1914 stalled. Leave it blank if you don't want any automatic viewing of
1915 non-textual attachments. The PageViewAttach ('V') command can al‐
1916 ways be used to manually view any attachments. See also
1917 ask_for_metamail.
1918 MM_CHARSET (mm_charset)
1920 Charset supported locally, which is also used for MIME header
1921 (charset parameter and charset name in header encoding) in mail and
1922 news postings. If MIME_STRICT_CHARSET is defined at compile time,
1923 text in charset other than the value of this parameter is consid‐
1924 ered not displayable and represented as '?'. Otherwise, all charac‐
1925 ter sets are regarded as compatible with the display. If it's not
1926 set, the value of the environment variable $MM_CHARSET is used. US-
1927 ASCII or compile-time default is used in case neither of them is
1928 defined. If your system supports iconv(3), this option is disabled
1929 and you should use mm_network_charset instead.
1930 MM_NETWORK_CHARSET (mm_network_charset)
1932 Charset used for posting and MIME headers; replaces mm_charset.
1933 Conversion between mm_network_charset and local charset (determined
1934 via nl_langinfo(3)) is done via iconv(3), if this function is not
1935 available on your system this option is disabled and you have to
1936 use mm_charset instead. mm_network_charset is limited to one of the
1937 following charsets:
1938 US-ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16}, KOI8-{R,U,RU}
1939 EUC-{CN,JP,KR,TW}, ISO-2022-{CN,CN-EXT,JP,JP-1,JP-2}, Big5,
1940 UTF-8
1941 Not all values might work on your system, see iconv_open(3) for
1942 more details. If it's not set, the value of the environment vari‐
1943 able $MM_CHARSET is used. US-ASCII or compile-time default is used
1944 in case neither of them is defined.
1945 Attribute of highlighting with _dash_ (mono_markdash)
1947 Character attribute of words emphasized like _this_. It depends on
1948 your terminal which attributes are usable. See also word_h_dis‐
1949 play_marks and word_highlight.
1950 Attribute of highlighting with /slash/ (mono_markslash)
1952 Character attribute of words emphasized like /this/. It depends on
1953 your terminal which attributes are usable. See also word_h_dis‐
1954 play_marks and word_highlight.
1955 Attribute of highlighting with *stars* (mono_markstar)
1957 Character attribute of words emphasized like *this*. It depends on
1958 your terminal which attributes are usable. See also word_h_dis‐
1959 play_marks and word_highlight.
1960 Attribute of highlighting with -stroke- (mono_markstroke)
1962 Character attribute of words emphasized like -this-. It depends on
1963 your terminal which attributes are usable. See also word_h_dis‐
1964 play_marks and word_highlight.
1965 (newnews)
1967 These are internal timers used by tin to keep track of new news‐
1968 groups. Do not change them unless you understand what they are
1969 for.
1970 Display these header fields (or *) (news_headers_to_display)
1972 Which news headers you wish to see. If you want to see _all_ the
1973 headers, place an '*' as this value. This is the only way a wild‐
1974 card can be used. If you enter 'X-' as the value, you will see all
1975 headers beginning with 'X-' (like X-Alan or X-Pape). You can list
1976 more than one by delimiting with spaces. Not defining anything
1977 turns off this option.
1978 Do not display these header fields (news_headers_to_not_display)
1980 Same as news_headers_to_display except it denotes the opposite. An
1981 example of using both options might be if you thought 'X-' headers
1982 were A Good Thing(tm), but thought Alan and Pape were miscreants...
1983 well then you would do something like this: news_headers_to_dis‐
1984 play=X- news_headers_to_not_display=X-Alan X-Pape Not defining any‐
1985 thing turns off this option.
1986 Quote line when following up (news_quote_format)
1988 Format of quote line when posting/following up an article (%A=Ad‐
1989 dress, %D=Date, %F=Fullname+Address, %G=Groupname, %M=Message-ID,
1990 %N=Fullname, %C=Firstname, %I=Initials). Default is "%F wrote:".
1991 NNTP read timeout in seconds (nntp_read_timeout_secs)
1993 Time in seconds to wait for a response from the server. Default is
1994 120. Setting this to 0 means no timeout.
1995 Unicode normalization form (normalization_form)
1997 The normalization form tin should use to normalize unicode input.
1998 The possible values are:
1999 0 None: no normalization
2001 1 NFKC: Compatibility Decomposition, followed by Canonical Compo‐
2003 sition
2004 2 NFKD: Compatibility Decomposition
2006 3 NFC: Canonical Decomposition, followed by Canonical Composition
2008 4 NFD: Canonical Decomposition
2010 5 NFKC_CF: Compatibility Decomposition, followed by Canonical
2012 Composition and Case Folding
2013 Some normalization modes are only available if they are supported by
2014 the library tin uses to do the normalization. NFC should be used if
2015 possible.
2016 Go to first unread article in group (pos_first_unread)
2018 If ON put cursor at first unread article in group otherwise at last
2019 article. Default is ON.
2020 Use 8bit characters in news headers (post_8bit_header)
2022 Allows 8bit characters unencoded in the header of a news article,
2023 if set this also disables the generation of MIME-headers when they
2024 are usually required. Default is OFF. Only enacted if post_mime_en‐
2025 coding is also set to 8bit. In a number of local hierarchies where
2026 8bit characters are used, using unencoded (raw) 8bit characters in
2027 header is acceptable and sometimes even recommended so that you
2028 need to check the convention adopted in the local hierarchy of your
2029 interest to determine what to do with this and post_mime_encoding.
2030 MIME encoding in news messages (post_mime_encoding)
2032 MIME encoding of the body in news message, if necessary. (8bit,
2033 base64, quoted-printable, 7bit). Default is 8bit, which leads to no
2034 encoding. base64 and quoted-printable are usually undesired on
2035 usenet.
2036 View post-processed files (post_process_view)
2038 If ON, then tin will start an appropriate viewer program to display
2039 any files that were post processed and uudecoded. The program is
2040 determined using the mailcap(5) file. Default is ON.
2041 Post process saved articles (post_process_type)
2043 This specifies whether to perform post processing on saved arti‐
2044 cles. Because the shell archive may contain commands you may not
2045 want to be executed, be careful when extracting shell archives.
2046 The following values are allowed:
2047 0 No (default), no post processing is done.
2049 1 Shell archives, unpacking of multi-part shar(1) files only.
2051 2 Yes, binary attachments and data will be decoded and saved.
2053 Filename to be used for storing posted articles (posted_articles_file)
2055 Keep posted articles in given file. If the given filename does not
2056 contain any expandable strings it will be prefixed with ${TIN_HOME‐
2057 DIR:-"$HOME"}/Mail/. If no filename is set then postings will not
2058 be saved. See the section "MAILING PIPING PRINTING REPOSTING AND
2059 SAVING ARTICLES" for more information about the various expansion
2060 characters. Default is 'posted'.
2061 Print all headers when printing (print_header)
2063 If ON, then the full article header is sent to the printer. Other‐
2064 wise only the ''Subject:'' and ''From:'' fields are output. Default
2065 is OFF.
2066 Printer program with options (printer)
2068 The printer program with options that is to be used to print arti‐
2069 cles. The default is lpr(1) for BSD machines and lp(1) for SysV
2070 machines. Printing from tin may have been disabled by the System
2071 Administrator.
2072 Process only unread articles (process_only_unread)
2074 If ON only save/print/pipe/mail unread articles (tagged articles
2075 excepted). Default is OFF.
2076 Show empty Followup-To in editor (prompt_followupto)
2078 If ON show empty ''Followup-To:'' header when editing an article.
2079 Default is OFF.
2080 Characters used as quote-marks (quote_chars)
2082 The character used in quoting included text to article followups
2083 and mail replies. The '_' character represents a blank character
2084 and is replaced with ' ' when read, %I is replaced by author's ini‐
2085 tials. Default is '>_'.
2086 Quoting behavior (quote_style)
2088 How articles should be quoted when following up or replying to
2089 them. There are a number of things that can be done: empty lines
2090 can be quoted, signatures can be quoted and quote_chars can be com‐
2091 pressed when quoting multiple times (for example, '> > >' will be
2092 turned into '>>>'). The default is to compress quotes, and to quote
2093 empty lines.
2094 When you are viewing an article in raw mode ('^H'), and follow up
2095 or reply to it, the signature will be quoted even if it would oth‐
2096 erwise not be. If show_signatures is off, then the signature will
2097 never be quoted.
2098 Regex used to show quoted lines (quote_regex)
2100 A regular expression that will be applied when reading articles.
2101 All matching lines are shown in col_quote. If quote_regex is blank,
2102 then tin uses a built-in default.
2103 Regex used to show twice quoted l. (quote_regex2)
2105 A regular expression that will be applied when reading articles.
2106 All matching lines are shown in col_quote2. If quote_regex2 is
2107 blank, then tin uses a built-in default.
2108 Regex used to show >= 3 times q.l. (quote_regex3)
2110 A regular expression that will be applied when reading articles.
2111 All matching lines are shown in col_quote3. If quote_regex3 is
2112 blank, then tin uses a built-in default.
2113 Article recentness time limit (recent_time)
2115 If set to 0, this feature is deactivated, otherwise it means the
2116 number of days. Default is 2.
2117 Render BiDi (render_bidi)
2119 If ON tin does the rendering of bi-directional text. If OFF tin
2120 leaves the rendering of bi-directional text to the terminal. De‐
2121 fault is OFF.
2122 Interval in seconds to reread active (reread_active_file_secs)
2124 The news ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active} file
2125 is reread at regular intervals to show if any new news has arrived.
2126 Default is 1200. Setting this to 0 will disable this feature.
2127 Directory to save arts/threads in (savedir)
2129 Directory where articles/threads are saved. Default is ${TIN_HOME‐
2130 DIR:-"$HOME"}/News.
2131 Score limit (kill) (score_limit_kill)
2133 If the score of an article is below or equal this value the article
2134 gets marked as killed.
2135 Score limit (select) (score_limit_select)
2137 If the score of an article is above or equal this value the article
2138 gets marked as hot.
2139 Default score to kill articles (score_kill)
2141 Score of an article which should be killed, this must be <=
2142 score_limit_kill.
2143 Default score to select articles (score_select)
2145 Score of an article which should be marked hot, this must be >=
2146 score_limit_select.
2147 Number of lines to scroll in pager (scroll_lines)
2149 The number of lines that will be scrolled up/down in the article
2150 pager when using cursor-up/down. The default is 1 (line-by-line).
2151 Set to 0 to get traditional tin page-by-page scrolling. Set to -1
2152 to get page-by-page scrolling where the top/bottom line is carried
2153 over onto the next page. This setting supersedes
2154 show_last_line_prev_page=ON. Set to -2 to get half-page scrolling.
2155 This setting supersedes full_page_scroll=OFF.
2156 Format string for the Selection level (select_format)
2158 Format string tin uses for Selection level representation. See the
2159 section "CUSTOMIZING THE SCREEN FORMAT". Default is
2160 "%f %n %U %G %d".
2161 In group and thread level, show author by (show_author)
2163 Which information about the author should be shown. Default is 2,
2164 authors full name.
2165 0 None, only the ''Subject:'' line will be displayed.
2167 1 Address, ''Subject:'' line & the address part of the ''From:''
2169 line are displayed.
2170 2 Full Name, ''Subject:'' line & the authors full name part of
2172 the ''From:'' line are displayed (default).
2173 3 Address and Name, ''Subject:'' line & all of the ''From:'' line
2175 are displayed.
2176 Show description of each newsgroup (show_description)
2178 If ON show a short group description text after newsgroup name at
2179 the group selection level. The ''-d'' command-line flag will over‐
2180 ride the setting and turn descriptions off. The text used is taken
2181 from the ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups file and if supported
2182 (requires tin to be build with mh-mail-handling support) from
2183 ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups for mailgroups. Default is
2184 ON.
2185 Function for sorting articles (sort_function)
2187 Function used for sorting articles. Default is 0.
2188 0 Use qsort(3) for sorting.
2190 1 Use heapsort(3) for sorting. This might be faster in large
2192 groups with long threads (somewhat presorted data).
2193 Show lines/score in listings (show_info)
2195 Which information about the thread or article should be shown. De‐
2196 fault is 1, show only the line count.
2197 0 None, no information will be displayed.
2199 1 Lines, in article listing the line count of an article will be
2201 displayed and in thread listing the line count of first (un‐
2202 read) article will be displayed.
2203 2 Score, in article listing the score of an article will be dis‐
2205 played and in thread listing the score of the thread will be
2206 displayed — see also thread_score.
2207 3 Lines & Score, display line count and score.
2209 Show only unread articles (show_only_unread_arts)
2211 If ON show only new/unread articles otherwise show all articles.
2212 Default is ON.
2213 Show only groups with unread arts (show_only_unread_groups)
2215 If ON show only subscribed groups that contain unread articles. De‐
2216 fault is OFF.
2217 Display signatures (show_signatures)
2219 If OFF don't show signatures when displaying articles. Default is
2220 ON.
2221 Prepend signature with '\n-- \n' (sigdashes)
2223 If ON prepend the signature with sigdashes. Default is ON.
2224 Create signature from path/command (sigfile)
2226 The path that specifies the signature file to use when posting,
2227 following up to or replying to an article. If the path is a direc‐
2228 tory then the signature will be randomly generated from files that
2229 are in the specified directory. If the path starts with a ! the
2230 program the path points to will be executed to generate a signa‐
2231 ture. In order to pass the group name to the program, %G can be
2232 specified. This will be replaced by the name of the current news‐
2233 group. --none will suppress any signature. Default is ${TIN_HOME‐
2234 DIR:-"$HOME"}/.Sig.
2235 Add signature when reposting (signature_repost)
2237 If ON add signature to reposted articles. Default is ON.
2238 Regex used to highlight /slashes/ (slashes_regex)
2240 A regular expression that will be applied when reading articles.
2241 All matching words are shown in col_markslash or mono_markslash. If
2242 slashes_regex is blank, then tin uses a built-in default.
2243 Sort articles by (sort_article_type)
2245 This specifies how articles should be sorted. Sort by ascending
2246 Date (6) is the default. The following sort types are allowed:
2247 0 Nothing, don't sort articles.
2249 1 Subject: (descending), sort articles by ''Subject:'' field de‐
2251 scending.
2252 2 Subject: (ascending), sort articles by ''Subject:'' field as‐
2254 cending.
2255 3 From: (descending), sort articles by ''From:'' field descend‐
2257 ing.
2258 4 From: (ascending), sort articles by ''From:'' field ascending.
2260 5 Date: (descending), sort articles by ''Date:'' field descend‐
2262 ing.
2263 6 Date: (ascending), sort articles by ''Date:'' field ascending
2265 (default).
2266 7 Score (descending), sort articles by filtering score descend‐
2268 ing.
2269 8 Score (ascending), sort articles by filtering score ascending.
2271 9 Lines: (descending), sort articles by ''Lines:'' field descend‐
2273 ing.
2274 10 Lines: (ascending), sort articles by ''Lines:'' field ascend‐
2276 ing.
2277 Sort threads by (sort_threads_type)
2279 This specifies how threads will be sorted. Sort by descending Score
2280 (1) is the default. The following sort types are allowed:
2281 0 Nothing, don't sort threads.
2283 1 Score (descending), sort threads by filtering score descending
2285 (default).
2286 2 Score (ascending), sort threads by filtering score ascending.
2288 3 Last posting date (descending), sort threads by date of last
2290 posting descending.
2291 4 Last posting date (ascending), sort threads by date of last
2293 posting ascending.
2294 Spamtrap warning address parts (spamtrap_warning_addresses)
2296 Set this option to a list of comma-separated strings to be warned
2297 if you are replying to an article by mail where the e-mail address
2298 contains one of these strings. The matching is case-insensitive.
2299 Example:
2300 spam,delete,remove
2302 Regex used to highlight *stars* (stars_regex)
2304 A regular expression that will be applied when reading articles.
2305 All matching words are shown in col_markstar or mono_markstar. If
2306 stars_regex is blank, then tin uses a built-in default.
2307 Strip blanks of end of lines (strip_blanks)
2309 Strips the blanks from the end of each line therefore speeding up
2310 the display when reading on a slow terminal or via modem. Default
2311 is ON.
2312 Remove bogus groups from newsrc (strip_bogus)
2314 Bogus groups are groups that are present in your ${TIN_HOME‐
2315 DIR:-"$HOME"}/.newsrc file that no longer exist on the news server.
2316 There are 3 options. 0 means do nothing & always keep bogus groups.
2317 1 means bogus groups will be permanently removed. 2 means that bo‐
2318 gus groups will appear on the Group Selection Menu, prefixed with a
2319 'D'. This allows you to unsubscribe from them as and when you wish.
2320 Default is 0 (Always Keep).
2321 No unsubscribed groups in newsrc (strip_newsrc)
2323 If ON, then unsubscribed groups will be permanently removed from
2324 your ${TIN_HOMEDIR:-"$HOME"}/.newsrc file. Default is OFF.
2325 Regex with Subject prefixes (strip_re_regex)
2327 A regular expression to find Subject prefixes like "Re:" to remove.
2328 If strip_re_regex is blank, then tin(1) uses a built-in default.
2329 Regex with Subject suffixes (strip_was_regex)
2331 A regular expression to find Subject suffixes like "(was:" to re‐
2332 move. If strip_was_regex is blank, then tin(1) uses a built-in de‐
2333 fault.
2334 Regex used to highlight -strokes- (strokes_regex)
2336 A regular expression that will be applied when reading articles.
2337 All matching words are shown in col_markstroke or mono_markstroke.
2338 If strokes_regex is blank, then tin uses a built-in default.
2339 Wrap around threads on next unread (wrap_on_next_unread)
2341 If enabled a search for the next unread article will wrap around
2342 all articles to find also previous unread articles. If disabled the
2343 search stops at the end of the thread list. Default is ON.
2344 Display "a as Umlaut-a (tex2iso_conv)
2346 If ON, show "a as Umlaut-a, etc. Default is OFF. This behavior can
2347 also be toggled in the article viewer via PageToggleTex2iso ('"').
2348 Thread articles by (thread_articles)
2350 Defines which threading method to use. It's possible to set the
2351 threading type on a per group basis by setting the group attribute
2352 variable thread_arts to 0 – 4 in the file ${TIN_HOME‐
2353 DIR:-"$HOME"}/.tin/attributes. (See also "GROUP ATTRIBUTES".) The
2354 default is Both Subject and References. The choices are:
2355 0 None, don't thread.
2357 1 Subject, thread on ''Subject:'' only.
2359 2 References, thread on ''References:'' only.
2361 3 Both Subject and References, thread on ''References:'' then
2363 ''Subject:'' (default).
2364 4 Multipart Subject, thread multipart articles on ''Subject:''.
2366 5 Percentage Match, thread base upon a partial character match on
2368 ''Subject:''.
2369 Catchup thread by using left key (thread_catchup_on_exit)
2371 If ON catchup group/thread when leaving with the left arrow key.
2372 Default is ON.
2373 Format string for the Thread level (thread_format)
2375 Format string tin uses for Thread level representation. See the
2376 section "CUSTOMIZING THE SCREEN FORMAT". Default is
2377 "%n %m [%L] %T %F".
2378 Matchingness of a thread (thread_perc)
2380 How closely the subjects must match for two threads to be consid‐
2381 ered part of the same thread. This is a percentage and the default
2382 if 75%.
2383 Score of a thread (thread_score)
2385 How the total score of a thread is computed. Default is 0, the max‐
2386 imum score in this thread.
2387 0 Max, the maximum score in this thread.
2389 1 Sum, the sum of all scores in this thread.
2391 2 Average, the average score in this thread.
2393 Transliteration (translit)
2395 If ON append //TRANSLIT to the first argument of iconv_open(3) to
2396 enable transliteration. This means that when a character cannot be
2397 represented in the target character set, it can be approximated
2398 through one or several similarly looking characters. On systems
2399 where this extension doesn't exist, this option is disabled. De‐
2400 fault is OFF.
2401 How to treat blank lines (trim_article_body)
2403 Allows you to select how tin treats blank lines in article bodies.
2404 Default is 0. This option does not affect lines within verbatim
2405 blocks.
2406 0 Don't trim article body, do nothing.
2408 1 Skip leading blank lines.
2410 2 Skip trailing blank lines.
2412 3 Skip leading and trailing blank l., skip leading and trailing
2414 blank lines.
2415 4 Compact multiple between text, replace multiple blank lines be‐
2417 tween text blocks with one blank line.
2418 5 Compact multiple and skip leading, 4 + 1
2420 6 Compact multiple and skip trailing, 4 + 2
2422 7 Compact mltpl., skip lead. & trai., 4 + 3
2424 Regex used to highlight _underline_ (underscores_regex)
2426 A regular expression that will be applied when reading articles.
2427 All matching words are shown in col_markdash or mono_markdash. If
2428 underscores_regex is blank, then tin uses a built-in default.
2429 Remove ~/.article after posting (unlink_article)
2431 If ON remove ~/.article after posting. Default is ON.
2432 Program that opens URLs (url_handler)
2434 The program that will be run when launching URLs in the article
2435 viewer using PageViewUrl ('U'). The actual URL will be appended.
2436 Default is url_handler.pl.
2437 URL highlighting in message body (url_highlight)
2439 Enable highlighting URLs in message body. Default is ON.
2440 Use ANSI color (use_color)
2442 If enabled tin uses ANSI-colors. Default is OFF.
2443 Use scroll keys on keypad (use_keypad)
2445 Default is OFF.
2446 Use mouse in xterm (use_mouse)
2448 Allows the mouse button support in an xterm(1x) to be enabled/dis‐
2449 abled. Default is OFF.
2450 Use slrnface to show ''X-Face:''s (use_slrnface)
2452 If enabled tin uses slrnface(1) to interpret the ''X-Face:''
2453 header. For this option to have any effect, tin must be running in
2454 an xterm(1x) and slrnface(1) must be in your $PATH. Default is OFF.
2455 Use UTF-8 graphics (utf8_graphics)
2457 If ON use UTF-8 characters for indicator ('->'), thread/attachment
2458 tree and ellipsis ('...'). Default is OFF.
2459 Regex for begin of a verbatim block (verbatim_begin_regex)
2461 A regular expression that tin will use to find the begin of a ver‐
2462 batim block.
2463 Regex for end of a verbatim block (verbatim_end_regex)
2465 A regular expression that tin will use to find the end of a verba‐
2466 tim block.
2467 Detection of verbatim blocks (verbatim_handling)
2469 If ON verbatim blocks will be detected. Default is ON.
2470 Wildcard matching (wildcard)
2472 Allows you to select how tin matches strings. The default is 0 and
2473 uses the wildmat(3) notation, which is how this has traditionally
2474 been handled. Setting this to 1 allows you to use perl(1) compati‐
2475 ble regular expressions pcre(3) (see also perlre(1) and
2476 pcrepattern(3)). You will probably want to update your filter file
2477 if you use this regularly. NB: Newsgroup names will always be
2478 matched using the wildmat(3) notation.
2479 What to display instead of mark (word_h_display_marks)
2481 Should the leading and ending stars, slashes, strokes and dashes
2482 also be displayed, even when they are highlighting marks?
2483 0 no
2485 1 yes, display mark
2487 2 print a space instead
2489 Word highlighting in message body (word_highlight)
2491 Enable word highlighting. See word_h_display_marks for the options
2492 available. If use_color is enabled the colors specified in
2493 col_markdash, col_markslash, col_markstar and col_markstroke are
2494 used for word highlighting else the character attributes specified
2495 in mono_markdash, mono_markslash, mono_markstar and mono_markstroke
2496 are used. Default is ON.
2497 Page line wrap column (wrap_column)
2499 Sets the column at which a displayed article body should be
2500 wrapped. If this value is equal to 0, it defaults to the current
2501 screen width. If this value is greater than your current screen
2502 width the part off-screen is not displayed. Thus setting this op‐
2503 tion to a large value can be used to disable wrapping. If this
2504 value is negative the wrap margin is the current screen width plus
2505 the given value (as long as the result is still positive, otherwise
2506 it will fall back to the current screen width). Default is 0, wrap‐
2507 ping at the current screen width.
2508 Quote line when crossposting (xpost_quote_format)
2510 Format is the same as for news_quote_format, this is used when an‐
2511 swering to a crossposting to several groups with no ''Fol‐
2512 lowup-To:'' set.
2513 ATTRIBUTES MENU AND GROUP ATTRIBUTES
2515 tin allows certain attributes to be set on a per group basis. If it ex‐
2516 ists, the global attributes file, ${TIN_LIBDIR:-NEWSLIBDIR}/attributes
2517 is read. After that, the user's own attributes file ${TIN_HOME‐
2518 DIR:-"$HOME"}/.tin/attributes is read. The global attributes file is
2519 useful for distributing system-wide defaults to new users who have no
2520 private attributes file yet.
2521 Note that the scope=<grouplist> line has to be specified before the at‐
2523 tributes are specified for that list. All attributes are set to a rea‐
2524 sonable default so you only have to specify the attribute that you want
2525 to change (e.g., savedir). All toggle attributes are set by specifying
2526 ON/OFF. Otherwise, these function exactly the same as their global
2527 equivalents. For more details see tin(5).
2528 Attributes can also be changed from the attributes menu which can be
2530 accessed by ConfigToggleAttrib ('<TAB>') from the options menu or
2531 ScopeSelect ('^J' or '<CR>') from the scopes menu. The attributes menu
2532 looks and behaves very similar to the options menu. The title shows the
2533 current scope. Attributes set in the current scope are marked with '+'
2534 to the left of the attributes number.
2535 Besides the keys for moving around and changing values known from the
2537 options menu the attributes menu provides the following command: Confi‐
2538 gResetAttrib ('r') which resets an attribute to a default value.
2539 SCOPES MENU
2541 The scopes menu (accessible from the options menu with ConfigScopeMenu
2542 ('S')) shows all scopes read from the global and local attributes file.
2543 Scopes from the global attributes file are marked with '!' to the left
2544 of the scope number. Delete/rename/move are not possible with those
2545 scopes.
2546 In addition to the common moving keys the following commands are avail‐
2548 able: ScopeSelect ('^J' or '<CR>') enter the attributes menu for the
2549 current scope, ScopeEditAttributesFile ('E') edit the local attributes
2550 file, ScopeAdd ('a') add a new scope, ScopeDelete ('d') delete the cur‐
2551 rent scope, ScopeMove ('m') move the current scope to a new position,
2552 ScopeRename ('r') rename the current scope. ToggleHelpDisplay ('H')
2553 toggles the help mini menu at the bottom of the screen and posting eti‐
2554 quette after composing an article (beginner_level).
2555 FILTERING ARTICLES
2557 When there is a subject or an author which you are either very inter‐
2558 ested in, or find completely uninteresting, you can easily instruct tin
2559 to auto-select or auto-kill articles that match rules that you specify.
2560 This can be anything from the name of the author to the number of lines
2561 in an article.
2562 When tin starts up the user's kill-file ${TIN_HOME‐
2564 DIR:-"$HOME"}/.tin/filter (see also tin(5)) is read. Each time a news‐
2565 group is entered the rules are applied and articles killed or selected
2566 when they meet certain criteria.
2567 The degree to which rules are applied depend on the kill_level tinrc
2569 setting. By default killed articles will only be marked read. Adjust
2570 kill_level for more aggressive processing. Articles that match an auto-
2571 selection rule are marked with a ''*''.
2572 Filtering rules can be manually entered into ${TIN_HOME‐
2574 DIR:-"$HOME"}/.tin/filter (but don't do this whilst running tin else
2575 you will lose your changes) or by using an on-screen menu within tin.
2576 The filtering capabilities of tin have been significantly enhanced over
2578 previous versions to include scoring and better pattern matching. It is
2579 recommended that you read the file filtering in the tin documentation
2580 directory. This file can also be read online at
2581 <http://www.tin.org/filtering.txt>.
2582 The on-screen filtering menu is accessed by pressing MenuFilterKill
2584 ('^K') or MenuFilterSelect ('^A') at the Group and Article levels. It
2585 allows the user to kill or select an article that matches the current
2586 ''Subject:'' line, ''From:'' line or a string entered by the user. The
2587 user entered string can be applied to the ''Subject:'' or ''From:''
2588 line of an article. The filter can be limited to the current newsgroup
2589 or it can apply to all newsgroups. Once entered the user can abort the
2590 command and not save the new filter, edit the full filter file or save
2591 filter.
2592 POSTING ARTICLES
2594 tin allows posting of articles, follow-up to already posted articles
2595 and replying direct through mail to the author of an article.
2596 Use the Post ('w') command to post an article to a newsgroup. After
2598 entering the post subject the default editor (i.e., vi(1)) or the edi‐
2599 tor specified by the $VISUAL or $EDITOR environment variable will be
2600 started and the article can be entered. To crosspost articles simply
2601 add a comma and the name of the newsgroup(s) to the end of the ''News‐
2602 groups:'' line at the beginning of the article. After saving and exit‐
2603 ing the editor you are asked if you wish to a)bort posting the article,
2604 e)dit the article again or p)ost the article to the specified news‐
2605 group(s).
2606 Use the DisplayPostHist ('W') command to display a history of the arti‐
2608 cles you have posted. The date the article was posted, which newsgroups
2609 the article was posted to and the articles subject line are displayed.
2610 See the section "POSTING HISTORY LISTING" for more information.
2611 Use the PageFollowupQuote ('f'), PageFollowup ('F') or PageFol‐
2613 lowupQuoteHeaders ('^W') command to post a follow-up article to an al‐
2614 ready posted article. The PageFollowupQuote command will copy the text
2615 of the original article into the editor. The PageFollowupQuoteHeaders
2616 command will copy the text and all headers of the original article into
2617 the editor. The editing procedure is the same as when posting an arti‐
2618 cle with the Post ('w') command.
2619 Use the PageReplyQuote ('r'), PageReply ('R') or PageReplyQuoteHeaders
2621 ('^E') command to reply direct through mail to the author of an already
2622 posted article. The PageReplyQuote command will copy the text of the
2623 original article into the editor. The PageReplyQuoteHeaders command
2624 will copy the text and all headers of the original article into the ed‐
2625 itor. The editing procedure is the same as when posting an article with
2626 the Post ('w') command. After saving and exiting the editor you are
2627 asked if you wish to abort sending the article via PostAbort ('a'),
2628 edit the article again via PostEdit ('e') or send the article to the
2629 author via PostSend ('s').
2630 CUSTOMIZING THE ARTICLE QUOTE STRING
2632 When posting a followup to an article or replying direct to the author
2633 of an article via email the text of the article can be quoted. The be‐
2634 ginning of the quoted text can contain information about the quoted ar‐
2635 ticle (e.g., Name and the Message-ID of the article). To allow for dif‐
2636 ferent situations certain information from the article can be used in
2637 the quoted string. The following variables are expanded if found in the
2638 tinrc variables mail_quote_format, news_quote_format or
2639 xpost_quote_format:
2640 %A Address (Email)
2641 %D Date (uses date_format)
2642 %F Full address (%N <%A>)
2643 %G Groupname
2644 %M Message-ID
2645 %N Fullname of author
2646 %C Firstname of author
2647 %I Initials of author
2648 e.g.,
2649 mail_quote_format=On %D in %G you wrote:
2650 news_quote_format=In %M, %F wrote:
2651 would expand to:
2652 On 21 Sep 1993 09:45:51 -0400 in alt.sources you wrote:
2653 In <abcINN123@example.org>, Joe Bar <joe@example.org> wrote:
2654 The quoted text section of an article is marked by a preceding quote
2655 string at the beginning of each quoted line. The default quote string
2656 is set to '>_'. The default can be changed by setting the tinrc vari‐
2657 able quote_chars to ones own preference. (Note that '_' underline is
2658 used to represent a space).
2659 MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES
2661 The command interface to GroupMail, PageMail, PostMail or ThreadMail
2662 ('m'), Pipe ('|'), Print ('o'), PageRepost or GroupRepost ('x') and
2663 GroupSave, PageSave or ThreadSave ('s' and GroupAutoSave, PageAutoSave
2664 or ThreadAutoSave 'S') articles is the same for ease of use.
2665 Auto-saving with *AutoSave ('S') is a special case and operates only on
2667 marked articles. They will processed without any further prompting ac‐
2668 cording to the default save parameters defined in tinrc or by any at‐
2669 tributes set for the current group.
2670 Otherwise, the initial prompt will ask you to select which article,
2672 thread, hot (auto-selected), regular expression pattern, tagged arti‐
2673 cles you wish to mail, pipe etc.
2674 Tagged articles must have already been tagged with a *Tag ('t') com‐
2676 mand. All tagged articles can be untagged by a *Untag ('U') untag com‐
2677 mand.
2678 If a regular expression pattern is selected you are asked to enter a
2680 pattern (e.g., to match all articles subject lines containing 'net
2681 News' you enter "net News"). Any articles that match the entered ex‐
2682 pression will be mailed, piped etc. See also the wildcard tinrc vari‐
2683 able for advanced pattern matching options.
2684 Various expansion characters are recognized when entering the directory
2686 and file to save to. Environment variables (prefixed with '$') and user
2687 home directories (prefixed by '~' or '~username') can be specified.
2688 Environment variables can themselves contain other special characters.
2689 To save articles to a mailbox enter '=<mailbox name>' when asked for
2691 the save filename. If you enter just '=' then articles will be saved to
2692 a mailbox with the name of the current newsgroup (eg, alt.sources).
2693 See maildir.
2694 To save in savedir/<news.group.name>/<filename> format enter '+<file‐
2696 name>'. See savedir. Like '+' %G is expanded to the current
2697 news.group.name but without savedir prefixed. %P is expanded to the
2698 news.group.name with all '.' replaced by '/'.
2699 If saving multiple files at once the filename (if not referring to a
2701 mailbox) will be extended by ".num" where "num" is at least 3 digit
2702 number counting up from 1. Environment variables are allowed within a
2703 filename (e.g., $SOURCES/dir/filename).
2704 When saving articles you can specify whether the saved files should be
2706 post processed. A default process type can be set via
2707 post_process_type.
2708 AUTOMATIC MAILING AND SAVING NEW NEWS
2710 tin allows new/unread news articles to be mailed (''-M'' and ''-N'' op‐
2711 tion) or saved (''-S'' option) in batch mode for later reading. Useful
2712 when going on holiday and you don't want to return and find that expire
2713 has removed a whole load of unread articles. Best to run via cron(8)
2714 everyday while away, after which you will be mailed a report of which
2715 articles were mailed/saved from which newsgroups and the total number
2716 of articles mailed/saved. Articles are saved in a private news struc‐
2717 ture under your savedir directory (default is ${TIN_HOME‐
2718 DIR:-"$HOME"}/News). Be careful of using this option if you read a lot
2719 of groups because you could overflow your file system.
2720 When using ''-S'' together with a given directory to save to (''-s''
2722 option), the same directory must be specified when reading the articles
2723 by ''-R''.
2724 If you only want to save some of your groups use the batch_save tinrc
2726 variable. Set to ON or OFF in tinrc to enable/disable saving of all
2727 groups and then use the batch_save attribute to fine tune which groups
2728 you want to have saved. For example, if you want to save most of your
2729 groups, then set batch_save to ON in tinrc and selectively turn off the
2730 ones you don't want using attributes.
2731 tin -M iain -c -f newsrc.mail
2733 (mail any unread articles in newsgroups specified
2734 in file newsrc.mail to the local user iain and mark
2735 them as read)
2736 tin -S -c -f newsrc.save
2738 (save any unread articles in newsgroups specified
2739 in file newsrc.save and mark them as read)
2740 tin -R (read any articles saved by tin -S)
2742 RANGES
2744 A range is simply a group of items marked using the SetRange ('#') key.
2745 Certain tin commands will operate on a range if one exists rather than
2746 just the current item. A range is an expression of the form
2747 <min>–<max>, e.g. 10–15 will highlight items 10 through 15 on the cur‐
2748 rent screen. Other than absolute numeric positions, '.' can be used in
2749 place of the current cursor position and '$' can be used to mean the
2750 highest number available. Currently the only commands that understand
2751 ranges are GroupMarkThdRead ('K'), MarkArtUnread ('z') and MarkThdUn‐
2752 read ('Z').
2753 NEWSGROUP LISTS & WILDCARDS
2755 Several places in tin allow you to specify a list of newsgroups. These
2756 include command-line groups, (un)subscribe groups, the AUTO[UN]SUB‐
2757 SCRIBE mechanism. The scope= attributes file tag and the filter file
2758 group= tag also use the same syntax. tin interprets this variable simi‐
2759 larly to rn(1). It contains a list of patterns, separated by commas
2760 and possibly prefixed with exclamation points. An exclamation point
2761 negates the meaning of a match on this pattern, and can be used to can‐
2762 cel certain matches. See wildmat(3) for details about the understood
2763 patterns. Some examples:
2764 alt.config,news.*,!news.test
2766 Matches alt.config and everything in the 'news' hierarchy except
2768 news.test
2769 See the explanation for the $AUTOSUBSCRIBE and $AUTOUNSUBSCRIBE vari‐
2771 ables for further examples.
2772 SIGNATURES
2774 tin will recognize a signature in either ${TIN_HOMEDIR:-"$HOME"}/.sig‐
2775 nature or ${TIN_HOMEDIR:-"$HOME"}/.Sig. If ${TIN_HOME‐
2776 DIR:-"$HOME"}/.signature exists, then the signature will be pulled into
2777 the editor for mail commands only. A signature in ${TIN_HOME‐
2778 DIR:-"$HOME"}/.signature will not be pulled into the editor for posting
2779 commands since inews(1) will append the signature itself.
2780 A signature in ${TIN_HOMEDIR:-"$HOME"}/.Sig will be pulled into the ed‐
2782 itor for both posting and mailing commands.
2783 The following is an example of a .Sig file:
2785 NAMES Joe Bar <joe@example.org>
2786 SNAIL Musterweg 12, 99999 Notreal, Germany
2787 tin also has the capability to generate random signatures on a per
2789 newsgroup basis if so desired. The way to accomplish this is to specify
2790 the default signature or the group attribute sigfile as a directory. If
2791 for example the sigfile path is /usr/iain/.sigs and .sigs is a direc‐
2792 tory then tin will select a random signature from any file that is in
2793 the directory .sigs (note: one signature per numbered file). A random
2794 signature can also consist of a fixed part signature that can contain
2795 your name, address etc. followed by the random sig. The fixed part of
2796 the random sig is read from the file $HOME/.sigfixed.
2797 CUSTOMIZING THE SCREEN FORMAT
2799 The look of the Selection, Group and Thread level can be customized via
2800 format strings. These format strings define the content and the posi‐
2801 tion of each element on the screen. Variables are used within the for‐
2802 mat strings as placeholders. The following variables are available:
2803 %D date
2805 %F from, name and/or address
2806 %G newsgroup name
2807 %I initials
2808 %L line count
2809 %M message-id
2810 %R number of responses in thread
2811 %S score
2812 %T thread tree
2813 %U unread count
2814 %d newsgroup description
2815 %f newsgroup flag
2816 %m article marks
2817 %n current group/thread/article number
2818 %s subject
2819 %% %
2820 Not all variables can be used in each level. The following table pro‐
2822 vides an overview:
2823 select_format group_format thread_format
2825 %D X X
2826 %F X X
2827 %G X
2828 %I X X
2829 %L X X
2830 %M X X
2831 %R X
2832 %S X X
2833 %T X
2834 %U X
2835 %d X
2836 %f X
2837 %m X X
2838 %n X X X
2839 %s X
2840 %% X X X
2841 Defaults for the format strings:
2843 select_format: "%f %n %U %G %d"
2845 group_format: "%n %m %R %L %s %F"
2846 thread_format: "%n %m [%L] %T %F"
2847 show_description controls whether the newsgroup description is shown or
2849 not. The description can also be toggled with SelectToggleDescriptions
2850 ('d').
2851 The information displayed with '%F' depends on the value of show_au‐
2853 thor. GroupToggleSubjDisplay resp. ThreadToggleSubjDisplay ('d')
2854 switches through all available options.
2855 For date representation '%D' uses date_format. It is possible to spec‐
2857 ify a different date format in round brackets (e.g. '%(%d %b %y
2858 %H:%M)D'). See date_format for more details.
2859 The length of each item (except '%%') can be defined with a positive
2861 number after the '%'. The following example displays the score in the
2862 thread level 10 characters wide: '%10S'.
2863 If the newsgroup name is displayed together with the newsgroup descrip‐
2865 tion, the width of the newsgroup name can be controlled via an optional
2866 comma separated second value (e.g. '%60,20G'). It is valid to omit the
2867 first value (e.g. ('%,20G')). If no second value is given, tin uses a
2868 default value of 32.
2869 Some variables do have a default width which may lead to truncation.
2871 Truncation for variables which contain only numbers happens by dividing
2872 the value with a sufficient power of ten and adding a SI suffix to the
2873 result, that is the variable holds a value of 54321 and the width for
2874 the variable is 4 the result will be "54 k". If that's undesired you
2875 have to specify a larger width manually, e.g. '%6n'. Here is an over‐
2876 view of the defaults:
2877 Variable width
2879 %I 3
2880 %L 4
2881 %M 10
2882 %R 3
2883 %S 6
2884 %U 5
2885 %n 4
2886 If no length is given for '%D', the length is determined by the format
2888 string for the date and the date of the current day. If the date format
2889 string contains weekdays or months names it may happen that the date is
2890 longer than determined in the first pass. In this case, the date is
2891 truncated before display. This occurs, for example, if the current
2892 month is May and the article to which the date is displayed was posted
2893 in December. In such cases it might useful to determine the maximum
2894 length manually and specify the length in the format string.
2895 In case the format string contains '%G' and '%d' and no length are
2897 given, tin determines the longest newsgroup name and uses this length
2898 for '%G'. The remaining space will used for '%d'.
2899 When the format string contains the specifier '%F' and '%s' resp. '%T'
2901 and no length are given, '%F' will use one third and '%s' resp. '%T'
2902 will use two third of the available space.
2903 In addition, a minimum screen width can be defined for each item (ex‐
2905 cept '%%'). In this case, the item will only be displayed when the
2906 screen is wider than specified. This comes in handy to not overload a
2907 small screen but have maximum information on a large screen. The mini‐
2908 mum screen width has to be specified by a positive number preceded by
2909 an '>'. In the following example tin will display the score only if the
2910 screen is wider than 100 characters: '%>100S'.
2911 If both the length and the minimum screen width should be specified for
2913 an item, the length must be the first parameter and the minimum screen
2914 width must be the second one. The following example displays the score
2915 with a length of 10 characters only if the screen is wider than 100
2916 characters: '%10>100S'.
2917 TIPS AND TRICKS
2919 tin can be pretty much be navigated by using the four cursor keys. The
2920 left arrow key goes up a level, the right arrow key goes down a level,
2921 the up arrow key goes up a line and the down arrow key goes down a
2922 line.
2923 The following newsgroups provide useful information concerning news
2925 software:
2926 —news.software.readers (info. about news user agents tin, rn, nn,
2927 slrn etc.)
2928 —news.software.nntp (info. about NNTP)
2929 —news.answers (Frequently Asked Questions (FAQ) about many differ‐
2930 ent themes)
2931 Many prompts within tin offer a default choice that the cursor is posi‐
2933 tioned on. By pressing '<CR>' the default value is taken. Most prompts
2934 can be aborted by pressing '<ESC>'.
2935 When tin is run in an xterm(1x) it will resize itself each time the
2937 xterm(1x) is resized.
2938 tin will reread the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-ac‐
2940 tive} file at set intervals (reread_active_file_secs) to show any newly
2941 arrived news.
2942 If you find large number of new newsgroups cluttering up your screen,
2944 pressing SelectToggleReadDisplay ('r') will make them go away.
2945 XTERM BUTTONS
2947 If the environment variable $TERM is set to xterm(1x), then button
2948 pressing can be used to select groups and articles. In this discussion,
2949 the buttons are assumed to be assigned conventionally (i.e., Button1 is
2950 the left button).
2951 In general (i.e., for the group, thread and article menus),
2953 Button1 (left)
2955 enters next (lower) level if you click on an article, other‐
2956 wise pages down.
2957 Button2 (center)
2959 returns to the previous (upper) level if you click on an ar‐
2960 ticle, otherwise pages up.
2961 Button3 (right)
2963 positions on the article line under mouse cursor, or pages
2964 down if you've clicked outside the list of articles.
2965 In the group selection menu, if the mouse is pointing at a group then:
2967 left button
2969 moves to and selects the group pointed at, just like Selec‐
2970 tReadGrp ('<CR>').
2971 center button
2973 quits the program, just like Quit ('q').
2974 right button
2976 moves to the group pointed at.
2977 In the article menu, if the mouse is pointing at an article (or thread)
2979 then:
2980 left button
2982 reads the article pointed at, just like GroupReadBasenote
2983 ('<CR>'), or the thread, just like GroupListThd ('l').
2984 center button
2986 exits the menu, catching up on the group if you have
2987 group_catchup_on_exit set in your configuration, just like
2988 Quit ('q').
2989 right button
2991 moves to the article (or thread) pointed at.
2992 In the thread menu, if the mouse is pointing at an article then:
2994 left button
2996 reads article pointed at, just like ThreadReadArt ('<CR>').
2997 center button
2999 exits the menu, catching up on the thread if you have
3000 thread_catchup_on_exit set in your configuration, just like
3001 Quit ('q').
3002 right button
3004 moves to the article pointed at.
3005 In other menus and areas button pressing reverts back to usual cut and
3007 paste of xterm(1x), but after one click of any button.
3008 INDEX FILES
3010 If your news server supports NOV index files (see newsoverview(5), most
3011 modern installations will) and you have a fast connection to your news
3012 server then this section can be ignored.
3013 If your news server doesn't support NOV index files or you have a very
3015 slow connection to your news server then tin can cache the index for
3016 each newsgroup if cache_overview_files is set to ON. Note that this
3017 cache can use up large amounts of disk space if you read a lot of
3018 groups and/or high traffic groups.
3019 Each user creates/updates his/her own index files that are stored in
3021 ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news/. If you are
3022 reading via NNTP then the news server name will be appended to keep the
3023 indexes for different servers separate. If you are reading off the lo‐
3024 cal spool and local overview files already exist then turning on
3025 caching will have no effect. Likewise unless you see significant delays
3026 entering a group when reading via NNTP then turning on caching will
3027 have little or no effect.
3028 Entering a group the first time tends to be slow because the index file
3030 must be built from scratch. To alleviate the slowness start tin to cre‐
3031 ate all index files for the groups you subscribe to with tin -u -v and
3032 go for a coffee. Subsequent readings of a group will only need to do
3033 incremental updating of the index file and will be much faster as only
3034 new articles will need to be cached.
3035 As indexing might take some time you may want to run tin from the sys‐
3037 tem batcher cron(8) with the ''-u'' option:
3038 30 6 * * * /usr/local/bin/tin -u
3040 If you are low on local disk space you should consider to manually
3042 purge cached data for groups you are not reading anymore with something
3043 like:
3044 find ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news* \
3046 -type f -name "[0-9]*.[0-9]" -atime +28 | xargs rm -f
3047
3049 For a detailed description see tin(5).
3050 $MAILCAPS
3052 ~/.mailcap
3053 /etc/mailcap
3054 /usr/etc/mailcap
3055 /usr/local/etc/mailcap
3056 /etc/mail/mailcap
3057 /etc/nntpserver
3059 ${TIN_HOMEDIR:-"$HOME"}/.cancelsecret
3061 ${TIN_HOMEDIR:-"$HOME"}/.mime.types
3063 /etc/mime.types
3064 /etc/tin/mime.types
3065 ${TIN_HOMEDIR:-"$HOME"}/.newsauth
3067 ${TIN_HOMEDIR:-"$HOME"}/.newsrc
3069 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/.oldnewsrc
3071 ${TIN_HOMEDIR:-"$HOME"}/.signature
3073 ${TIN_HOMEDIR:-"$HOME"}/.Sig
3074 ${TIN_HOMEDIR:-"$HOME"}/.sigfixed
3076 ${TIN_HOMEDIR:-"$HOME"}/.tin/.inputhistory
3078 ${TIN_INDEX_MAILDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.mail/
3080 ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news${NNTPSERVER:+"-$NNTPSERVER"}/
3082 ${TIN_INDEX_SAVEDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.save/
3084 ${TIN_HOMEDIR:-"$HOME"}/.tin/active.mail
3086 ${TIN_HOMEDIR:-"$HOME"}/.tin/active.save
3088 /etc/tin/attributes
3090 ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes
3091 ${TIN_HOMEDIR:-"$HOME"}/.tin/filter
3093 /etc/tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
3095 ${TIN_HOMEDIR:-"$HOME"}/.tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
3096 ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups
3098 ${TIN_HOMEDIR:-"$HOME"}/.tin/newsrctable
3100 ${TIN_HOMEDIR:-"$HOME"}/.tin/posted
3102 ${TIN_HOMEDIR:-"$HOME"}/Mail/posted
3104 ${TIN_HOMEDIR:-"$HOME"}/.tin/postponed.articles
3106 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER:${NNTPPORT:+":$NNTPPORT"}/newsgroups
3108 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER:${NNTPPORT:+":$NNTPPORT"}/serverrc
3110 /etc/tin/tinrc
3112 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc
3113 /etc/tin/tin.defaults
3115 /usr/local/share/locale/${LC_MESSAGES}/LC_MESSAGES/tin.mo
3117 ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active}
3119 ${TIN_LIBDIR:-NEWSLIBDIR}/active.times
3121 ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups
3123 ${TIN_LIBDIR:-NEWSLIBDIR}/organization
3125 ${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt
3127 ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions
3129
3131 TINRC Define this variable if you want to specify command-line options
3132 that tin should be started with to save typing them each time it
3133 is started. The contents of the environment variable are added
3134 to the front of the command-line options before it is parsed
3135 therefore allowing an option specified on the command-line to
3136 override the same option specified in the environment.
3137 TIN_HOMEDIR
3139 Define this variable if you do not want the .tin directory in
3140 $HOME/. E.g., if you want all tin's private files in /tmp/.tin
3141 you would set $TIN_HOMEDIR to /tmp.
3142 TIN_INDEX_NEWSDIR
3144 Define this variable if you do not want the .news directory in
3145 ${TIN_HOMEDIR:-"$HOME"}/.tin/. E.g., if you want all tin's news
3146 index files in /tmp/.news you would set $TIN_INDEX_NEWSDIR to
3147 /tmp.
3148 TIN_INDEX_MAILDIR
3150 Define this variable if you do not want the .mail directory in
3151 ${TIN_HOMEDIR:-"$HOME"}/.tin/. E.g., if you want all tin's mail
3152 index files in /tmp/.mail you would set $TIN_INDEX_MAILDIR to
3153 /tmp.
3154 TIN_INDEX_SAVEDIR
3156 Define this variable if you do not want the .save directory in
3157 ${TIN_HOMEDIR:-"$HOME"}/.tin/. E.g., if you want all tin's save
3158 index files in /tmp/.save you would set $TIN_INDEX_SAVEDIR to
3159 /tmp.
3160 TIN_LIBDIR
3162 Define this variable if you want to override the NEWSLIBDIR path
3163 that was compiled into the tin binary, default is /usr/lib/news.
3164 If tin is running in NNTP mode setting this variable has no ef‐
3165 fect.
3166 TIN_SPOOLDIR
3168 Define this variable if you want to override the SPOOLDIR path
3169 that was compiled into the tin binary, default is
3170 /var/spool/news. If tin is running in NNTP mode setting this
3171 variable has no effect.
3172 TIN_NOVROOTDIR
3174 Define this variable if you want to override the NOVROOTDIR path
3175 that was compiled into the tin binary, default is SPOOLDIR (see
3176 above). If tin is running in NNTP mode setting this variable has
3177 no effect.
3178 TIN_NOVFILENAME
3180 Define this variable if you want to override the OVERVIEW_FILE
3181 filename that was compiled into the tin binary, default is
3182 .overview. If tin is running in NNTP mode setting this variable
3183 has no effect.
3184 TIN_ACTIVEFILE
3186 Define this variable if you want to override the NEWSLIBDIR/ac‐
3187 tive path that was compiled into the tin binary. If tin is run‐
3188 ning in NNTP mode setting this variable has no effect. If
3189 $TIN_LIBDIR is set it is prepended to $TIN_ACTIVEFILE.
3190 NNTPSERVER
3192 The default NNTP server to remotely read news from. This vari‐
3193 able only needs to be set if the ''-r'' command-line option is
3194 specified and the file /etc/nntpserver does not exist. The
3195 ''-g'' command line option overrides $NNTPSERVER.
3196 NNTPPORT
3198 The NNTP TCP-port to read news from. This variable only needs to
3199 be set if the TCP-port is not 119 (the default). The ''-p''
3200 command-line option overrides $NNTPPORT.
3201 DISTRIBUTION
3203 Set the article header field ''Distribution:'' to the contents
3204 of the variable instead of the system default.
3205 ISO2ASC
3207 Set the ISO to ASCII charset decoding table character to use in
3208 decoding an article text. Values can range from -1 to 6.
3209 -1 no conversion
3211 0 universal table for many languages
3213 1 single-spacing universal table
3215 2 table for Danish, Dutch, German, Norwegian and Swedish
3217 3 table for Danish, Finnish, Norwegian and Swedish using the
3219 appropriate ISO 646 variant
3220 4 table with RFC1345 codes in brackets
3222 5 table for printers that allow overstriking with backspace
3224 6 table for IBM PC character set (code page 437)
3226 ORGANIZATION
3228 Set the article header field ''Organization:'' to the contents
3229 of the variable instead of the system default. If reading news
3230 on an Apollo DomainOS machine the environment variable $NEWSORG
3231 has to be used instead of $ORGANIZATION.
3232 NEWSORG (DomainOS)
3234 DomainOS specific, same as $ORGANIZATION on other OSs (see
3235 above).
3236 REPLYTO
3238 Set the article header field ''Reply-To:'' to the return address
3239 specified by the variable. This is useful if you wish to receive
3240 replies at a different address.
3241 NAME Overrides the full name given in the gecos-field in /etc/passwd,
3243 see also mail_address.
3244 REALNAME
3246 Same as $NAME.
3247 HOME Pathname of the user's home directory. See environ(5) for more
3249 info.
3250 MAILER This variable has precedence over the default mailer that is
3252 used in all mailing operations within tin.
3253 MAIL Full path to the user's mailbox.
3255 VISUAL This variable has precedence over the default editor (i.e.,
3257 vi(1)) that is used in all editing operations within tin (e.g.,
3258 posting, replying, follow-ups, ...). Evaluation order is ${VIS‐
3259 UAL:-"${EDITOR:-vi}"}. See environ(5) for more info.
3260 EDITOR If $VISUAL is unset, then this variable is looked up for a de‐
3262 fault editor. If $EDITOR and $VISUAL are both unset, tin uses
3263 the systems default editor (i.e. vi(1) on UNIX-systems). See
3264 environ(5) for more info.
3265 AUTOSUBSCRIBE
3267 A new group is checked against the list of patterns; if it
3268 matches, tin subscribes the user to the group without further
3269 query. See the section "NEWSGROUP LISTS & WILDCARDS" for an ex‐
3270 planation of the valid syntax. For example, setting
3271 AUTOSUBSCRIBE=comp.os.unix.*,talk.*,!talk.politics.*
3273 will automatically subscribe the user to all new groups in the
3275 comp.os.unix hierarchy, and all talk groups other than talk.pol‐
3276 itics groups (which will be queried for as usual). Of course
3277 this does not work if tin is started with the ''-X'' command-
3278 line switch.
3279 AUTOUNSUBSCRIBE
3281 Is handled like the $AUTOSUBSCRIBE variable, but groups matching
3282 the list are unsubscribed from without further query. For exam‐
3283 ple, setting
3284 AUTOUNSUBSCRIBE=alt.flame.*,u*,!uk.*
3286 will automatically unsubscribe the user from all new alt.flame
3288 groups and all groups starting with u (university groups) other
3289 than UK groups (which will be queried for as usual).
3290 TMPDIR A pathname of a directory made available for tin to create tem‐
3292 porary files.
3293 MAILCAPS
3295 This variable can be used to override the default path search
3296 for mailcap(5) files. See also tin(5).
3297 NOMETAMAIL
3299 Set this variable to disable the use of metamail(1) or a re‐
3300 placement (e.g. metamutt).
3301 MM_CHARSET
3303 MIME character set used if not configured via the tinrc variable
3304 mm_charset.
3305 ISPELL Set this variable to point to ispell(1) or a replacement and its
3307 cmd-line options.
3308 PGPOPTS
3310 Define any additional options that you wish to pass to your
3311 pgp(1) or gpg(1) program.
3312 PGPPATH
3314 Override the name of the pgp(1) directory in $HOME that holds
3315 your keys etc..
3316 GNUPGHOME
3318 Override the name of the gpg(1) directory in $HOME that holds
3319 your keys etc..
3320 LC_CTYPE
3322 This variable determines the locale(5) category for character
3323 handling functions. Usually it determines the character classes
3324 for pattern matching character classification and case conver‐
3325 sion. Currently this is not true for tin (which temporary unsets
3326 $LC_CTYPE right before any match is done to avoid confusion).
3327 It's value should be of the form language[_territory][.code‐
3328 set][@modifier]. See environ(5) for more information.
3329 LC_MESSAGES
3331 Formats of informative and diagnostic messages and interactive
3332 responses. It's value should be of the form language[_terri‐
3333 tory][.codeset][@modifier]. See locale(5) and environ(5) for
3334 more information.
3335 LC_TIME
3337 Date and time formats. It's value should be of the form lan‐
3338 guage[_territory][.codeset][@modifier]. See locale(5) and
3339 environ(5) for more information.
3340 LC_ALL This variable overrides the value of the $LANG variable and any
3342 other $LC_ variable. It's value should be of the form lan‐
3343 guage[_territory][.codeset]. See locale(5) and environ(5) for
3344 more information.
3345 LANG This variable determines the locale(5) category for any category
3347 not specifically selected with a variable starting with $LC_.
3348 It's value should be of the form language[_territory][.codeset].
3349 See environ(5) for more information.
3350 LANGUAGE
3352 This variable defines a priority list for translations. Whenever
3353 a translation is not available in the language selected via
3354 $LC_ALL or $LANG the next language from the list is tried. It's
3355 value should be of the form language:language[:language]. See
3356 environ(5) for more information.
3357 COLUMNS
3359 A decimal integer > 0 used to indicate the user's preferred
3360 width in column positions for the terminal screen or window. If
3361 this variable is unset or null, the implementation determines
3362 the number of columns, appropriate for the terminal or window.
3363 When $COLUMNS is set, any terminal-width information implied by
3364 $TERM will be overridden. Users and portable applications should
3365 not set $COLUMNS unless they wish to override the system selec‐
3366 tion and produce output unrelated to the terminal characteris‐
3367 tics.
3368 LINES A decimal integer > 0 used to indicate the user's preferred num‐
3370 ber of lines on a page or the vertical screen or window size in
3371 lines. A line in this case is a vertical measure large enough to
3372 hold the tallest character in the character set being displayed.
3373 If this variable is unset or null, the implementation determines
3374 the number of lines, appropriate for the terminal or window.
3375 When $LINES is set, any terminal-height information implied by
3376 $TERM will be overridden. Users and portable applications should
3377 not set $LINES unless they wish to override the system selec‐
3378 tion.
3379 TERM The type of terminal in use. This is used when looking up term‐
3381 cap sequences. See environ(5) for more information.
3382 DISPLAY
3384 Display name, pointing to the X server; required for xface.
3385 WINDOWID
3387 Used for determining terminal's X window id; required for xface.
3388 Should be set by the terminal emulator.
3389 SHELL The pathname of the user's login shell. Used to set de‐
3391 fault_shell_command.
3392 XDG_RUNTIME_DIR
3394 The pathname of the user's dir to put non-essential run time
3395 files into.
3396
3398 tin handles a couple of signals:
3399 SIGHUP Terminate gracefully.
3401 SIGTERM
3403 Terminate gracefully.
3404 SIGUSR1
3406 Terminate gracefully but do not restore terminal (tty).
3407 SIGUSR2
3409 Write out ${TIN_HOMEDIR:-"$HOME"}/.newsrc-file.
3410
3412 If tin is started in debug mode (''-D n'') it will create world read‐
3413 able files in $TMPDIR which may contain the users NNTP password in
3414 cleartext. On multiuser-systems $TMPDIR should be set to a safe loca‐
3415 tion before starting tin in debug mode (e.g. TMPDIR=$HOME tin -D 1).
3416
3418 tin does conform to the Base Definitions volume of IEEE Std
3419 1003.1-2008, Section 12, Utility Conventions (Utility Argument Syntax,
3420 Utility Syntax Guidelines).
3421
3423 Regular expression support is provided by the PCRE library package
3424 pcre(3), which is open source software, written by Philip Hazel, and
3425 copyright by the University of Cambridge, England.
3426 <https://www.pcre.org/>
3427
3429 CNews NNTPd, noffle(1) (<= V1.0-pre5) and NewsCache (<= V1.1.91) can't
3430 handle pipelined GROUP commands. If you run into trouble with any of
3431 the mentioned servers define DISABLE_PIPELINING in include/autoconf.h
3432 and recompile.
3433 Before mailing a bug-report to <tin-bugs@tin.org> please check if you
3434 are using the latest (stable) release, and if not, please upgrade
3435 first! Have a look at the doc/TODO file for known bugs. If you still
3436 think you've found a bug, please use the BugReport ('R') function and
3437 write in English. Please do NOT enclose a core-file in your bug-report
3438 until we request it.
3439
3441 tin is based on the tass(1) newsreader that was developed by Rich
3442 Skrenta and posted to alt.sources in March 1991; its first version was
3443 released on August 23rd 1991. tass(1) itself was heavily influenced by
3444 notesfiles a public domain UNIX version of PLATO Notes, developed at
3445 the University of Illinois by Ray Essick and Rob Kolstad in 1982. For a
3446 version overview see
3447 <http://www.tin.org/history.html>.
3448
3450 Rich Skrenta
3451 author of tass(1) v3.2 which this newsreader used as its base.
3452 Bill Davidsen
3454 author of envarg.c environment variable reading routine.
3455 Mike Gleason
3457 author of sigfile.c random signature generation routines.
3458 Markus Kuhn <Markus.Kuhn@cl.cam.ac.uk>
3460 author of langinfo.c, charset.c and iso2asc.txt ISO-8859-1 docu‐
3461 mentation.
3462 Arnold Robbins
3464 author of strftime.c date formatting routine.
3465 Rich Salz
3467 author of wildmat.c pattern matching and parsdate.y date parsing
3468 routines.
3469 Dave Taylor
3471 author of curses.c from the elm(1) mailreader.
3472 Chris Thewalt
3474 author of getline.c emacs(1) style editing routine.
3475 Steven Madsen
3477 for adding pgp(1) (Pretty Good Privacy) support.
3478 Philip Hazel <ph10@cam.ac.uk>
3480 for pcre(3) (Perl-compatible regular expression library).
3481 Patrick Powell <papowell@astart.com>
3483 for snprintf(3) and vsnprintf(3) fallbacks.
3484
3486 Iain Lea <iain@bricbrac.de>
3487
3489 Urs Janssen <urs@tin.org>
3490
3492 elm(1), emacs(1), gpg(1), inews(1), ispell(1), lp(1), lpr(1),
3493 metamail(1), mutt(1), noffle(1), perl(1), perlre(1), pgp(1), rn(1),
3494 sendmail(1), shar(1), slrnface(1), tass(1), unshar(1), uudecode(1),
3495 vi(1), xterm(1x), heapsort(3), iconv(3), iconv_open(3), nl_langinfo(3),
3496 pcre(3), pcrepattern(3), qsort(3), snprintf(3), strftime(3),
3497 vsnprintf(3), wildmat(3), environ(5), locale(5), mailcap(5), mbox(5),
3498 mmdf(5), newsoverview(5), tin(5), cron(8), RFC1345, RFC1524, RFC2045,
3499 RFC2046, RFC2047, RFC2048, RFC2231, RFC2980, RFC3156, RFC3977, RFC4155,
3500 RFC4643, RFC4880, RFC5322, RFC5536, RFC5537, RFC6048
35012.6.0 August 23rd, 2021 tin(1)