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