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 ''-dnq''.
138 -r Read news remotely from the default NNTP server specified
140 in the environment variable $NNTPSERVER or contained in the
141 file /etc/nntpserver.
142 -R Read news saved by the ''-S'' option.
144 -s dir Save/read articles to/in directory. Default is ${TIN_HOME‐
146 DIR:-"$HOME"}/News.
147 -S Save unread articles for later reading by the ''-R''
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 ''-c'', ''-D'', ''-M'', ''-N'', ''-S'',
159 ''-u'' and ''-Z'' options. Can be used multiple times to
160 increase verbosity.
161 -V Print version and date information.
163 -w Quick mode to post an article and then exit. This option
165 implies ''-d''. In order for this to be really quick, it
166 should be used with ''-n'' if possible.
167 -x No-posting mode. You cannot post articles if you use this
169 option.
170 -X No overwrite mode. ${TIN_HOMEDIR:-"$HOME"}/.newsrc and
172 files in ${TIN_HOMEDIR:-"$HOME"}/.tin will not be overwrit‐
173 ten but may be created if they don't exist.
174 -z Only start tin if there is any new/unread news. If there is
176 news tin will position cursor at first group with unread
177 news. Useful for putting in login file.
178 -Z Check if there is any new/unread news and exit with appro‐
180 priate status. If ''-v'' option is specified the number of
181 unread articles in each group is printed. An exit code 0
182 indicates no news, 1 that an error occurred and 2 that
183 new/unread news exists. Useful for writing scripts.
184 tin can also dynamically change its options by the OptionMenu ('M')
186 command. Any changes are written to ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc.
187 For more information see section "GLOBAL OPTIONS MENU AND TINRC CONFIG‐
188 URABLE VARIABLES" and tin(5).
189 A list of groups can be specified after the other command-line options.
191 This can be useful if you wish to yank in or subscribe to a hand-picked
192 subset of the active newsgroups. See the section "NEWSGROUP LISTS &
193 WILDCARDS" for the types of pattern that tin understands.
194 If you specify a single group-name, or a wildcard that matches a single
196 group, then you will automatically enter that group. Otherwise the nor‐
197 mal group selection screen will appear, but with all the matching
198 groups present too, as though you had yanked just those groups in.
199 With the ''-w'' flag a given group-name is used as default group to
201 post to. If more than one group or a wildcard is specified only the
202 first group respectively the first group that matches is used.
203 Once you use SelectYankActive ('y') to yank in all active groups, or
205 SelectToggleReadDisplay ('r') to toggle the read/unread status, then
206 the command-line groups will be gone. You can use SelectSyncWithActive
207 ('Y') to reread the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_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/untag all the parts of the current multi-
790 part message in order.
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 ThreadTagParts 'T'
975 Automatically tag/untag all the parts of the current multi-
976 part message in order.
977 ThreadUntag 'U'
979 Untag all tagged threads.
980 Post 'w' Post an article to the current group. If posting fails for
982 some reason, you'll get the chance to edit the article again
983 via PostEdit ('e'), postpone it for later processing via
984 PostPostpone ('o') (see also ''-o'' command-line switch) or
985 discard it via Quit ('q').
986 MarkArtUnread 'z'
988 Mark current article in thread as unread. If a range of arti‐
989 cles is set, the range will be marked as unread instead of
990 the current article. When tagged articles are present, a
991 prompt asks how to proceed.
992 MarkThdUnread 'Z'
994 Mark all articles in thread as unread.
995 ARTICLE VIEWER COMMANDS
997 0 Read the first (base) article in this thread.
998 4 Read response 4 in this thread.
1000 MenuFilterSelect '^A'
1002 Auto select article(s) using a menu. Read the section "FIL‐
1003 TERING ARTICLES" for more information.
1004 PageReplyQuoteHeaders '^E'
1006 Reply through mail to the author of the current article with
1007 a copy of the article with all headers included.
1008 PagePGPCheckArticle '^G'
1010 Perform pgp(1) operations on article.
1011 PageToggleRaw '^H'
1013 Toggles the display mode (raw including all headers vs.
1014 cooked).
1015 MenuFilterKill '^K'
1017 Kill article(s) using a menu. Read the section "FILTERING
1018 ARTICLES" for more information.
1019 PageToggleTabs '^T'
1021 Toggle the TAB width between 4 and 8 characters.
1022 PageFollowupQuoteHeaders '^W'
1024 Post a followup to the current article with a copy of the
1025 article with all headers included.
1026 PageToggleTex2iso '"'
1028 Toggle TeX to ISO decoding for current article. The default
1029 behavior is taken from the tex2iso_conv variable in the tinrc
1030 file.
1031 PageToggleAllHeaders '*'
1033 Toggles the display of all headers vs. headers in news_head‐
1034 ers_to_display.
1035 PageToggleRot '%'
1037 Toggle ROT-13 decoding for this article.
1038 PageToggleUue '('
1040 Toggle the display of uuencoded sections. The default behav‐
1041 ior is taken from the hide_uue variable in the tinrc file.
1042 PageReveal ')'
1044 The formfeed character (^L) is often used to hide 'spoilers'
1045 that the reader may not initially wish to see when viewing an
1046 article. Any text after a formfeed is not displayed. This
1047 key-press acts like a reveal key and turns the hidden text
1048 back on. Scrolling down will also reveal the text, scrolling
1049 up will hide it again.
1050 LastViewed '-'
1052 Re-enter the last message that was viewed.
1053 SearchRepeat '\'
1055 Repeat the previous search.
1056 SearchSubjF '/'
1058 Forward search the text of this article.
1059 SearchSubjB '?'
1061 Backward search the text of this article.
1062 PageSkipIncludedText ':'
1064 Skip to the end of the next quoted text-block in this arti‐
1065 cle. Quoted text is everything which matches quote_regex,
1066 quote_regex2 or quote_regex3.
1067 PageTopThd '<'
1069 Go to the first article in the current thread.
1070 PageBotThd '>'
1072 Go to the last article in the current thread.
1073 PageToggleHighlight '_'
1075 Toggle word highlighting on/off.
1076 Pipe '|' Pipe current article / thread / auto-selected (hot) articles
1078 / articles matching pattern / tagged articles into command.
1079 See the section "MAILING PIPING PRINTING REPOSTING AND SAVING
1080 ARTICLES" for more information.
1081 QuickFilterSelect '['
1083 Auto select article(s) with a single key. The defaults used
1084 for selection are set based upon the following four tinrc
1085 config variables: default_filter_select_case, default_fil‐
1086 ter_select_expire, default_filter_select_global and
1087 default_filter_select_header Read the section "GLOBAL OPTIONS
1088 MENU AND TINRC CONFIGURABLE VARIABLES" for a full explanation
1089 of these variables and "FILTERING ARTICLES" for more informa‐
1090 tion on filtering.
1091 QuickFilterKill ']'
1093 Kill article(s) with a single key. The defaults used for
1094 killing are based upon the following four tinrc config vari‐
1095 ables: default_filter_kill_case, default_filter_kill_expire,
1096 default_filter_kill_global and default_filter_kill_header.
1097 Read the section "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE
1098 VARIABLES" for a full explanation of these variables and
1099 "FILTERING ARTICLES" for more information on filtering.
1100 PageNextThd '^J' '<CR>'
1102 Go to next base article.
1103 PageNextUnread '<TAB>'
1105 Go to next unread article. If the tinrc variable
1106 goto_next_unread doesn't contain PageNextUnread, then this
1107 key will first page through the current article.
1108 SearchAuthF 'a'
1110 Author forward search.
1111 SearchAuthB 'A'
1113 Author backward search.
1114 SearchBody 'B'
1116 Search the body of all articles in group (can be slow). You
1117 can abort the search using Quit ('q').
1118 Catchup 'c'
1120 Mark the current thread as read [after confirmation] and
1121 return to the previous menu. Move cursor to next item.
1122 CatchupNextUnread 'C'
1124 Mark the rest of the current thread as read [after confirma‐
1125 tion] and enter the next thread with unread articles.
1126 PageCancel 'D'
1128 Cancel (delete) or supersede (overwrite) the current article.
1129 It must have been posted by the same user. The cancel message
1130 can be seen in the newsgroup 'control' or 'control.cancel'.
1131 PageEditArticle 'e'
1133 Edit the current article. This is restricted to mailgroups
1134 and saved news.
1135 EditFilter 'E'
1137 Edit the filter file and reload it afterwards.
1138 PageFollowupQuote 'f'
1140 Post a followup to the current article with a copy of the
1141 article included.
1142 PageFollowup 'F'
1144 Post a followup to the current article without including a
1145 copy of the article.
1146 PageFirstPage 'g'
1148 Go to the start of the article.
1149 PageLastPage 'G'
1151 Go to the end of the article.
1152 ToggleInfoLastLine 'i'
1154 Display the subject of the current article in the last line.
1155 ToggleInverseVideo 'I'
1157 Toggle inverse video.
1158 PageKillThd 'K'
1160 Mark rest of thread as read and move onto the next unread
1161 thread.
1162 PageListThd 'l'
1164 Show the thread menu that the current article is a part of.
1165 LookupMessage 'L'
1167 Look up article by ''Message-ID:''.
1168 PageMail 'm'
1170 Mail current article / thread / auto-selected (hot) articles
1171 / articles matching pattern / tagged articles to someone. See
1172 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
1173 ARTICLES" for more information.
1174 OptionMenu 'M'
1176 User configurable options menu (for more information see sec‐
1177 tion "GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES").
1178 PageNextArt 'n'
1180 Go to the next article.
1181 PageNextUnreadArt 'N'
1183 Go to the next unread article.
1184 Print 'o' Send current article / thread / auto-selected (hot) articles
1186 / articles matching pattern / tagged articles to printer. See
1187 the section "MAILING PIPING PRINTING REPOSTING AND SAVING
1188 ARTICLES" for more information.
1189 PagePrevArt 'p'
1191 Go to the previous article.
1192 PagePrevUnreadArt 'P'
1194 Go to the previous unread article.
1195 Quit 'q' Return to the previous level.
1197 QuitTin 'Q'
1199 Quit tin — don't ask the user to confirm.
1200 PageReplyQuote 'r'
1202 Reply through mail to the author of the current article with
1203 a copy of the article included.
1204 PageReply 'R'
1206 Reply through mail to the author of the current article with‐
1207 out including the original article.
1208 PageSave 's'
1210 Save current article / thread / auto-selected (hot) articles
1211 / articles matching pattern / tagged articles. See the sec‐
1212 tion "MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES"
1213 for more information.
1214 PageAutoSave 'S'
1216 Save marked articles automatically without further prompting.
1217 PageTag 't'
1219 Toggle tag status of current article for mailing, piping,
1220 printing, saving or reposting.
1221 PageGroupSel 'T'
1223 Return to group selection level.
1224 PageGotoParent 'u'
1226 Go to parent article.
1227 PageViewUrl 'U'
1229 Display a list of URLs in the current article. See the sec‐
1230 tion "URL LISTING" for more information.
1231 PageViewAttach 'V'
1233 Display a list of attachments of the current article. See the
1234 section "ATTACHMENT LISTING" for more information.
1235 Post 'w' Post an article to the current group. If posting fails for
1237 some reason, you'll get the chance to edit the article again
1238 via PostEdit ('e'), postpone it for later processing via
1239 PostPostpone ('o') (see also ''-o'' command-line switch) or
1240 discard it via Quit ('q').
1241 PageRepost 'x'
1243 Repost an already posted article / thread / auto-selected
1244 (hot) articles / articles matching pattern / tagged articles
1245 to another newsgroup(s). Useful for reposting from global to
1246 local newsgroups. Do not use this to crosspost your own arti‐
1247 cles.
1248 MarkArtUnread 'z'
1250 Mark article as unread.
1251 MarkThdUnread 'Z'
1253 Mark the current thread as unread.
1254 URL LISTING
1256 PageViewUrl ('U') displays a list of URLs in the current article.
1257 Besides the common moving keys, the following commands are available:
1258 UrlSelect '^J' '<CR>'
1260 The current URL will be prompted and opened using the
1261 url_handler. '<ESC>' or no input will skip the URL.
1262 SearchSubjF '/'
1264 URL forward search.
1265 SearchSubjB '?'
1267 URL backward search.
1268 SearchRepeat '\'
1270 Repeat the previous search.
1271 ShellEscape '!'
1273 Shell escape.
1274 ToggleInfoLastLine 'i'
1276 Toggle the display of the current URL in the last line.
1277 Help 'h' Help screen of commands available.
1279 ToggleHelpDisplay 'H'
1281 Toggle the display of help mini menu at the bottom of the
1282 screen.
1283 ATTACHMENT LISTING
1285 PageViewAttach ('V') displays a list of attachments of the current
1286 article. Besides the common moving keys, the following commands are
1287 available:
1288 AttachPipe 'p'
1290 Pipe attachment into command.
1291 AttachSave 's'
1293 Save current attachment / tagged attachments to disk.
1294 AttachSelect '^J' '<CR>'
1296 View attachment.
1297 AttachTag 't'
1299 Tag one or more attachments for saving.
1300 AttachTagPattern '='
1302 Prompts for a pattern to match. All attachments whose
1303 name/description or content type/transfer encoding match
1304 the pattern will be tagged.
1305 AttachToggleTagged '@'
1307 Reverse tagging of all attachments.
1308 AttachUntag 'U'
1310 Untag all tagged attachments.
1311 SearchSubjF '/'
1313 Attachment forward search.
1314 SearchSubjB '?'
1316 Attachment backward search.
1317 SearchRepeat '\'
1319 Repeat the previous search.
1320 GlobalPipe '|'
1322 Pipe attachment into command. Uses the raw attachment, no
1323 decoding is done.
1324 ShellEscape '!'
1326 Shell escape.
1327 ToggleInfoLastLine 'i'
1329 Toggle the display of the name/description of the current
1330 attachment in the last line.
1331 Help 'h' Help screen of commands available.
1333 ToggleHelpDisplay 'H'
1335 Toggle the display of help mini menu at the bottom of the
1336 screen.
1337 GLOBAL OPTIONS MENU AND TINRC CONFIGURABLE VARIABLES
1339 At startup, tin reads in the configuration files (see also tin(5)).
1340 They contain a list of variables that can be used to configure the way
1341 tin works. If it exists, the global configuration file, /etc/tin/tinrc
1342 is read. After that, the user's own configuration file is read from
1343 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc. The global file is useful for dis‐
1344 tributing system-wide defaults to new users who have no private tinrc
1345 yet.
1346 The variables are user configurable by editing ${TIN_HOME‐
1348 DIR:-"$HOME"}/.tin/tinrc directly. Most of them can also be set in the
1349 GLOBAL OPTIONS MENU which is accessed by pressing OptionMenu ('M') at
1350 all levels. It allows the user to customize the behavior of tin. The
1351 options are saved to the file ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc when
1352 you exit tin so don't edit the file directly whilst tin is running.
1353 In the options menu use the cursor keys in the usual way to move
1355 around. Use ConfigSelect ('^J' or '<CR>') to 'open' the option you wish
1356 to change. You will need to enter a new value or use '<SPACE>' to tog‐
1357 gle the available options. ConfigSelect will save the new value,
1358 '<ESC>' will abort without saving changes.
1359 As with the other menus, RedrawScr ('^L') will redraw the screen. You
1361 can use SearchSubjF ('/'), SearchSubjB ('?') and SearchRepeat ('\') to
1362 search for a specific option. Use Quit ('q') to exit the option menu
1363 and keep your changes. Use QuitTin ('Q') to exit without keeping your
1364 changes.
1365 The options menu provides access to the attributes menu for the current
1367 group by the ConfigToggleAttrib ('<TAB>') command. Pressing ConfigTog‐
1368 gleAttrib again toggles back to the options menu. For more information
1369 see section "ATTRIBUTES MENU AND GROUP ATTRIBUTES".
1370 The ConfigScopeMenu ('S') command brings up the scopes menu. For more
1372 information see section "SCOPES MENU".
1373 Here is a full list of all the available variables. The name in braces
1375 is the name of the corresponding setting in ${TIN_HOME‐
1376 DIR:-"$HOME"}/.tin/tinrc.
1377 Abbreviate long newsgroup names (abbreviate_groupname)
1379 If ON abbreviate long newsgroup names at group selection level and
1380 article level (if necessary) like this: news.software.readers ->
1381 n.software.readers -> n.s.readers -> n.s.r. Default is OFF.
1382 Add posted articles to filter (add_posted_to_filter)
1384 If ON add posted articles which start a new thread to filter for
1385 highlighting follow-ups. Default is ON.
1386 Insert 'User-Agent:'-header (advertising)
1388 Turn ON advertising in header (''User-Agent:''). Default is ON.
1389 Skip multipart/alternative parts (alternative_handling)
1391 If ON strip multipart/alternative messages automatically. Default
1392 is ON.
1393 Character to show deleted articles (art_marked_deleted)
1395 The character used to show that an article was deleted. Default is
1396 'D'.
1397 Character to show inrange articles (art_marked_inrange)
1399 The character used to show that an article is in a range. Default
1400 is '#'.
1401 Character to show returning arts (art_marked_return)
1403 The character used to show that an article will return as an unread
1404 article when the group is next entered. Default is '-'.
1405 Character to show selected articles (art_marked_selected)
1407 The character used to show that an article/thread is auto-selected
1408 (hot). Default is '*'.
1409 Character to show recent articles (art_marked_recent)
1411 The character used to show that an article/thread is recent (not
1412 older than X days). See also recent_time. Default is 'o'.
1413 Character to show unread articles (art_marked_unread)
1415 The character used to show that an article has not been read.
1416 Default is '+'.
1417 Character to show read articles (art_marked_read)
1419 The character used to show that an article was read. Default is '
1420 '.
1421 Character to show killed articles (art_marked_killed)
1423 The character used to show that an article was killed. Default is
1424 'K'. kill_level must be set accordingly.
1425 Character to show read selected arts (art_marked_read_selected)
1427 The character used to show that an article was hot before it was
1428 read. Default is ':'. kill_level must be set accordingly.
1429 Ask before using MIME viewer (ask_for_metamail)
1431 If ON tin will ask before using a MIME viewer (metamail_prog) to
1432 display MIME messages. This only occurs if a MIME viewer is set.
1433 Default is OFF.
1434 Send you a cc and/or bcc automatically (auto_cc_bcc)
1436 Automatically put your name in the ''Cc:'' and/or ''Bcc:'' field
1437 when mailing an article. Default is No.
1438 List thread using right arrow key (auto_list_thread)
1440 If ON automatically list thread when entering it using right arrow
1441 key. Default is ON.
1442 Reconnect to server automatically (auto_reconnect)
1444 Default is OFF.
1445 Use Archive-name: header for save (auto_save)
1447 If ON articles/threads with ''Archive-name:'' in header will be
1448 automatically saved with the Archive-name & part/patch no and post
1449 processed if post_process_type is set to something other than 'No'.
1450 Default is OFF.
1451 Save articles in batch mode (batch_save)
1453 If set ON articles/threads will be saved in batch mode when save
1454 ''-S'' or mail ''-M, -N'' is specified on the command line. Default
1455 is ON.
1456 Show mini menu & posting etiquette (beginner_level)
1458 If set ON a mini menu of the most useful commands will be displayed
1459 at the bottom of the screen for each level. Also a short posting
1460 etiquette will be displayed after composing an article. Default is
1461 ON.
1462 Cache NNTP overview files locally (cache_overview_files)
1464 If ON, create local copies of NNTP overview files. This can be used
1465 to considerably speed up accessing large groups when using a slow
1466 connection. See also "INDEX FILES". Default is OFF.
1467 Hash algorithm for cancel-locks (cancel_lock_algo)
1469 Use this hash algorithm for cancel-locks. Only available when build
1470 with cancel-lock support. none disables the generation of cancel-
1471 locks. Valid values are none, sha1, sha256 and sha512. Default is
1472 sha1.
1473 Catchup read groups when quitting (catchup_read_groups)
1475 If set ON the user is asked when quitting if all groups read during
1476 the current session should be marked read. Default is OFF.
1477 Standard background color (col_back)
1479 Standard background color
1480 Color of quoted text from external sources (col_extquote)
1482 Color of quoted text from external sources
1483 Color of sender (From:) (col_from)
1485 Color of sender (From:)
1486 Color of article header lines (col_head)
1488 Color of header-lines
1489 Color of help text (col_help)
1491 Color of help pages
1492 Color for inverse text (background) (col_invers_bg)
1494 Color of background for inverse text
1495 Color for inverse text (foreground) (col_invers_fg)
1497 Color of foreground for inverse text
1498 Color of status messages (col_message)
1500 Color of status messages in last line
1501 Color of highlighting with _dash_ (col_markdash)
1503 Color of words emphasized like _this_. See also word_h_dis‐
1504 play_marks and word_highlight.
1505 Color of highlighting with /slash/ (col_markslash)
1507 Color of words emphasized like /this/. See also word_h_dis‐
1508 play_marks and word_highlight.
1509 Color of highlighting with *stars* (col_markstar)
1511 Color of words emphasized like *this*. See also word_h_dis‐
1512 play_marks and word_highlight.
1513 Color of highlighting with -stroke- (col_markstroke)
1515 Color of words emphasized like -this-. See also word_h_dis‐
1516 play_marks and word_highlight.
1517 Color of mini help menu (col_minihelp)
1519 Color of mini help menu
1520 Color of actual news header fields (col_newsheaders)
1522 Color of actual news header fields
1523 Standard foreground color (col_normal)
1525 Standard foreground color
1526 Color of quoted lines (col_quote)
1528 Color of quoted lines
1529 Color of twice quoted line (col_quote2)
1531 Color of twice quoted lines
1532 Color of =>3 times quoted line (col_quote3)
1534 Color of >=3 times quoted lines
1535 Color of response counter (col_response)
1537 Color of response counter. This is the text that says "Response x
1538 of y" in the article viewer.
1539 Color of signatures (col_signature)
1541 Color of signatures
1542 Color of urls highlight (col_urls)
1544 Color of urls highlight
1545 Color of verbatim blocks (col_verbatim)
1547 Color of verbatim blocks
1548 Color of article subject lines (col_subject)
1550 Color of article subject
1551 Color of text lines (col_text)
1553 Color of text-lines
1554 Color of help/mail sign (col_title)
1556 Color of help/mail sign
1557 Which actions require confirmation (confirm_choice)
1559 Ask for manual confirmation to protect the user.
1560 · commands Ask for confirmation before executing certain danger‐
1562 ous commands (e.g., Catchup ('c')). Commands that this affects
1563 are marked in this manual with '[after confirmation]'. Default
1564 is commands & quit.
1565 · quit You'll be asked to confirm that you wish to exit tin when
1567 you use the Quit ('q') command.
1568 · select Ask for confirmation before marking all not selected
1570 (with GroupMarkUnselArtRead ('X') command) articles as read.
1571 Format string for display of dates (date_format)
1573 Format string tin uses for date representation. A description of
1574 the different format options can be found at strftime(3). tin uses
1575 strftime(3) when available and supports most format options in his
1576 fallback code. Default is "%a, %d %b %Y %H:%M:%S".
1577 (default_art_search)
1579 (default_author_search)
1581 (default_config_search)
1583 The last article/author/config option that was searched for.
1584 (default_filter_days)
1586 Default is 28.
1587 (default_filter_kill_case)
1589 Default for quick (1 key) kill filter case. ON = filter case sen‐
1590 sitive, OFF = ignore case. Default is OFF.
1591 (default_filter_kill_expire)
1593 Default for quick (1 key) kill filter expire. ON = limit to
1594 default_filter_days, OFF = don't ever expire. Default is OFF.
1595 (default_filter_kill_global)
1597 Default for quick (1 key) kill filter global. ON=apply to all
1598 groups, OFF=apply to current group. Default is ON.
1599 (default_filter_kill_header)
1601 Default for quick (1 key) kill filter header.
1602 0
1604 ''Subject:'' (case sensitive)
1605 1
1607 ''Subject:'' (ignore case)
1608 2
1610 ''From:'' (case sensitive)
1611 3
1613 ''From:'' (ignore case)
1614 4
1616 ''Message-ID:'' & full ''References:'' line
1617 5
1619 ''Message-ID:'' & last ''References:'' entry only
1620 6
1622 ''Message-ID:'' entry only
1623 7
1625 ''Lines:''
1626 (default_filter_select_case)
1628 Default for quick (1 key) auto-selection filter case. ON=filter
1629 case sensitive, OFF=ignore case. Default is OFF.
1630 (default_filter_select_expire)
1632 Default for quick (1 key) auto-selection filter expire. ON = limit
1633 to default_filter_days, OFF = don't ever expire. Default is OFF.
1634 (default_filter_select_global)
1636 Default for quick (1 key) auto-selection filter global. ON=apply
1637 to all groups, OFF=apply to current group. Default is ON.
1638 (default_filter_select_header)
1640 Default for quick (1 key) auto-selection filter header.
1641 0
1643 ''Subject:'' (case sensitive)
1644 1
1646 ''Subject:'' (ignore case)
1647 2
1649 ''From:'' (case sensitive)
1650 3
1652 ''From:'' (ignore case)
1653 4
1655 ''Message-ID:'' & full ''References:'' line
1656 5
1658 ''Message-ID:'' & last ''References:'' entry only
1659 6
1661 ''Message-ID:'' entry only
1662 7
1664 ''Lines:''
1665 (default_goto_group)
1667 (default_group_search)
1669 (default_mail_address)
1671 (default_move_group)
1673 (default_pattern)
1675 (default_pipe_command)
1677 (default_post_newsgroups)
1679 (default_post_subject)
1681 (default_range_group)
1683 (default_range_select)
1685 (default_range_thread)
1687 (default_repost_group)
1689 (default_save_file)
1691 (default_save_mode)
1693 (default_select_pattern)
1695 (default_shell_command)
1697 (default_subject_search)
1699 Draw -> instead of highlighted bar (draw_arrow)
1701 Allows groups/articles to be selected by an arrow '->' if set ON or
1702 by a highlighted bar if set OFF. Default is OFF.
1703 Invocation of your editor (editor_format)
1705 The format string used to create the editor start command with
1706 parameters. Default is "%E +%N %F" (e.g., /bin/vi +7 .article).
1707 Detection of external quotes (extquote_handling)
1709 If ON quotes from external sources will be detected. Default is
1710 OFF.
1711 Regex used to show external quotes (extquote_regex)
1713 A regular expression that will be applied when reading articles.
1714 All matching lines are shown in col_extquote. If extquote_regex is
1715 blank, then tin uses a built-in default.
1716 Force redraw after certain commands (force_screen_redraw)
1718 Specifies whether a screen redraw should always be done after cer‐
1719 tain external commands. Default is OFF.
1720 Number of articles to get (getart_limit)
1722 If getart_limit is > 0 not more than the last getart_limit arti‐
1723 cles/group are fetched from the server. If getart_limit is < 0 tin
1724 will start fetching articles from your first unread minus absolute
1725 value of getart_limit. Default is 0, which means no limit.
1726 Catchup group using left key (group_catchup_on_exit)
1728 If ON catchup group when leaving with the left arrow key. Default
1729 is ON.
1730 Format string for the Group level (group_format)
1732 Format string tin uses for Group level representation. See the sec‐
1733 tion "CUSTOMIZING THE SCREEN FORMAT". Default is
1734 "%n %m %R %L %s %F".
1735 Go to the next unread article with (goto_next_unread)
1737 Which keys tin should accept to jump to the next unread article.
1738 Possible is any combination of PageDown and PageNextUnread. When
1739 PageDown is set tin jumps to the next article at the end of the
1740 current one. When PageNextUnread is set tin jumps immediately to
1741 the next article when PageNextUnread ('<TAB>') is pressed. Default
1742 is PageNextUnread.
1743 Display uue data as an attachment (hide_uue)
1745 If set to 'No' then raw uuencoded data is displayed. If set to
1746 'Yes' then sections of uuencoded data will be shown with a single
1747 tag line showing the size and filename (much the same as a MIME
1748 attachment). If set to 'Hide all' then any line that looks like
1749 uuencoded data will be folded into a tag line. This is useful when
1750 uuencoded data is split across more than one article but can also
1751 lead to false positives. This setting can also be toggled in the
1752 article viewer. Default is 'No'.
1753 External inews (inews_prog)
1755 Path, name and options of external inews(1). If you are reading
1756 via NNTP the default value is "--internal" (use built-in NNTP
1757 inews), else it is "inews -h". The article is passed to inews_prog
1758 on STDIN via '< article'.
1759 (info_in_last_line)
1761 If ON, show current group description or article subject in the
1762 last line (not in the pager and global menu) — ToggleInfoLastLine
1763 ('i') toggles setting. This facility is useful as the full width of
1764 the screen is available to display long subjects. Default is OFF.
1765 Use interactive mail reader (interactive_mailer)
1767 Interactive mailreader: if greater than 0 your mailreader will be
1768 invoked earlier for reply so you can use more of its features (e.g.
1769 MIME, pgp, ...). 1 means include headers, 2 means don't include
1770 headers (old use_mailreader_i=ON option). 0 turns off usage. This
1771 option has to suit mailer_format. Default is 0.
1772 Use inverse video for page headers (inverse_okay)
1774 If ON use inverse video for page headers and URL highlighting.
1775 Default is ON.
1776 Keep failed arts in ~/dead.articles (keep_dead_articles)
1778 If ON keep all failed postings in ${TIN_HOME‐
1779 DIR:-"$HOME"}/dead.articles besides keeping the last failed posting
1780 in ${TIN_HOMEDIR:-"$HOME"}/dead.article. Default is ON.
1781 Filter which articles (kill_level)
1783 This option controls the processing and display of articles that
1784 are killed. There are 3 options:
1785 0 Kill only unread arts is the 'traditional' behavior of tin.
1787 Only unread articles are killed once only by marking them read.
1788 As filtering only happens on unread articles with kill_level
1789 set to 0, art_marked_killed and art_marked_read_selected are
1790 only shown once. When you reenter the group the mark will be
1791 gone.
1792 1 Kill all arts & show with K will process all articles in the
1794 group and therefore there is a processing overhead when using
1795 this option. Killed articles are threaded as normal but they
1796 will be marked with art_marked_killed.
1797 2 Kill all arts and never show will process all articles in the
1799 group and therefore there is a processing overhead when using
1800 this option. Killed articles simply does not get displayed at
1801 all.
1802 Default is 0 (Kill only unread arts).
1803 Use 8bit characters in mail headers (mail_8bit_header)
1805 Allows 8bit characters unencoded in the header of mail message.
1806 Default is OFF. Turning it ON is effective only if mail_mime_encod‐
1807 ing is also set to 8bit. Leaving it OFF is safe for most users and
1808 compliant to Internet Mail Standard (RFC5322 and RFC2047). Default
1809 is OFF.
1810 Mail address (mail_address)
1812 User's mail address (and full name), if not username@host. This is
1813 used when creating articles, sending mail and when pgp(1) signing.
1814 MIME encoding in mail messages (mail_mime_encoding)
1816 MIME encoding of the body in mail message, if necessary (8bit,
1817 base64, quoted-printable, 7bit). Default is quoted-printable.
1818 Quote line when mailing (mail_quote_format)
1820 Format of quote line when replying (via mail) to an article
1821 (%A=Address, %D=Date, %F=Fullname+Address, %G=Groupname, %M=Mes‐
1822 sage-ID, %N=Fullname, %C=Firstname, %I=Initials). Default is "In
1823 article %M you wrote:"
1824 Format of the mailbox (mailbox_format)
1826 Select one of the following mailbox-formats: MBOXO (default, except
1827 on SCO), MBOXRD or MMDF (default on SCO). See mbox(5) and RFC4155
1828 for more details on MBOXO and MBOXRD and mmdf(5) for more details
1829 about MMDF.
1830 Mail directory (maildir)
1832 The directory where articles/threads are to be saved in mbox(5)
1833 format. This feature is mainly for use with the elm(1) mail pro‐
1834 gram. It allows the user to save articles/threads/groups simply by
1835 giving '=' as the filename to save to. Default is ${TIN_HOME‐
1836 DIR:-"$HOME"}/Mail.
1837 Invocation of your mail command (mailer_format)
1839 The format string used to create the mailer command with parameters
1840 that is used for mailing articles to other people. Default is '%M
1841 "%T" < %F' (e.g., /bin/mail "iain" < .article). The flexible format
1842 allows other mailers with different command line parameters to be
1843 used such as
1844 sendmail -oem -t < %F
1845 elm -s "%S" "%T" < "%F"
1846 claws-mail --compose "mailto:%T?subject=%S&insert=%F"
1847 interactive_mailer must be set adequate. The following substitu‐
1848 tions are supported:
1849 %F filename
1850 %M default_mailer
1851 %S subject-field
1852 %T to-filed
1853 %U username
1854 %% %
1855 'Mark as (un)read' ignores tags (mark_ignore_tags)
1857 When this is ON, the GroupMarkThdRead ('K'), ThreadMarkArtRead
1858 ('K'), MarkThdUnread ('Z') at Group level and MarkArtUnread ('z')
1859 at Thread level functions mark just the current article or thread,
1860 ignoring other tagged, (un)read articles. When OFF, the same func‐
1861 tion presents a menu with choices of the current thread or article,
1862 all tagged, unread articles, or nothing.
1863 Mark saved articles/threads as read (mark_saved_read)
1865 If ON mark articles that are saved as read. Default is ON.
1866 Viewer program for MIME articles (metamail_prog)
1868 Path, name and options of external metamail(1) program used to view
1869 non-textual parts of articles. To use the built-in viewer, set to
1870 --internal. This is the default value when metamail(1) is not
1871 installed. Leave it blank if you don't want any automatic viewing
1872 of non-textual attachments. The 'V' command can always be used to
1873 manually view any attachments. See also ask_for_metamail.
1874 MM_CHARSET (mm_charset)
1876 Charset supported locally, which is also used for MIME header
1877 (charset parameter and charset name in header encoding) in mail and
1878 news postings. If MIME_STRICT_CHARSET is defined at compile time,
1879 text in charset other than the value of this parameter is consid‐
1880 ered not displayable and represented as '?'. Otherwise, all charac‐
1881 ter sets are regarded as compatible with the display. If it's not
1882 set, the value of the environment variable $MM_CHARSET is used. US-
1883 ASCII or compile-time default is used in case neither of them is
1884 defined. If your system supports iconv(3), this option is disabled
1885 and you should use mm_network_charset instead.
1886 MM_NETWORK_CHARSET (mm_network_charset)
1888 Charset used for posting and MIME headers; replaces mm_charset.
1889 Conversion between mm_network_charset and local charset (determined
1890 via nl_langinfo(3)) is done via iconv(3), if this function is not
1891 available on your system this option is disabled and you have to
1892 use mm_charset instead. mm_network_charset is limited to one of the
1893 following charsets:
1894 US-ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16}, KOI8-{R,U,RU}
1895 EUC-{CN,JP,KR,TW}, ISO-2022-{CN,CN-EXT,JP,JP-1,JP-2}, Big5,
1896 UTF-8
1897 Not all values might work on your system, see iconv_open(3) for
1898 more details. If it's not set, the value of the environment vari‐
1899 able $MM_CHARSET is used. US-ASCII or compile-time default is used
1900 in case neither of them is defined.
1901 Attribute of highlighting with _dash_ (mono_markdash)
1903 Character attribute of words emphasized like _this_. It depends on
1904 your terminal which attributes are usable. See also word_h_dis‐
1905 play_marks and word_highlight.
1906 Attribute of highlighting with /slash/ (mono_markslash)
1908 Character attribute of words emphasized like /this/. It depends on
1909 your terminal which attributes are usable. See also word_h_dis‐
1910 play_marks and word_highlight.
1911 Attribute of highlighting with *stars* (mono_markstar)
1913 Character attribute of words emphasized like *this*. It depends on
1914 your terminal which attributes are usable. See also word_h_dis‐
1915 play_marks and word_highlight.
1916 Attribute of highlighting with -stroke- (mono_markstroke)
1918 Character attribute of words emphasized like -this-. It depends on
1919 your terminal which attributes are usable. See also word_h_dis‐
1920 play_marks and word_highlight.
1921 (newnews)
1923 These are internal timers used by tin to keep track of new news‐
1924 groups. Do not change them unless you understand what they are
1925 for.
1926 Display these header fields (or *) (news_headers_to_display)
1928 Which news headers you wish to see. If you want to see _all_ the
1929 headers, place an '*' as this value. This is the only way a wild‐
1930 card can be used. If you enter 'X-' as the value, you will see all
1931 headers beginning with 'X-' (like X-Alan or X-Pape). You can list
1932 more than one by delimiting with spaces. Not defining anything
1933 turns off this option.
1934 Do not display these header fields (news_headers_to_not_display)
1936 Same as news_headers_to_display except it denotes the opposite. An
1937 example of using both options might be if you thought 'X-' headers
1938 were A Good Thing(tm), but thought Alan and Pape were miscreants...
1939 well then you would do something like this: news_headers_to_dis‐
1940 play=X- news_headers_to_not_display=X-Alan X-Pape Not defining any‐
1941 thing turns off this option.
1942 Quote line when following up (news_quote_format)
1944 Format of quote line when posting/following up an article
1945 (%A=Address, %D=Date, %F=Fullname+Address, %G=Groupname, %M=Mes‐
1946 sage-ID, %N=Fullname, %C=Firstname, %I=Initials). Default is "%F
1947 wrote:".
1948 NNTP read timeout in seconds (nntp_read_timeout_secs)
1950 Time in seconds to wait for a response from the server. Default is
1951 120. Setting this to 0 means no timeout.
1952 Unicode normalization form (normalization_form)
1954 The normalization form tin should use to normalize unicode input.
1955 The possible values are:
1956 0 None: no normalization
1958 1 NFKC: Compatibility Decomposition, followed by Canonical Compo‐
1960 sition
1961 2 NFKD: Compatibility Decomposition
1963 3 NFC: Canonical Decomposition, followed by Canonical Composition
1965 4 NFD: Canonical Decomposition
1967 5 NFKC_CF: Compatibility Decomposition, followed by Canonical
1969 Composition and Case Folding
1970 Some normalization modes are only available if they are supported by
1971 the library tin uses to do the normalization. NFC should be used if
1972 possible.
1973 Go to first unread article in group (pos_first_unread)
1975 If ON put cursor at first unread article in group otherwise at last
1976 article. Default is ON.
1977 Use 8bit characters in news headers (post_8bit_header)
1979 Allows 8bit characters unencoded in the header of a news article,
1980 if set this also disables the generation of MIME-headers when they
1981 are usually required. Default is OFF. Only enacted if
1982 post_mime_encoding is also set to 8bit. In a number of local hier‐
1983 archies where 8bit characters are used, using unencoded (raw) 8bit
1984 characters in header is acceptable and sometimes even recommended
1985 so that you need to check the convention adopted in the local hier‐
1986 archy of your interest to determine what to do with this and
1987 post_mime_encoding.
1988 MIME encoding in news messages (post_mime_encoding)
1990 MIME encoding of the body in news message, if necessary. (8bit,
1991 base64, quoted-printable, 7bit). Default is 8bit, which leads to no
1992 encoding. base64 and quoted-printable are usually undesired on
1993 usenet.
1994 View post-processed files (post_process_view)
1996 If ON, then tin will start an appropriate viewer program to display
1997 any files that were post processed and uudecoded. The program is
1998 determined using the mailcap(5) file. Default is ON.
1999 Post process saved articles (post_process_type)
2001 This specifies whether to perform post processing on saved arti‐
2002 cles. The following values are allowed:
2003 0 No (default), no post processing is done.
2005 1 Shell archives, unpacking of multi-part shar(1) files only.
2007 2 Yes, binary attachments and data will be decoded and saved.
2009 Filename to be used for storing posted articles (posted_articles_file)
2011 Keep posted articles in given file. If the given filename does not
2012 contain any expandable strings it will be prefixed with ${TIN_HOME‐
2013 DIR:-"$HOME"}/Mail/. If no filename is set then postings will not
2014 be saved. See the section "MAILING PIPING PRINTING REPOSTING AND
2015 SAVING ARTICLES" for more information about the various expansion
2016 characters. Default is 'posted'.
2017 Print all headers when printing (print_header)
2019 If ON, then the full article header is sent to the printer. Other‐
2020 wise only the ''Subject:'' and ''From:'' fields are output. Default
2021 is OFF.
2022 Printer program with options (printer)
2024 The printer program with options that is to be used to print arti‐
2025 cles. The default is lpr(1) for BSD machines and lp(1) for SysV
2026 machines. Printing from tin may have been disabled by the System
2027 Administrator.
2028 Process only unread articles (process_only_unread)
2030 If ON only save/print/pipe/mail unread articles (tagged articles
2031 excepted). Default is OFF.
2032 Show empty Followup-To in editor (prompt_followupto)
2034 If ON show empty ''Followup-To:'' header when editing an article.
2035 Default is OFF.
2036 Characters used as quote-marks (quote_chars)
2038 The character used in quoting included text to article followups
2039 and mail replies. The '_' character represents a blank character
2040 and is replaced with ' ' when read, %I is replaced by author's ini‐
2041 tials. Default is '>_'.
2042 Quoting behavior (quote_style)
2044 How articles should be quoted when following up or replying to
2045 them. There are a number of things that can be done: empty lines
2046 can be quoted, signatures can be quoted and quote_chars can be com‐
2047 pressed when quoting multiple times (for example, '> > >' will be
2048 turned into '>>>'). The default is to compress quotes, and to quote
2049 empty lines.
2050 When you are viewing an article in raw mode ('^H'), and follow up
2051 or reply to it, the signature will be quoted even if it would oth‐
2052 erwise not be. If show_signatures is off, then the signature will
2053 never be quoted.
2054 Regex used to show quoted lines (quote_regex)
2056 A regular expression that will be applied when reading articles.
2057 All matching lines are shown in col_quote. If quote_regex is blank,
2058 then tin uses a built-in default.
2059 Regex used to show twice quoted l. (quote_regex2)
2061 A regular expression that will be applied when reading articles.
2062 All matching lines are shown in col_quote2. If quote_regex2 is
2063 blank, then tin uses a built-in default.
2064 Regex used to show >= 3 times q.l. (quote_regex3)
2066 A regular expression that will be applied when reading articles.
2067 All matching lines are shown in col_quote3. If quote_regex3 is
2068 blank, then tin uses a built-in default.
2069 Article recentness time limit (recent_time)
2071 If set to 0, this feature is deactivated, otherwise it means the
2072 number of days. Default is 2.
2073 Render BiDi (render_bidi)
2075 If ON tin does the rendering of bi-directional text. If OFF tin
2076 leaves the rendering of bi-directional text to the terminal.
2077 Default is OFF.
2078 Interval in seconds to reread active (reread_active_file_secs)
2080 The news ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active} file
2081 is reread at regular intervals to show if any new news has arrived.
2082 Default is 1200. Setting this to 0 will disable this feature.
2083 Directory to save arts/threads in (savedir)
2085 Directory where articles/threads are saved. Default is ${TIN_HOME‐
2086 DIR:-"$HOME"}/News.
2087 Score limit (kill) (score_limit_kill)
2089 If the score of an article is below or equal this value the article
2090 gets marked as killed.
2091 Score limit (select) (score_limit_select)
2093 If the score of an article is above or equal this value the article
2094 gets marked as hot.
2095 Default score to kill articles (score_kill)
2097 Score of an article which should be killed, this must be <=
2098 score_limit_kill.
2099 Default score to select articles (score_select)
2101 Score of an article which should be marked hot, this must be >=
2102 score_limit_select.
2103 Number of lines to scroll in pager (scroll_lines)
2105 The number of lines that will be scrolled up/down in the article
2106 pager when using cursor-up/down. The default is 1 (line-by-line).
2107 Set to 0 to get traditional tin page-by-page scrolling. Set to -1
2108 to get page-by-page scrolling where the top/bottom line is carried
2109 over onto the next page. This setting supersedes
2110 show_last_line_prev_page=ON. Set to -2 to get half-page scrolling.
2111 This setting supersedes full_page_scroll=OFF.
2112 Format string for the Selection level (select_format)
2114 Format string tin uses for Selection level representation. See the
2115 section "CUSTOMIZING THE SCREEN FORMAT". Default is
2116 "%f %n %U %G %d".
2117 In group and thread level, show author by (show_author)
2119 Which information about the author should be shown. Default is 2,
2120 authors full name.
2121 0 None, only the ''Subject:'' line will be displayed.
2123 1 Address, ''Subject:'' line & the address part of the ''From:''
2125 line are displayed.
2126 2 Full Name, ''Subject:'' line & the authors full name part of
2128 the ''From:'' line are displayed (default).
2129 3 Address and Name, ''Subject:'' line & all of the ''From:'' line
2131 are displayed.
2132 Show description of each newsgroup (show_description)
2134 If ON show a short group description text after newsgroup name at
2135 the group selection level. The ''-d'' command-line flag will over‐
2136 ride the setting and turn descriptions off. The text used is taken
2137 from the ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups file and if supported
2138 (requires tin to be build with mh-mail-handling support) from
2139 ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups for mailgroups. Default is
2140 ON.
2141 Function for sorting articles (sort_function)
2143 Function used for sorting articles. Default is 0.
2144 0 Use qsort(3) for sorting.
2146 1 Use heapsort(3) for sorting. This might be faster in large
2148 groups with long threads (somewhat presorted data).
2149 Show lines/score in listings (show_info)
2151 Which information about the thread or article should be shown.
2152 Default is 1, show only the line count.
2153 0 None, no information will be displayed.
2155 1 Lines, in article listing the line count of an article will be
2157 displayed and in thread listing the line count of first
2158 (unread) article will be displayed.
2159 2 Score, in article listing the score of an article will be dis‐
2161 played and in thread listing the score of the thread will be
2162 displayed — see also thread_score.
2163 3 Lines & Score, display line count and score.
2165 Show only unread articles (show_only_unread_arts)
2167 If ON show only new/unread articles otherwise show all articles.
2168 Default is ON.
2169 Show only groups with unread arts (show_only_unread_groups)
2171 If ON show only subscribed groups that contain unread articles.
2172 Default is OFF.
2173 Display signatures (show_signatures)
2175 If OFF don't show signatures when displaying articles. Default is
2176 ON.
2177 Prepend signature with '\n-- \n' (sigdashes)
2179 If ON prepend the signature with sigdashes. Default is ON.
2180 Create signature from path/command (sigfile)
2182 The path that specifies the signature file to use when posting,
2183 following up to or replying to an article. If the path is a direc‐
2184 tory then the signature will be randomly generated from files that
2185 are in the specified directory. If the path starts with a ! the
2186 program the path points to will be executed to generate a signa‐
2187 ture. In order to pass the group name to the program, %G can be
2188 specified. This will be replaced by the name of the current news‐
2189 group. --none will suppress any signature. Default is ${TIN_HOME‐
2190 DIR:-"$HOME"}/.Sig.
2191 Add signature when reposting (signature_repost)
2193 If ON add signature to reposted articles. Default is ON.
2194 Regex used to highlight /slashes/ (slashes_regex)
2196 A regular expression that will be applied when reading articles.
2197 All matching words are shown in col_markslash or mono_markslash. If
2198 slashes_regex is blank, then tin uses a built-in default.
2199 Sort articles by (sort_article_type)
2201 This specifies how articles should be sorted. Sort by ascending
2202 Date (6) is the default. The following sort types are allowed:
2203 0 Nothing, don't sort articles.
2205 1 Subject: (descending), sort articles by ''Subject:'' field
2207 descending.
2208 2 Subject: (ascending), sort articles by ''Subject:'' field
2210 ascending.
2211 3 From: (descending), sort articles by ''From:'' field descend‐
2213 ing.
2214 4 From: (ascending), sort articles by ''From:'' field ascending.
2216 5 Date: (descending), sort articles by ''Date:'' field descend‐
2218 ing.
2219 6 Date: (ascending), sort articles by ''Date:'' field ascending
2221 (default).
2222 7 Score (descending), sort articles by filtering score descend‐
2224 ing.
2225 8 Score (ascending), sort articles by filtering score ascending.
2227 9 Lines: (descending), sort articles by ''Lines:'' field descend‐
2229 ing.
2230 10 Lines: (ascending), sort articles by ''Lines:'' field ascend‐
2232 ing.
2233 Sort threads by (sort_threads_type)
2235 This specifies how threads will be sorted. Sort by descending Score
2236 (1) is the default. The following sort types are allowed:
2237 0 Nothing, don't sort threads.
2239 1 Score (descending), sort threads by filtering score descending
2241 (default).
2242 2 Score (ascending), sort threads by filtering score ascending.
2244 3 Last posting date (descending), sort threads by date of last
2246 posting descending.
2247 4 Last posting date (ascending), sort threads by date of last
2249 posting ascending.
2250 Spamtrap warning address parts (spamtrap_warning_addresses)
2252 Set this option to a list of comma-separated strings to be warned
2253 if you are replying to an article by mail where the e-mail address
2254 contains one of these strings. The matching is case-insensitive.
2255 Example:
2256 spam,delete,remove
2258 Regex used to highlight *stars* (stars_regex)
2260 A regular expression that will be applied when reading articles.
2261 All matching words are shown in col_markstar or mono_markstar. If
2262 stars_regex is blank, then tin uses a built-in default.
2263 Start editor with line offset (start_editor_offset)
2265 Set ON if the editor used for posting, follow-ups and bug reports
2266 has the capability of starting and positioning the cursor at a
2267 specified line within a file. Default is ON.
2268 Strip blanks of end of lines (strip_blanks)
2270 Strips the blanks from the end of each line therefore speeding up
2271 the display when reading on a slow terminal or via modem. Default
2272 is ON.
2273 Remove bogus groups from newsrc (strip_bogus)
2275 Bogus groups are groups that are present in your ${TIN_HOME‐
2276 DIR:-"$HOME"}/.newsrc file that no longer exist on the news server.
2277 There are 3 options. 0 means do nothing & always keep bogus groups.
2278 1 means bogus groups will be permanently removed. 2 means that
2279 bogus groups will appear on the Group Selection Menu, prefixed with
2280 a 'D'. This allows you to unsubscribe from them as and when you
2281 wish. Default is 0 (Always Keep).
2282 No unsubscribed groups in newsrc (strip_newsrc)
2284 If ON, then unsubscribed groups will be permanently removed from
2285 your ${TIN_HOMEDIR:-"$HOME"}/.newsrc file. Default is OFF.
2286 Regex with Subject prefixes (strip_re_regex)
2288 A regular expression to find Subject prefixes like "Re:" to remove.
2289 If strip_re_regex is blank, then tin(1) uses a built-in default.
2290 Regex with Subject suffixes (strip_was_regex)
2292 A regular expression to find Subject suffixes like "(was:" to
2293 remove. If strip_was_regex is blank, then tin(1) uses a built-in
2294 default.
2295 Regex used to highlight -strokes- (strokes_regex)
2297 A regular expression that will be applied when reading articles.
2298 All matching words are shown in col_markstroke or mono_markstroke.
2299 If strokes_regex is blank, then tin uses a built-in default.
2300 Wrap around threads on next unread (wrap_on_next_unread)
2302 If enabled a search for the next unread article will wrap around
2303 all articles to find also previous unread articles. If disabled the
2304 search stops at the end of the thread list. Default is ON.
2305 Display "a as Umlaut-a (tex2iso_conv)
2307 If ON, show "a as Umlaut-a, etc. Default is OFF. This behavior can
2308 also be toggled in the article viewer via PageToggleTex2iso ('"').
2309 Thread articles by (thread_articles)
2311 Defines which threading method to use. It's possible to set the
2312 threading type on a per group basis by setting the group attribute
2313 variable thread_arts to 0 – 4 in the file ${TIN_HOME‐
2314 DIR:-"$HOME"}/.tin/attributes. (See also "GROUP ATTRIBUTES".) The
2315 default is Both Subject and References. The choices are:
2316 0 None, don't thread.
2318 1 Subject, thread on ''Subject:'' only.
2320 2 References, thread on ''References:'' only.
2322 3 Both Subject and References, thread on ''References:'' then
2324 ''Subject:'' (default).
2325 4 Multipart Subject, thread multipart articles on ''Subject:''.
2327 5 Percentage Match, thread base upon a partial character match on
2329 ''Subject:''.
2330 Catchup thread by using left key (thread_catchup_on_exit)
2332 If ON catchup group/thread when leaving with the left arrow key.
2333 Default is ON.
2334 Format string for the Thread level (thread_format)
2336 Format string tin uses for Thread level representation. See the
2337 section "CUSTOMIZING THE SCREEN FORMAT". Default is
2338 "%n %m [%L] %T %F".
2339 Matchingness of a thread (thread_perc)
2341 How closely the subjects must match for two threads to be consid‐
2342 ered part of the same thread. This is a percentage and the default
2343 if 75%.
2344 Score of a thread (thread_score)
2346 How the total score of a thread is computed. Default is 0, the max‐
2347 imum score in this thread.
2348 0 Max, the maximum score in this thread.
2350 1 Sum, the sum of all scores in this thread.
2352 2 Average, the average score in this thread.
2354 Transliteration (translit)
2356 If ON append //TRANSLIT to the first argument of iconv_open(3) to
2357 enable transliteration. This means that when a character cannot be
2358 represented in the target character set, it can be approximated
2359 through one or several similarly looking characters. On systems
2360 where this extension doesn't exist, this option is disabled.
2361 Default is OFF.
2362 How to treat blank lines (trim_article_body)
2364 Allows you to select how tin treats blank lines in article bodies.
2365 Default is 0. This option does not affect lines within verbatim
2366 blocks.
2367 0 Don't trim article body, do nothing.
2369 1 Skip leading blank lines.
2371 2 Skip trailing blank lines.
2373 3 Skip leading and trailing blank l., skip leading and trailing
2375 blank lines.
2376 4 Compact multiple between text, replace multiple blank lines
2378 between textblocks with one blank line.
2379 5 Compact multiple and skip leading, 4 + 1
2381 6 Compact multiple and skip trailing, 4 + 2
2383 7 Compact mltpl., skip lead. & trai., 4 + 3
2385 Regex used to highlight _underline_ (underscores_regex)
2387 A regular expression that will be applied when reading articles.
2388 All matching words are shown in col_markdash or mono_markdash. If
2389 underscores_regex is blank, then tin uses a built-in default.
2390 Remove ~/.article after posting (unlink_article)
2392 If ON remove ~/.article after posting. Default is ON.
2393 Program that opens URLs (url_handler)
2395 The program that will be run when launching URLs in the article
2396 viewer using PageViewUrl ('U'). The actual URL will be appended.
2397 Default is url_handler.pl.
2398 URL highlighting in message body (url_highlight)
2400 Enable highlighting URLs in message body. Default is ON.
2401 Use ANSI color (use_color)
2403 If enabled tin uses ANSI-colors. Default is OFF.
2404 Use scroll keys on keypad (use_keypad)
2406 Default is OFF.
2407 Use mouse in xterm (use_mouse)
2409 Allows the mouse button support in an xterm(1x) to be enabled/dis‐
2410 abled. Default is OFF.
2411 Use slrnface to show ''X-Face:''s (use_slrnface)
2413 If enabled tin uses slrnface(1) to interpret the ''X-Face:''
2414 header. For this option to have any effect, tin must be running in
2415 an xterm(1x) and slrnface(1) must be in your $PATH. Default is OFF.
2416 Use UTF-8 graphics (utf8_graphics)
2418 If ON use UTF-8 characters for indicator ('->'), thread/attachment
2419 tree and ellipsis ('...'). Default is OFF.
2420 Regex for begin of a verbatim block (verbatim_begin_regex)
2422 A regular expression that tin will use to find the begin of a ver‐
2423 batim block.
2424 Regex for end of a verbatim block (verbatim_end_regex)
2426 A regular expression that tin will use to find the end of a verba‐
2427 tim block.
2428 Detection of verbatim blocks (verbatim_handling)
2430 If ON verbatim blocks will be detected. Default is ON.
2431 Wildcard matching (wildcard)
2433 Allows you to select how tin matches strings. The default is 0 and
2434 uses the wildmat notation, which is how this has traditionally been
2435 handled. Setting this to 1 allows you to use perl(1) compatible
2436 regular expressions pcre(3) (see also perlre(1) and
2437 pcrepattern(3)). You will probably want to update your filter file
2438 if you use this regularly. NB: Newsgroup names will always be
2439 matched using the wildmat notation.
2440 What to display instead of mark (word_h_display_marks)
2442 Should the leading and ending stars, slashes, strokes and dashes
2443 also be displayed, even when they are highlighting marks?
2444 0 no
2446 1 yes, display mark
2448 2 print a space instead
2450 Word highlighting in message body (word_highlight)
2452 Enable word highlighting. See word_h_display_marks for the options
2453 available. If use_color is enabled the colors specified in
2454 col_markdash, col_markslash, col_markstar and col_markstroke are
2455 used for word highlighting else the character attributes specified
2456 in mono_markdash, mono_markslash, mono_markstar and mono_markstroke
2457 are used. Default is ON.
2458 Page line wrap column (wrap_column)
2460 Sets the column at which a displayed article body should be
2461 wrapped. If this value is equal to 0, it defaults to the current
2462 screen width. If this value is greater than your current screen
2463 width the part off-screen is not displayed. Thus setting this
2464 option to a large value can be used to disable wrapping. If this
2465 value is negative the wrap margin is the current screen width plus
2466 the given value (as long as the result is still positive, otherwise
2467 it will fall back to the current screen width). Default is 0, wrap‐
2468 ping at the current screen width.
2469 Quote line when crossposting (xpost_quote_format)
2471 Format is the same as for news_quote_format, this is used when
2472 answering to a crossposting to several groups with no ''Fol‐
2473 lowup-To:'' set.
2474 ATTRIBUTES MENU AND GROUP ATTRIBUTES
2476 tin allows certain attributes to be set on a per group basis. If it
2477 exists, the global attributes file, ${TIN_LIBDIR:-NEWSLIB‐
2478 DIR}/attributes is read. After that, the user's own attributes file
2479 ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes is read. The global attributes
2480 file is useful for distributing system-wide defaults to new users who
2481 have no private attributes file yet.
2482 Note that the scope=<grouplist> line has to be specified before the
2484 attributes are specified for that list. All attributes are set to a
2485 reasonable default so you only have to specify the attribute that you
2486 want to change (e.g., savedir). All toggle attributes are set by speci‐
2487 fying ON/OFF. Otherwise, these function exactly the same as their
2488 global equivalents. For more details see tin(5).
2489 Attributes can also be changed from the attributes menu which can be
2491 accessed by ConfigToggleAttrib ('<TAB>') from the options menu or
2492 ScopeSelect ('^J' or '<CR>') from the scopes menu. The attributes menu
2493 looks and behaves very similar to the options menu. The title shows the
2494 current scope. Attributes set in the current scope are marked with '+'
2495 to the left of the attributes number.
2496 Besides the keys for moving around and changing values known from the
2498 options menu the attributes menu provides the following command: Confi‐
2499 gResetAttrib ('r') which resets an attribute to a default value.
2500 SCOPES MENU
2502 The scopes menu (accessible from the options menu with ConfigScopeMenu
2503 ('S')) shows all scopes read from the global and local attributes file.
2504 Scopes from the global attributes file are marked with '!' to the left
2505 of the scope number. Delete/rename/move are not possible with those
2506 scopes.
2507 In addition to the common moving keys the following commands are avail‐
2509 able: ScopeSelect ('^J' or '<CR>') enter the attributes menu for the
2510 current scope, ScopeEditAttributesFile ('E') edit the local attributes
2511 file, ScopeAdd ('a') add a new scope, ScopeDelete ('d') delete the cur‐
2512 rent scope, ScopeMove ('m') move the current scope to a new position,
2513 ScopeRename ('r') rename the current scope. ToggleHelpDisplay ('H')
2514 toggles the help mini menu at the bottom of the screen.
2515 FILTERING ARTICLES
2517 When there is a subject or an author which you are either very inter‐
2518 ested in, or find completely uninteresting, you can easily instruct tin
2519 to auto-select or auto-kill articles that match rules that you specify.
2520 This can be anything from the name of the author to the number of lines
2521 in an article.
2522 When tin starts up the user's kill-file ${TIN_HOME‐
2524 DIR:-"$HOME"}/.tin/filter (see also tin(5)) is read. Each time a news‐
2525 group is entered the rules are applied and articles killed or selected
2526 when they meet certain criteria.
2527 The degree to which rules are applied depend on the kill_level tinrc
2529 setting. By default killed articles will only be marked read. Adjust
2530 kill_level for more aggressive processing. Articles that match an auto-
2531 selection rule are marked with a ''*''.
2532 Filtering rules can be manually entered into ${TIN_HOME‐
2534 DIR:-"$HOME"}/.tin/filter (but don't do this whilst running tin else
2535 you will lose your changes) or by using an on-screen menu within tin.
2536 The filtering capabilities of tin have been significantly enhanced over
2538 previous versions to include scoring and better pattern matching. It is
2539 recommended that you read the file filtering in the tin documentation
2540 directory. This file can also be read online at
2541 <http://www.tin.org/filtering.txt>.
2542 The on-screen filtering menu is accessed by pressing MenuFilterKill
2544 ('^K') or MenuFilterSelect ('^A') at the Group and Article levels. It
2545 allows the user to kill or select an article that matches the current
2546 ''Subject:'' line, ''From:'' line or a string entered by the user. The
2547 user entered string can be applied to the ''Subject:'' or ''From:''
2548 line of an article. The filter can be limited to the current newsgroup
2549 or it can apply to all newsgroups. Once entered the user can abort the
2550 command and not save the new filter, edit the full filter file or save
2551 filter.
2552 POSTING ARTICLES
2554 tin allows posting of articles, follow-up to already posted articles
2555 and replying direct through mail to the author of an article.
2556 Use the Post ('w') command to post an article to a newsgroup. After
2558 entering the post subject the default editor (i.e., vi(1)) or the edi‐
2559 tor specified by the $VISUAL or $EDITOR environment variable will be
2560 started and the article can be entered. To crosspost articles simply
2561 add a comma and the name of the newsgroup(s) to the end of the ''News‐
2562 groups:'' line at the beginning of the article. After saving and exit‐
2563 ing the editor you are asked if you wish to a)bort posting the article,
2564 e)dit the article again or p)ost the article to the specified news‐
2565 group(s).
2566 Use the DisplayPostHist ('W') command to display a history of the arti‐
2568 cles you have posted. The date the article was posted, which newsgroups
2569 the article was posted to and the articles subject line are displayed.
2570 Use the PageFollowupQuote ('f'), PageFollowup ('F') or PageFol‐
2572 lowupQuoteHeaders ('^W') command to post a follow-up article to an
2573 already posted article. The PageFollowupQuote command will copy the
2574 text of the original article into the editor. The PageFollowupQuote‐
2575 Headers command will copy the text and all headers of the original
2576 article into the editor. The editing procedure is the same as when
2577 posting an article with the Post ('w') command.
2578 Use the PageReplyQuote ('r'), PageReply ('R') or PageReplyQuoteHeaders
2580 ('^E') command to reply direct through mail to the author of an already
2581 posted article. The PageReplyQuote command will copy the text of the
2582 original article into the editor. The PageReplyQuoteHeaders command
2583 will copy the text and all headers of the original article into the
2584 editor. The editing procedure is the same as when posting an article
2585 with the Post ('w') command. After saving and exiting the editor you
2586 are asked if you wish to abort sending the article via PostAbort ('a'),
2587 edit the article again via PostEdit ('e') or send the article to the
2588 author via PostSend ('s').
2589 CUSTOMIZING THE ARTICLE QUOTE STRING
2591 When posting a followup to an article or replying direct to the author
2592 of an article via email the text of the article can be quoted. The
2593 beginning of the quoted text can contain information about the quoted
2594 article (e.g., Name and the Message-ID of the article). To allow for
2595 different situations certain information from the article can be used
2596 in the quoted string. The following variables are expanded if found in
2597 the tinrc variables mail_quote_format, news_quote_format or
2598 xpost_quote_format:
2599 %A Address (Email)
2600 %D Date (uses date_format)
2601 %F Full address (%N <%A>)
2602 %G Groupname
2603 %M Message-ID
2604 %N Fullname of author
2605 %C Firstname of author
2606 %I Initials of author
2607 e.g.,
2608 mail_quote_format=On %D in %G you wrote:
2609 news_quote_format=In %M, %F wrote:
2610 would expand to:
2611 On 21 Sep 1993 09:45:51 -0400 in alt.sources you wrote:
2612 In <abcINN123@example.org>, Joe Bar <joe@example.org> wrote:
2613 The quoted text section of an article is marked by a preceding quote
2614 string at the beginning of each quoted line. The default quote string
2615 is set to '>_'. The default can be changed by setting the tinrc vari‐
2616 able quote_chars to ones own preference. (Note that '_' underline is
2617 used to represent a space).
2618 MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES
2620 The command interface to GroupMail, PageMail, PostMail or ThreadMail
2621 ('m'), Pipe ('|'), Print ('o'), PageRepost or GroupRepost ('x') and
2622 GroupSave, PageSave or ThreadSave ('s' and GroupAutoSave, PageAutoSave
2623 or ThreadAutoSave 'S') articles is the same for ease of use.
2624 Auto-saving with *AutoSave ('S') is a special case and operates only on
2626 marked articles. They will processed without any further prompting
2627 according to the default save parameters defined in tinrc or by any
2628 attributes set for the current group.
2629 Otherwise, the initial prompt will ask you to select which article,
2631 thread, hot (auto-selected), regular expression pattern, tagged arti‐
2632 cles you wish to mail, pipe etc.
2633 Tagged articles must have already been tagged with a *Tag ('t') com‐
2635 mand. All tagged articles can be untagged by a *Untag ('U') untag com‐
2636 mand.
2637 If a regular expression pattern is selected you are asked to enter a
2639 pattern (e.g., to match all articles subject lines containing 'net
2640 News' you enter "net News"). Any articles that match the entered
2641 expression will be mailed, piped etc. See also the wildcard tinrc vari‐
2642 able for advanced pattern matching options.
2643 Various expansion characters are recognized when entering the directory
2645 and file to save to. Environment variables (prefixed with '$') and user
2646 home directories (prefixed by '~' or '~username') can be specified.
2647 Environment variables can themselves contain other special characters.
2648 To save articles to a mailbox enter '=<mailbox name>' when asked for
2650 the save filename. If you enter just '=' then articles will be saved to
2651 a mailbox with the name of the current newsgroup (eg, alt.sources).
2652 See maildir.
2653 To save in savedir/<news.group.name>/<filename> format enter '+<file‐
2655 name>'. See savedir. Like '+' %G is expanded to the current
2656 news.group.name but without savedir prefixed. %P is expanded to the
2657 news.group.name with all '.' replaced by '/'.
2658 If saving multiple files at once the filename (if not referring to a
2660 mailbox) will be extended by ".num" where "num" is at least 3 digit
2661 number counting up from 1. Environment variables are allowed within a
2662 filename (e.g., $SOURCES/dir/filename).
2663 When saving articles you can specify whether the saved files should be
2665 post processed. A default process type can be set via
2666 post_process_type.
2667 AUTOMATIC MAILING AND SAVING NEW NEWS
2669 tin allows new/unread news articles to be mailed (''-M'' and ''-N''
2670 option) or saved (''-S'' option) in batch mode for later reading. Use‐
2671 ful when going on holiday and you don't want to return and find that
2672 expire has removed a whole load of unread articles. Best to run via
2673 cron(8) everyday while away, after which you will be mailed a report of
2674 which articles were mailed/saved from which newsgroups and the total
2675 number of articles mailed/saved. Articles are saved in a private news
2676 structure under your savedir directory (default is ${TIN_HOME‐
2677 DIR:-"$HOME"}/News). Be careful of using this option if you read a lot
2678 of groups because you could overflow your file system.
2679 When using ''-S'' together with a given directory to save to (''-s''
2681 option), the same directory must be specified when reading the articles
2682 by ''-R''.
2683 If you only want to save some of your groups use the batch_save tinrc
2685 variable. Set to ON or OFF in tinrc to enable/disable saving of all
2686 groups and then use the batch_save attribute to fine tune which groups
2687 you want to have saved. For example, if you want to save most of your
2688 groups, then set batch_save to ON in tinrc and selectively turn off the
2689 ones you don't want using attributes.
2690 tin -M iain -c -f newsrc.mail
2692 (mail any unread articles in newsgroups specified
2693 in file newsrc.mail to the local user iain and mark
2694 them as read)
2695 tin -S -c -f newsrc.save
2697 (save any unread articles in newsgroups specified
2698 in file newsrc.save and mark them as read)
2699 tin -R (read any articles saved by tin -S)
2701 RANGES
2703 A range is simply a group of items marked using the SetRange ('#') key.
2704 Certain tin commands will operate on a range if one exists rather than
2705 just the current item. A range is an expression of the form
2706 <min>–<max>, e.g. 10–15 will highlight items 10 through 15 on the cur‐
2707 rent screen. Other than absolute numeric positions, '.' can be used in
2708 place of the current cursor position and '$' can be used to mean the
2709 highest number available. Currently the only commands that understand
2710 ranges are GroupMarkThdRead ('K'), MarkArtUnread ('z') and MarkThdUn‐
2711 read ('Z').
2712 NEWSGROUP LISTS & WILDCARDS
2714 Several places in tin allow you to specify a list of newsgroups. These
2715 include command-line groups, (un)subscribe groups, the AUTO[UN]SUB‐
2716 SCRIBE mechanism. The scope= attributes file tag and the filter file
2717 group= tag also use the same syntax. tin interprets this variable simi‐
2718 larly to rn(1). It contains a list of patterns, separated by commas
2719 and possibly prefixed with exclamation points. An exclamation point
2720 negates the meaning of a match on this pattern, and can be used to can‐
2721 cel certain matches. Some examples:
2722 alt.config,news.*,!news.test
2724 Matches alt.config and everything in the 'news' hierarchy except
2726 news.test
2727 See the explanation for the $AUTOSUBSCRIBE variables for further exam‐
2729 ples.
2730 SIGNATURES
2732 tin will recognize a signature in either ${TIN_HOMEDIR:-"$HOME"}/.sig‐
2733 nature or ${TIN_HOMEDIR:-"$HOME"}/.Sig. If ${TIN_HOME‐
2734 DIR:-"$HOME"}/.signature exists, then the signature will be pulled into
2735 the editor for mail commands only. A signature in ${TIN_HOME‐
2736 DIR:-"$HOME"}/.signature will not be pulled into the editor for posting
2737 commands since inews(1) will append the signature itself.
2738 A signature in ${TIN_HOMEDIR:-"$HOME"}/.Sig will be pulled into the
2740 editor for both posting and mailing commands.
2741 The following is an example of a .Sig file:
2743 NAMES Joe Bar <joe@example.org>
2744 SNAIL Musterweg 12, 99999 Notreal, Germany
2745 tin also has the capability to generate random signatures on a per
2747 newsgroup basis if so desired. The way to accomplish this is to specify
2748 the default signature or the group attribute sigfile as a directory. If
2749 for example the sigfile path is /usr/iain/.sigs and .sigs is a direc‐
2750 tory then tin will select a random signature from any file that is in
2751 the directory .sigs (note: one signature per numbered file). A random
2752 signature can also consist of a fixed part signature that can contain
2753 your name, address etc. followed by the random sig. The fixed part of
2754 the random sig is read from the file $HOME/.sigfixed.
2755 CUSTOMIZING THE SCREEN FORMAT
2757 The look of the Selection, Group and Thread level can be customized via
2758 format strings. These format strings define the content and the posi‐
2759 tion of each element on the screen. Variables are used within the for‐
2760 mat strings as placeholders. The following variables are available:
2761 %D date
2763 %F from, name and/or address
2764 %G newsgroup name
2765 %I initials
2766 %L line count
2767 %M message-id
2768 %R number of responses in thread
2769 %S score
2770 %T thread tree
2771 %U unread count
2772 %d newsgroup description
2773 %f newsgroup flag
2774 %m article marks
2775 %n current group/thread/article number
2776 %s subject
2777 %% %
2778 Not all variables can be used in each level. The following table pro‐
2780 vides an overview:
2781 select_format group_format thread_format
2783 %D X X
2784 %F X X
2785 %G X
2786 %I X X
2787 %L X X
2788 %M X X
2789 %R X
2790 %S X X
2791 %T X
2792 %U X
2793 %d X
2794 %f X
2795 %m X X
2796 %n X X X
2797 %s X
2798 %% X X X
2799 Defaults for the format strings:
2801 select_format: "%f %n %U %G %d"
2803 group_format: "%n %m %R %L %s %F"
2804 thread_format: "%n %m [%L] %T %F"
2805 show_description controls whether the newsgroup description is shown or
2807 not. The description can also be toggled with SelectToggleDescriptions
2808 ('d').
2809 The information displayed with '%F' depends on the value of
2811 show_author. GroupToggleSubjDisplay resp. ThreadToggleSubjDisplay
2812 ('d') switches through all available options.
2813 For date representation '%D' uses date_format. It is possible to spec‐
2815 ify a different date format in round brackets (e.g. '%(%d %b %y
2816 %H:%M)D'). See date_format for more details.
2817 The length of each item (except '%%') can be defined with a positive
2819 number after the '%'. The following example displays the score in the
2820 thread level 10 characters wide: '%10S'.
2821 If the newsgroup name is displayed together with the newsgroup descrip‐
2823 tion, the width of the newsgroup name can be controlled via an optional
2824 comma separated second value (e.g. '%60,20G'). It is valid to omit the
2825 first value (e.g. ('%,20G')). If no second value is given, tin uses a
2826 default value of 32.
2827 Some variables do have a default width which may lead to truncation.
2829 Truncation for variables which contain only numbers happens by dividing
2830 the value with a sufficient power of ten and adding a SI suffix to the
2831 result, that is the variable holds a value of 54321 and the width for
2832 the variable is 4 the result will be "54 k". If that's undesired you
2833 have to specify a larger width manually, e.g. '%6n'. Here is an over‐
2834 view of the defaults:
2835 Variable width
2837 %I 3
2838 %L 4
2839 %M 10
2840 %R 3
2841 %S 6
2842 %U 5
2843 %n 4
2844 If no length is given for '%D', the length is determined by the format
2846 string for the date and the date of the current day. If the date format
2847 string contains weekdays or months names it may happen that the date is
2848 longer than determined in the first pass. In this case, the date is
2849 truncated before display. This occurs, for example, if the current
2850 month is May and the article to which the date is displayed was posted
2851 in December. In such cases it might useful to determine the maximum
2852 length manually and specify the length in the format string.
2853 In case the format string contains '%G' and '%d' and no length are
2855 given, tin determines the longest newsgroup name and uses this length
2856 for '%G'. The remaining space will used for '%d'.
2857 When the format string contains the specifier '%F' and '%s' resp. '%T'
2859 and no length are given, '%F' will use one third and '%s' resp. '%T'
2860 will use two third of the available space.
2861 In addition, a minimum screen width can be defined for each item
2863 (except '%%'). In this case, the item will only be displayed when the
2864 screen is wider than specified. This comes in handy to not overload a
2865 small screen but have maximum information on a large screen. The mini‐
2866 mum screen width has to be specified by a positive number preceded by
2867 an '>'. In the following example tin will display the score only if the
2868 screen is wider than 100 characters: '%>100S'.
2869 If both the length and the minimum screen width should be specified for
2871 an item, the length must be the first parameter and the minimum screen
2872 width must be the second one. The following example displays the score
2873 with a length of 10 characters only if the screen is wider than 100
2874 characters: '%10>100S'.
2875 TIPS AND TRICKS
2877 tin can be pretty much be navigated by using the four cursor keys. The
2878 left arrow key goes up a level, the right arrow key goes down a level,
2879 the up arrow key goes up a line and the down arrow key goes down a
2880 line.
2881 The following newsgroups provide useful information concerning news
2883 software:
2884 —news.software.readers (info. about news user agents tin, rn, nn,
2885 slrn etc.)
2886 —news.software.nntp (info. about NNTP)
2887 —news.answers (Frequently Asked Questions (FAQ) about many differ‐
2888 ent themes)
2889 Many prompts within tin offer a default choice that the cursor is posi‐
2891 tioned on. By pressing '<CR>' the default value is taken. Most prompts
2892 can be aborted by pressing '<ESC>'.
2893 When tin is run in an xterm(1x) it will resize itself each time the
2895 xterm(1x) is resized.
2896 tin will reread the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVE‐
2898 FILE:-active} file at set intervals (reread_active_file_secs) to show
2899 any newly arrived news.
2900 If you find large number of new newsgroups cluttering up your screen,
2902 pressing SelectToggleReadDisplay ('r') will make them go away.
2903 XTERM BUTTONS
2905 If the environment variable $TERM is set to xterm(1x), then button
2906 pressing can be used to select groups and articles. In this discussion,
2907 the buttons are assumed to be assigned conventionally (i.e., Button1 is
2908 the left button).
2909 In general (i.e., for the group, thread and article menus),
2911 Button1 (left)
2913 enters next (lower) level if you click on an article, other‐
2914 wise pages down.
2915 Button2 (center)
2917 returns to the previous (upper) level if you click on an
2918 article, otherwise pages up.
2919 Button3 (right)
2921 positions on the article line under mouse cursor, or pages
2922 down if you've clicked outside the list of articles.
2923 In the group selection menu, if the mouse is pointing at a group then:
2925 left button
2927 moves to and selects the group pointed at, just like Selec‐
2928 tReadGrp ('<CR>').
2929 center button
2931 quits the program, just like Quit ('q').
2932 right button
2934 moves to the group pointed at.
2935 In the article menu, if the mouse is pointing at an article (or thread)
2937 then:
2938 left button
2940 reads the article pointed at, just like GroupReadBasenote
2941 ('<CR>'), or the thread, just like GroupListThd ('l').
2942 center button
2944 exits the menu, catching up on the group if you have
2945 group_catchup_on_exit set in your configuration, just like
2946 Quit ('q').
2947 right button
2949 moves to the article (or thread) pointed at.
2950 In the thread menu, if the mouse is pointing at an article then:
2952 left button
2954 reads article pointed at, just like ThreadReadArt ('<CR>').
2955 center button
2957 exits the menu, catching up on the thread if you have
2958 thread_catchup_on_exit set in your configuration, just like
2959 Quit ('q').
2960 right button
2962 moves to the article pointed at.
2963 In other menus and areas button pressing reverts back to usual cut and
2965 paste of xterm(1x), but after one click of any button.
2966 INDEX FILES
2968 If your news server supports NOV index files (see newsoverview(5), most
2969 modern installations will) and you have a fast connection to your news
2970 server then this section can be ignored.
2971 If your news server doesn't support NOV index files or you have a very
2973 slow connection to your news server then tin can cache the index for
2974 each newsgroup if cache_overview_files is set to ON. Note that this
2975 cache can use up large amounts of disk space if you read a lot of
2976 groups and/or high traffic groups.
2977 Each user creates/updates his/her own index files that are stored in
2979 ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news/. If you are
2980 reading via NNTP then the news server name will be appended to keep the
2981 indexes for different servers separate. If you are reading off the
2982 local spool and local overview files already exist then turning on
2983 caching will have no effect. Likewise unless you see significant delays
2984 entering a group when reading via NNTP then turning on caching will
2985 have little or no effect.
2986 Entering a group the first time tends to be slow because the index file
2988 must be built from scratch. To alleviate the slowness start tin to cre‐
2989 ate all index files for the groups you subscribe to with tin -u -v and
2990 go for a coffee. Subsequent readings of a group will only need to do
2991 incremental updating of the index file and will be much faster as only
2992 new articles will need to be cached.
2993 As indexing might take some time you may want to run tin from the sys‐
2995 tem batcher cron(8) with the ''-u'' option:
2996 30 6 * * * /usr/local/bin/tin -u
2998 If you are low on local disk space you should consider to manually
3000 purge cached data for groups you are not reading anymore with something
3001 like:
3002 find ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news* \
3004 -type f -name "[0-9]*.[0-9]" -atime +28 | xargs rm -f
3005
3007 For a detailed description see tin(5).
3008 $MAILCAPS
3010 ~/.mailcap
3011 /etc/mailcap
3012 /usr/etc/mailcap
3013 /usr/local/etc/mailcap
3014 /etc/mail/mailcap
3015 /etc/nntpserver
3017 ${TIN_HOMEDIR:-"$HOME"}/.cancelsecret
3019 ${TIN_HOMEDIR:-"$HOME"}/.mime.types
3021 /etc/mime.types
3022 /etc/tin/mime.types
3023 ${TIN_HOMEDIR:-"$HOME"}/.newsauth
3025 ${TIN_HOMEDIR:-"$HOME"}/.newsrc
3027 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER${NNTPPORT:+":$NNTPPORT"}/.oldnewsrc
3029 ${TIN_HOMEDIR:-"$HOME"}/.signature
3031 ${TIN_HOMEDIR:-"$HOME"}/.Sig
3032 ${TIN_HOMEDIR:-"$HOME"}/.sigfixed
3034 ${TIN_HOMEDIR:-"$HOME"}/.tin/.inputhistory
3036 ${TIN_INDEX_MAILDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.mail/
3038 ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news${NNTPSERVER:+"-$NNTPSERVER"}/
3040 ${TIN_INDEX_SAVEDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.save/
3042 ${TIN_HOMEDIR:-"$HOME"}/.tin/active.mail
3044 ${TIN_HOMEDIR:-"$HOME"}/.tin/active.save
3046 /etc/tin/attributes
3048 ${TIN_HOMEDIR:-"$HOME"}/.tin/attributes
3049 ${TIN_HOMEDIR:-"$HOME"}/.tin/filter
3051 /etc/tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
3053 ${TIN_HOMEDIR:-"$HOME"}/.tin/keymap${${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}:+".${LC_ALL:-"${LC_CTYPE:-"${LC_MESSAGES:-"$LANG"}"}"}"}
3054 ${TIN_HOMEDIR:-"$HOME"}/.tin/mailgroups
3056 ${TIN_HOMEDIR:-"$HOME"}/.tin/newsrctable
3058 ${TIN_HOMEDIR:-"$HOME"}/.tin/posted
3060 ${TIN_HOMEDIR:-"$HOME"}/Mail/posted
3062 ${TIN_HOMEDIR:-"$HOME"}/.tin/postponed.articles
3064 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER:${NNTPPORT:+":$NNTPPORT"}/newsgroups
3066 ${TIN_HOMEDIR:-"$HOME"}/.tin/$NNTPSERVER:${NNTPPORT:+":$NNTPPORT"}/serverrc
3068 /etc/tin/tinrc
3070 ${TIN_HOMEDIR:-"$HOME"}/.tin/tinrc
3071 /etc/tin/tin.defaults
3073 /usr/local/share/locale/${LC_MESSAGES}/LC_MESSAGES/tin.mo
3075 ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-active}
3077 ${TIN_LIBDIR:-NEWSLIBDIR}/active.times
3079 ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups
3081 ${TIN_LIBDIR:-NEWSLIBDIR}/organization
3083 ${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt
3085 ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions
3087
3089 TINRC Define this variable if you want to specify command-line options
3090 that tin should be started with to save typing them each time it
3091 is started. The contents of the environment variable are added
3092 to the front of the command-line options before it is parsed
3093 therefore allowing an option specified on the command-line to
3094 override the same option specified in the environment.
3095 TIN_HOMEDIR
3097 Define this variable if you do not want the .tin directory in
3098 $HOME/. E.g., if you want all tin's private files in /tmp/.tin
3099 you would set $TIN_HOMEDIR to /tmp.
3100 TIN_INDEX_NEWSDIR
3102 Define this variable if you do not want the .news directory in
3103 ${TIN_HOMEDIR:-"$HOME"}/.tin/. E.g., if you want all tin's news
3104 index files in /tmp/.news you would set $TIN_INDEX_NEWSDIR to
3105 /tmp.
3106 TIN_INDEX_MAILDIR
3108 Define this variable if you do not want the .mail directory in
3109 ${TIN_HOMEDIR:-"$HOME"}/.tin/. E.g., if you want all tin's mail
3110 index files in /tmp/.mail you would set $TIN_INDEX_MAILDIR to
3111 /tmp.
3112 TIN_INDEX_SAVEDIR
3114 Define this variable if you do not want the .save directory in
3115 ${TIN_HOMEDIR:-"$HOME"}/.tin/. E.g., if you want all tin's save
3116 index files in /tmp/.save you would set $TIN_INDEX_SAVEDIR to
3117 /tmp.
3118 TIN_LIBDIR
3120 Define this variable if you want to override the NEWSLIBDIR path
3121 that was compiled into the tin binary, default is /usr/lib/news.
3122 If tin is running in NNTP mode setting this variable has no
3123 effect.
3124 TIN_SPOOLDIR
3126 Define this variable if you want to override the SPOOLDIR path
3127 that was compiled into the tin binary, default is
3128 /var/spool/news. If tin is running in NNTP mode setting this
3129 variable has no effect.
3130 TIN_NOVROOTDIR
3132 Define this variable if you want to override the NOVROOTDIR path
3133 that was compiled into the tin binary, default is SPOOLDIR (see
3134 above). If tin is running in NNTP mode setting this variable has
3135 no effect.
3136 TIN_NOVFILENAME
3138 Define this variable if you want to override the OVERVIEW_FILE
3139 filename that was compiled into the tin binary, default is
3140 .overview. If tin is running in NNTP mode setting this variable
3141 has no effect.
3142 TIN_ACTIVEFILE
3144 Define this variable if you want to override the NEWSLIB‐
3145 DIR/active path that was compiled into the tin binary. If tin is
3146 running in NNTP mode setting this variable has no effect. If
3147 $TIN_LIBDIR is set it is prepended to $TIN_ACTIVEFILE.
3148 NNTPSERVER
3150 The default NNTP server to remotely read news from. This vari‐
3151 able only needs to be set if the ''-r'' command-line option is
3152 specified and the file /etc/nntpserver does not exist. The
3153 ''-g'' command line option overrides $NNTPSERVER.
3154 NNTPPORT
3156 The NNTP TCP-port to read news from. This variable only needs to
3157 be set if the TCP-port is not 119 (the default). The ''-p''
3158 command-line option overrides $NNTPPORT.
3159 DISTRIBUTION
3161 Set the article header field ''Distribution:'' to the contents
3162 of the variable instead of the system default.
3163 ISO2ASC
3165 Set the ISO to ASCII charset decoding table character to use in
3166 decoding an article text. Values can range from -1 to 6.
3167 -1 no conversion
3169 0 universal table for many languages
3171 1 single-spacing universal table
3173 2 table for Danish, Dutch, German, Norwegian and Swedish
3175 3 table for Danish, Finnish, Norwegian and Swedish using the
3177 appropriate ISO 646 variant
3178 4 table with RFC1345 codes in brackets
3180 5 table for printers that allow overstriking with backspace
3182 6 table for IBM PC character set (code page 437)
3184 ORGANIZATION
3186 Set the article header field ''Organization:'' to the contents
3187 of the variable instead of the system default. If reading news
3188 on an Apollo DomainOS machine the environment variable $NEWSORG
3189 has to be used instead of $ORGANIZATION.
3190 NEWSORG (DomainOS)
3192 DomainOS specific, same as $ORGANIZATION on other OSs (see
3193 above).
3194 REPLYTO
3196 Set the article header field ''Reply-To:'' to the return address
3197 specified by the variable. This is useful if you wish to receive
3198 replies at a different address.
3199 NAME Overrides the full name given in the gecos-field in /etc/passwd,
3201 see also mail_address.
3202 REALNAME
3204 Same as $NAME.
3205 HOME Pathname of the user's home directory. See environ(5) for more
3207 info.
3208 MAILER This variable has precedence over the default mailer that is
3210 used in all mailing operations within tin.
3211 MAIL Full path to the user's mailbox.
3213 VISUAL This variable has precedence over the default editor (i.e.,
3215 vi(1)) that is used in all editing operations within tin (e.g.,
3216 posting, replying, follow-ups, ...). Evaluation order is ${VIS‐
3217 UAL:-"${EDITOR:-vi}"}. See environ(5) for more info.
3218 EDITOR If $VISUAL is unset, then this variable is looked up for a
3220 default editor. If $EDITOR and $VISUAL are both unset, tin uses
3221 the systems default editor (i.e. vi(1)) on UNIX-systems). See
3222 environ(5) for more info.
3223 AUTOSUBSCRIBE
3225 A new group is checked against the list of patterns; if it
3226 matches, tin subscribes the user to the group without further
3227 query. See the section "NEWSGROUP LISTS & WILDCARDS" for an
3228 explanation of the valid syntax. For example, setting
3229 AUTOSUBSCRIBE=comp.os.unix.*,talk.*,!talk.politics.*
3231 will automatically subscribe the user to all new groups in the
3233 comp.os.unix hierarchy, and all talk groups other than talk.pol‐
3234 itics groups (which will be queried for as usual). Of course
3235 this does not work if tin is started with the ''-X'' command-
3236 line switch.
3237 AUTOUNSUBSCRIBE
3239 Is handled like the $AUTOSUBSCRIBE variable, but groups matching
3240 the list are unsubscribed from without further query. For exam‐
3241 ple, setting
3242 AUTOUNSUBSCRIBE=alt.flame.*,u*,!uk.*
3244 will automatically unsubscribe the user from all new alt.flame
3246 groups and all groups starting with u (university groups) other
3247 than UK groups (which will be queried for as usual).
3248 TMPDIR A pathname of a directory made available for tin to create tem‐
3250 porary files.
3251 MAILCAPS
3253 This variable can be used to override the default path search
3254 for mailcap(5) files. See also tin(5).
3255 NOMETAMAIL
3257 Set this variable to disable the use of metamail(1) or a
3258 replacement (e.g. metamutt).
3259 MM_CHARSET
3261 MIME character set used if not configured via the tinrc variable
3262 mm_charset.
3263 ISPELL Set this variable to point to ispell(1) or a replacement and its
3265 cmd-line options.
3266 PGPOPTS
3268 Define any additional options that you wish to pass to your
3269 pgp(1) or gpg(1) program.
3270 PGPPATH
3272 Override the name of the pgp(1) directory in $HOME that holds
3273 your keys etc..
3274 GNUPGHOME
3276 Override the name of the gpg(1) directory in $HOME that holds
3277 your keys etc..
3278 LC_CTYPE
3280 This variable determines the locale(5) category for character
3281 handling functions. Usually it determines the character classes
3282 for pattern matching character classification and case conver‐
3283 sion. Currently this is not true for tin (which temporary unsets
3284 $LC_CTYPE right before any match is done to avoid confusion).
3285 It's value should be of the form language[_territory][.code‐
3286 set][@modifier]. See environ(5) for more information.
3287 LC_MESSAGES
3289 Formats of informative and diagnostic messages and interactive
3290 responses. It's value should be of the form language[_terri‐
3291 tory][.codeset][@modifier]. See locale(5) and environ(5) for
3292 more information.
3293 LC_TIME
3295 Date and time formats. It's value should be of the form lan‐
3296 guage[_territory][.codeset][@modifier]. See locale(5) and
3297 environ(5) for more information.
3298 LC_ALL This variable overrides the value of the $LANG variable and any
3300 other $LC_ variable. It's value should be of the form lan‐
3301 guage[_territory][.codeset]. See locale(5) and environ(5) for
3302 more information.
3303 LANG This variable determines the locale(5) category for any category
3305 not specifically selected with a variable starting with $LC_.
3306 It's value should be of the form language[_territory][.codeset].
3307 See environ(5) for more information.
3308 LANGUAGE
3310 This variable defines a priority list for translations. Whenever
3311 a translation is not available in the language selected via
3312 $LC_ALL or $LANG the next language from the list is tried. It's
3313 value should be of the form language:language[:language]. See
3314 environ(5) for more information.
3315 COLUMNS
3317 A decimal integer > 0 used to indicate the user's preferred
3318 width in column positions for the terminal screen or window. If
3319 this variable is unset or null, the implementation determines
3320 the number of columns, appropriate for the terminal or window.
3321 When $COLUMNS is set, any terminal-width information implied by
3322 $TERM will be overridden. Users and portable applications should
3323 not set $COLUMNS unless they wish to override the system selec‐
3324 tion and produce output unrelated to the terminal characteris‐
3325 tics.
3326 LINES A decimal integer > 0 used to indicate the user's preferred num‐
3328 ber of lines on a page or the vertical screen or window size in
3329 lines. A line in this case is a vertical measure large enough to
3330 hold the tallest character in the character set being displayed.
3331 If this variable is unset or null, the implementation determines
3332 the number of lines, appropriate for the terminal or window.
3333 When $LINES is set, any terminal-height information implied by
3334 $TERM will be overridden. Users and portable applications should
3335 not set $LINES unless they wish to override the system selec‐
3336 tion.
3337 TERM The type of terminal in use. This is used when looking up term‐
3339 cap sequences. See environ(5) for more information.
3340 DISPLAY
3342 Display name, pointing to the X server; required for xface.
3343 WINDOWID
3345 Used for determining terminal's X window id; required for xface.
3346 Should be set by the terminal emulator.
3347 SHELL The pathname of the user's login shell. Used to set
3349 default_shell_command.
3350 XDG_RUNTIME_DIR
3352 The pathname of the user's dir to put non-essential run time
3353 files into.
3354
3356 tin handles a couple of signals:
3357 SIGHUP Terminate gracefully.
3359 SIGTERM
3361 Terminate gracefully.
3362 SIGUSR1
3364 Terminate gracefully but do not restore terminal (tty).
3365 SIGUSR2
3367 Write out ${TIN_HOMEDIR:-"$HOME"}/.newsrc-file.
3368
3370 If tin is started in debug mode (''-D n'') it will create world read‐
3371 able files in $TMPDIR which may contain the users NNTP password in
3372 cleartext. On multiuser-systems $TMPDIR should be set to a safe loca‐
3373 tion before starting tin in debug mode (e.g. TMPDIR=$HOME tin -D 1).
3374
3376 tin does conform to the Base Definitions volume of IEEE Std
3377 1003.1-2008, Section 12, Utility Conventions (Utility Argument Syntax,
3378 Utility Syntax Guidelines).
3379
3381 Regular expression support is provided by the PCRE library package
3382 pcre(3), which is open source software, written by Philip Hazel, and
3383 copyright by the University of Cambridge, England.
3384 <ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/>
3385
3387 CNews NNTPd, noffle(1) (<= V1.0-pre5) and NewsCache (<= V1.1.91) can't
3388 handle pipelined GROUP commands. If you run into trouble with any of
3389 the mentioned servers define DISABLE_PIPELINING in include/autoconf.h
3390 and recompile.
3391 Before mailing a bug-report to <tin-bugs@tin.org> please check if you
3392 are using the latest (stable) release, and if not, please upgrade
3393 first! Have a look at the doc/TODO file for known bugs. If you still
3394 think you've found a bug, please use the BugReport ('R') function and
3395 write in English. Please do NOT enclose a core-file in your bug-report
3396 until we request it.
3397
3399 tin is based on the tass(1) newsreader that was developed by Rich
3400 Skrenta and posted to alt.sources in March 1991; its first version was
3401 released on August 23rd 1991. tass(1) itself was heavily influenced by
3402 notesfiles a public domain UNIX version of PLATO Notes, developed at
3403 the University of Illinois by Ray Essick and Rob Kolstad in 1982. For a
3404 version overview see
3405 <http://www.tin.org/history.html>.
3406
3408 Rich Skrenta
3409 author of tass(1) v3.2 which this newsreader used as its base.
3410 Bill Davidsen
3412 author of envarg.c environment variable reading routine.
3413 Mike Gleason
3415 author of sigfile.c random signature generation routines.
3416 Markus Kuhn <Markus.Kuhn@cl.cam.ac.uk>
3418 author of langinfo.c, charset.c and iso2asc.txt ISO-8859-1 docu‐
3419 mentation.
3420 Arnold Robbins
3422 author of strftime.c date formatting routine.
3423 Rich Salz
3425 author of wildmat.c pattern matching and parsdate.y date parsing
3426 routines.
3427 Dave Taylor
3429 author of curses.c from the elm(1) mailreader.
3430 Chris Thewalt
3432 author of getline.c emacs(1) style editing routine.
3433 Steven Madsen
3435 for adding pgp(1) (Pretty Good Privacy) support.
3436 Philip Hazel <ph10@cam.ac.uk>
3438 for pcre(3) (Perl-compatible regular expression library).
3439 Patrick Powell <papowell@astart.com>
3441 for snprintf(3) and vsnprintf(3) fallbacks.
3442
3444 Iain Lea <iain@bricbrac.de>
3445
3447 Urs Janssen <urs@tin.org>
3448
3450 elm(1), emacs(1), gpg(1), inews(1), ispell(1), lp(1), lpr(1),
3451 metamail(1), noffle(1), perl(1), perlre(1), pgp(1), rn(1), sendmail(1),
3452 shar(1), slrnface(1), tass(1), unshar(1), uudecode(1), vi(1),
3453 xterm(1x), heapsort(3), iconv(3), iconv_open(3), nl_langinfo(3),
3454 pcre(3), pcrepattern(3), qsort(3), snprintf(3), strftime(3),
3455 vsnprintf(3), wildmat(3), environ(5), locale(5), mailcap(5), mbox(5),
3456 mmdf(5), newsoverview(5), tin(5), cron(8), RFC1345, RFC1524, RFC2045,
3457 RFC2046, RFC2047, RFC2048, RFC2231, RFC2980, RFC3977, RFC4155, RFC4643,
3458 RFC5322, RFC5536, RFC5537, RFC6048
34592.4.5 December 24th, 2020 tin(1)