1tin(1) Usenet newsreader tin(1)
2
6 tin, rtin - Usenet newsreader
7
9 tin [[-h|-H|-V] | [[[-a] [-dlnq|-Q] [-ArzxX]] [[-R|-S] -s News_dir]
10 [-cuvZ] [-4|-6] [-N|-M address] [-o|-w]] [-D debug_level] [-G arti‐
11 cle_limit] [-f newsrc_file] [-g server] [-m Mail_dir] [-p port] [-I
12 index_dir] [newsgroup[,...]]]
13
15 tin is a full-screen easy to use Usenet newsreader. It can read news
16 locally (e.g., /var/spool/news) or remotely (rtin or tin -r option) via
17 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''
59 option 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
80 article-limit articles/group are fetched from the server.
81 If article-limit is < 0 tin will start fetching articles
82 from your first unread minus absolute value of article-
83 limit. 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
117 allows a noticeable speedup when connecting via a slow
118 line, but tin may not be able detect which groups are mod‐
119 erated. 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 ''-nqd''.
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''
149 option. For more information read section "AUTOMATIC MAIL‐
150 ING 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''
154 option. 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 ''-D'', ''-c'', ''-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_ACTIVE‐
208 FILE:-active} 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
216 options. Thus, command-line option takes precedence over configured
217 values.
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
228 directory (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
231 Extensions (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
287 articles (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
302 recent articles within the thread it might be marked with
303 art_marked_recent in front of the total number of articles in the
304 thread — this is controlled by the recent_time option. If a thread has
305 hot articles in it (see also section "FILTERING ARTICLES") it's marked
306 with art_marked_selected in front of the total number of articles in
307 the thread. The number of lines of the first (unread) article in the
308 thread might also be shown right before the subject — this is con‐
309 trolled by the show_info option. The display can be customized via
310 group_format.
311 de.admin.net-abuse.announce (11B 13+ 1* 1o 0K) M
313 -> 1 + 3 108 bincancels in de.talk.sex Christopher Lueg <l
315 2 + 69 EMP/ECP gecancelt. xynx. BI= 10 Henning Weede <hwee
316 3 o 93 EMP gecancelt. SouthBeach/Palms Henning Weede <hwee
317 4 * 368 <1997-11-12> Fremdcancel-FAQ Thomas Roessler <ro
318 At the Thread level the screen usually (depends on the threading method
320 used) looks like this, but can be customized via thread_format:
321 -> 1 [ 7] What is this funny tree in the thr Robert F. Simmig
323 2 [ 12] +-> Sephan Wagner <s
324 3 [ 230] | `->Tin thread-level (was: What is Bob Johnson <bob
325 4 [ 22] `->tin threading menu Brian Richardson
326 At the Article level the page header has the following format:
329 Sun, 28 Dec 1997 21:21:01 de.admin.news.groups Thread 20 of 86
331 Lines 50 Re: EINSPRUCH zu RESULT:de.comm.mobil.ALL Article 47 of 59
332 Urs Janssen <urs@akk.org> at Arbeitskreis Kultur und Kommunikati
333 article-body
335 The look of the Selection, Group and Thread level can be customized.
337 See the section "CUSTOMIZING THE SCREEN FORMAT".
338 COMMON MOVING KEYS
340 This table shows the common keys used for moving around all levels
341 within tin.
342 ANSI/vt100 Other Terminals
343 Beg. of list/article Home FirstPage (^)
344 End of list/article End LastPage ($)
345 Page Up PgUp PageUp (u, ^U or ^B)
346 Page Down PgDn PageDown (^D or ^F or <SPACE>)
347 Line Up Up arrow Up (k or ^P)
348 Line Down Down arrow Down (j or ^N)
349 COMMON EDITING COMMANDS
351 An emacs(1) style editing package allows the easy editing of input
352 strings. A history list allows the easy reuse of previously entered
353 strings. In addition to the cursor keys, the following commands are
354 available when editing a string:
355 ^A, ^E move to beginning or end of line, respectively.
357 ^F, ^B non-destructive move forward or back one location, respec‐
359 tively.
360 ^D delete the character currently under the cursor, or send EOF
362 if no characters in the buffer.
363 ^H, <DEL> delete character left of the cursor.
365 ^K delete from cursor to end of line.
367 ^P, ^N move through history, previous and next, respectively.
369 ^L, ^R redraw the current line.
371 <CR> places line on history list if non-blank, appends newline and
373 returns to the caller.
374 <ESC> aborts the present editing operation.
376 GLOBAL COMMANDS
378 The following commands are available at all 4 menu levels and always
379 have the same effect.
380 ShellEscape '!'
382 Shell escape. ShellEscape by itself will launch a shell,
383 ShellEscape <command> will run an external <command>. This
384 facility may have been disabled by the System Administrator.
385 ToggleColor '&'
387 Toggle use of ANSI color.
388 RedrawScr '^L'
390 Redraw the current screen.
391 ScrollUp '<'
393 Scroll screen up by one line.
394 ScrollDown '>'
396 Scroll screen down by one line.
397 Postponed 'O' '^O'
399 Reload postponed article. If your system blocks the Postponed
400 key you must quote it by pressing '^V' (CTRL-V) first. The
401 postpone-menu offers the following actions: PromptYes ('y') =
402 reload and spawn editor; PostponeOverride ('Y') = post arti‐
403 cle (without spawning editor); PostponeAll ('A') = post all
404 postponed articles (without spawning editor); PromptNo ('n')
405 = skip this article; Quit ('q') = quit postponed menu. Cur‐
406 rently there is no 'simple' way to delete a postponed article
407 from the postponed-file, you have to use the following com‐
408 mand sequence instead: reload it with Postponed, enter editor
409 with PromptYes, quit editor, discard posting with Quit
410 ('^O''y''q'). See also ''-o'' command-line switch.
411 Help 'h' Help screen of commands available on the current menu. You
413 can use SearchSubjF ('/'), SearchSubjB ('?') and SearchRepeat
414 ('\') to search on this screen. Quit ('q') returns to the
415 menu.
416 ToggleHelpDisplay 'H'
418 Toggle the display of help mini menu at the bottom of the
419 screen.
420 DisplayPostHist 'W'
422 List articles posted by user. The date posted, the newsgroup
423 and the subject are listed. You can use SearchSubjF ('/'),
424 SearchSubjB ('?') and SearchRepeat ('\') to search on this
425 screen. Quit ('q') returns to the menu.
426 Version 'v'
428 Print tin version information.
429 NEWSGROUP SELECTION COMMANDS
431 4 Select group 4.
432 SelectResetNewsrc '^R'
434 Reset ${TIN_HOMEDIR:-"$HOME"}/.newsrc file. This will destroy
435 all records of which articles have been read, so use this
436 carefully.
437 SetRange '#'
439 Choose a range of articles to be affected by the next com‐
440 mand. See the section "RANGES" for more information.
441 SelectSortActive '.'
443 Sort the list of newsgroups.
444 SearchRepeat '\'
446 Repeat the previous search.
447 SearchSubjF '/'
449 Search for a group by name and description (if displayed).
450 SearchSubjB '?'
452 Backward search through the group names and descriptions.
453 SelectReadGrp '^J' '<CR>'
455 Read current group.
456 SelectEnterNextUnreadGrp '<TAB>' 'n'
458 Enter next group with unread news. Will wrap around to the
459 beginning of the group selection list looking for unread
460 groups.
461 Catchup 'c'
463 Make current group as all read [after confirmation] and move
464 to the next group in the group selection list.
465 CatchupNextUnread 'C'
467 Mark current group as all read [after confirmation] and enter
468 the next unread group in the group selection list.
469 SelectToggleDescriptions 'd'
471 Toggle display to show just the group name or the group name
472 and the group descriptions.
473 EditFilter 'E'
475 Edit the filter file and reload it afterwards.
476 SelectGoto 'g'
478 Choose a new group by name. This command can be used to
479 access any group, even those not currently yanked in.
480 ToggleInfoLastLine 'i'
482 Toggle the display of the description of the current news‐
483 group in the last line. This will not be available if tin was
484 started with the ''-d'' option.
485 ToggleInverseVideo 'I'
487 Toggle inverse video.
488 LookupMessage 'L'
490 Look up article by ''Message-ID:''. If none of the groups
491 listed in the ''Newsgroups:''-header of the referenced arti‐
492 cle is available, just the contents of the ''News‐
493 groups:''-header will be displayed in the last line. At this
494 level this command only works if reading via NNTP and the
495 server supports [X]HDR (RFC2980, RFC3977) or XPAT (RFC2980).
496 SelectMoveGrp 'm'
498 Move the current group within the group selection list. By
499 entering '1' the group will become the first displayed group
500 in the list, by entering '8' the eighth group in the list
501 etc. By entering '$' the group will be the last group dis‐
502 played.
503 OptionMenu 'M'
505 User configurable options menu (for more information see sec‐
506 tion "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES").
507 SelectNextUnreadGrp 'N'
509 Positions the cursor on the next group with unread articles
510 in it.
511 Quit 'q' Quit tin — ask the user to confirm if confirm_choice is set
513 accordingly.
514 QuitTin 'Q'
516 Quit tin — don't ask the user to confirm.
517 SelectToggleReadDisplay 'r'
519 Toggle display of all subscribed to groups and just those
520 groups containing unread articles. Command has no effect if
521 groups were specified on the command-line when tin was
522 started.
523 BugReport 'R'
525 Mail a bug report or comment to <tin-bugs@tin.org>. This is
526 the best way of getting bugs fixed and features
527 added/changed.
528 SelectSubscribe 's'
530 Subscribe to current group.
531 SelectSubscribePat 'S'
533 Subscribe to groups matching user specified pattern. See the
534 section "NEWSGROUP LISTS & WILDCARDS" for the types of pat‐
535 tern that tin understands.
536 SelectUnsubscribe 'u'
538 Unsubscribe to current group. This can be used to remove
539 bogus groups. See strip_bogus in the "GLOBAL OPTIONS MENU
540 AND TINRC CONFIGURABLE VARIABLES" section.
541 SelectUnsubscribePat 'U'
543 Unsubscribe to groups matching user specified pattern. See
544 the section "NEWSGROUP LISTS & WILDCARDS" for the types of
545 pattern that tin understands.
546 Post 'w' Post an article to current group. If posting fails for some
548 reason, you'll get the chance to PostEdit ('e') the article
549 again, PostPostpone ('o') it for later processing (see also
550 ''-o'' command-line switch) or discard it via Quit ('q').
551 SelectQuitNoWrite 'X'
553 Quit tin without saving any changes to the configuration.
554 SelectYankActive 'y'
556 Yanks in all groups. Toggles the displayed groups between all
557 the groups in the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE‐
558 FILE:-active} file and just those that are subscribed to in
559 ${TIN_HOMEDIR:-"$HOME"}/.newsrc.
560 SelectSyncWithActive 'Y'
562 Reread the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE‐
563 FILE:-active} file to see if any new news has arrived since
564 starting tin.
565 SelectMarkGrpUnread 'z' 'Z'
567 Mark all articles in the current group as unread.
568 GROUP INDEX COMMANDS
570 All searches in this level are limited to unread articles if in
571 show_only_unread_arts mode. GroupToggleReadUnread ('r') can be use tog‐
572 gle the setting right before/after the search.
573 4 Select article 4.
575 MenuFilterSelect '^A'
577 Auto select article(s) using a menu. Read the section "FIL‐
578 TERING ARTICLES" for more information.
579 MenuFilterKill '^K'
581 Kill article(s) using a menu. Read the section "FILTERING
582 ARTICLES" for more information.
583 MarkFeedRead '^X'
585 Mark current article, thread, range, auto-selected (hot)
586 articles, articles matching pattern or tagged articles as
587 read. A prompt asks which type should be marked.
588 MarkFeedUnread '^W'
590 Mark current article, thread, range, auto-selected (hot)
591 articles, articles matching pattern or tagged articles as
592 unread. A prompt asks which type should be marked.
593 SetRange '#'
595 Choose a range of articles to be affected by the next com‐
596 mand. See the section "RANGES" for more information.
597 LastViewed '-'
599 Re-enter the last message that was viewed.
600 SearchRepeat '\'
602 Repeat the previous search.
603 SearchSubjF '/'
605 Search forward for specified subject.
606 SearchSubjB '?'
608 Search backwards for specified subject.
609 GroupSelThd '*'
611 Select current thread for later processing.
612 GroupDoAutoSel '+'
614 Selects all threads in current group. It is a shortcut for
615 calling GroupSelPattern with a pattern of ''*''.
616 GroupToggleThdSel '.'
618 Toggle selection of current thread. If at least one unread
619 article, (but not every unread article) in the current thread
620 is selected, then all unread articles become selected.
621 GroupSelThdIfUnreadSelected ';'
623 For each thread in current group, if it at least one unread
624 article is selected, all unread articles become selected.
625 This is useful for auto-selection on author where reader
626 wants to see entire thread.
627 GroupSelPattern '='
629 Prompts for a pattern with which to match on. All threads
630 whose subjects match the pattern will be marked selected. A
631 pattern of ''*'' will match all subjects. Entering just
632 '<CR>' will re-use the last pattern that was entered.
633 GroupReverseSel '@'
635 Reverse all selections on all articles.
636 GroupUndoSel '~'
638 Undo all selections on all articles. It clears the toggle
639 effect of GroupMarkUnselArtRead ('X') command. Thus after
640 first doing a GroupMarkUnselArtRead, one can then do GroupUn‐
641 doSel to reset articles. Thus, one can iteratively whittle
642 down uninteresting threads.
643 Pipe '|' Pipe current article / thread / auto-selected (hot) articles
645 / articles matching pattern / tagged articles into command.
646 See the section "MAILING PIPING PRINTING REPOSTING AND SAVING
647 ARTICLES" for more information.
648 QuickFilterSelect '['
650 Auto select article(s) with a single key [after confirma‐
651 tion]. The defaults used for selection are based upon the
652 following four tinrc config variables: default_fil‐
653 ter_select_case, default_filter_select_expire, default_fil‐
654 ter_select_global and default_filter_select_header. Read the
655 section "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARI‐
656 ABLES" for a full explanation of these variables and "FILTER‐
657 ING ARTICLES" for more information on filtering.
658 QuickFilterKill ']'
660 Kill article(s) with a single key [after confirmation]. The
661 defaults used for killing are based upon the following four
662 tinrc config variables: default_filter_kill_case,
663 default_filter_kill_expire, default_filter_kill_global and
664 default_filter_kill_header. Read the section "GLOBAL OPTIONS
665 MENU AND TINRC CONFIGURABLE VARIABLES" for a full explanation
666 of these variables and "FILTERING ARTICLES" for more informa‐
667 tion on filtering.
668 GroupReadBasenote '^J' '<CR>'
670 Read current article.
671 GroupNextUnreadArtOrGrp '<TAB>'
673 View next unread article or group.
674 SearchAuthF 'a'
676 Author forward search. This searches for articles with a spe‐
677 cific ''From:'' line.
678 SearchAuthB 'A'
680 Author backward search. Otherwise, see SearchAuthF ('a')
681 above.
682 SearchBody 'B'
684 Search the body of all articles in group (can be slow). You
685 can abort the search using Quit ('q').
686 Catchup 'c'
688 Mark all articles as read [after confirmation] then return to
689 the group selection list. Move cursor to next group.
690 CatchupNextUnread 'C'
692 Mark all articles as read [after confirmation] and enter the
693 next group with unread news.
694 GroupToggleSubjDisplay 'd'
696 Cycle the display of the author through all the possible
697 options for the tinrc variable show_author.
698 GroupCancel 'D'
700 Cancel (delete) or supersede (overwrite) the current article.
701 It must have been posted by the same user. The cancel message
702 can be seen in the newsgroup 'control' or 'control.cancel'.
703 EditFilter 'E'
705 Edit the filter file and reload it afterwards.
706 GroupGoto 'g'
708 Choose a new group by name. This command can be used to
709 access any group, even those not currently yanked in.
710 GroupToggleGetartLimit 'G'
712 Toggle article/group limit.
713 ToggleInfoLastLine 'i'
715 Display the subject of the first article in the current
716 thread in the last line.
717 ToggleInverseVideo 'I'
719 Toggle inverse video.
720 GroupMarkThdRead 'K'
722 Mark article/thread as read and move onto the next unread
723 article/thread. If a range of articles/threads is set, the
724 range will be marked as read instead of the current arti‐
725 cle/thread. When tagged articles/threads are present, a
726 prompt asks how to proceed.
727 GroupListThd 'l'
729 Open the thread under the current cursor position.
730 LookupMessage 'L'
732 Look up article by ''Message-ID:''.
733 GroupMail 'm'
735 Mail current article / thread / auto-selected (hot) articles
736 / articles matching pattern / tagged articles to someone. See
737 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
738 ARTICLES" for more information.
739 OptionMenu 'M'
741 User configurable options menu (for more information see sec‐
742 tion "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES").
743 GroupNextGroup 'n'
745 Go to next group.
746 GroupNextUnreadArt 'N'
748 Go to the next unread article.
749 Print 'o' Send current article / thread / auto-selected (hot) articles
751 / articles matching pattern / tagged articles to printer. See
752 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
753 ARTICLES" for more information.
754 GroupPrevGroup 'p'
756 Go to previous group.
757 GroupPrevUnreadArt 'P'
759 Go to previous unread article.
760 Quit 'q' Return to previous level.
762 QuitTin 'Q'
764 Quit tin — don't ask the user to confirm.
765 GroupToggleReadUnread 'r'
767 Toggle the display between all articles and unread articles.
768 BugReport 'R'
770 Mail a bug report or comment to <tin-bugs@tin.org>. This is
771 the best way of getting bugs fixed and features
772 added/changed.
773 GroupSave 's'
775 Save current article / thread / auto-selected (hot) articles
776 / articles matching pattern / tagged articles. See the sec‐
777 tion "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
778 for more information.
779 GroupAutoSave 'S'
781 Save marked articles automatically without further prompting.
782 GroupTag 't'
784 Toggle tag-status of current article / thread for GroupMail
785 ('m') / Pipe ('|') / Print ('o') / GroupSave ('s') / GroupRe‐
786 post ('x').
787 GroupTagParts 'T'
789 Automatically tag in order all the parts of the current
790 multi-part message.
791 GroupToggleThreading 'u'
793 Cycle the threading mode through no threading, threading by
794 subject, threading by references, threading on both subject
795 and references, group multipart articles into a thread
796 (''Subject:'' based).
797 GroupUntag 'U'
799 Untag all articles that were tagged.
800 Post 'w' Post an article to the current group. If posting fails for
802 some reason, you'll get the chance to edit the article again
803 via PostEdit ('e'), postpone it for later processing via
804 PostPostpone ('o') (see also ''-o'' command-line switch) or
805 discard it via Quit ('q').
806 GroupRepost 'x'
808 Repost an already posted article / thread / auto-selected
809 (hot) articles / articles matching pattern / tagged articles
810 to another newsgroup(s). Useful for reposting from global to
811 local newsgroups. Do not use this to crosspost your own arti‐
812 cles.
813 GroupMarkUnselArtRead 'X'
815 Mark all unread articles that have not been selected as read,
816 redraw screen to reflect changes and put index at the first
817 thread to begin reading. Pressing GroupMarkUnselArtRead
818 ('X') again will toggle back to the way it was before. See
819 GroupUndoSel ('~') command for clearing the toggle effect,
820 leaving the group will also clear the toggle effect and make
821 the changes permanent.
822 MarkArtUnread 'z'
824 Mark current article as unread.
825 MarkThdUnread 'Z'
827 Mark current thread as unread. If a range of threads is set,
828 the range will be marked as unread instead of the current
829 thread. When tagged threads are present, a prompt asks how to
830 proceed.
831 THREAD LISTING COMMANDS
833 4 Select article 4 within thread.
834 MenuFilterSelect '^A'
836 Auto select article(s) using a menu. Read the section "FIL‐
837 TERING ARTICLES" for more information.
838 MenuFilterKill '^K'
840 Kill article(s) using a menu. Read the section "FILTERING
841 ARTICLES" for more information.
842 MarkFeedRead '^X'
844 Mark current article, thread, range, auto-selected (hot)
845 articles, articles matching pattern or tagged articles as
846 read. A prompt asks which type should be marked.
847 MarkFeedUnread '^W'
849 Mark current article, thread, range, auto-selected (hot)
850 articles, articles matching pattern or tagged articles as
851 unread. A prompt asks which type should be marked.
852 SetRange '#'
854 Choose a range of articles to be affected by the next com‐
855 mand. See the section "RANGES" for more information.
856 LastViewed '-'
858 Re-enter the last message that was viewed.
859 SearchRepeat '\'
861 Repeat the previous search.
862 SearchSubjF '/'
864 Search forward for specified subject.
865 SearchSubjB '?'
867 Search backwards for specified subject.
868 ThreadSelArt '*'
870 Select current thread for later processing.
871 ThreadToggleArtSel '.'
873 Toggle selection of current article.
874 ThreadReverseSel '@'
876 Reverse article selections.
877 ThreadUndoSel '~'
879 Undo all selections on current thread.
880 Pipe '|' Pipe current article / thread / auto-selected (hot) articles
882 / articles matching pattern / tagged articles into command.
883 See the section "MAILING PIPING PRINTING REPOSTING AND SAVING
884 ARTICLES" for more information.
885 ThreadReadArt '^J' '<CR>'
887 Read current article within thread.
888 ThreadReadNextArtOrThread '<TAB>'
890 View next unread article within thread.
891 SearchAuthF 'a'
893 Author forward search. This searches for articles with a spe‐
894 cific ''From:'' line. The search will wrap over into the next
895 thread if nothing is found in the current one.
896 SearchAuthB 'A'
898 Author backward search. Otherwise, see SearchAuthF ('a')
899 above.
900 SearchBody 'B'
902 Search the body of all articles in group (can be slow). You
903 can abort the search using Quit ('q').
904 Catchup 'c'
906 Mark thread as read [after confirmation] and return to the
907 group index page. Move cursor to next thread.
908 CatchupNextUnread 'C'
910 Mark thread as read [after confirmation] and enter the next
911 thread containing unread news.
912 ThreadToggleSubjDisplay 'd'
914 Cycle the display of the author through all the possible
915 options for the tinrc variable show_author.
916 ThreadCancel 'D'
918 Cancel (delete) or supersede (overwrite) the current article.
919 It must have been posted by the same user. The cancel message
920 can be seen in the newsgroup 'control' or 'control.cancel'.
921 EditFilter 'E'
923 Edit the filter file and reload it afterwards.
924 ToggleInfoLastLine 'i'
926 Display the subject of the current article in the last line.
927 ToggleInverseVideo 'I'
929 Toggle inverse video.
930 ThreadMarkArtRead 'K'
932 Mark article as read and move onto the next unread article.
933 If a range of articles is set, the range will be marked as
934 read instead of the current article. When tagged articles are
935 present, a prompt asks how to proceed.
936 LookupMessage 'L'
938 Look up article by ''Message-ID:''.
939 ThreadMail 'm'
941 Mail current article / thread / auto-selected (hot) articles
942 / articles matching pattern / tagged articles to someone. See
943 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
944 ARTICLES" for more information.
945 Print 'o' Send current article / thread / auto-selected (hot) articles
947 / articles matching pattern / tagged articles to printer. See
948 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
949 ARTICLES" for more information.
950 Quit 'q' Return to previous level.
952 QuitTin 'Q'
954 Quit tin — don't ask the user to confirm.
955 BugReport 'R'
957 Mail a bug report or comment to <tin-bugs@tin.org>. This is
958 the best way of getting bugs fixed and features
959 added/changed.
960 ThreadSave 's'
962 Save current article / thread / auto-selected (hot) articles
963 / articles matching pattern / tagged articles. See the sec‐
964 tion "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
965 for more information.
966 ThreadAutoSave 'S'
968 Save marked articles automatically without further prompting.
969 ThreadTag 't'
971 Toggle tag status of current article for mailing, piping,
972 printing, saving or reposting.
973 ThreadUntag 'U'
975 Untag all tagged threads.
976 Post 'w' Post an article to the current group. If posting fails for
978 some reason, you'll get the chance to edit the article again
979 via PostEdit ('e'), postpone it for later processing via
980 PostPostpone ('o') (see also ''-o'' command-line switch) or
981 discard it via Quit ('q').
982 MarkArtUnread 'z'
984 Mark current article in thread as unread. If a range of arti‐
985 cles is set, the range will be marked as unread instead of
986 the current article. When tagged articles are present, a
987 prompt asks how to proceed.
988 MarkThdUnread 'Z'
990 Mark all articles in thread as unread.
991 ARTICLE VIEWER COMMANDS
993 0 Read the first (base) article in this thread.
994 4 Read response 4 in this thread.
996 MenuFilterSelect '^A'
998 Auto select article(s) using a menu. Read the section "FIL‐
999 TERING ARTICLES" for more information.
1000 PageReplyQuoteHeaders '^E'
1002 Reply through mail to the author of the current article with
1003 a copy of the article with all headers included.
1004 PagePGPCheckArticle '^G'
1006 Perform pgp(1) operations on article.
1007 PageToggleRaw '^H'
1009 Toggles the display mode (raw including all headers vs.
1010 cooked).
1011 MenuFilterKill '^K'
1013 Kill article(s) using a menu. Read the section "FILTERING
1014 ARTICLES" for more information.
1015 PageToggleTabs '^T'
1017 Toggle the TAB width between 4 and 8 characters.
1018 PageFollowupQuoteHeaders '^W'
1020 Post a followup to the current article with a copy of the
1021 article with all headers included.
1022 PageToggleTex2iso '"'
1024 Toggle TeX to ISO decoding for current article. The default
1025 behavior is taken from the tex2iso_conv variable in the tinrc
1026 file.
1027 PageToggleAllHeaders '*'
1029 Toggles the display of all headers vs. headers in news_head‐
1030 ers_to_display.
1031 PageToggleRot '%'
1033 Toggle ROT-13 decoding for this article.
1034 PageToggleUue '('
1036 Toggle the display of uuencoded sections. The default behav‐
1037 ior is taken from the hide_uue variable in the tinrc file.
1038 PageReveal ')'
1040 The formfeed character (^L) is often used to hide 'spoilers'
1041 that the reader may not initially wish to see when viewing an
1042 article. Any text after a formfeed is not displayed. This
1043 key-press acts like a reveal key and turns the hidden text
1044 back on. Scrolling down will also reveal the text, scrolling
1045 up will hide it again.
1046 LastViewed '-'
1048 Re-enter the last message that was viewed.
1049 SearchRepeat '\'
1051 Repeat the previous search.
1052 SearchSubjF '/'
1054 Forward search the text of this article.
1055 SearchSubjB '?'
1057 Backward search the text of this article.
1058 PageSkipIncludedText ':'
1060 Skip to the end of the next quoted text-block in this arti‐
1061 cle. Quoted text is everything which matches quote_regex,
1062 quote_regex2 or quote_regex3.
1063 PageTopThd '<'
1065 Go to the first article in the current thread.
1066 PageBotThd '>'
1068 Go to the last article in the current thread.
1069 PageToggleHighlight '_'
1071 Toggle word highlighting on/off.
1072 Pipe '|' Pipe current article / thread / auto-selected (hot) articles
1074 / articles matching pattern / tagged articles into command.
1075 See the section "MAILING PIPING PRINTING REPOSTING AND SAVING
1076 ARTICLES" for more information.
1077 QuickFilterSelect '['
1079 Auto select article(s) with a single key. The defaults used
1080 for selection are set based upon the following four tinrc
1081 config variables: default_filter_select_case, default_fil‐
1082 ter_select_expire, default_filter_select_global and
1083 default_filter_select_header Read the section "GLOBAL OPTIONS
1084 MENU AND TINRC CONFIGURABLE VARIABLES" for a full explanation
1085 of these variables and "FILTERING ARTICLES" for more informa‐
1086 tion on filtering.
1087 QuickFilterKill ']'
1089 Kill article(s) with a single key. The defaults used for
1090 killing are based upon the following four tinrc config vari‐
1091 ables: default_filter_kill_case, default_filter_kill_expire,
1092 default_filter_kill_global and default_filter_kill_header.
1093 Read the section "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE
1094 VARIABLES" for a full explanation of these variables and
1095 "FILTERING ARTICLES" for more information on filtering.
1096 PageNextThd '^J' '<CR>'
1098 Go to next base article.
1099 PageNextUnread '<TAB>'
1101 Go to next unread article. If the tinrc variable
1102 goto_next_unread doesn't contain PageNextUnread, then this
1103 key will first page through the current article.
1104 SearchAuthF 'a'
1106 Author forward search.
1107 SearchAuthB 'A'
1109 Author backward search.
1110 SearchBody 'B'
1112 Search the body of all articles in group (can be slow). You
1113 can abort the search using Quit ('q').
1114 Catchup 'c'
1116 Mark the current thread as read [after confirmation] and
1117 return to the previous menu. Move cursor to next item.
1118 CatchupNextUnread 'C'
1120 Mark the rest of the current thread as read [after confirma‐
1121 tion] and enter the next thread with unread articles.
1122 PageCancel 'D'
1124 Cancel (delete) or supersede (overwrite) the current article.
1125 It must have been posted by the same user. The cancel message
1126 can be seen in the newsgroup 'control' or 'control.cancel'.
1127 PageEditArticle 'e'
1129 Edit the current article. This is restricted to mailgroups
1130 and saved news.
1131 EditFilter 'E'
1133 Edit the filter file and reload it afterwards.
1134 PageFollowupQuote 'f'
1136 Post a followup to the current article with a copy of the
1137 article included.
1138 PageFollowup 'F'
1140 Post a followup to the current article without including a
1141 copy of the article.
1142 PageFirstPage 'g'
1144 Go to the start of the article.
1145 PageLastPage 'G'
1147 Go to the end of the article.
1148 ToggleInfoLastLine 'i'
1150 Display the subject of the current article in the last line.
1151 ToggleInverseVideo 'I'
1153 Toggle inverse video.
1154 PageKillThd 'K'
1156 Mark rest of thread as read and move onto the next unread
1157 thread.
1158 PageListThd 'l'
1160 Show the thread menu that the current article is a part of.
1161 LookupMessage 'L'
1163 Look up article by ''Message-ID:''.
1164 PageMail 'm'
1166 Mail current article / thread / auto-selected (hot) articles
1167 / articles matching pattern / tagged articles to someone. See
1168 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
1169 ARTICLES" for more information.
1170 OptionMenu 'M'
1172 User configurable options menu (for more information see sec‐
1173 tion "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES").
1174 PageNextArt 'n'
1176 Go to the next article.
1177 PageNextUnreadArt 'N'
1179 Go to the next unread article.
1180 Print 'o' Send current article / thread / auto-selected (hot) articles
1182 / articles matching pattern / tagged articles to printer. See
1183 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
1184 ARTICLES" for more information.
1185 PagePrevArt 'p'
1187 Go to the previous article.
1188 PagePrevUnreadArt 'P'
1190 Go to the previous unread article.
1191 Quit 'q' Return to the previous level.
1193 QuitTin 'Q'
1195 Quit tin — don't ask the user to confirm.
1196 PageReplyQuote 'r'
1198 Reply through mail to the author of the current article with
1199 a copy of the article included.
1200 PageReply 'R'
1202 Reply through mail to the author of the current article with‐
1203 out including the original article.
1204 PageSave 's'
1206 Save current article / thread / auto-selected (hot) articles
1207 / articles matching pattern / tagged articles. See the sec‐
1208 tion "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
1209 for more information.
1210 PageAutoSave 'S'
1212 Save marked articles automatically without further prompting.
1213 PageTag 't'
1215 Toggle tag status of current article for mailing, piping,
1216 printing, saving or reposting.
1217 PageGroupSel 'T'
1219 Return to group selection level.
1220 PageGotoParent 'u'
1222 Go to parent article.
1223 PageViewUrl 'U'
1225 Display a list of URLs in the current article. See the sec‐
1226 tion "URL LISTING" for more information.
1227 PageViewAttach 'V'
1229 Display a list of attachments of the current article. See the
1230 section "ATTACHMENT LISTING" for more information.
1231 Post 'w' Post an article to the current group. If posting fails for
1233 some reason, you'll get the chance to edit the article again
1234 via PostEdit ('e'), postpone it for later processing via
1235 PostPostpone ('o') (see also ''-o'' command-line switch) or
1236 discard it via Quit ('q').
1237 PageRepost 'x'
1239 Repost an already posted article / thread / auto-selected
1240 (hot) articles / articles matching pattern / tagged articles
1241 to another newsgroup(s). Useful for reposting from global to
1242 local newsgroups. Do not use this to crosspost your own arti‐
1243 cles.
1244 MarkArtUnread 'z'
1246 Mark article as unread.
1247 MarkThdUnread 'Z'
1249 Mark the current thread as unread.
1250 URL LISTING
1252 PageViewUrl ('U') displays a list of URLs in the current article.
1253 Besides the common moving keys, the following commands are available:
1254 UrlSelect '^J' '<CR>'
1256 The current URL will be prompted and opened using the
1257 url_handler. '<ESC>' or no input will skip the URL.
1258 SearchSubjF '/'
1260 URL forward search.
1261 SearchSubjB '?'
1263 URL backward search.
1264 SearchRepeat '\'
1266 Repeat the previous search.
1267 ShellEscape '!'
1269 Shell escape.
1270 ToggleInfoLastLine 'i'
1272 Toggle the display of the current URL in the last line.
1273 Help 'h' Help screen of commands available.
1275 ToggleHelpDisplay 'H'
1277 Toggle the display of help mini menu at the bottom of the
1278 screen.
1279 ATTACHMENT LISTING
1281 PageViewAttach ('V') displays a list of attachments of the current
1282 article. Besides the common moving keys, the following commands are
1283 available:
1284 AttachPipe 'p'
1286 Pipe attachment into command.
1287 AttachSave 's'
1289 Save current attachment / tagged attachments to disk.
1290 AttachSelect '^J' '<CR>'
1292 View attachment.
1293 AttachTag 't'
1295 Tag one or more attachments for saving.
1296 AttachTagPattern '='
1298 Prompts for a pattern to match. All attachments whose
1299 name/description or content type/transfer encoding match
1300 the pattern will be tagged.
1301 AttachToggleTagged '@'
1303 Reverse tagging of all attachments.
1304 AttachUntag 'U'
1306 Untag all tagged attachments.
1307 SearchSubjF '/'
1309 Attachment forward search.
1310 SearchSubjB '?'
1312 Attachment backward search.
1313 SearchRepeat '\'
1315 Repeat the previous search.
1316 GlobalPipe '|'
1318 Pipe attachment into command. Uses the raw attachment, no
1319 decoding is done.
1320 ShellEscape '!'
1322 Shell escape.
1323 ToggleInfoLastLine 'i'
1325 Toggle the display of the name/description of the current
1326 attachment in the last line.
1327 Help 'h' Help screen of commands available.
1329 ToggleHelpDisplay 'H'
1331 Toggle the display of help mini menu at the bottom of the
1332 screen.
1333 GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES
1335 At startup, tin reads in the configuration files (see also tin(5)).
1336 They contain a list of variables that can be used to configure the way
1337 tin works. If it exists, the global configuration file, /etc/tin/tinrc
1338 is read. After that, the user's own configuration file is read from
1339 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc. The global file is useful for dis‐
1340 tributing system-wide defaults to new users who have no private tinrc
1341 yet.
1342 The variables are user configurable by editing ${TIN_HOME‐
1344 DIR:-"$HOME"}/.tin/tinrc directly. Most of them can also be set in the
1345 GLOBAL OPTIONS MENU which is accessed by pressing OptionMenu ('M') at
1346 all levels. It allows the user to customize the behavior of tin. The
1347 options are saved to the file ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc when
1348 you exit tin so don't edit the file directly whilst tin is running.
1349 In the options menu use the cursor keys in the usual way to move
1351 around. Use ConfigSelect ('^J' or '<CR>') to 'open' the option you wish
1352 to change. You will need to enter a new value or use '<SPACE>' to tog‐
1353 gle the available options. ConfigSelect will save the new value,
1354 '<ESC>' will abort without saving changes.
1355 As with the other menus, RedrawScr ('^L') will redraw the screen. You
1357 can use SearchSubjF ('/'), SearchSubjB ('?') and SearchRepeat ('\') to
1358 search for a specific option. Use Quit ('q') to exit the option menu
1359 and keep your changes. Use QuitTin ('Q') to exit without keeping your
1360 changes.
1361 The options menu provides access to the attributes menu for the current
1363 group by the ConfigToggleAttrib ('<TAB>') command. Pressing ConfigTog‐
1364 gleAttrib again toggles back to the options menu. For more information
1365 see section "ATTRIBUTES MENU AND GROUP ATTRIBUTES".
1366 The ConfigScopeMenu ('S') command brings up the scopes menu. For more
1368 information see section "SCOPES MENU".
1369 Here is a full list of all the available variables. The name in braces
1371 is the name of the corresponding setting in ${TIN_HOME‐
1372 DIR:-"$HOME"}/.tin/tinrc.
1373 Abbreviate long newsgroup names (abbreviate_groupname)
1375 If ON abbreviate long newsgroup names at group selection level and
1376 article level (if necessary) like this: news.software.readers ->
1377 n.software.readers -> n.s.readers -> n.s.r. Default is OFF.
1378 Add posted articles to filter (add_posted_to_filter)
1380 If ON add posted articles which start a new thread to filter for
1381 highlighting follow-ups. Default is ON.
1382 Insert 'User-Agent:'-header (advertising)
1384 Turn ON advertising in header (''User-Agent:''). Default is ON.
1385 Skip multipart/alternative parts (alternative_handling)
1387 If ON strip multipart/alternative messages automatically. Default
1388 is ON.
1389 Character to show deleted articles (art_marked_deleted)
1391 The character used to show that an article was deleted. Default is
1392 'D'.
1393 Character to show inrange articles (art_marked_inrange)
1395 The character used to show that an article is in a range. Default
1396 is '#'.
1397 Character to show returning arts (art_marked_return)
1399 The character used to show that an article will return as an unread
1400 article when the group is next entered. Default is '-'.
1401 Character to show selected articles (art_marked_selected)
1403 The character used to show that an article/thread is auto-selected
1404 (hot). Default is '*'.
1405 Character to show recent articles (art_marked_recent)
1407 The character used to show that an article/thread is recent (not
1408 older than X days). See also recent_time. Default is 'o'.
1409 Character to show unread articles (art_marked_unread)
1411 The character used to show that an article has not been read.
1412 Default is '+'.
1413 Character to show read articles (art_marked_read)
1415 The character used to show that an article was read. Default is '
1416 '.
1417 Character to show killed articles (art_marked_killed)
1419 The character used to show that an article was killed. Default is
1420 'K'. kill_level must be set accordingly.
1421 Character to show read selected arts (art_marked_read_selected)
1423 The character used to show that an article was hot before it was
1424 read. Default is ':'. kill_level must be set accordingly.
1425 Ask before using MIME viewer (ask_for_metamail)
1427 If ON tin will ask before using a MIME viewer (metamail_prog) to
1428 display MIME messages. This only occurs if a MIME viewer is set.
1429 Default is OFF.
1430 Send you a cc and/or bcc automatically (auto_cc_bcc)
1432 Automatically put your name in the ''Cc:'' and/or ''Bcc:'' field
1433 when mailing an article. Default is No.
1434 List thread using right arrow key (auto_list_thread)
1436 If ON automatically list thread when entering it using right arrow
1437 key. Default is ON.
1438 Reconnect to server automatically (auto_reconnect)
1440 Default is OFF.
1441 Use Archive-name: header for save (auto_save)
1443 If ON articles/threads with ''Archive-name:'' in header will be
1444 automatically saved with the Archive-name & part/patch no and post
1445 processed if post_process_type is set to something other than 'No'.
1446 Default is OFF.
1447 Save articles in batch mode (batch_save)
1449 If set ON articles/threads will be saved in batch mode when save
1450 ''-S'' or mail ''-M, -N'' is specified on the command line. Default
1451 is ON.
1452 Show mini menu & posting etiquette (beginner_level)
1454 If set ON a mini menu of the most useful commands will be displayed
1455 at the bottom of the screen for each level. Also a short posting
1456 etiquette will be displayed after composing an article. Default is
1457 ON.
1458 Cache NNTP overview files locally (cache_overview_files)
1460 If ON, create local copies of NNTP overview files. This can be used
1461 to considerably speed up accessing large groups when using a slow
1462 connection. See also "INDEX FILES". Default is OFF.
1463 Hash algorithm for cancel-locks (cancel_lock_algo)
1465 Use this hash algorithm for cancel-locks. Only available when build
1466 with cancel-lock support. none disables the generation of cancel-
1467 locks. Valid values are none, sha1, sha256 and sha512. Default is
1468 sha1.
1469 Catchup read groups when quitting (catchup_read_groups)
1471 If set ON the user is asked when quitting if all groups read during
1472 the current session should be marked read. Default is OFF.
1473 Standard background color (col_back)
1475 Standard background color
1476 Color of quoted text from external sources (col_extquote)
1478 Color of quoted text from external sources
1479 Color of sender (From:) (col_from)
1481 Color of sender (From:)
1482 Color of article header lines (col_head)
1484 Color of header-lines
1485 Color of help text (col_help)
1487 Color of help pages
1488 Color for inverse text (background) (col_invers_bg)
1490 Color of background for inverse text
1491 Color for inverse text (foreground) (col_invers_fg)
1493 Color of foreground for inverse text
1494 Color of highlighting with _dash_ (col_markdash)
1496 Color of words emphasized like _this_. See also word_h_dis‐
1497 play_marks and word_highlight.
1498 Color of highlighting with /slash/ (col_markslash)
1500 Color of words emphasized like /this/. See also word_h_dis‐
1501 play_marks and word_highlight.
1502 Color of highlighting with *stars* (col_markstar)
1504 Color of words emphasized like *this*. See also word_h_dis‐
1505 play_marks and word_highlight.
1506 Color of highlighting with -stroke- (col_markstroke)
1508 Color of words emphasized like -this-. See also word_h_dis‐
1509 play_marks and word_highlight.
1510 Color of mini help menu (col_minihelp)
1512 Color of mini help menu
1513 Color of actual news header fields (col_newsheaders)
1515 Color of actual news header fields
1516 Standard foreground color (col_normal)
1518 Standard foreground color
1519 Color of quoted lines (col_quote)
1521 Color of quoted lines
1522 Color of twice quoted line (col_quote2)
1524 Color of twice quoted lines
1525 Color of =>3 times quoted line (col_quote3)
1527 Color of >=3 times quoted lines
1528 Color of response counter (col_response)
1530 Color of response counter. This is the text that says "Response x
1531 of y" in the article viewer.
1532 Color of signatures (col_signature)
1534 Color of signatures
1535 Color of urls highlight (col_urls)
1537 Color of urls highlight
1538 Color of verbatim blocks (col_verbatim)
1540 Color of verbatim blocks
1541 Color of article subject lines (col_subject)
1543 Color of article subject
1544 Color of text lines (col_text)
1546 Color of text-lines
1547 Color of help/mail sign (col_title)
1549 Color of help/mail sign
1550 Which actions require confirmation (confirm_choice)
1552 Ask for manual confirmation to protect the user.
1553 · commands Ask for confirmation before executing certain danger‐
1555 ous commands (e.g., Catchup ('c')). Commands that this affects
1556 are marked in this manual with '[after confirmation]'. Default
1557 is commands & quit.
1558 · quit You'll be asked to confirm that you wish to exit tin when
1560 you use the Quit ('q') command.
1561 · select Ask for confirmation before marking all not selected
1563 (with GroupMarkUnselArtRead ('X') command) articles as read.
1564 Format string for display of dates (date_format)
1566 Format string tin uses for date representation. A description of
1567 the different format options can be found at strftime(3). tin uses
1568 strftime(3) when available and supports most format options in his
1569 fallback code. Default is "%a, %d %b %Y %H:%M:%S".
1570 (default_art_search)
1572 (default_author_search)
1574 (default_config_search)
1576 The last article/author/config option that was searched for.
1577 (default_filter_days)
1579 Default is 28.
1580 (default_filter_kill_case)
1582 Default for quick (1 key) kill filter case. ON = filter case sen‐
1583 sitive, OFF = ignore case. Default is OFF.
1584 (default_filter_kill_expire)
1586 Default for quick (1 key) kill filter expire. ON = limit to
1587 default_filter_days, OFF = don't ever expire. Default is OFF.
1588 (default_filter_kill_global)
1590 Default for quick (1 key) kill filter global. ON=apply to all
1591 groups, OFF=apply to current group. Default is ON.
1592 (default_filter_kill_header)
1594 Default for quick (1 key) kill filter header.
1595 0
1597 ''Subject:'' (case sensitive)
1598 1
1600 ''Subject:'' (ignore case)
1601 2
1603 ''From:'' (case sensitive)
1604 3
1606 ''From:'' (ignore case)
1607 4
1609 ''Message-ID:'' & full ''References:'' line
1610 5
1612 ''Message-ID:'' & last ''References:'' entry only
1613 6
1615 ''Message-ID:'' entry only
1616 7
1618 ''Lines:''
1619 (default_filter_select_case)
1621 Default for quick (1 key) auto-selection filter case. ON=filter
1622 case sensitive, OFF=ignore case. Default is OFF.
1623 (default_filter_select_expire)
1625 Default for quick (1 key) auto-selection filter expire. ON = limit
1626 to default_filter_days, OFF = don't ever expire. Default is OFF.
1627 (default_filter_select_global)
1629 Default for quick (1 key) auto-selection filter global. ON=apply
1630 to all groups, OFF=apply to current group. Default is ON.
1631 (default_filter_select_header)
1633 Default for quick (1 key) auto-selection filter header.
1634 0
1636 ''Subject:'' (case sensitive)
1637 1
1639 ''Subject:'' (ignore case)
1640 2
1642 ''From:'' (case sensitive)
1643 3
1645 ''From:'' (ignore case)
1646 4
1648 ''Message-ID:'' & full ''References:'' line
1649 5
1651 ''Message-ID:'' & last ''References:'' entry only
1652 6
1654 ''Message-ID:'' entry only
1655 7
1657 ''Lines:''
1658 (default_goto_group)
1660 (default_group_search)
1662 (default_mail_address)
1664 (default_move_group)
1666 (default_pattern)
1668 (default_pipe_command)
1670 (default_post_newsgroups)
1672 (default_post_subject)
1674 (default_range_group)
1676 (default_range_select)
1678 (default_range_thread)
1680 (default_repost_group)
1682 (default_save_file)
1684 (default_save_mode)
1686 (default_select_pattern)
1688 (default_shell_command)
1690 (default_subject_search)
1692 Draw -> instead of highlighted bar (draw_arrow)
1694 Allows groups/articles to be selected by an arrow '->' if set ON or
1695 by a highlighted bar if set OFF. Default is OFF.
1696 Invocation of your editor (editor_format)
1698 The format string used to create the editor start command with
1699 parameters. Default is "%E +%N %F" (e.g., /bin/vi +7 .article).
1700 Detection of external quotes (extquote_handling)
1702 If ON quotes from external sources will be detected. Default is
1703 OFF.
1704 Regex used to show external quotes (extquote_regex)
1706 A regular expression that will be applied when reading articles.
1707 All matching lines are shown in col_extquote. If extquote_regex is
1708 blank, then tin uses a built-in default.
1709 Force redraw after certain commands (force_screen_redraw)
1711 Specifies whether a screen redraw should always be done after cer‐
1712 tain external commands. Default is OFF.
1713 Number of articles to get (getart_limit)
1715 If getart_limit is > 0 not more than the last getart_limit arti‐
1716 cles/group are fetched from the server. If getart_limit is < 0 tin
1717 will start fetching articles from your first unread minus absolute
1718 value of getart_limit. Default is 0, which means no limit.
1719 Catchup group using left key (group_catchup_on_exit)
1721 If ON catchup group when leaving with the left arrow key. Default
1722 is ON.
1723 Format string for the Group level (group_format)
1725 Format string tin uses for Group level representation. See the sec‐
1726 tion "CUSTOMIZING THE SCREEN FORMAT". Default is
1727 "%n %m %R %L %s %F".
1728 Go to the next unread article with (goto_next_unread)
1730 Which keys tin should accept to jump to the next unread article.
1731 Possible is any combination of PageDown and PageNextUnread. When
1732 PageDown is set tin jumps to the next article at the end of the
1733 current one. When PageNextUnread is set tin jumps immediately to
1734 the next article when PageNextUnread ('<TAB>') is pressed. Default
1735 is PageNextUnread.
1736 Display uue data as an attachment (hide_uue)
1738 If set to 'No' then raw uuencoded data is displayed. If set to
1739 'Yes' then sections of uuencoded data will be shown with a single
1740 tag line showing the size and filename (much the same as a MIME
1741 attachment). If set to 'Hide all' then any line that looks like
1742 uuencoded data will be folded into a tag line. This is useful when
1743 uuencoded data is split across more than one article but can also
1744 lead to false positives. This setting can also be toggled in the
1745 article viewer. Default is 'No'.
1746 External inews (inews_prog)
1748 Path, name and options of external inews(1). If you are reading
1749 via NNTP the default value is "--internal" (use built-in NNTP
1750 inews), else it is "inews -h". The article is passed to inews_prog
1751 on STDIN via '< article'.
1752 (info_in_last_line)
1754 If ON, show current group description or article subject in the
1755 last line (not in the pager and global menu) — ToggleInfoLastLine
1756 ('i') toggles setting. This facility is useful as the full width of
1757 the screen is available to display long subjects. Default is OFF.
1758 Use interactive mail reader (interactive_mailer)
1760 Interactive mailreader: if greater than 0 your mailreader will be
1761 invoked earlier for reply so you can use more of its features (e.g.
1762 MIME, pgp, ...). 1 means include headers, 2 means don't include
1763 headers (old use_mailreader_i=ON option). 0 turns off usage. This
1764 option has to suit mailer_format. Default is 0.
1765 Use inverse video for page headers (inverse_okay)
1767 If ON use inverse video for page headers and URL highlighting.
1768 Default is ON.
1769 Keep failed arts in ~/dead.articles (keep_dead_articles)
1771 If ON keep all failed postings in ${TIN_HOME‐
1772 DIR:-"$HOME"}/dead.articles besides keeping the last failed posting
1773 in ${TIN_HOMEDIR:-"$HOME"}/dead.article. Default is ON.
1774 Filter which articles (kill_level)
1776 This option controls the processing and display of articles that
1777 are killed. There are 3 options:
1778 0 Kill only unread arts is the 'traditional' behavior of tin.
1780 Only unread articles are killed once only by marking them read.
1781 As filtering only happens on unread articles with kill_level
1782 set to 0, art_marked_killed and art_marked_read_selected are
1783 only shown once. When you reenter the group the mark will be
1784 gone.
1785 1 Kill all arts & show with K will process all articles in the
1787 group and therefore there is a processing overhead when using
1788 this option. Killed articles are threaded as normal but they
1789 will be marked with art_marked_killed.
1790 2 Kill all arts and never show will process all articles in the
1792 group and therefore there is a processing overhead when using
1793 this option. Killed articles simply does not get displayed at
1794 all.
1795 Default is 0 (Kill only unread arts).
1796 Use 8bit characters in mail headers (mail_8bit_header)
1798 Allows 8bit characters unencoded in the header of mail message.
1799 Default is OFF. Turning it ON is effective only if mail_mime_encod‐
1800 ing is also set to 8bit. Leaving it OFF is safe for most users and
1801 compliant to Internet Mail Standard (RFC5322 and RFC2047). Default
1802 is OFF.
1803 Mail address (mail_address)
1805 User's mail address (and full name), if not username@host. This is
1806 used when creating articles, sending mail and when pgp(1) signing.
1807 MIME encoding in mail messages (mail_mime_encoding)
1809 MIME encoding of the body in mail message, if necessary (8bit,
1810 base64, quoted-printable, 7bit). Default is quoted-printable.
1811 Quote line when mailing (mail_quote_format)
1813 Format of quote line when replying (via mail) to an article
1814 (%A=Address, %D=Date, %F=Fullname+Address, %G=Groupname, %M=Mes‐
1815 sage-ID, %N=Fullname, %C=Firstname, %I=Initials). Default is "In
1816 article %M you wrote:"
1817 Format of the mailbox (mailbox_format)
1819 Select one of the following mailbox-formats: MBOXO (default, except
1820 on SCO), MBOXRD or MMDF (default on SCO). See mbox(5) and RFC4155
1821 for more details on MBOXO and MBOXRD and mmdf(5) for more details
1822 about MMDF.
1823 Mail directory (maildir)
1825 The directory where articles/threads are to be saved in mbox(5)
1826 format. This feature is mainly for use with the elm(1) mail pro‐
1827 gram. It allows the user to save articles/threads/groups simply by
1828 giving '=' as the filename to save to. Default is ${TIN_HOME‐
1829 DIR:-"$HOME"}/Mail.
1830 Invocation of your mail command (mailer_format)
1832 The format string used to create the mailer command with parameters
1833 that is used for mailing articles to other people. Default is '%M
1834 "%T" < %F' (e.g., /bin/mail "iain" < .article). The flexible format
1835 allows other mailers with different command line parameters to be
1836 used such as
1837 sendmail -oem -t < %F
1838 elm -s "%S" "%T" < "%F"
1839 claws-mail --compose "mailto:%T?subject=%S&insert=%F"
1840 interactive_mailer must be set adequate. The following substitu‐
1841 tions are supported:
1842 %F filename
1843 %M default_mailer
1844 %S subject-field
1845 %T to-filed
1846 %U username
1847 %% %
1848 'Mark as (un)read' ignores tags (mark_ignore_tags)
1850 When this is ON, the GroupMarkThdRead ('K'), ThreadMarkArtRead
1851 ('K'), MarkThdUnread ('Z') at Group level and MarkArtUnread ('z')
1852 at Thread level functions mark just the current article or thread,
1853 ignoring other tagged, (un)read articles. When OFF, the same func‐
1854 tion presents a menu with choices of the current thread or article,
1855 all tagged, unread articles, or nothing.
1856 Mark saved articles/threads as read (mark_saved_read)
1858 If ON mark articles that are saved as read. Default is ON.
1859 Viewer program for MIME articles (metamail_prog)
1861 Path, name and options of external metamail(1) program used to view
1862 non-textual parts of articles. To use the built-in viewer, set to
1863 --internal. This is the default value when metamail(1) is not
1864 installed. Leave it blank if you don't want any automatic viewing
1865 of non-textual attachments. The 'V' command can always be used to
1866 manually view any attachments. See also ask_for_metamail.
1867 MM_CHARSET (mm_charset)
1869 Charset supported locally, which is also used for MIME header
1870 (charset parameter and charset name in header encoding) in mail and
1871 news postings. If MIME_STRICT_CHARSET is defined at compile time,
1872 text in charset other than the value of this parameter is consid‐
1873 ered not displayable and represented as '?'. Otherwise, all charac‐
1874 ter sets are regarded as compatible with the display. If it's not
1875 set, the value of the environment variable $MM_CHARSET is used. US-
1876 ASCII or compile-time default is used in case neither of them is
1877 defined. If your system supports iconv(3), this option is disabled
1878 and you should use mm_network_charset instead.
1879 MM_NETWORK_CHARSET (mm_network_charset)
1881 Charset used for posting and MIME headers; replaces mm_charset.
1882 Conversion between mm_network_charset and local charset (determined
1883 via nl_langinfo(3)) is done via iconv(3), if this function is not
1884 available on your system this option is disabled and you have to
1885 use mm_charset instead. mm_network_charset is limited to one of the
1886 following charsets:
1887 US-ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16}, KOI8-{R,U,RU}
1888 EUC-{CN,JP,KR,TW}, ISO-2022-{CN,CN-EXT,JP,JP-1,JP-2}, Big5,
1889 UTF-8
1890 Not all values might work on your system, see iconv_open(3) for
1891 more details. If it's not set, the value of the environment vari‐
1892 able $MM_CHARSET is used. US-ASCII or compile-time default is used
1893 in case neither of them is defined.
1894 Attribute of highlighting with _dash_ (mono_markdash)
1896 Character attribute of words emphasized like _this_. It depends on
1897 your terminal which attributes are usable. See also word_h_dis‐
1898 play_marks and word_highlight.
1899 Attribute of highlighting with /slash/ (mono_markslash)
1901 Character attribute of words emphasized like /this/. It depends on
1902 your terminal which attributes are usable. See also word_h_dis‐
1903 play_marks and word_highlight.
1904 Attribute of highlighting with *stars* (mono_markstar)
1906 Character attribute of words emphasized like *this*. It depends on
1907 your terminal which attributes are usable. See also word_h_dis‐
1908 play_marks and word_highlight.
1909 Attribute of highlighting with -stroke- (mono_markstroke)
1911 Character attribute of words emphasized like -this-. It depends on
1912 your terminal which attributes are usable. See also word_h_dis‐
1913 play_marks and word_highlight.
1914 (newnews)
1916 These are internal timers used by tin to keep track of new news‐
1917 groups. Do not change them unless you understand what they are
1918 for.
1919 Display these header fields (or *) (news_headers_to_display)
1921 Which news headers you wish to see. If you want to see _all_ the
1922 headers, place an '*' as this value. This is the only way a wild‐
1923 card can be used. If you enter 'X-' as the value, you will see all
1924 headers beginning with 'X-' (like X-Alan or X-Pape). You can list
1925 more than one by delimiting with spaces. Not defining anything
1926 turns off this option.
1927 Do not display these header fields (news_headers_to_not_display)
1929 Same as news_headers_to_display except it denotes the opposite. An
1930 example of using both options might be if you thought 'X-' headers
1931 were A Good Thing(tm), but thought Alan and Pape were miscreants...
1932 well then you would do something like this: news_headers_to_dis‐
1933 play=X- news_headers_to_not_display=X-Alan X-Pape Not defining any‐
1934 thing turns off this option.
1935 Quote line when following up (news_quote_format)
1937 Format of quote line when posting/following up an article
1938 (%A=Address, %D=Date, %F=Fullname+Address, %G=Groupname, %M=Mes‐
1939 sage-ID, %N=Fullname, %C=Firstname, %I=Initials). Default is "%F
1940 wrote:".
1941 NNTP read timeout in seconds (nntp_read_timeout_secs)
1943 Time in seconds to wait for a response from the server. Default is
1944 120. Setting this to 0 means no timeout.
1945 Unicode normalization form (normalization_form)
1947 The normalization form tin should use to normalize unicode input.
1948 The possible values are:
1949 0 None: no normalization
1951 1 NFKC: Compatibility Decomposition, followed by Canonical Compo‐
1953 sition
1954 2 NFKD: Compatibility Decomposition
1956 3 NFC: Canonical Decomposition, followed by Canonical Composition
1958 4 NFD: Canonical Decomposition
1960 5 NFKC_CF: Compatibility Decomposition, followed by Canonical
1962 Composition and Case Folding
1963 Some normalization modes are only available if they are supported by
1964 the library tin uses to do the normalization. NFC should be used if
1965 possible.
1966 Go to first unread article in group (pos_first_unread)
1968 If ON put cursor at first unread article in group otherwise at last
1969 article. Default is ON.
1970 Use 8bit characters in news headers (post_8bit_header)
1972 Allows 8bit characters unencoded in the header of a news article,
1973 if set this also disables the generation of MIME-headers when they
1974 are usually required. Default is OFF. Only enacted if
1975 post_mime_encoding is also set to 8bit. In a number of local hier‐
1976 archies where 8bit characters are used, using unencoded (raw) 8bit
1977 characters in header is acceptable and sometimes even recommended
1978 so that you need to check the convention adopted in the local hier‐
1979 archy of your interest to determine what to do with this and
1980 post_mime_encoding.
1981 MIME encoding in news messages (post_mime_encoding)
1983 MIME encoding of the body in news message, if necessary. (8bit,
1984 base64, quoted-printable, 7bit). Default is 8bit, which leads to no
1985 encoding. base64 and quoted-printable are usually undesired on
1986 usenet.
1987 View post-processed files (post_process_view)
1989 If ON, then tin will start an appropriate viewer program to display
1990 any files that were post processed and uudecoded. The program is
1991 determined using the mailcap(5) file. Default is ON.
1992 Post process saved articles (post_process_type)
1994 This specifies whether to perform post processing on saved arti‐
1995 cles. The following values are allowed:
1996 0 No (default), no post processing is done.
1998 1 Shell archives, unpacking of multi-part shar(1) files only.
2000 2 Yes, binary attachments and data will be decoded and saved.
2002 Filename to be used for storing posted articles (posted_articles_file)
2004 Keep posted articles in ${TIN_HOMEDIR:-"$HOME"}/Mail/posted_arti‐
2005 cles_file. If no filename is set then postings will not be saved.
2006 Default is 'posted'.
2007 Print all headers when printing (print_header)
2009 If ON, then the full article header is sent to the printer. Other‐
2010 wise only the ''Subject:'' and ''From:'' fields are output. Default
2011 is OFF.
2012 Printer program with options (printer)
2014 The printer program with options that is to be used to print arti‐
2015 cles. The default is lpr(1) for BSD machines and lp(1) for SysV
2016 machines. Printing from tin may have been disabled by the System
2017 Administrator.
2018 Process only unread articles (process_only_unread)
2020 If ON only save/print/pipe/mail unread articles (tagged articles
2021 excepted). Default is OFF.
2022 Show empty Followup-To in editor (prompt_followupto)
2024 If ON show empty ''Followup-To:'' header when editing an article.
2025 Default is OFF.
2026 Characters used as quote-marks (quote_chars)
2028 The character used in quoting included text to article followups
2029 and mail replies. The '_' character represents a blank character
2030 and is replaced with ' ' when read, %I is replaced by author's ini‐
2031 tials. Default is '>_'.
2032 Quoting behavior (quote_style)
2034 How articles should be quoted when following up or replying to
2035 them. There are a number of things that can be done: empty lines
2036 can be quoted, signatures can be quoted and quote_chars can be com‐
2037 pressed when quoting multiple times (for example, '> > >' will be
2038 turned into '>>>'). The default is to compress quotes, and to quote
2039 empty lines.
2040 When you are viewing an article in raw mode ('^H'), and follow up
2041 or reply to it, the signature will be quoted even if it would oth‐
2042 erwise not be. If show_signatures is off, then the signature will
2043 never be quoted.
2044 Regex used to show quoted lines (quote_regex)
2046 A regular expression that will be applied when reading articles.
2047 All matching lines are shown in col_quote. If quote_regex is blank,
2048 then tin uses a built-in default.
2049 Regex used to show twice quoted l. (quote_regex2)
2051 A regular expression that will be applied when reading articles.
2052 All matching lines are shown in col_quote2. If quote_regex2 is
2053 blank, then tin uses a built-in default.
2054 Regex used to show >= 3 times q.l. (quote_regex3)
2056 A regular expression that will be applied when reading articles.
2057 All matching lines are shown in col_quote3. If quote_regex3 is
2058 blank, then tin uses a built-in default.
2059 Article recentness time limit (recent_time)
2061 If set to 0, this feature is deactivated, otherwise it means the
2062 number of days. Default is 2.
2063 Render BiDi (render_bidi)
2065 If ON tin does the rendering of bi-directional text. If OFF tin
2066 leaves the rendering of bi-directional text to the terminal.
2067 Default is OFF.
2068 Interval in seconds to reread active (reread_active_file_secs)
2070 The news ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active} file
2071 is reread at regular intervals to show if any new news has arrived.
2072 Default is 1200. Setting this to 0 will disable this feature.
2073 Directory to save arts/threads in (savedir)
2075 Directory where articles/threads are saved. Default is ${TIN_HOME‐
2076 DIR:-"$HOME"}/News.
2077 Score limit (kill) (score_limit_kill)
2079 If the score of an article is below or equal this value the article
2080 gets marked as killed.
2081 Score limit (select) (score_limit_select)
2083 If the score of an article is above or equal this value the article
2084 gets marked as hot.
2085 Default score to kill articles (score_kill)
2087 Score of an article which should be killed, this must be <=
2088 score_limit_kill.
2089 Default score to select articles (score_select)
2091 Score of an article which should be marked hot, this must be >=
2092 score_limit_select.
2093 Number of lines to scroll in pager (scroll_lines)
2095 The number of lines that will be scrolled up/down in the article
2096 pager when using cursor-up/down. The default is 1 (line-by-line).
2097 Set to 0 to get traditional tin page-by-page scrolling. Set to -1
2098 to get page-by-page scrolling where the top/bottom line is carried
2099 over onto the next page. This setting supersedes
2100 show_last_line_prev_page=ON. Set to -2 to get half-page scrolling.
2101 This setting supersedes full_page_scroll=OFF.
2102 Format string for the Selection level (select_format)
2104 Format string tin uses for Selection level representation. See the
2105 section "CUSTOMIZING THE SCREEN FORMAT". Default is
2106 "%f %n %U %G %d".
2107 In group and thread level, show author by (show_author)
2109 Which information about the author should be shown. Default is 2,
2110 authors full name.
2111 0 None, only the ''Subject:'' line will be displayed.
2113 1 Address, ''Subject:'' line & the address part of the ''From:''
2115 line are displayed.
2116 2 Full Name, ''Subject:'' line & the authors full name part of
2118 the ''From:'' line are displayed (default).
2119 3 Address and Name, ''Subject:'' line & all of the ''From:'' line
2121 are displayed.
2122 Show description of each newsgroup (show_description)
2124 If ON show a short group description text after newsgroup name at
2125 the group selection level. The ''-d'' command-line flag will over‐
2126 ride the setting and turn descriptions off. The text used is taken
2127 from the ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups file and if supported
2128 (requires tin to be build with mh-mail-handling support) from
2129 ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups for mailgroups. Default is
2130 ON.
2131 Function for sorting articles (sort_function)
2133 Function used for sorting articles. Default is 0.
2134 0 Use qsort(3) for sorting.
2136 1 Use heapsort(3) for sorting. This might be faster in large
2138 groups with long threads (somewhat presorted data).
2139 Show lines/score in listings (show_info)
2141 Which information about the thread or article should be shown.
2142 Default is 1, show only the line count.
2143 0 None, no information will be displayed.
2145 1 Lines, in article listing the line count of an article will be
2147 displayed and in thread listing the line count of first
2148 (unread) article will be displayed.
2149 2 Score, in article listing the score of an article will be dis‐
2151 played and in thread listing the score of the thread will be
2152 displayed — see also thread_score.
2153 3 Lines & Score, display line count and score.
2155 Show only unread articles (show_only_unread_arts)
2157 If ON show only new/unread articles otherwise show all articles.
2158 Default is ON.
2159 Show only groups with unread arts (show_only_unread_groups)
2161 If ON show only subscribed groups that contain unread articles.
2162 Default is OFF.
2163 Display signatures (show_signatures)
2165 If OFF don't show signatures when displaying articles. Default is
2166 ON.
2167 Prepend signature with '\n-- \n' (sigdashes)
2169 If ON prepend the signature with sigdashes. Default is ON.
2170 Create signature from path/command (sigfile)
2172 The path that specifies the signature file to use when posting,
2173 following up to or replying to an article. If the path is a direc‐
2174 tory then the signature will be randomly generated from files that
2175 are in the specified directory. If the path starts with a ! the
2176 program the path points to will be executed to generate a signa‐
2177 ture. In order to pass the group name to the program, %G can be
2178 specified. This will be replaced by the name of the current news‐
2179 group. --none will suppress any signature. Default is ${TIN_HOME‐
2180 DIR:-"$HOME"}/.Sig.
2181 Add signature when reposting (signature_repost)
2183 If ON add signature to reposted articles. Default is ON.
2184 Regex used to highlight /slashes/ (slashes_regex)
2186 A regular expression that will be applied when reading articles.
2187 All matching words are shown in col_markslash or mono_markslash. If
2188 slashes_regex is blank, then tin uses a built-in default.
2189 Sort articles by (sort_article_type)
2191 This specifies how articles should be sorted. Sort by ascending
2192 Date (6) is the default. The following sort types are allowed:
2193 0 Nothing, don't sort articles.
2195 1 Subject: (descending), sort articles by ''Subject:'' field
2197 descending.
2198 2 Subject: (ascending), sort articles by ''Subject:'' field
2200 ascending.
2201 3 From: (descending), sort articles by ''From:'' field descend‐
2203 ing.
2204 4 From: (ascending), sort articles by ''From:'' field ascending.
2206 5 Date: (descending), sort articles by ''Date:'' field descend‐
2208 ing.
2209 6 Date: (ascending), sort articles by ''Date:'' field ascending
2211 (default).
2212 7 Score (descending), sort articles by filtering score descend‐
2214 ing.
2215 8 Score (ascending), sort articles by filtering score ascending.
2217 9 Lines: (descending), sort articles by ''Lines:'' field descend‐
2219 ing.
2220 10 Lines: (ascending), sort articles by ''Lines:'' field ascend‐
2222 ing.
2223 Sort threads by (sort_threads_type)
2225 This specifies how threads will be sorted. Sort by descending Score
2226 (1) is the default. The following sort types are allowed:
2227 0 Nothing, don't sort threads.
2229 1 Score (descending), sort threads by filtering score descending
2231 (default).
2232 2 Score (ascending), sort threads by filtering score ascending.
2234 3 Last posting date (descending), sort threads by date of last
2236 posting descending.
2237 4 Last posting date (ascending), sort threads by date of last
2239 posting ascending.
2240 Spamtrap warning address parts (spamtrap_warning_addresses)
2242 Set this option to a list of comma-separated strings to be warned
2243 if you are replying to an article by mail where the e-mail address
2244 contains one of these strings. The matching is case-insensitive.
2245 Example:
2246 spam,delete,remove
2248 Regex used to highlight *stars* (stars_regex)
2250 A regular expression that will be applied when reading articles.
2251 All matching words are shown in col_markstar or mono_markstar. If
2252 stars_regex is blank, then tin uses a built-in default.
2253 Start editor with line offset (start_editor_offset)
2255 Set ON if the editor used for posting, follow-ups and bug reports
2256 has the capability of starting and positioning the cursor at a
2257 specified line within a file. Default is ON.
2258 Strip blanks of end of lines (strip_blanks)
2260 Strips the blanks from the end of each line therefore speeding up
2261 the display when reading on a slow terminal or via modem. Default
2262 is ON.
2263 Remove bogus groups from newsrc (strip_bogus)
2265 Bogus groups are groups that are present in your ${TIN_HOME‐
2266 DIR:-"$HOME"}/.newsrc file that no longer exist on the news server.
2267 There are 3 options. 0 means do nothing & always keep bogus groups.
2268 1 means bogus groups will be permanently removed. 2 means that
2269 bogus groups will appear on the Group Selection Menu, prefixed with
2270 a 'D'. This allows you to unsubscribe from them as and when you
2271 wish. Default is 0 (Always Keep).
2272 No unsubscribed groups in newsrc (strip_newsrc)
2274 If ON, then unsubscribed groups will be permanently removed from
2275 your ${TIN_HOMEDIR:-"$HOME"}/.newsrc file. Default is OFF.
2276 Regex used to highlight -strokes- (strokes_regex)
2278 A regular expression that will be applied when reading articles.
2279 All matching words are shown in col_markstroke or mono_markstroke.
2280 If strokes_regex is blank, then tin uses a built-in default.
2281 Wrap around threads on next unread (wrap_on_next_unread)
2283 If enabled a search for the next unread article will wrap around
2284 all articles to find also previous unread articles. If disabled the
2285 search stops at the end of the thread list. Default is ON.
2286 Display "a as Umlaut-a (tex2iso_conv)
2288 If ON, show "a as Umlaut-a, etc. Default is OFF. This behavior can
2289 also be toggled in the article viewer via PageToggleTex2iso ('"').
2290 Thread articles by (thread_articles)
2292 Defines which threading method to use. It's possible to set the
2293 threading type on a per group basis by setting the group attribute
2294 variable thread_arts to 0 – 4 in the file ${TIN_HOME‐
2295 DIR:-"$HOME"}/.tin/attributes. (See also "GROUP ATTRIBUTES".) The
2296 default is Both Subject and References. The choices are:
2297 0 None, don't thread.
2299 1 Subject, thread on ''Subject:'' only.
2301 2 References, thread on ''References:'' only.
2303 3 Both Subject and References, thread on ''References:'' then
2305 ''Subject:'' (default).
2306 4 Multipart Subject, thread multipart articles on ''Subject:''.
2308 5 Percentage Match, thread base upon a partial character match on
2310 ''Subject:''.
2311 Catchup thread by using left key (thread_catchup_on_exit)
2313 If ON catchup group/thread when leaving with the left arrow key.
2314 Default is ON.
2315 Format string for the Thread level (thread_format)
2317 Format string tin uses for Thread level representation. See the
2318 section "CUSTOMIZING THE SCREEN FORMAT". Default is
2319 "%n %m [%L] %T %F".
2320 Matchingness of a thread (thread_perc)
2322 How closely the subjects must match for two threads to be consid‐
2323 ered part of the same thread. This is a percentage and the default
2324 if 75%.
2325 Score of a thread (thread_score)
2327 How the total score of a thread is computed. Default is 0, the max‐
2328 imum score in this thread.
2329 0 Max, the maximum score in this thread.
2331 1 Sum, the sum of all scores in this thread.
2333 2 Average, the average score in this thread.
2335 Transliteration (translit)
2337 If ON append //TRANSLIT to the first argument of iconv_open(3) to
2338 enable transliteration. This means that when a character cannot be
2339 represented in the target character set, it can be approximated
2340 through one or several similarly looking characters. On systems
2341 where this extension doesn't exist, this option is disabled.
2342 Default is OFF.
2343 How to treat blank lines (trim_article_body)
2345 Allows you to select how tin treats blank lines in article bodies.
2346 Default is 0. This option does not affect lines within verbatim
2347 blocks.
2348 0 Don't trim article body, do nothing.
2350 1 Skip leading blank lines.
2352 2 Skip trailing blank lines.
2354 3 Skip leading and trailing blank l., skip leading and trailing
2356 blank lines.
2357 4 Compact multiple between text, replace multiple blank lines
2359 between textblocks with one blank line.
2360 5 Compact multiple and skip leading, 4 + 1
2362 6 Compact multiple and skip trailing, 4 + 2
2364 7 Compact mltpl., skip lead. & trai., 4 + 3
2366 Regex used to highlight _underline_ (underscores_regex)
2368 A regular expression that will be applied when reading articles.
2369 All matching words are shown in col_markdash or mono_markdash. If
2370 underscores_regex is blank, then tin uses a built-in default.
2371 Remove ~/.article after posting (unlink_article)
2373 If ON remove ~/.article after posting. Default is ON.
2374 Program that opens URLs (url_handler)
2376 The program that will be run when launching URLs in the article
2377 viewer using PageViewUrl ('U'). The actual URL will be appended.
2378 Default is url_handler.pl.
2379 URL highlighting in message body (url_highlight)
2381 Enable highlighting URLs in message body. Default is ON.
2382 Use ANSI color (use_color)
2384 If enabled tin uses ANSI-colors. Default is OFF.
2385 Use scroll keys on keypad (use_keypad)
2387 Default is OFF.
2388 Use mouse in xterm (use_mouse)
2390 Allows the mouse button support in an xterm(1x) to be enabled/dis‐
2391 abled. Default is OFF.
2392 Use slrnface to show ''X-Face:''s (use_slrnface)
2394 If enabled tin uses slrnface(1) to interpret the ''X-Face:''
2395 header. For this option to have any effect, tin must be running in
2396 an xterm(1x) and slrnface(1) must be in your $PATH. Default is OFF.
2397 Use UTF-8 graphics (utf8_graphics)
2399 If ON use UTF-8 characters for indicator ('->'), thread/attachment
2400 tree and ellipsis ('...'). Default is OFF.
2401 Regex for begin of a verbatim block (verbatim_begin_regex)
2403 A regular expression that tin will use to find the begin of a ver‐
2404 batim block.
2405 Regex for end of a verbatim block (verbatim_end_regex)
2407 A regular expression that tin will use to find the end of a verba‐
2408 tim block.
2409 Detection of verbatim blocks (verbatim_handling)
2411 If ON verbatim blocks will be detected. Default is ON.
2412 Wildcard matching (wildcard)
2414 Allows you to select how tin matches strings. The default is 0 and
2415 uses the wildmat notation, which is how this has traditionally been
2416 handled. Setting this to 1 allows you to use perl(1) compatible
2417 regular expressions pcre(3) (see also perlre(1) and
2418 pcrepattern(3)). You will probably want to update your filter file
2419 if you use this regularly. NB: Newsgroup names will always be
2420 matched using the wildmat notation.
2421 What to display instead of mark (word_h_display_marks)
2423 Should the leading and ending stars, slashes, strokes and dashes
2424 also be displayed, even when they are highlighting marks?
2425 0 no
2427 1 yes, display mark
2429 2 print a space instead
2431 Word highlighting in message body (word_highlight)
2433 Enable word highlighting. See word_h_display_marks for the options
2434 available. If use_color is enabled the colors specified in
2435 col_markdash, col_markslash, col_markstar and col_markstroke are
2436 used for word highlighting else the character attributes specified
2437 in mono_markdash, mono_markslash, mono_markstar and mono_markstroke
2438 are used. Default is ON.
2439 Page line wrap column (wrap_column)
2441 Sets the column at which a displayed article body should be
2442 wrapped. If this value is equal to 0, it defaults to the current
2443 screen width. If this value is greater than your current screen
2444 width the part off-screen is not displayed. Thus setting this
2445 option to a large value can be used to disable wrapping. If this
2446 value is negative the wrap margin is the current screen width plus
2447 the given value (as long as the result is still positive, otherwise
2448 it will fall back to the current screen width). Default is 0, wrap‐
2449 ping at the current screen width.
2450 Quote line when crossposting (xpost_quote_format)
2452 Format is the same as for news_quote_format, this is used when
2453 answering to a crossposting to several groups with no ''Fol‐
2454 lowup-To:'' set.
2455 ATTRIBUTES MENU AND GROUP ATTRIBUTES
2457 tin allows certain attributes to be set on a per group basis. If it
2458 exists, the global attributes file, ${TIN_LIBDIR:-NEWSLIB‐
2459 DIR}/attributes is read. After that, the user's own attributes file
2460 ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes is read. The global attributes
2461 file is useful for distributing system-wide defaults to new users who
2462 have no private attributes file yet.
2463 Note that the scope=<grouplist> line has to be specified before the
2465 attributes are specified for that list. All attributes are set to a
2466 reasonable default so you only have to specify the attribute that you
2467 want to change (e.g., savedir). All toggle attributes are set by speci‐
2468 fying ON/OFF. Otherwise, these function exactly the same as their
2469 global equivalents. For more details see tin(5).
2470 Attributes can also be changed from the attributes menu which can be
2472 accessed by ConfigToggleAttrib ('<TAB>') from the options menu or
2473 ScopeSelect ('^J' or '<CR>') from the scopes menu. The attributes menu
2474 looks and behaves very similar to the options menu. The title shows the
2475 current scope. Attributes set in the current scope are marked with '+'
2476 to the left of the attributes number.
2477 Besides the keys for moving around and changing values known from the
2479 options menu the attributes menu provides the following command: Confi‐
2480 gResetAttrib ('r') which resets an attribute to a default value.
2481 SCOPES MENU
2483 The scopes menu (accessible from the options menu with ConfigScopeMenu
2484 ('S')) shows all scopes read from the global and local attributes file.
2485 Scopes from the global attributes file are marked with '!' to the left
2486 of the scope number. Delete/rename/move are not possible with those
2487 scopes.
2488 In addition to the common moving keys the following commands are avail‐
2490 able: ScopeSelect ('^J' or '<CR>') enter the attributes menu for the
2491 current scope, ScopeEditAttributesFile ('E') edit the local attributes
2492 file, ScopeAdd ('a') add a new scope, ScopeDelete ('d') delete the cur‐
2493 rent scope, ScopeMove ('m') move the current scope to a new position,
2494 ScopeRename ('r') rename the current scope. ToggleHelpDisplay ('H')
2495 toggles the help mini menu at the bottom of the screen.
2496 FILTERING ARTICLES
2498 When there is a subject or an author which you are either very inter‐
2499 ested in, or find completely uninteresting, you can easily instruct tin
2500 to auto-select or auto-kill articles that match rules that you specify.
2501 This can be anything from the name of the author to the number of lines
2502 in an article.
2503 When tin starts up the user's kill-file ${TIN_HOME‐
2505 DIR:-"$HOME"}/.tin/filter (see also tin(5)) is read. Each time a news‐
2506 group is entered the rules are applied and articles killed or selected
2507 when they meet certain criteria.
2508 The degree to which rules are applied depend on the kill_level tinrc
2510 setting. By default killed articles will only be marked read. Adjust
2511 kill_level for more aggressive processing. Articles that match an auto-
2512 selection rule are marked with a ''*''.
2513 Filtering rules can be manually entered into ${TIN_HOME‐
2515 DIR:-"$HOME"}/.tin/filter (but don't do this whilst running tin else
2516 you will lose your changes) or by using an on-screen menu within tin.
2517 The filtering capabilities of tin have been significantly enhanced over
2519 previous versions to include scoring and better pattern matching. It is
2520 recommended that you read the file filtering in the tin documentation
2521 directory. This file can also be read online at
2522 <http://www.tin.org/filtering.txt>.
2523 The on-screen filtering menu is accessed by pressing MenuFilterKill
2525 ('^K') or MenuFilterSelect ('^A') at the Group and Article levels. It
2526 allows the user to kill or select an article that matches the current
2527 ''Subject:'' line, ''From:'' line or a string entered by the user. The
2528 user entered string can be applied to the ''Subject:'' or ''From:''
2529 line of an article. The filter can be limited to the current newsgroup
2530 or it can apply to all newsgroups. Once entered the user can abort the
2531 command and not save the new filter, edit the full filter file or save
2532 filter.
2533 POSTING ARTICLES
2535 tin allows posting of articles, follow-up to already posted articles
2536 and replying direct through mail to the author of an article.
2537 Use the Post ('w') command to post an article to a newsgroup. After
2539 entering the post subject the default editor (i.e., vi(1)) or the edi‐
2540 tor specified by the $VISUAL or $EDITOR environment variable will be
2541 started and the article can be entered. To crosspost articles simply
2542 add a comma and the name of the newsgroup(s) to the end of the ''News‐
2543 groups:'' line at the beginning of the article. After saving and exit‐
2544 ing the editor you are asked if you wish to a)bort posting the article,
2545 e)dit the article again or p)ost the article to the specified news‐
2546 group(s).
2547 Use the DisplayPostHist ('W') command to display a history of the arti‐
2549 cles you have posted. The date the article was posted, which newsgroups
2550 the article was posted to and the articles subject line are displayed.
2551 Use the PageFollowupQuote ('f'), PageFollowup ('F') or PageFol‐
2553 lowupQuoteHeaders ('^W') command to post a follow-up article to an
2554 already posted article. The PageFollowupQuote command will copy the
2555 text of the original article into the editor. The PageFollowupQuote‐
2556 Headers command will copy the text and all headers of the original
2557 article into the editor. The editing procedure is the same as when
2558 posting an article with the Post ('w') command.
2559 Use the PageReplyQuote ('r'), PageReply ('R') or PageReplyQuoteHeaders
2561 ('^E') command to reply direct through mail to the author of an already
2562 posted article. The PageReplyQuote command will copy the text of the
2563 original article into the editor. The PageReplyQuoteHeaders command
2564 will copy the text and all headers of the original article into the
2565 editor. The editing procedure is the same as when posting an article
2566 with the Post ('w') command. After saving and exiting the editor you
2567 are asked if you wish to abort sending the article via PostAbort ('a'),
2568 edit the article again via PostEdit ('e') or send the article to the
2569 author via PostSend ('s').
2570 CUSTOMIZING THE ARTICLE QUOTE STRING
2572 When posting a followup to an article or replying direct to the author
2573 of an article via email the text of the article can be quoted. The
2574 beginning of the quoted text can contain information about the quoted
2575 article (e.g., Name and the Message-ID of the article). To allow for
2576 different situations certain information from the article can be used
2577 in the quoted string. The following variables are expanded if found in
2578 the tinrc variables mail_quote_format, news_quote_format or
2579 xpost_quote_format:
2580 %A Address (Email)
2581 %D Date (uses date_format)
2582 %F Full address (%N <%A>)
2583 %G Groupname
2584 %M Message-ID
2585 %N Fullname of author
2586 %C Firstname of author
2587 %I Initials of author
2588 e.g.,
2589 mail_quote_format=On %D in %G you wrote:
2590 news_quote_format=In %M, %F wrote:
2591 would expand to:
2592 On 21 Sep 1993 09:45:51 -0400 in alt.sources you wrote:
2593 In <abcINN123@example.org>, Joe Bar <joe@example.org> wrote:
2594 The quoted text section of an article is marked by a preceding quote
2595 string at the beginning of each quoted line. The default quote string
2596 is set to '>_'. The default can be changed by setting the tinrc vari‐
2597 able quote_chars to ones own preference. (Note that '_' underline is
2598 used to represent a space).
2599 MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES
2601 The command interface to GroupMail, PageMail, PostMail or ThreadMail
2602 ('m'), Pipe ('|'), Print ('o'), PageRepost or GroupRepost ('x') and
2603 GroupSave, PageSave or ThreadSave ('s' and GroupAutoSave, PageAutoSave
2604 or ThreadAutoSave 'S') articles is the same for ease of use.
2605 Auto-saving with *AutoSave ('S') is a special case and operates only on
2607 marked articles. They will processed without any further prompting
2608 according to the default save parameters defined in tinrc or by any
2609 attributes set for the current group.
2610 Otherwise, the initial prompt will ask you to select which article,
2612 thread, hot (auto-selected), regular expression pattern, tagged arti‐
2613 cles you wish to mail, pipe etc.
2614 Tagged articles must have already been tagged with a *Tag ('t') com‐
2616 mand. All tagged articles can be untagged by a *Untag ('U') untag com‐
2617 mand.
2618 If a regular expression pattern is selected you are asked to enter a
2620 pattern (e.g., to match all articles subject lines containing 'net
2621 News' you enter "net News"). Any articles that match the entered
2622 expression will be mailed, piped etc. See also the wildcard tinrc vari‐
2623 able for advanced pattern matching options.
2624 Various expansion characters are recognized when entering the directory
2626 and file to save to. Environment variables (prefixed with '$') and user
2627 home directories (prefixed by '~' or '~username') can be specified.
2628 Environment variables can themselves contain other special characters.
2629 To save articles to a mailbox enter '=<mailbox name>' when asked for
2631 the save filename. If you enter just '=' then articles will be saved to
2632 a mailbox with the name of the current newsgroup (eg, alt.sources).
2633 See maildir.
2634 To save in savedir/<news.group.name>/<filename> format enter '+<file‐
2636 name>'. See savedir. Like '+' %G is expanded to the current
2637 news.group.name but without savedir prefixed. %P is expanded to the
2638 news.group.name with all '.' replaced by '/'.
2639 If saving multiple files at once the filename (if not referring to a
2641 mailbox) will be extended by ".num" where "num" is a at least 3 digit
2642 number counting up from 1. Environment variables are allowed within a
2643 filename (e.g., $SOURCES/dir/filename).
2644 When saving articles you can specify whether the saved files should be
2646 post processed. A default process type can be set via
2647 post_process_type.
2648 AUTOMATIC MAILING AND SAVING NEW NEWS
2650 tin allows new/unread news articles to be mailed (''-M'' and ''-N''
2651 option) or saved (''-S'' option) in batch mode for later reading. Use‐
2652 ful when going on holiday and you don't want to return and find that
2653 expire has removed a whole load of unread articles. Best to run via
2654 cron(8) everyday while away, after which you will be mailed a report of
2655 which articles were mailed/saved from which newsgroups and the total
2656 number of articles mailed/saved. Articles are saved in a private news
2657 structure under your savedir directory (default is ${TIN_HOME‐
2658 DIR:-"$HOME"}/News). Be careful of using this option if you read a lot
2659 of groups because you could overflow your file system.
2660 When using ''-S'' together with a given directory to save to (''-s''
2662 option), the same directory must be specified when reading the articles
2663 by ''-R''.
2664 If you only want to save some of your groups use the batch_save tinrc
2666 variable. Set to ON or OFF in tinrc to enable/disable saving of all
2667 groups and then use the batch_save attribute to fine tune which groups
2668 you want to have saved. For example, if you want to save most of your
2669 groups, then set batch_save to ON in tinrc and selectively turn off the
2670 ones you don't want using attributes.
2671 tin -M iain -c -f newsrc.mail
2673 (mail any unread articles in newsgroups specified
2674 in file newsrc.mail to the local user iain and mark
2675 them as read)
2676 tin -S -c -f newsrc.save
2678 (save any unread articles in newsgroups specified
2679 in file newsrc.save and mark them as read)
2680 tin -R (read any articles saved by tin -S)
2682 RANGES
2684 A range is simply a group of items marked using the SetRange ('#') key.
2685 Certain tin commands will operate on a range if one exists rather than
2686 just the current item. A range is an expression of the form
2687 <min>–<max>, e.g. 10–15 will highlight items 10 through 15 on the cur‐
2688 rent screen. Other than absolute numeric positions, '.' can be used in
2689 place of the current cursor position and '$' can be used to mean the
2690 highest number available. Currently the only commands that understand
2691 ranges are GroupMarkThdRead ('K'), MarkArtUnread ('z') and MarkThdUn‐
2692 read ('Z').
2693 NEWSGROUP LISTS & WILDCARDS
2695 Several places in tin allow you to specify a list of newsgroups. These
2696 include command-line groups, (un)subscribe groups, the AUTO[UN]SUB‐
2697 SCRIBE mechanism. The scope= attributes file tag and the filter file
2698 group= tag also use the same syntax. tin interprets this variable simi‐
2699 larly to rn(1). It contains a list of patterns, separated by commas
2700 and possibly prefixed with exclamation points. An exclamation point
2701 negates the meaning of a match on this pattern, and can be used to can‐
2702 cel certain matches. Some examples:
2703 alt.config,news.*,!news.test
2705 Matches alt.config and everything in the 'news' hierarchy except
2707 news.test
2708 See the explanation for the $AUTOSUBSCRIBE variables for further exam‐
2710 ples.
2711 SIGNATURES
2713 tin will recognize a signature in either ${TIN_HOMEDIR:-"$HOME"}/.sig‐
2714 nature or ${TIN_HOMEDIR:-"$HOME"}/.Sig. If ${TIN_HOME‐
2715 DIR:-"$HOME"}/.signature exists, then the signature will be pulled into
2716 the editor for mail commands only. A signature in ${TIN_HOME‐
2717 DIR:-"$HOME"}/.signature will not be pulled into the editor for posting
2718 commands since inews(1) will append the signature itself.
2719 A signature in ${TIN_HOMEDIR:-"$HOME"}/.Sig will be pulled into the
2721 editor for both posting and mailing commands.
2722 The following is an example of a .Sig file:
2724 NAMES Joe Bar <joe@example.org>
2725 SNAIL Musterweg 12, 99999 Notreal, Germany
2726 tin also has the capability to generate random signatures on a per
2728 newsgroup basis if so desired. The way to accomplish this is to specify
2729 the default signature or the group attribute sigfile as a directory. If
2730 for example the sigfile path is /usr/iain/.sigs and .sigs is a direc‐
2731 tory then tin will select a random signature from any file that is in
2732 the directory .sigs (note: one signature per numbered file). A random
2733 signature can also consist of a fixed part signature that can contain
2734 your name, address etc. followed by the random sig. The fixed part of
2735 the random sig is read from the file $HOME/.sigfixed.
2736 CUSTOMIZING THE SCREEN FORMAT
2738 The look of the Selection, Group and Thread level can be customized via
2739 format strings. These format strings define the content and the posi‐
2740 tion of each element on the screen. Variables are used within the for‐
2741 mat strings as placeholders. The following variables are available:
2742 %D date
2744 %F from, name and/or address
2745 %G newsgroup name
2746 %I initials
2747 %L line count
2748 %M message-id
2749 %R number of responses in thread
2750 %S score
2751 %T thread tree
2752 %U unread count
2753 %d newsgroup description
2754 %f newsgroup flag
2755 %m article marks
2756 %n current group/thread/article number
2757 %s subject
2758 %% %
2759 Not all variables can be used in each level. The following table pro‐
2761 vides an overview:
2762 select_format group_format thread_format
2764 %D X X
2765 %F X X
2766 %G X
2767 %I X X
2768 %L X X
2769 %M X X
2770 %R X
2771 %S X X
2772 %T X
2773 %U X
2774 %d X
2775 %f X
2776 %m X X
2777 %n X X X
2778 %s X
2779 %% X X X
2780 Defaults for the format strings:
2782 select_format: "%f %n %U %G %d"
2784 group_format: "%n %m %R %L %s %F"
2785 thread_format: "%n %m [%L] %T %F"
2786 show_description controls whether the newsgroup description is shown or
2788 not. The description can also be toggled with SelectToggleDescriptions
2789 ('d').
2790 The information displayed with '%F' depends on the value of
2792 show_author. GroupToggleSubjDisplay resp. ThreadToggleSubjDisplay
2793 ('d') switches through all available options.
2794 For date representation '%D' uses date_format. It is possible to spec‐
2796 ify a different date format in round brackets (e.g. '%(%d %b %y
2797 %H:%M)D'). See date_format for more details.
2798 The length of each item (except '%%') can be defined with a positive
2800 number after the '%'. The following example displays the score in the
2801 thread level 10 characters wide: '%10S'.
2802 If the newsgroup name is displayed together with the newsgroup descrip‐
2804 tion, the width of the newsgroup name can be controlled via an optional
2805 comma separated second value (e.g. '%60,20G'). It is valid to omit the
2806 first value (e.g. ('%,20G')). If no second value is given, tin uses a
2807 default value of 32.
2808 Some variables do have a default width which may lead to truncation.
2810 Truncation for variables which contain only numbers happens by dividing
2811 the value with a sufficient power of ten and adding a SI suffix to the
2812 result, that is the variable holds a value of 54321 and the width for
2813 the variable is 4 the result will be "54 k". If that's undesired you
2814 have to specify a larger width manually, e.g. '%6n'. Here is an over‐
2815 view of the defaults:
2816 Variable width
2818 %I 3
2819 %L 4
2820 %M 10
2821 %R 3
2822 %S 6
2823 %U 5
2824 %n 4
2825 If no length is given for '%D', the length is determined by the format
2827 string for the date and the date of the current day. If the date format
2828 string contains weekdays or months names it may happen that the date is
2829 longer than determined in the first pass. In this case, the date is
2830 truncated before display. This occurs, for example, if the current
2831 month is May and the article to which the date is displayed was posted
2832 in December. In such cases it might useful to determine the maximum
2833 length manually and specify the length in the format string.
2834 In case the format string contains '%G' and '%d' and no length are
2836 given, tin determines the longest newsgroup name and uses this length
2837 for '%G'. The remaining space will used for '%d'.
2838 When the format string contains the specifier '%F' and '%s' resp. '%T'
2840 and no length are given, '%F' will use one third and '%s' resp. '%T'
2841 will use two third of the available space.
2842 In addition, a minimum screen width can be defined for each item
2844 (except '%%'). In this case, the item will only be displayed when the
2845 screen is wider than specified. This comes in handy to not overload a
2846 small screen but have maximum information on a large screen. The mini‐
2847 mum screen width has to be specified by a positive number preceded by
2848 an '>'. In the following example tin will display the score only if the
2849 screen is wider than 100 characters: '%>100S'.
2850 If both the length and the minimum screen width should be specified for
2852 an item, the length must be the first parameter and the minimum screen
2853 width must be the second one. The following example displays the score
2854 with a length of 10 characters only if the screen is wider than 100
2855 characters: '%10>100S'.
2856 TIPS AND TRICKS
2858 tin can be pretty much be navigated by using the four cursor keys. The
2859 left arrow key goes up a level, the right arrow key goes down a level,
2860 the up arrow key goes up a line and the down arrow key goes down a
2861 line.
2862 The following newsgroups provide useful information concerning news
2864 software:
2865 —news.software.readers (info. about news user agents tin, rn, nn,
2866 slrn etc.)
2867 —news.software.nntp (info. about NNTP)
2868 —news.answers (Frequently Asked Questions (FAQ) about many differ‐
2869 ent themes)
2870 Many prompts within tin offer a default choice that the cursor is posi‐
2872 tioned on. By pressing '<CR>' the default value is taken. Most prompts
2873 can be aborted by pressing '<ESC>'.
2874 When tin is run in an xterm(1x) it will resize itself each time the
2876 xterm(1x) is resized.
2877 tin will reread the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE‐
2879 FILE:-active} file at set intervals (reread_active_file_secs) to show
2880 any newly arrived news.
2881 If you find large number of new newsgroups cluttering up your screen,
2883 pressing SelectToggleReadDisplay ('r') will make them go away.
2884 XTERM BUTTONS
2886 If the environment variable $TERM is set to xterm(1x), then button
2887 pressing can be used to select groups and articles. In this discussion,
2888 the buttons are assumed to be assigned conventionally (i.e., Button1 is
2889 the left button).
2890 In general (i.e., for the group, thread and article menus),
2892 Button1 (left)
2894 enters next (lower) level if you click on an article, other‐
2895 wise pages down.
2896 Button2 (center)
2898 returns to the previous (upper) level if you click on an
2899 article, otherwise pages up.
2900 Button3 (right)
2902 positions on the article line under mouse cursor, or pages
2903 down if you've clicked outside the list of articles.
2904 In the group selection menu, if the mouse is pointing at a group then:
2906 left button
2908 moves to and selects the group pointed at, just like Selec‐
2909 tReadGrp ('<CR>').
2910 center button
2912 quits the program, just like Quit ('q').
2913 right button
2915 moves to the group pointed at.
2916 In the article menu, if the mouse is pointing at an article (or thread)
2918 then:
2919 left button
2921 reads the article pointed at, just like GroupReadBasenote
2922 ('<CR>'), or the thread, just like GroupListThd ('l').
2923 center button
2925 exits the menu, catching up on the group if you have
2926 group_catchup_on_exit set in your configuration, just like
2927 Quit ('q').
2928 right button
2930 moves to the article (or thread) pointed at.
2931 In the thread menu, if the mouse is pointing at an article then:
2933 left button
2935 reads article pointed at, just like ThreadReadArt ('<CR>').
2936 center button
2938 exits the menu, catching up on the thread if you have
2939 thread_catchup_on_exit set in your configuration, just like
2940 Quit ('q').
2941 right button
2943 moves to the article pointed at.
2944 In other menus and areas button pressing reverts back to usual cut and
2946 paste of xterm(1x), but after one click of any button.
2947 INDEX FILES
2949 If your news server supports NOV index files (see newsoverview(5), most
2950 modern installations will) and you have a fast connection to your news
2951 server then this section can be ignored.
2952 If your news server doesn't support NOV index files or you have a very
2954 slow connection to your news server then tin can cache the index for
2955 each newsgroup if cache_overview_files is set to ON. Note that this
2956 cache can use up large amounts of disk space if you read a lot of
2957 groups and/or high traffic groups.
2958 Each user creates/updates his/her own index files that are stored in
2960 ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news/. If you are
2961 reading via NNTP then the news server name will be appended to keep the
2962 indexes for different servers separate. If you are reading off the
2963 local spool and local overview files already exist then turning on
2964 caching will have no effect. Likewise unless you see significant delays
2965 entering a group when reading via NNTP then turning on caching will
2966 have little or no effect.
2967 Entering a group the first time tends to be slow because the index file
2969 must be built from scratch. To alleviate the slowness start tin to cre‐
2970 ate all index files for the groups you subscribe to with tin -u -v and
2971 go for a coffee. Subsequent readings of a group will only need to do
2972 incremental updating of the index file and will be much faster as only
2973 new articles will need to be cached.
2974 As indexing might take some time you may want to run tin form the sys‐
2976 tem batcher cron(8) with the ''-u'' option:
2977 30 6 * * * /usr/local/bin/tin -u
2979 If you are low on local disk space you should consider to manually
2981 purge cached data for groups you are not reading anymore with something
2982 like:
2983 find ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news* \
2985 -type f -name "[0-9]*.[0-9]" -atime +28 | xargs rm -f
2986
2988 For a detailed description see tin(5).
2989 $MAILCAPS
2991 ~/.mailcap
2992 /etc/mailcap
2993 /usr/etc/mailcap
2994 /usr/local/etc/mailcap
2995 /etc/mail/mailcap
2996 /etc/nntpserver
2998 ${TIN_HOMEDIR:-"$HOME"}/.cancelsecret
3000 ${TIN_HOMEDIR:-"$HOME"}/.mime.types
3002 /etc/mime.types
3003 /etc/tin/mime.types
3004 ${TIN_HOMEDIR:-"$HOME"}/.newsauth
3006 ${TIN_HOMEDIR:-"$HOME"}/.newsrc
3008 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/.oldnewsrc
3010 ${TIN_HOMEDIR:-"$HOME"}/.signature
3012 ${TIN_HOMEDIR:-"$HOME"}/.Sig
3013 ${TIN_HOMEDIR:-"$HOME"}/.sigfixed
3015 ${TIN_HOMEDIR:-"$HOME"}/.tin/.inputhistory
3017 ${TIN_INDEX_MAILDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.mail/
3019 ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news${NNTPSERVER:+"-$NNTPSERVER"}/
3021 ${TIN_INDEX_SAVEDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.save/
3023 ${TIN_HOMEDIR:-"$HOME"}/.tin/active.mail
3025 ${TIN_HOMEDIR:-"$HOME"}/.tin/active.save
3027 /etc/tin/attributes
3029 ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes
3030 ${TIN_HOMEDIR:-"$HOME"}/.tin/filter
3032 /etc/tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
3034 ${TIN_HOMEDIR:-"$HOME"}/.tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
3035 ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups
3037 ${TIN_HOMEDIR:-"$HOME"}/.tin/newsrctable
3039 ${TIN_HOMEDIR:-"$HOME"}/.tin/posted
3041 ${TIN_HOMEDIR:-"$HOME"}/Mail/posted
3043 ${TIN_HOMEDIR:-"$HOME"}/.tin/postponed.articles
3045 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER:${NNTPPORT:+":$NNTPPORT"}/newsgroups
3047 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER:${NNTPPORT:+":$NNTPPORT"}/serverrc
3049 /etc/tin/tinrc
3051 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc
3052 /etc/tin/tin.defaults
3054 /usr/local/share/locale/${LC_MESSAGES}/LC_MESSAGES/tin.mo
3056 ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active}
3058 ${TIN_LIBDIR:-NEWSLIBDIR}/active.times
3060 ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups
3062 ${TIN_LIBDIR:-NEWSLIBDIR}/organization
3064 ${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt
3066 ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions
3068
3070 TINRC Define this variable if you want to specify command-line options
3071 that tin should be started with to save typing them each time it
3072 is started. The contents of the environment variable are added
3073 to the front of the command-line options before it is parsed
3074 therefore allowing an option specified on the command-line to
3075 override the same option specified in the environment.
3076 TIN_HOMEDIR
3078 Define this variable if you do not want the .tin directory in
3079 $HOME/. E.g., if you want all tin's private files in /tmp/.tin
3080 you would set $TIN_HOMEDIR to /tmp.
3081 TIN_INDEX_NEWSDIR
3083 Define this variable if you do not want the .news directory in
3084 ${TIN_HOMEDIR:-"$HOME"}/.tin/. E.g., if you want all tin's news
3085 index files in /tmp/.news you would set $TIN_INDEX_NEWSDIR to
3086 /tmp.
3087 TIN_INDEX_MAILDIR
3089 Define this variable if you do not want the .mail directory in
3090 ${TIN_HOMEDIR:-"$HOME"}/.tin/. E.g., if you want all tin's mail
3091 index files in /tmp/.mail you would set $TIN_INDEX_MAILDIR to
3092 /tmp.
3093 TIN_INDEX_SAVEDIR
3095 Define this variable if you do not want the .save directory in
3096 ${TIN_HOMEDIR:-"$HOME"}/.tin/. E.g., if you want all tin's save
3097 index files in /tmp/.save you would set $TIN_INDEX_SAVEDIR to
3098 /tmp.
3099 TIN_LIBDIR
3101 Define this variable if you want to override the NEWSLIBDIR path
3102 that was compiled into the tin binary, default is /usr/lib/news.
3103 If tin is running in NNTP mode setting this variable has no
3104 effect.
3105 TIN_SPOOLDIR
3107 Define this variable if you want to override the SPOOLDIR path
3108 that was compiled into the tin binary, default is
3109 /var/spool/news. If tin is running in NNTP mode setting this
3110 variable has no effect.
3111 TIN_NOVROOTDIR
3113 Define this variable if you want to override the NOVROOTDIR path
3114 that was compiled into the tin binary, default is SPOOLDIR (see
3115 above). If tin is running in NNTP mode setting this variable has
3116 no effect.
3117 TIN_NOVFILENAME
3119 Define this variable if you want to override the OVERVIEW_FILE
3120 filename that was compiled into the tin binary, default is
3121 .overview. If tin is running in NNTP mode setting this variable
3122 has no effect.
3123 TIN_ACTIVEFILE
3125 Define this variable if you want to override the NEWSLIB‐
3126 DIR/active path that was compiled into the tin binary. If tin is
3127 running in NNTP mode setting this variable has no effect. If
3128 $TIN_LIBDIR is set it is prepended to $TIN_ACTIVEFILE.
3129 NNTPSERVER
3131 The default NNTP server to remotely read news from. This vari‐
3132 able only needs to be set if the ''-r'' command-line option is
3133 specified and the file /etc/nntpserver does not exist. The
3134 ''-g'' command line option overrides $NNTPSERVER.
3135 NNTPPORT
3137 The NNTP TCP-port to read news from. This variable only needs to
3138 be set if the TCP-port is not 119 (the default). The ''-p''
3139 command-line option overrides $NNTPPORT.
3140 DISTRIBUTION
3142 Set the article header field ''Distribution:'' to the contents
3143 of the variable instead of the system default.
3144 ISO2ASC
3146 Set the ISO to ASCII charset decoding table character to use in
3147 decoding an article text. Values can range from -1 to 6.
3148 -1 no conversion
3150 0 universal table for many languages
3152 1 single-spacing universal table
3154 2 table for Danish, Dutch, German, Norwegian and Swedish
3156 3 table for Danish, Finnish, Norwegian and Swedish using the
3158 appropriate ISO 646 variant
3159 4 table with RFC1345 codes in brackets
3161 5 table for printers that allow overstriking with backspace
3163 6 table for IBM PC character set (code page 437)
3165 ORGANIZATION
3167 Set the article header field ''Organization:'' to the contents
3168 of the variable instead of the system default. If reading news
3169 on an Apollo DomainOS machine the environment variable $NEWSORG
3170 has to be used instead of $ORGANIZATION.
3171 NEWSORG (DomainOS)
3173 DomainOS specific, same as $ORGANIZATION on other OSs (see
3174 above).
3175 REPLYTO
3177 Set the article header field ''Reply-To:'' to the return address
3178 specified by the variable. This is useful if you wish to receive
3179 replies at a different address.
3180 NAME Overrides the full name given in the gecos-field in /etc/passwd,
3182 see also mail_address.
3183 REALNAME
3185 Same as $NAME.
3186 HOME Pathname of the user's home directory. See environ(5) for more
3188 info.
3189 MAILER This variable has precedence over the default mailer that is
3191 used in all mailing operations within tin.
3192 MAIL Full path to the user's mailbox.
3194 VISUAL This variable has precedence over the default editor (i.e.,
3196 vi(1)) that is used in all editing operations within tin (e.g.,
3197 posting, replying, follow-ups, ...). Evaluation order is ${VIS‐
3198 UAL:-"${EDITOR:-vi}"}. See environ(5) for more info.
3199 EDITOR If $VISUAL is unset, then this variable is looked up for a
3201 default editor. If $EDITOR and $VISUAL are both unset, tin uses
3202 the systems default editor (i.e. vi(1)) on UNIX-systems). See
3203 environ(5) for more info.
3204 AUTOSUBSCRIBE
3206 A new group is checked against the list of patterns; if it
3207 matches, tin subscribes the user to the group without further
3208 query. See the section "NEWSGROUP LISTS & WILDCARDS" for an
3209 explanation of the valid syntax. For example, setting
3210 AUTOSUBSCRIBE=comp.os.unix.*,talk.*,!talk.politics.*
3212 will automatically subscribe the user to all new groups in the
3214 comp.os.unix hierarchy, and all talk groups other than talk.pol‐
3215 itics groups (which will be queried for as usual). Of course
3216 this does not work if tin is started with the ''-X'' command-
3217 line switch.
3218 AUTOUNSUBSCRIBE
3220 Is handled like the $AUTOSUBSCRIBE variable, but groups matching
3221 the list are unsubscribed from without further query. For exam‐
3222 ple, setting
3223 AUTOUNSUBSCRIBE=alt.flame.*,u*,!uk.*
3225 will automatically unsubscribe the user from all new alt.flame
3227 groups and all groups starting with u (university groups) other
3228 than UK groups (which will be queried for as usual).
3229 TMPDIR A pathname of a directory made available for tin to create tem‐
3231 porary files.
3232 MAILCAPS
3234 This variable can be used to override the default path search
3235 for mailcap(5) files. See also tin(5).
3236 NOMETAMAIL
3238 Set this variable to disable the use of metamail(1) or a
3239 replacement (e.g. metamutt).
3240 MM_CHARSET
3242 MIME character set used if not configured via the tinrc variable
3243 mm_charset.
3244 ISPELL Set this variable to point to ispell(1) or a replacement and its
3246 cmd-line options.
3247 PGPOPTS
3249 Define any additional options that you wish to pass to your
3250 pgp(1) or gpg(1) program.
3251 PGPPATH
3253 Override the name of the pgp(1) directory in $HOME that holds
3254 your keys etc..
3255 GNUPGHOME
3257 Override the name of the gpg(1) directory in $HOME that holds
3258 your keys etc..
3259 LC_CTYPE
3261 This variable determines the locale(5) category for character
3262 handling functions. Usually it determines the character classes
3263 for pattern matching character classification and case conver‐
3264 sion. Currently this is not true for tin (which temporary unsets
3265 $LC_CTYPE right before any match is done to avoid confusion).
3266 It's value should be of the form language[_territory][.code‐
3267 set][@modifier]. See environ(5) for more information.
3268 LC_MESSAGES
3270 Formats of informative and diagnostic messages and interactive
3271 responses. It's value should be of the form language[_terri‐
3272 tory][.codeset][@modifier]. See locale(5) and environ(5) for
3273 more information.
3274 LC_TIME
3276 Date and time formats. It's value should be of the form lan‐
3277 guage[_territory][.codeset][@modifier]. See locale(5) and
3278 environ(5) for more information.
3279 LC_ALL This variable overrides the value of the $LANG variable and any
3281 other $LC_ variable. It's value should be of the form lan‐
3282 guage[_territory][.codeset]. See locale(5) and environ(5) for
3283 more information.
3284 LANG This variable determines the locale(5) category for any category
3286 not specifically selected with a variable starting with $LC_.
3287 It's value should be of the form language[_territory][.codeset].
3288 See environ(5) for more information.
3289 LANGUAGE
3291 This variable defines a priority list for translations. Whenever
3292 a translation is not available in the language selected via
3293 $LC_ALL or $LANG the next language from the list is tried. It's
3294 value should be of the form language:language[:language]. See
3295 environ(5) for more information.
3296 COLUMNS
3298 A decimal integer > 0 used to indicate the user's preferred
3299 width in column positions for the terminal screen or window. If
3300 this variable is unset or null, the implementation determines
3301 the number of columns, appropriate for the terminal or window.
3302 When $COLUMNS is set, any terminal-width information implied by
3303 $TERM will be overridden. Users and portable applications should
3304 not set $COLUMNS unless they wish to override the system selec‐
3305 tion and produce output unrelated to the terminal characteris‐
3306 tics.
3307 LINES A decimal integer > 0 used to indicate the user's preferred num‐
3309 ber of lines on a page or the vertical screen or window size in
3310 lines. A line in this case is a vertical measure large enough to
3311 hold the tallest character in the character set being displayed.
3312 If this variable is unset or null, the implementation determines
3313 the number of lines, appropriate for the terminal or window.
3314 When $LINES is set, any terminal-height information implied by
3315 $TERM will be overridden. Users and portable applications should
3316 not set $LINES unless they wish to override the system selec‐
3317 tion.
3318 TERM The type of terminal in use. This is used when looking up term‐
3320 cap sequences. See environ(5) for more information.
3321 DISPLAY
3323 Display name, pointing to the X server; required for xface.
3324 WINDOWID
3326 Used for determining terminal's X window id; required for xface.
3327 Should be set by the terminal emulator.
3328 SHELL The pathname of the user's login shell. Used to set
3330 default_shell_command.
3331 XDG_RUNTIME_DIR
3333 The pathname of the user's dir to put non-essential run time
3334 files into.
3335
3337 tin handles a couple of signals:
3338 SIGHUP Terminate gracefully.
3340 SIGTERM
3342 Terminate gracefully.
3343 SIGUSR1
3345 Terminate gracefully but do not restore terminal (tty).
3346 SIGUSR2
3348 Write out ${TIN_HOMEDIR:-"$HOME"}/.newsrc-file.
3349
3351 If tin is started in debug mode (''-D n'') it will create world read‐
3352 able files in $TMPDIR which may contain the users NNTP password in
3353 cleartext. On multiuser-systems $TMPDIR should be set to a safe loca‐
3354 tion before starting tin in debug mode (e.g. TMPDIR=$HOME tin -D 1).
3355
3357 tin does conform to the Base Definitions volume of IEEE Std
3358 1003.1-2008, Section 12, Utility Conventions (Utility Argument Syntax,
3359 Utility Syntax Guidelines).
3360
3362 Regular expression support is provided by the PCRE library package
3363 pcre(3), which is open source software, written by Philip Hazel, and
3364 copyright by the University of Cambridge, England.
3365 <ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/>
3366
3368 CNews NNTPd, noffle(1) (<= V1.0-pre5) and NewsCache (<= V1.1.91) can't
3369 handle pipelined GROUP commands. If you run into trouble with any of
3370 the mentioned servers define DISABLE_PIPELINING in include/autoconf.h
3371 and recompile.
3372 Before mailing a bug-report to <tin-bugs@tin.org> please check if you
3373 are using the latest (stable) release, and if not, please upgrade
3374 first! Have a look at the doc/TODO file for known bugs. If you still
3375 think you've found a bug, please use the BugReport ('R') function and
3376 write in English. Please do NOT enclose a core-file in your bug-report
3377 until we request it.
3378
3380 tin is based on the tass(1) newsreader that was developed by Rich
3381 Skrenta and posted to alt.sources in March 1991; its first version was
3382 released on August 23rd 1991. tass(1) itself was heavily influenced by
3383 notesfiles a public domain UNIX version of PLATO Notes, developed at
3384 the University of Illinois by Ray Essick and Rob Kolstad in 1982. For a
3385 version overview see
3386 <http://www.tin.org/history.html>.
3387
3389 Rich Skrenta
3390 author of tass(1) v3.2 which this newsreader used as its base.
3391 Bill Davidsen
3393 author of envarg.c environment variable reading routine.
3394 Mike Gleason
3396 author of sigfile.c random signature generation routines.
3397 Markus Kuhn <Markus.Kuhn@cl.cam.ac.uk>
3399 author of langinfo.c, charset.c and iso2asc.txt ISO-8859-1 docu‐
3400 mentation.
3401 Arnold Robbins
3403 author of strftime.c date formatting routine.
3404 Rich Salz
3406 author of wildmat.c pattern matching and parsdate.y date parsing
3407 routines.
3408 Dave Taylor
3410 author of curses.c from the elm(1) mailreader.
3411 Chris Thewalt
3413 author of getline.c emacs(1) style editing routine.
3414 Steven Madsen
3416 for adding pgp(1) (Pretty Good Privacy) support.
3417 Philip Hazel <ph10@cam.ac.uk>
3419 for pcre(3) (Perl-compatible regular expression library).
3420 Patrick Powell <papowell@astart.com>
3422 for snprintf(3) and vsnprintf(3) fallbacks.
3423
3425 Iain Lea <iain@bricbrac.de>
3426
3428 Urs Janssen <urs@tin.org>
3429
3431 cron(8), elm(1), emacs(1), gpg(1), inews(1), ispell(1), lp(1), lpr(1),
3432 metamail(1), noffle(1), perl(1), perlre(1), pgp(1), rn(1), sendmail(1),
3433 shar(1), slrnface(1), tass(1), unshar(1), uudecode(1), vi(1),
3434 xterm(1x), heapsort(3), iconv(3), iconv_open(3), nl_langinfo(3),
3435 pcre(3), pcrepattern(3), qsort(3), snprintf(3), strftime(3),
3436 vsnprintf(3), wildmat(3), environ(5), locale(5), mailcap(5), mbox(5),
3437 mmdf(5), newsoverview(5), tin(5), RFC1345, RFC1524, RFC2045, RFC2046,
3438 RFC2047, RFC2048, RFC2231, RFC2980, RFC3977, RFC4155, RFC4643, RFC5322,
3439 RFC5536, RFC5537, RFC6048
34402.4.4 December 24th, 2019 tin(1)