"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/l10n/en_GB/tin.1" between
tin-2.4.1.tar.gz and tin-2.4.2.tar.xz

About: TIN is a threaded NNTP and spool based UseNet newsreader.

tin.1  (tin-2.4.1):tin.1  (tin-2.4.2.tar.xz)
skipping to change at line 130 skipping to change at line 130
"AUTOMATIC MAILING AND SAVING NEW NEWS". "AUTOMATIC MAILING AND SAVING NEW NEWS".
-u Create/update index files for every group in ${TIN_HOMEDIR:- "$HOME"}/.newsrc or file speci- -u Create/update index files for every group in ${TIN_HOMEDIR:- "$HOME"}/.newsrc or file speci-
fied by the ”-f” option. This option is disabled if tin retri eves its index files via a NNTP fied by the ”-f” option. This option is disabled if tin retri eves its index files via a NNTP
server and cache_overview_files is turned off. server and cache_overview_files is turned off.
-v Verbose mode for ”-c”, ”-M”, ”-N”, ”-S”, ”-u” and ”-Z” option s. -v Verbose mode for ”-c”, ”-M”, ”-N”, ”-S”, ”-u” and ”-Z” option s.
-V Print version and date information. -V Print version and date information.
-w Quick mode to post an article and then exit. In order for thi -w Quick mode to post an article and then exit. This option imp
s to be really quick, it should lies ”-d”. In order for this to
be used with ”-n” if possible. be really quick, it should be used with ”-n” if possible.
-x No-posting mode. You cannot post articles if you use this opt ion. -x No-posting mode. You cannot post articles if you use this opt ion.
-X No overwrite mode. ${TIN_HOMEDIR:-"$HOME"}/.newsrc and files in ${TIN_HOMEDIR:-"$HOME"}/.tin -X No overwrite mode. ${TIN_HOMEDIR:-"$HOME"}/.newsrc and files in ${TIN_HOMEDIR:-"$HOME"}/.tin
will not be overwritten but may be created if they don't exis t. will not be overwritten but may be created if they don't exis t.
-z Only start tin if there is any new/unread news. If there is n ews tin will position cursor at -z Only start tin if there is any new/unread news. If there is n ews tin will position cursor at
first group with unread news. Useful for putting in login fil e. first group with unread news. Useful for putting in login fil e.
-Z Check if there is any new/unread news and exit with appropria te status. If ”-v” option is -Z Check if there is any new/unread news and exit with appropria te status. If ”-v” option is
skipping to change at line 494 skipping to change at line 494
or tagged articles as unread. A prompt asks which type should b e marked. or tagged articles as unread. A prompt asks which type should b e marked.
SetRange '#' SetRange '#'
Choose a range of articles to be affected by the next comman d. See the section "RANGES" for Choose a range of articles to be affected by the next comman d. See the section "RANGES" for
more information. more information.
LastViewed '-' LastViewed '-'
Re-enter the last message that was viewed. Re-enter the last message that was viewed.
SearchRepeat '\' SearchRepeat '\'
Repeat the previous search Repeat the previous search.
SearchSubjF '/' SearchSubjF '/'
Search forward for specified subject. Search forward for specified subject.
SearchSubjB '?' SearchSubjB '?'
Search backwards for specified subject. Search backwards for specified subject.
GroupSelThd '*' GroupSelThd '*'
Select current thread for later processing. Select current thread for later processing.
skipping to change at line 620 skipping to change at line 620
ARTICLES" for more information. ARTICLES" for more information.
OptionMenu 'M' OptionMenu 'M'
User configurable options menu (for more information see s ection "GLOBAL OPTIONS MENU AND User configurable options menu (for more information see s ection "GLOBAL OPTIONS MENU AND
TINRC CONFIGURABLE VARIABLES"). TINRC CONFIGURABLE VARIABLES").
GroupNextGroup 'n' GroupNextGroup 'n'
Go to next group. Go to next group.
GroupNextUnreadArt 'N' GroupNextUnreadArt 'N'
Go to next unread article. Go to the next unread article.
Print 'o' Send current article / thread / auto-selected (hot) articles / articles matching pattern / Print 'o' Send current article / thread / auto-selected (hot) articles / articles matching pattern /
tagged articles to printer. See the section "MAILING PIPIN G PRINTING REPOSTING AND SAVING tagged articles to printer. See the section "MAILING PIPIN G PRINTING REPOSTING AND SAVING
ARTICLES" for more information. ARTICLES" for more information.
GroupPrevGroup 'p' GroupPrevGroup 'p'
Go to previous group. Go to previous group.
GroupPrevUnreadArt 'P' GroupPrevUnreadArt 'P'
Go to previous unread article. Go to previous unread article.
skipping to change at line 1248 skipping to change at line 1248
Show mini menu & posting etiquette (beginner_level) Show mini menu & posting etiquette (beginner_level)
If set ON a mini menu of the most useful commands will be displayed at the bottom of the screen for If set ON a mini menu of the most useful commands will be displayed at the bottom of the screen for
each level. Also a short posting etiquette will be displayed after co mposing an article. Default is each level. Also a short posting etiquette will be displayed after co mposing an article. Default is
ON. ON.
Cache NNTP overview files locally (cache_overview_files) Cache NNTP overview files locally (cache_overview_files)
If ON, create local copies of NNTP overview files. This can be used t o considerably speed up access- If ON, create local copies of NNTP overview files. This can be used t o considerably speed up access-
ing large groups when using a slow connection. See also "INDEX FILES ". Default is OFF. ing large groups when using a slow connection. See also "INDEX FILES ". Default is OFF.
Hash algorithm for cancel-locks (cancel_lock_algo)
Use this hash algorithm for cancel-locks. Only available when build w
ith cancel-lock support. none
disables the generation of cancel-locks. Valid values are none, sha1,
sha256 and sha512. Default is
sha1.
Catchup read groups when quitting (catchup_read_groups) Catchup read groups when quitting (catchup_read_groups)
If set ON the user is asked when quitting if all groups read during t he current session should be If set ON the user is asked when quitting if all groups read during t he current session should be
marked read. Default is OFF. marked read. Default is OFF.
Standard background colour (col_back) Standard background colour (col_back)
Standard background colour Standard background colour
Colour of quoted text from external sources (col_extquote) Colour of quoted text from external sources (col_extquote)
Colour of quoted text from external sources Colour of quoted text from external sources
skipping to change at line 1782 skipping to change at line 1787
If the score of an article is above or equal this value the article g ets marked as hot. If the score of an article is above or equal this value the article g ets marked as hot.
Default score to kill articles (score_kill) Default score to kill articles (score_kill)
Score of an article which should be killed, this must be <= score_lim it_kill. Score of an article which should be killed, this must be <= score_lim it_kill.
Default score to select articles (score_select) Default score to select articles (score_select)
Score of an article which should be marked hot, this must be >= score _limit_select. Score of an article which should be marked hot, this must be >= score _limit_select.
Number of lines to scroll in pager (scroll_lines) Number of lines to scroll in pager (scroll_lines)
The number of lines that will be scrolled up/down in the article p ager when using cursor-up/down. The number of lines that will be scrolled up/down in the article p ager when using cursor-up/down.
The default is 1 (line-by-line). Set to 0 to get traditional tin page The default is 1 (line-by-line). Set to 0 to get traditional tin tin
-by-page scrolling. Set to -1 page-by-page scrolling. Set to
to get page-by-page scrolling where the top/bottom line is carried -1 to get page-by-page scrolling where the top/bottom line is carried
over onto the next page. This over onto the next page. This
setting supersedes show_last_line_prev_page=ON. Set to -2 to get half -page scrolling. This setting setting supersedes show_last_line_prev_page=ON. Set to -2 to get half -page scrolling. This setting
supersedes full_page_scroll=OFF. supersedes full_page_scroll=OFF.
Format string for the Selection level (select_format) Format string for the Selection level (select_format)
Format string tin uses for Selection level representation. See the section "CUSTOMISING THE SCREEN Format string tin uses for Selection level representation. See the section "CUSTOMISING THE SCREEN
FORMAT". Default is "%f %n %U %G %d". FORMAT". Default is "%f %n %U %G %d".
In group and thread level, show author by (show_author) In group and thread level, show author by (show_author)
Which information about the author should be shown. Default is 2, aut hors full name. Which information about the author should be shown. Default is 2, aut hors full name.
skipping to change at line 1839 skipping to change at line 1844
3 Lines & Score, display line count and score. 3 Lines & Score, display line count and score.
Show only unread articles (show_only_unread_arts) Show only unread articles (show_only_unread_arts)
If ON show only new/unread articles otherwise show all articles. Def ault is ON. If ON show only new/unread articles otherwise show all articles. Def ault is ON.
Show only groups with unread arts (show_only_unread_groups) Show only groups with unread arts (show_only_unread_groups)
If ON show only subscribed groups that contain unread articles. Defau lt is OFF. If ON show only subscribed groups that contain unread articles. Defau lt is OFF.
Display signatures (show_signatures) Display signatures (show_signatures)
If OFF don't show signatures when displaying articles. Default is ON . If OFF don't show signatures when displaying articles. Default is ON.
Prepend signature with '\n-- \n' (sigdashes) Prepend signature with '\n-- \n' (sigdashes)
If ON prefix the signature with sigdashes. Default is ON. If ON prefix the signature with sigdashes. Default is ON.
Create signature from path/command (sigfile) Create signature from path/command (sigfile)
The path that specifies the signature file to use when posting, fo llowing up to or replying to an The path that specifies the signature file to use when posting, fo llowing up to or replying to an
article. If the path is a directory then the signature will be random ly generated from files that article. If the path is a directory then the signature will be random ly generated from files that
are in the specified directory. If the path starts with a ! the pro gram the path points to will be are in the specified directory. If the path starts with a ! the pro gram the path points to will be
executed to generate a signature. tin will pass the name of the curre executed to generate a signature. In order to pass the group name to
nt newsgroup as argument to the the program, %G can be speci-
program. --none will suppress any signature. Default is ${TIN_HOMEDI fied. This will be replaced by the name of the current newsgroup.
R:-"$HOME"}/.Sig. --none will suppress any signa-
ture. Default is ${TIN_HOMEDIR:-"$HOME"}/.Sig.
Add signature when reposting (signature_repost) Add signature when reposting (signature_repost)
If ON add signature to reposted articles. Default is ON. If ON add signature to reposted articles. Default is ON.
Regex used to highlight /slashes/ (slashes_regex) Regex used to highlight /slashes/ (slashes_regex)
A regular expression that will be applied when reading articles. All matching words are shown in A regular expression that will be applied when reading articles. All matching words are shown in
col_markslash or mono_markslash. If slashes_regex is blank, then tin uses a built-in default. col_markslash or mono_markslash. If slashes_regex is blank, then tin uses a built-in default.
Sort articles by (sort_article_type) Sort articles by (sort_article_type)
This specifies how articles should be sorted. Sort by ascending Date (6) is the default. The follow- This specifies how articles should be sorted. Sort by ascending Date (6) is the default. The follow-
ing sort types are allowed: ing sort types are allowed:
0 Nothing, don't sort articles. 0 Nothing, don't sort articles.
1 Subject: (descending), sort articles by ”Subject:” field descendi ng. 1 Subject: (descending), sort articles by ”Subject:” field descendi ng.
skipping to change at line 1885 skipping to change at line 1891
7 Score (descending), sort articles by filtering score descending. 7 Score (descending), sort articles by filtering score descending.
8 Score (ascending), sort articles by filtering score ascending. 8 Score (ascending), sort articles by filtering score ascending.
9 Lines: (descending), sort articles by ”Lines:” field descending. 9 Lines: (descending), sort articles by ”Lines:” field descending.
10 Lines: (ascending), sort articles by ”Lines:” field ascending. 10 Lines: (ascending), sort articles by ”Lines:” field ascending.
Sort threads by (sort_threads_type) Sort threads by (sort_threads_type)
This specifies how threads will be sorted. Sort by descending Score (1) is the default. The follow- This specifies how threads will be sorted. Sort by descending Score ( 1) is the default. The follow-
ing sort types are allowed: ing sort types are allowed:
0 Nothing, don't sort threads. 0 Nothing, don't sort threads.
1 Score (descending), sort threads by filtering score descending (d efault). 1 Score (descending), sort threads by filtering score descending (d efault).
2 Score (ascending), sort threads by filtering score ascending. 2 Score (ascending), sort threads by filtering score ascending.
3 Last posting date (descending), sort threads by date of last post ing descending. 3 Last posting date (descending), sort threads by date of last post ing descending.
4 Last posting date (ascending), sort threads by date of last posti ng ascending. 4 Last posting date (ascending), sort threads by date of last posti ng ascending.
Spamtrap warning address parts (spamtrap_warning_addresses) Spamtrap warning address parts (spamtrap_warning_addresses)
Set this option to a list of comma-separated strings to be warned if Set this option to a list of comma-separated strings to be warned if
you are replying to an article you are replying to an article
by mail where the e-mail address contains one of these strings. Th by mail where the e-mail address contains one of these strings. The
e matching is case-insensitive. matching is case-insensitive.
Example: Example:
spam,delete,remove spam,delete,remove
Regex used to highlight *stars* (stars_regex) Regex used to highlight *stars* (stars_regex)
A regular expression that will be applied when reading articles. All matching words are shown in A regular expression that will be applied when reading articles. All matching words are shown in
col_markstar or mono_markstar. If stars_regex is blank, then tin uses a built-in default. col_markstar or mono_markstar. If stars_regex is blank, then tin uses a built-in default.
Start editor with line offset (start_editor_offset) Start editor with line offset (start_editor_offset)
Set ON if the editor used for posting, follow-ups and bug reports has the capability of starting and Set ON if the editor used for posting, follow-ups and bug reports has the capability of starting and
positioning the cursor at a specified line within a file. Default is ON. positioning the cursor at a specified line within a file. Default is ON.
Strip blanks of end of lines (strip_blanks) Strip blanks of end of lines (strip_blanks)
Strips the blanks from the end of each line therefore speeding up the display when reading on a slow Strips the blanks from the end of each line therefore speeding up the display when reading on a slow
terminal or via modem. Default is ON. terminal or via modem. Default is ON.
Remove bogus groups from newsrc (strip_bogus) Remove bogus groups from newsrc (strip_bogus)
Bogus groups are groups that are present in your ${TIN_HOMEDIR:-"$HOM E"}/.newsrc file that no longer Bogus groups are groups that are present in your ${TIN_HOMEDIR:-"$HOM E"}/.newsrc file that no longer
exist on the news server. There are 3 options. 0 means do nothing & a exist on the news server. There are 3 options. 0 means do nothing
lways keep bogus groups. 1 & always keep bogus groups. 1
means bogus groups will be permanently removed. 2 means that bogus means bogus groups will be permanently removed. 2 means that bogus gr
groups will appear on the Group oups will appear on the Group
Selection Menu, prefixed with a 'D'. This allows you to unsubscribe f Selection Menu, prefixed with a 'D'. This allows you to unsubscribe
rom them as and when you wish. from them as and when you wish.
Default is 0 (Always Keep). Default is 0 (Always Keep).
No unsubscribed groups in newsrc (strip_newsrc) No unsubscribed groups in newsrc (strip_newsrc)
If ON, then unsubscribed groups will be permanently r emoved from your ${TIN_HOME- If ON, then unsubscribed groups will be permanently remo ved from your ${TIN_HOME-
DIR:-"$HOME"}/.newsrc file. Default is OFF. DIR:-"$HOME"}/.newsrc file. Default is OFF.
Regex used to highlight -strokes- (strokes_regex) Regex used to highlight -strokes- (strokes_regex)
A regular expression that will be applied when reading articles. All matching words are shown in A regular expression that will be applied when reading articles. All matching words are shown in
col_markstroke or mono_markstroke. If strokes_regex is blank, then t in uses a built-in default. col_markstroke or mono_markstroke. If strokes_regex is blank, then t in uses a built-in default.
Wrap around threads on next unread (wrap_on_next_unread) Wrap around threads on next unread (wrap_on_next_unread)
If enabled a search for the next unread article will wrap around all articles to find also previous If enabled a search for the next unread article will wrap around all articles to find also previous
unread articles. If disabled the search stops at the end of the threa d list. Default is ON. unread articles. If disabled the search stops at the end of the threa d list. Default is ON.
Display "a as Umlaut-a (tex2iso_conv) Display "a as Umlaut-a (tex2iso_conv)
If ON, show "a as Umlaut-a, etc. Default is OFF. This behaviour can a lso be toggled in the article If ON, show "a as Umlaut-a, etc. Default is OFF. This behaviour can also be toggled in the article
viewer via PageToggleTex2iso ('"'). viewer via PageToggleTex2iso ('"').
Thread articles by (thread_articles) Thread articles by (thread_articles)
Defines which threading method to use. It's possible to set the thre Defines which threading method to use. It's possible to set the threa
ading type on a per group basis ding type on a per group basis
by setting the group attribute variable thread_arts to 0 - by setting the group attribute variable thread_arts to 0 -
4 in the file ${TIN_HOME- 4 in the file ${TIN_HOME-
DIR:-"$HOME"}/.tin/attributes. (See also "GROUP ATTRIBUTES".) The d DIR:-"$HOME"}/.tin/attributes. (See also "GROUP ATTRIBUTES".) The de
efault is Both Subject and Ref- fault is Both Subject and Ref-
erences. The choices are: erences. The choices are:
0 None, don't thread. 0 None, don't thread.
1 Subject, thread on ”Subject:” only. 1 Subject, thread on ”Subject:” only.
2 References, thread on ”References:” only. 2 References, thread on ”References:” only.
3 Both Subject and References, thread on ”References:” then ”Subjec t:” (default). 3 Both Subject and References, thread on ”References:” then ”Subjec t:” (default).
skipping to change at line 1966 skipping to change at line 1972
5 Percentage Match, thread base upon a partial character match on ” Subject:”. 5 Percentage Match, thread base upon a partial character match on ” Subject:”.
Catchup thread by using left key (thread_catchup_on_exit) Catchup thread by using left key (thread_catchup_on_exit)
If ON catchup group/thread when leaving with the left arrow key. Defa ult is ON. If ON catchup group/thread when leaving with the left arrow key. Defa ult is ON.
Format string for the Thread level (thread_format) Format string for the Thread level (thread_format)
Format string tin uses for Thread level representation. See the secti on "CUSTOMISING THE SCREEN FOR- Format string tin uses for Thread level representation. See the secti on "CUSTOMISING THE SCREEN FOR-
MAT". Default is "%n %m [%L] %T %F". MAT". Default is "%n %m [%L] %T %F".
Matchingness of a thread (thread_perc) Matchingness of a thread (thread_perc)
How closely the subjects must match for two threads to be considere d part of the same thread. This How closely the subjects must match for two threads to be considered part of the same thread. This
is a percentage and the default if 75%. is a percentage and the default if 75%.
Score of a thread (thread_score) Score of a thread (thread_score)
How the total score of a thread is computed. Default is 0, the maximu m score in this thread. How the total score of a thread is computed. Default is 0, the maximu m score in this thread.
0 Max, the maximum score in this thread. 0 Max, the maximum score in this thread.
1 Sum, the sum of all scores in this thread. 1 Sum, the sum of all scores in this thread.
2 Average, the average score in this thread. 2 Average, the average score in this thread.
Transliteration (translit) Transliteration (translit)
If ON append //TRANSLIT to the first argument of iconv_open(3) to If ON append //TRANSLIT to the first argument of iconv_open(3)
enable transliteration. This to enable transliteration. This
means that when a character cannot be represented in the target ch means that when a character cannot be represented in the target chara
aracter set, it can be approxi- cter set, it can be approxi-
mated through one or several similarly looking characters. On systems mated through one or several similarly looking characters. On syste
where this extension doesn't ms where this extension doesn't
exist, this option is disabled. Default is OFF. exist, this option is disabled. Default is OFF.
How to treat blank lines (trim_article_body) How to treat blank lines (trim_article_body)
Allows you to select how tin treats blank lines in article bodies. Default is 0. This option does Allows you to select how tin treats blank lines in article bodies. D efault is 0. This option does
not affect lines within verbatim blocks. not affect lines within verbatim blocks.
0 Don't trim article body, do nothing. 0 Don't trim article body, do nothing.
1 Skip leading blank lines. 1 Skip leading blank lines.
2 Skip trailing blank lines. 2 Skip trailing blank lines.
3 Skip leading and trailing blank l., skip leading and trailing bla nk lines. 3 Skip leading and trailing blank l., skip leading and trailing bla nk lines.
4 Compact multiple between text, replace multiple blank lines betwe en textblocks with one blank 4 Compact multiple between text, replace multiple blank lines be tween textblocks with one blank
line. line.
5 Compact multiple and skip leading, 4 + 1 5 Compact multiple and skip leading, 4 + 1
6 Compact multiple and skip trailing, 4 + 2 6 Compact multiple and skip trailing, 4 + 2
7 Compact mltpl., skip lead. & trai., 4 + 3 7 Compact mltpl., skip lead. & trai., 4 + 3
Regex used to highlight _underline_ (underscores_regex) Regex used to highlight _underline_ (underscores_regex)
A regular expression that will be applied when reading articles. All matching words are shown in A regular expression that will be applied when reading articles. All matching words are shown in
col_markdash or mono_markdash. If underscores_regex is blank, then ti n uses a built-in default. col_markdash or mono_markdash. If underscores_regex is blank, then ti n uses a built-in default.
Remove ~/.article after posting (unlink_article) Remove ~/.article after posting (unlink_article)
If ON remove ~/.article after posting. Default is ON. If ON remove ~/.article after posting. Default is ON.
Program that opens URLs (url_handler) Program that opens URLs (url_handler)
The program that will be run when launching URLs in the article viewe r using PageViewUrl ('U'). The The program that will be run when launching URLs in the article view er using PageViewUrl ('U'). The
actual URL will be appended to this. Default is url_handler.pl %s. actual URL will be appended to this. Default is url_handler.pl %s.
URL highlighting in message body (url_highlight) URL highlighting in message body (url_highlight)
Enable highlighting URLs in message body. Default is ON. Enable highlighting URLs in message body. Default is ON.
Use ANSI colour (use_color) Use ANSI colour (use_color)
If enabled tin uses ANSI-colours. Default is OFF. If enabled tin uses ANSI-colours. Default is OFF.
Use scroll keys on keypad (use_keypad) Use scroll keys on keypad (use_keypad)
Default is OFF. Default is OFF.
Use mouse in xterm (use_mouse) Use mouse in xterm (use_mouse)
Allows the mouse button support in a xterm(1x) to be enabled/disable d. Default is OFF. Allows the mouse button support in a xterm(1x) to be enabled/disable d. Default is OFF.
Use slrnface to show ”X-Face:”s (use_slrnface) Use slrnface to show ”X-Face:”s (use_slrnface)
If enabled tin uses slrnface(1) to interpret the ”X-Face:” head er. For this option to have any If enabled tin uses slrnface(1) to interpret the ”X-Face:” header. F or this option to have any
effect, tin must be running in a xterm(1x) and slrnface(1) must be in your $PATH. Default is OFF. effect, tin must be running in a xterm(1x) and slrnface(1) must be in your $PATH. Default is OFF.
Use UTF-8 graphics (utf8_graphics) Use UTF-8 graphics (utf8_graphics)
If ON use UTF-8 characters for indicator ('->'), thread/attachment tree and ellipsis ('...'). If ON use UTF-8 characters for indicator ('->'), thread/attach ment tree and ellipsis ('...').
Default is OFF. Default is OFF.
Regex for begin of a verbatim block (verbatim_begin_regex) Regex for begin of a verbatim block (verbatim_begin_regex)
A regular expression that tin will use to find the begin of a verbati m block. A regular expression that tin will use to find the begin of a verbat im block.
Regex for end of a verbatim block (verbatim_end_regex) Regex for end of a verbatim block (verbatim_end_regex)
A regular expression that tin will use to find the end of a verbatim block. A regular expression that tin will use to find the end of a verbatim block.
Detection of verbatim blocks (verbatim_handling) Detection of verbatim blocks (verbatim_handling)
If ON verbatim blocks will be detected. Default is ON. If ON verbatim blocks will be detected. Default is ON.
Wildcard matching (wildcard) Wildcard matching (wildcard)
Allows you to select how tin matches strings. The default is 0 and u ses the wildmat notation, which Allows you to select how tin matches strings. The default is 0 and us es the wildmat notation, which
is how this has traditionally been handled. Setting this to 1 allows you to use perl(1) compatible is how this has traditionally been handled. Setting this to 1 allows you to use perl(1) compatible
regular expressions pcre(3) (see also perlre(1) and pcrepattern( 3)). You will probably want to regular expressions pcre(3) (see also perlre(1) and pcrepattern(3)) . You will probably want to
update your filter file if you use this regularly. NB: Newsgroup nam es will always be matched using update your filter file if you use this regularly. NB: Newsgroup nam es will always be matched using
the wildmat notation. the wildmat notation.
What to display instead of mark (word_h_display_marks) What to display instead of mark (word_h_display_marks)
Should the leading and ending stars, slashes, strokes and dashes al so be displayed, even when they Should the leading and ending stars, slashes, strokes and dashes also be displayed, even when they
are highlighting marks? are highlighting marks?
0 no 0 no
1 yes, display mark 1 yes, display mark
2 print a space instead 2 print a space instead
Word highlighting in message body (word_highlight) Word highlighting in message body (word_highlight)
Enable word highlighting. See word_h_display_marks for the options Enable word highlighting. See word_h_display_marks for the opt
available. If use_color is ions available. If use_color is
enabled the colours specified in col_markdash, col_markslash, col_ enabled the colours specified in col_markdash, col_markslash, col_mar
markstar and col_markstroke are kstar and col_markstroke are
used for word highlighting else the character attributes specified in mono_markdash, mono_markslash, used for word highlighting else the character attributes specified in mono_markdash, mono_markslash,
mono_markstar and mono_markstroke are used. Default is ON. mono_markstar and mono_markstroke are used. Default is ON.
Page line wrap column (wrap_column) Page line wrap column (wrap_column)
Sets the column at which a displayed article body should be wrapped Sets the column at which a displayed article body should be wrapped.
. If this value is equal to 0, If this value is equal to 0,
it defaults to the current screen width. If this value is greater th it defaults to the current screen width. If this value is greater
an your current screen width than your current screen width
the part off-screen is not displayed. Thus setting this option to a the part off-screen is not displayed. Thus setting this option to a l
large value can be used to dis- arge value can be used to dis-
able wrapping. If this value is negative the wrap margin is the curre able wrapping. If this value is negative the wrap margin is the curr
nt screen width plus the given ent screen width plus the given
value (as long as the result is still positive, otherwise it will value (as long as the result is still positive, otherwise it will fal
fall back to the current screen l back to the current screen
width). Default is 0, wrapping at the current screen width. width). Default is 0, wrapping at the current screen width.
Quote line when crossposting (xpost_quote_format) Quote line when crossposting (xpost_quote_format)
Format is the same as for news_quote_format, this is used when answer ing to a crossposting to sev- Format is the same as for news_quote_format, this is used when answ ering to a crossposting to sev-
eral groups with no ”Followup-To:” set. eral groups with no ”Followup-To:” set.
ATTRIBUTES MENU AND GROUP ATTRIBUTES ATTRIBUTES MENU AND GROUP ATTRIBUTES
tin allows certain attributes to be set on a per group basis. If it exis tin allows certain attributes to be set on a per group basis. If it exist
ts, the global attributes file, s, the global attributes file,
${TIN_LIBDIR:-NEWSLIBDIR}/attributes is read. After that, the user's own ${TIN_LIBDIR:-NEWSLIBDIR}/attributes is read. After that, the user's
attributes file ${TIN_HOME- own attributes file ${TIN_HOME-
DIR:-"$HOME"}/.tin/attributes is read. The global attributes file DIR:-"$HOME"}/.tin/attributes is read. The global attributes file is
is useful for distributing sys- useful for distributing sys-
tem-wide defaults to new users who have no private attributes file yet. tem-wide defaults to new users who have no private attributes file yet.
Note that the scope=<grouplist> line has to be specified before the attri Note that the scope=<grouplist> line has to be specified before the at
butes are specified for that tributes are specified for that
list. All attributes are set to a reasonable default so you only have to list. All attributes are set to a reasonable default so you only have to
specify the attribute that you specify the attribute that you
want to change (e.g., savedir). All toggle attributes are set by specify want to change (e.g., savedir). All toggle attributes are set by spec
ing ON/OFF. Otherwise, these ifying ON/OFF. Otherwise, these
function exactly the same as their global equivalents. For more details s ee tin(5). function exactly the same as their global equivalents. For more details s ee tin(5).
Attributes can also be changed from the attributes menu which can be Attributes can also be changed from the attributes menu which can be a
accessed by ConfigToggleAttrib ccessed by ConfigToggleAttrib
('<TAB>') from the options menu or ScopeSelect ('^J' or '<CR>') from the ('<TAB>') from the options menu or ScopeSelect ('^J' or '<CR>') from t
scopes menu. The attributes he scopes menu. The attributes
menu looks and behaves very similar to the options menu. The title show menu looks and behaves very similar to the options menu. The title shows
s the current scope. Attributes the current scope. Attributes
set in the current scope are marked with '+' to the left of the attribute s number. set in the current scope are marked with '+' to the left of the attribute s number.
Besides the keys for moving around and changing values known from the opt ions menu the attributes menu Besides the keys for moving around and changing values known from the o ptions menu the attributes menu
provides the following command: ConfigResetAttrib ('r') which resets an a ttribute to a default value. provides the following command: ConfigResetAttrib ('r') which resets an a ttribute to a default value.
SCOPES MENU SCOPES MENU
The scopes menu (accessible from the options menu with ConfigScopeMenu (' S')) shows all scopes read from The scopes menu (accessible from the options menu with ConfigScopeMenu (' S')) shows all scopes read from
the global and local attributes file. Scopes from the global attributes file are marked with '!' to the the global and local attributes file. Scopes from the global attributes file are marked with '!' to the
left of the scope number. Delete/rename/move are not possible with those scopes. left of the scope number. Delete/rename/move are not possible with those scopes.
In addition to the common moving keys the following commands are availabl e: ScopeSelect ('^J' or '<CR>') In addition to the common moving keys the following commands are availabl e: ScopeSelect ('^J' or '<CR>')
enter the attributes menu for the current scope, ScopeEditAttributesFile ('E') edit the local attributes enter the attributes menu for the current scope, ScopeEditAttributesFile ('E') edit the local attributes
file, ScopeAdd ('a') add a new scope, ScopeDelete ('d') delete the curr ent scope, ScopeMove ('m') move file, ScopeAdd ('a') add a new scope, ScopeDelete ('d') delete the curren t scope, ScopeMove ('m') move
the current scope to a new position, ScopeRename ('r') rename the current scope. ToggleHelpDisplay ('H') the current scope to a new position, ScopeRename ('r') rename the current scope. ToggleHelpDisplay ('H')
toggles the help mini menu at the bottom of the screen. toggles the help mini menu at the bottom of the screen.
FILTERING ARTICLES FILTERING ARTICLES
When there is a subject or an author which you are either very interest When there is a subject or an author which you are either very interested
ed in, or find completely unin- in, or find completely unin-
teresting, you can easily instruct tin to auto-select or auto-kill articl teresting, you can easily instruct tin to auto-select or auto-kill art
es that match rules that you icles that match rules that you
specify. This can be anything from the name of the author to the number o f lines in an article. specify. This can be anything from the name of the author to the number o f lines in an article.
When tin starts up the user's kill-file ${TIN_HOMEDIR:-"$HOME"}/.tin/fil When tin starts up the user's kill-file ${TIN_HOMEDIR:-"$HOME"}/.tin/filt
ter (see also tin(5)) is read. er (see also tin(5)) is read.
Each time a newsgroup is entered the rules are applied and articles kille Each time a newsgroup is entered the rules are applied and articles ki
d or selected when they meet lled or selected when they meet
certain criteria. certain criteria.
The degree to which rules are applied depend on the kill_level tinrc sett ing. By default killed articles The degree to which rules are applied depend on the kill_level tinrc sett ing. By default killed articles
will only be marked read. Adjust kill_level for more aggressive process ing. Articles that match an will only be marked read. Adjust kill_level for more aggressive pro cessing. Articles that match an
auto-selection rule are marked with a ”*”. auto-selection rule are marked with a ”*”.
Filtering rules can be manually entered into ${TIN_HOMEDIR:-"$HOME"} /.tin/filter (but don't do this Filtering rules can be manually entered into ${TIN_HOMEDIR:-"$HOME"}/.ti n/filter (but don't do this
whilst running tin else you will lose your changes) or by using an on-scr een menu within tin. whilst running tin else you will lose your changes) or by using an on-scr een menu within tin.
The filtering capabilities of tin have been significantly enhanced over previous versions to include The filtering capabilities of tin have been significantly enhanced ov er previous versions to include
scoring and better pattern matching. It is recommended that you read the file filtering in the tin docu- scoring and better pattern matching. It is recommended that you read the file filtering in the tin docu-
mentation directory. This file can also be read online at mentation directory. This file can also be read online at
<http://www.tin.org/filtering.txt>. <http://www.tin.org/filtering.txt>.
The on-screen filtering menu is accessed by pressing MenuFilterKill ('^K' The on-screen filtering menu is accessed by pressing MenuFilterKill ('
) or MenuFilterSelect ('^A') ^K') or MenuFilterSelect ('^A')
at the Group and Article levels. It allows the user to kill or select a at the Group and Article levels. It allows the user to kill or select an
n article that matches the cur- article that matches the cur-
rent ”Subject:” line, ”From:” line or a string entered by the user. The rent ”Subject:” line, ”From:” line or a string entered by the user.
user entered string can be The user entered string can be
applied to the ”Subject:” or ”From:” line of an article. The filter can applied to the ”Subject:” or ”From:” line of an article. The filter can b
be limited to the current news- e limited to the current news-
group or it can apply to all newsgroups. Once entered the user can abort group or it can apply to all newsgroups. Once entered the user can abo
the command and not save the rt the command and not save the
new filter, edit the full filter file or save filter. new filter, edit the full filter file or save filter.
POSTING ARTICLES POSTING ARTICLES
tin allows posting of articles, follow-up to already posted articles and replying direct through mail to tin allows posting of articles, follow-up to already posted articles and replying direct through mail to
the author of an article. the author of an article.
Use the Post ('w') command to post an article to a newsgroup. After en Use the Post ('w') command to post an article to a newsgroup. Afte
tering the post subject the r entering the post subject the
default editor (i.e., vi(1)) or the editor specified by the $VISUAL default editor (i.e., vi(1)) or the editor specified by the $VISUAL or
or $EDITOR environment variable $EDITOR environment variable
will be started and the article can be entered. To crosspost articles sim ply add a comma and the name of will be started and the article can be entered. To crosspost articles sim ply add a comma and the name of
the newsgroup(s) to the end of the ”Newsgroups:” line at the beginning o the newsgroup(s) to the end of the ”Newsgroups:” line at the beginning of
f the article. After saving and the article. After saving and
exiting the editor you are asked if you wish to a)bort posting the articl exiting the editor you are asked if you wish to a)bort posting the arti
e, e)dit the article again or cle, e)dit the article again or
p)ost the article to the specified newsgroup(s). p)ost the article to the specified newsgroup(s).
Use the DisplayPostHist ('W') command to display a history of the article s you have posted. The date the Use the DisplayPostHist ('W') command to display a history of the article s you have posted. The date the
article was posted, which newsgroups the article was posted to and the ar ticles subject line are dis- article was posted, which newsgroups the article was posted to and the articles subject line are dis-
played. played.
Use the PageFollowupQuote ('f'), PageFollowup ('F') or PageFollowupQuot Use the PageFollowupQuote ('f'), PageFollowup ('F') or PageFollowupQuote
eHeaders ('^W') command to post Headers ('^W') command to post
a follow-up article to an already posted article. The PageFollowupQuote c a follow-up article to an already posted article. The PageFollowupQuot
ommand will copy the text of e command will copy the text of
the original article into the editor. The PageFollowupQuoteHeaders com the original article into the editor. The PageFollowupQuoteHeaders comman
mand will copy the text and all d will copy the text and all
headers of the original article into the editor. The editing procedure is headers of the original article into the editor. The editing procedure
the same as when posting an is the same as when posting an
article with the Post ('w') command. article with the Post ('w') command.
Use the PageReplyQuote ('r'), PageReply ('R') or PageReplyQuoteHeaders Use the PageReplyQuote ('r'), PageReply ('R') or PageReplyQuoteHeaders ('
('^E') command to reply direct ^E') command to reply direct
through mail to the author of an already posted article. The PageReplyQuo through mail to the author of an already posted article. The PageReplyQ
te command will copy the text uote command will copy the text
of the original article into the editor. The PageReplyQuoteHeaders com of the original article into the editor. The PageReplyQuoteHeaders comman
mand will copy the text and all d will copy the text and all
headers of the original article into the editor. The editing procedure is headers of the original article into the editor. The editing procedure
the same as when posting an is the same as when posting an
article with the Post ('w') command. After saving and exiting the edit article with the Post ('w') command. After saving and exiting the editor
or you are asked if you wish to you are asked if you wish to
abort sending the article via PostAbort ('a'), edit the article again via abort sending the article via PostAbort ('a'), edit the article again
PostEdit ('e') or send the via PostEdit ('e') or send the
article to the author via PostSend ('s'). article to the author via PostSend ('s').
CUSTOMISING THE ARTICLE QUOTE STRING CUSTOMISING THE ARTICLE QUOTE STRING
When posting a followup to an article or replying direct to the author o When posting a followup to an article or replying direct to the author of
f an article via email the text an article via email the text
of the article can be quoted. The beginning of the quoted text can contai of the article can be quoted. The beginning of the quoted text can conta
n information about the quoted in information about the quoted
article (e.g., Name and the Message-ID of the article). To allow for diff erent situations certain infor- article (e.g., Name and the Message-ID of the article). To allow for diff erent situations certain infor-
mation from the article can be used in the quoted string. The following v ariables are expanded if found mation from the article can be used in the quoted string. The following variables are expanded if found
in the tinrc variables mail_quote_format, news_quote_format or xpost_quot e_format: in the tinrc variables mail_quote_format, news_quote_format or xpost_quot e_format:
%A Address (Email) %A Address (Email)
%D Date (uses date_format) %D Date (uses date_format)
%F Full address (%N <%A>) %F Full address (%N <%A>)
%G Groupname %G Groupname
%M Message-ID %M Message-ID
%N Fullname of author %N Fullname of author
%C Firstname of author %C Firstname of author
%I Initials of author %I Initials of author
e.g., e.g.,
mail_quote_format=On %D in %G you wrote: mail_quote_format=On %D in %G you wrote:
news_quote_format=In %M, %F wrote: news_quote_format=In %M, %F wrote:
would expand to: would expand to:
On 21 Sep 1993 09:45:51 -0400 in alt.sources you wrote: On 21 Sep 1993 09:45:51 -0400 in alt.sources you wrote:
In <abcINN123@example.org>, Joe Bar <joe@example.org> wrote: In <abcINN123@example.org>, Joe Bar <joe@example.org> wrote:
The quoted text section of an article is marked by a preceding quote The quoted text section of an article is marked by a preceding quote stri
string at the beginning of each ng at the beginning of each
quoted line. The default quote string is set to '>_'. The default can be quoted line. The default quote string is set to '>_'. The default can
changed by setting the tinrc be changed by setting the tinrc
variable quote_chars to ones own preference. (Note that '_' underline is used to represent a space). variable quote_chars to ones own preference. (Note that '_' underline is used to represent a space).
MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES
The command interface to GroupMail, PageMail, PostMail or ThreadMail The command interface to GroupMail, PageMail, PostMail or ThreadMail ('m'
('m'), Pipe ('|'), Print ('o'), ), Pipe ('|'), Print ('o'),
PageRepost or GroupRepost ('x') and GroupSave, PageSave or ThreadSave ('s PageRepost or GroupRepost ('x') and GroupSave, PageSave or ThreadSave
' and GroupAutoSave, PageAu- ('s' and GroupAutoSave, PageAu-
toSave or ThreadAutoSave 'S') articles is the same for ease of use. toSave or ThreadAutoSave 'S') articles is the same for ease of use.
Auto-saving with *AutoSave ('S') is a special case and operates only on marked articles. They will pro- Auto-saving with *AutoSave ('S') is a special case and operates only on m arked articles. They will pro-
cessed without any further prompting according to the default save parame ters defined in tinrc or by any cessed without any further prompting according to the default save parame ters defined in tinrc or by any
attributes set for the current group. attributes set for the current group.
Otherwise, the initial prompt will ask you to select which article, threa d, hot (auto-selected), regular Otherwise, the initial prompt will ask you to select which article, threa d, hot (auto-selected), regular
expression pattern, tagged articles you wish to mail, pipe etc. expression pattern, tagged articles you wish to mail, pipe etc.
Tagged articles must have already been tagged with a *Tag ('t') command. All tagged articles can be Tagged articles must have already been tagged with a *Tag ('t') comm and. All tagged articles can be
untagged by a *Untag ('U') untag command. untagged by a *Untag ('U') untag command.
If a regular expression pattern is selected you are asked to enter a pa If a regular expression pattern is selected you are asked to enter a patt
ttern (e.g., to match all arti- ern (e.g., to match all arti-
cles subject lines containing 'net News' you enter "net News"). Any arti cles subject lines containing 'net News' you enter "net News"). Any
cles that match the entered articles that match the entered
expression will be mailed, piped etc. See also the wildcard tinrc variabl e for advanced pattern matching expression will be mailed, piped etc. See also the wildcard tinrc variabl e for advanced pattern matching
options. options.
Various expansion characters are recognised when entering the directory a nd file to save to. Environment Various expansion characters are recognised when entering the directory a nd file to save to. Environment
variables (prefixed with '$') and user home directories (prefixed by '~ ' or '~username') can be speci- variables (prefixed with '$') and user home directories (prefixed by '~' or '~username') can be speci-
fied. Environment variables can themselves contain other special charact ers. fied. Environment variables can themselves contain other special charact ers.
To save articles to a mailbox enter '=<mailbox name>' when asked for the To save articles to a mailbox enter '=<mailbox name>' when asked for
save filename. If you enter the save filename. If you enter
just '=' then articles will be saved to a mailbox with the nam just '=' then articles will be saved to a mailbox with the name of
e of the current newsgroup (eg, the current newsgroup (eg,
alt.sources). See maildir. alt.sources). See maildir.
To save in savedir/<news.group.name>/<filename> format enter '+<filename> '. Environment variables are To save in savedir/<news.group.name>/<filename> format enter '+<filenam e>'. Environment variables are
allowed within a filename (e.g., $SOURCES/dir/filename). See savedir. allowed within a filename (e.g., $SOURCES/dir/filename). See savedir.
When saving articles you can specify whether the saved files should be po st processed. A default process When saving articles you can specify whether the saved files should be po st processed. A default process
type can be set via post_process_type. type can be set via post_process_type.
AUTOMATIC MAILING AND SAVING NEW NEWS AUTOMATIC MAILING AND SAVING NEW NEWS
tin allows new/unread news articles to be mailed (”-M” and ”-N” option) o tin allows new/unread news articles to be mailed (”-M” and ”-N” option)
r saved (”-S” option) in batch or saved (”-S” option) in batch
mode for later reading. Useful when going on holiday and you don't want mode for later reading. Useful when going on holiday and you don't want t
to return and find that expire o return and find that expire
has removed a whole load of unread articles. Best to run via cron(1) eve has removed a whole load of unread articles. Best to run via cron(1) e
ryday while away, after which veryday while away, after which
you will be mailed a report of which articles were mailed/saved from whic h newsgroups and the total num- you will be mailed a report of which articles were mailed/saved from whic h newsgroups and the total num-
ber of articles mailed/saved. Articles are saved in a private news struct ber of articles mailed/saved. Articles are saved in a private news stru
ure under your savedir direc- cture under your savedir direc-
tory (default is ${TIN_HOMEDIR:-"$HOME"}/News). Be careful of using t tory (default is ${TIN_HOMEDIR:-"$HOME"}/News). Be careful of using this
his option if you read a lot of option if you read a lot of
groups because you could overflow your file system. groups because you could overflow your file system.
When using ”-S” together with a given directory to save to (”-s” option), the same directory must be When using ”-S” together with a given directory to save to (”-s” opti on), the same directory must be
specified when reading the articles by ”-R”. specified when reading the articles by ”-R”.
If you only want to save some of your groups use the batch_save tinr If you only want to save some of your groups use the batch_save tinrc var
c variable. Set to ON or OFF in iable. Set to ON or OFF in
tinrc to enable/disable saving of all groups and then use the batch_save tinrc to enable/disable saving of all groups and then use the batch_sa
attribute to fine tune which ve attribute to fine tune which
groups you want to have saved. For example, if you want to save most of y our groups, then set batch_save groups you want to have saved. For example, if you want to save most of y our groups, then set batch_save
to ON in tinrc and selectively turn off the ones you don't want using att ributes. to ON in tinrc and selectively turn off the ones you don't want using att ributes.
tin -M iain -c -f newsrc.mail tin -M iain -c -f newsrc.mail
(mail any unread articles in newsgroups specified in file newsrc.mail to the local (mail any unread articles in newsgroups specified i n file newsrc.mail to the local
user iain and mark them as read) user iain and mark them as read)
tin -S -c -f newsrc.save tin -S -c -f newsrc.save
(save any unread articles in newsgroups specified in file newsrc.save and mark them (save any unread articles in newsgroups specified in file newsrc.save and mark them
as read) as read)
tin -R (read any articles saved by tin -S) tin -R (read any articles saved by tin -S)
RANGES RANGES
A range is simply a group of items marked using the SetRange ('#') key. C A range is simply a group of items marked using the SetRange ('#') key.
ertain tin commands will oper- Certain tin commands will oper-
ate on a range if one exists rather than just the current item. A ran ate on a range if one exists rather than just the current item. A range i
ge is an expression of the form s an expression of the form
<min>-<max>, e.g. 10-15 will highlight items 10 through 15 on the current <min>-<max>, e.g. 10-15 will highlight items 10 through 15 on the curr
screen. Other than absolute ent screen. Other than absolute
numeric positions, '.' can be used in place of the current cursor posit numeric positions, '.' can be used in place of the current cursor positio
ion and '$' can be used to mean n and '$' can be used to mean
the highest number available. Currently the only commands that understand the highest number available. Currently the only commands that underst
ranges are GroupMarkThdRead and ranges are GroupMarkThdRead
('K'), MarkArtUnread ('z') and MarkThdUnread ('Z'). ('K'), MarkArtUnread ('z') and MarkThdUnread ('Z').
NEWSGROUP LISTS & WILDCARDS NEWSGROUP LISTS & WILDCARDS
Several places in tin allow you to specify a list of newsgroups. The Several places in tin allow you to specify a list of newsgroups. These
se include command-line groups, include command-line groups,
(un)subscribe groups, the AUTO[UN]SUBSCRIBE mechanism. The scope= attribu (un)subscribe groups, the AUTO[UN]SUBSCRIBE mechanism. The scope= att
tes file tag and the filter ributes file tag and the filter
file group= tag also use the same syntax. tin interprets this variable s file group= tag also use the same syntax. tin interprets this variable si
imilarly to rn(1). It contains milarly to rn(1). It contains
a list of patterns, separated by commas and possibly prefixed with exclam a list of patterns, separated by commas and possibly prefixed with exc
ation points. An exclamation lamation points. An exclamation
point negates the meaning of a match on this pattern, and can be used point negates the meaning of a match on this pattern, and can be used to
to cancel certain matches. Some cancel certain matches. Some
examples: examples:
alt.config,news.*,!news.test alt.config,news.*,!news.test
Matches alt.config and everything in the 'news' hierarchy except news.tes t Matches alt.config and everything in the 'news' hierarchy except news.tes t
See the explanation for the $AUTOSUBSCRIBE variables for further examples . See the explanation for the $AUTOSUBSCRIBE variables for further examples .
SIGNATURES SIGNATURES
tin will recognise a signature in either ${TIN_HOMEDIR:-"$HOME" tin will recognise a signature in either ${TIN_HOMEDIR:-"$HOM
}/.signature or ${TIN_HOME- E"}/.signature or ${TIN_HOME-
DIR:-"$HOME"}/.Sig. If ${TIN_HOMEDIR:-"$HOME"}/.signature exists, th DIR:-"$HOME"}/.Sig. If ${TIN_HOMEDIR:-"$HOME"}/.signature exists, then t
en the signature will be pulled he signature will be pulled
into the editor for mail commands only. A signature in ${TIN_HOMEDIR:-"$H into the editor for mail commands only. A signature in ${TIN_HOMEDIR:-
OME"}/.signature will not be "$HOME"}/.signature will not be
pulled into the editor for posting commands since inews(1) will append t he signature itself. pulled into the editor for posting commands since inews(1) will append t he signature itself.
A signature in ${TIN_HOMEDIR:-"$HOME"}/.Sig will be pulled into the edit or for both posting and mailing A signature in ${TIN_HOMEDIR:-"$HOME"}/.Sig will be pulled into the edito r for both posting and mailing
commands. commands.
The following is an example of a .Sig file: The following is an example of a .Sig file:
NAMES Joe Bar <joe@example.org> NAMES Joe Bar <joe@example.org>
SNAIL Musterweg 12, 99999 Notreal, Germany SNAIL Musterweg 12, 99999 Notreal, Germany
tin also has the capability to generate random signatures on a per newsgr tin also has the capability to generate random signatures on a per new
oup basis if so desired. The sgroup basis if so desired. The
way to accomplish this is to specify the default signature or the grou way to accomplish this is to specify the default signature or the group a
p attribute sigfile as a direc- ttribute sigfile as a direc-
tory. If for example the sigfile path is /usr/iain/.sigs and .sigs is a d irectory then tin will select a tory. If for example the sigfile path is /usr/iain/.sigs and .sigs is a d irectory then tin will select a
random signature from any file that is in the directory .sigs (note: one signature per numbered file). A random signature from any file that is in the directory .sigs (note: one signature per numbered file). A
random signature can also consist of a fixed part signature that can cont ain your name, address etc. random signature can also consist of a fixed part signature that can contain your name, address etc.
followed by the random sig. The fixed part of the random sig is read from the file $HOME/.sigfixed. followed by the random sig. The fixed part of the random sig is read from the file $HOME/.sigfixed.
CUSTOMISING THE SCREEN FORMAT CUSTOMISING THE SCREEN FORMAT
The look of the Selection, Group and Thread level can be customised v ia format strings. These format The look of the Selection, Group and Thread level can be customised via format strings. These format
strings define the content and the position of each element on the screen . Variables are used within the strings define the content and the position of each element on the screen . Variables are used within the
format strings as placeholders. The following variables are available: format strings as placeholders. The following variables are available:
%D date %D date
%F from, name and/or address %F from, name and/or address
%G newsgroup name %G newsgroup name
%I initials %I initials
%L line count %L line count
%M message-id %M message-id
%R number of responses in thread %R number of responses in thread
skipping to change at line 2345 skipping to change at line 2351
Defaults for the format strings: Defaults for the format strings:
select_format: "%f %n %U %G %d" select_format: "%f %n %U %G %d"
group_format: "%n %m %R %L %s %F" group_format: "%n %m %R %L %s %F"
thread_format: "%n %m [%L] %T %F" thread_format: "%n %m [%L] %T %F"
show_description controls whether the newsgroup description is shown or n ot. The description can also be show_description controls whether the newsgroup description is shown or n ot. The description can also be
toggled with SelectToggleDescriptions ('d'). toggled with SelectToggleDescriptions ('d').
The information displayed with '%F' depends on the value of show_author. GroupToggleSubjDisplay resp. The information displayed with '%F' depends on the value of show_autho r. GroupToggleSubjDisplay resp.
ThreadToggleSubjDisplay ('d') switches through all available options. ThreadToggleSubjDisplay ('d') switches through all available options.
For date representation '%D' uses date_format. It is possible to spe cify a different date format in For date representation '%D' uses date_format. It is possible to specify a different date format in
round brackets (e.g. '%(%d %b %y %H:%M)D'). See date_format for more deta ils. round brackets (e.g. '%(%d %b %y %H:%M)D'). See date_format for more deta ils.
The length of each item (except '%%') can be defined with a positive numb er after the '%'. The following The length of each item (except '%%') can be defined with a positive numb er after the '%'. The following
example displays the score in the thread level 10 characters wide: '%10S' . example displays the score in the thread level 10 characters wide: '%10S' .
If the newsgroup name is displayed together with the newsgroup descript ion, the width of the newsgroup If the newsgroup name is displayed together with the newsgroup descriptio n, the width of the newsgroup
name can be controlled via a optional comma separated second value (e.g. '%60,20G'). It is valid to omit name can be controlled via a optional comma separated second value (e.g. '%60,20G'). It is valid to omit
the first value (e.g. ('%,20G')). If no second value is given, tin uses a default value of 32. the first value (e.g. ('%,20G')). If no second value is given, tin uses a default value of 32.
Some variables do have a default width which may lead to truncation. Truncation for variables which Some variables do have a default width which may lead to truncation. Tr uncation for variables which
contain only numbers happens by dividing the value with a sufficient powe r of ten and adding a SI suffix contain only numbers happens by dividing the value with a sufficient powe r of ten and adding a SI suffix
to the result, that is the variable holds a value of 54321 and the width for the variable is 4 the to the result, that is the variable holds a value of 54321 and the width for the variable is 4 the
result will be "54 k". If that's undesired you have to specify a larger w idth manually, e.g. '%6n'. Here result will be "54 k". If that's undesired you have to specify a larger w idth manually, e.g. '%6n'. Here
is an overview of the defaults: is an overview of the defaults:
Variable width Variable width
%I 3 %I 3
%L 4 %L 4
%M 10 %M 10
%R 3 %R 3
%S 6 %S 6
%U 5 %U 5
%n 4 %n 4
If no length is given for '%D', the length is determined by the format s If no length is given for '%D', the length is determined by the format st
tring for the date and the date ring for the date and the date
of the current day. If the date format string contains weekdays or months of the current day. If the date format string contains weekdays or mont
names it may happen that the hs names it may happen that the
date is longer than determined in the first pass. In this case, the da date is longer than determined in the first pass. In this case, the date
te is truncated before display. is truncated before display.
This occurs, for example, if the current month is May and the article to which the date is displayed was This occurs, for example, if the current month is May and the article to which the date is displayed was
posted in December. In such cases it might useful to determine the maxi mum length manually and specify posted in December. In such cases it might useful to determine the maximu m length manually and specify
the length in the format string. the length in the format string.
In case the format string contains '%G' and '%d' and no length are given, tin determines the longest In case the format string contains '%G' and '%d' and no length are gi ven, tin determines the longest
newsgroup name and uses this length for '%G'. The remaining space will us ed for '%d'. newsgroup name and uses this length for '%G'. The remaining space will us ed for '%d'.
When the format string contains the specifier '%F' and '%s' resp. '%T ' and no length are given, '%F' When the format string contains the specifier '%F' and '%s' resp. '%T' an d no length are given, '%F'
will use one third and '%s' resp. '%T' will use two third of the availabl e space. will use one third and '%s' resp. '%T' will use two third of the availabl e space.
In addition, a minimum screen width can be defined for each item (except In addition, a minimum screen width can be defined for each item (excep
'%%'). In this case, the item t '%%'). In this case, the item
will only be displayed when the screen is wider than specified. This c will only be displayed when the screen is wider than specified. This come
omes in handy to not overload a s in handy to not overload a
small screen but have maximum information on a large screen. The minimum small screen but have maximum information on a large screen. The minimu
screen width has to be speci- m screen width has to be speci-
fied by a positive number preceded by an '>'. In the following example fied by a positive number preceded by an '>'. In the following example ti
tin will display the score only n will display the score only
if the screen is wider than 100 characters: '%>100S'. if the screen is wider than 100 characters: '%>100S'.
If both the length and the minimum screen width should be specified for a If both the length and the minimum screen width should be specified for
n item, the length must be the an item, the length must be the
first parameter and the minimum screen width must be the second one. The first parameter and the minimum screen width must be the second one. The
following example displays the following example displays the
score with a length of 10 characters only if the screen is wider than 100 characters: '%10>100S'. score with a length of 10 characters only if the screen is wider than 100 characters: '%10>100S'.
TIPS AND TRICKS TIPS AND TRICKS
tin can be pretty much be navigated by using the four cursor keys. The l tin can be pretty much be navigated by using the four cursor keys. The
eft arrow key goes up a level, left arrow key goes up a level,
the right arrow key goes down a level, the up arrow key goes up a line a the right arrow key goes down a level, the up arrow key goes up a line an
nd the down arrow key goes down d the down arrow key goes down
a line. a line.
The following newsgroups provide useful information concerning news softw are: The following newsgroups provide useful information concerning news softw are:
—news.software.readers (info. about news user agents tin, rn, nn, slr n etc.) —news.software.readers (info. about news user agents tin, rn, nn, slr n etc.)
—news.software.nntp (info. about NNTP) —news.software.nntp (info. about NNTP)
—news.answers (Frequently Asked Questions (FAQ) about many different themes) —news.answers (Frequently Asked Questions (FAQ) about many different themes)
Many prompts within tin offer a default choice that the cursor is positio ned on. By pressing '<CR>' the Many prompts within tin offer a default choice that the cursor is positi oned on. By pressing '<CR>' the
default value is taken. Most prompts can be aborted by pressing '<ESC>'. default value is taken. Most prompts can be aborted by pressing '<ESC>'.
When tin is run in a xterm(1x) it will resize itself each time the xterm (1x) is resized. When tin is run in a xterm(1x) it will resize itself each time the xterm (1x) is resized.
tin will reread the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-ac tive} file at set intervals tin will reread the ${TIN_LIBDIR:-NEWSLIBDIR}"/"${TIN_ACTIVEFILE:-act ive} file at set intervals
(reread_active_file_secs) to show any newly arrived news. (reread_active_file_secs) to show any newly arrived news.
If you find large number of new newsgroups cluttering up your screen, pr essing SelectToggleReadDisplay If you find large number of new newsgroups cluttering up your screen, p ressing SelectToggleReadDisplay
('r') will make them go away. ('r') will make them go away.
XTERM BUTTONS XTERM BUTTONS
If the environment variable $TERM is set to xterm(1x), then button pressi ng can be used to select groups If the environment variable $TERM is set to xterm(1x), then button pressi ng can be used to select groups
and articles. In this discussion, the buttons are assumed to be assigned conventionally (i.e., Button1 and articles. In this discussion, the buttons are assumed to be assigne d conventionally (i.e., Button1
is the left button). is the left button).
In general (i.e., for the group, thread and article menus), In general (i.e., for the group, thread and article menus),
Button1 (left) Button1 (left)
enters next (lower) level if you click on an article, otherwise pages down. enters next (lower) level if you click on an article, otherwise pages down.
Button2 (centre) Button2 (centre)
returns to the previous (upper) level if you click on an articl e, otherwise pages up. returns to the previous (upper) level if you click on an articl e, otherwise pages up.
Button3 (right) Button3 (right)
positions on the article line under mouse cursor, or pages dow n if you've clicked outside the positions on the article line under mouse cursor, or pages down if you've clicked outside the
list of articles. list of articles.
In the group selection menu, if the mouse is pointing at a group then: In the group selection menu, if the mouse is pointing at a group then:
left button left button
moves to and selects the group pointed at, just like SelectRead Grp ('<CR>'). moves to and selects the group pointed at, just like SelectRead Grp ('<CR>').
centre button centre button
quits the program, just like Quit ('q'). quits the program, just like Quit ('q').
right button right button
moves to the group pointed at. moves to the group pointed at.
In the article menu, if the mouse is pointing at an article (or thread) t hen: In the article menu, if the mouse is pointing at an article (or thread) t hen:
left button left button
reads the article pointed at, just like GroupReadBasenote ('<CR >'), or the thread, just like reads the article pointed at, just like GroupReadBasenote ('< CR>'), or the thread, just like
GroupListThd ('l'). GroupListThd ('l').
centre button centre button
exits the menu, catching up on the group if you have group_catc hup_on_exit set in your config- exits the menu, catching up on the group if you have group_catc hup_on_exit set in your config-
uration, just like Quit ('q'). uration, just like Quit ('q').
right button right button
moves to the article (or thread) pointed at. moves to the article (or thread) pointed at.
In the thread menu, if the mouse is pointing at an article then: In the thread menu, if the mouse is pointing at an article then:
left button left button
reads article pointed at, just like ThreadReadArt ('<CR>'). reads article pointed at, just like ThreadReadArt ('<CR>').
centre button centre button
exits the menu, catching up on the thread if you have thread_ca tchup_on_exit set in your con- exits the menu, catching up on the thread if you have thread_c atchup_on_exit set in your con-
figuration, just like Quit ('q'). figuration, just like Quit ('q').
right button right button
moves to the article pointed at. moves to the article pointed at.
In other menus and areas button pressing reverts back to usual cut and pa ste of xterm(1x), but after one In other menus and areas button pressing reverts back to usual cut and pa ste of xterm(1x), but after one
click of any button. click of any button.
INDEX FILES INDEX FILES
If your news server supports NOV index files (see newsoverview(5), most m odern installations will) and If your news server supports NOV index files (see newsoverview(5), most modern installations will) and
you have a fast connection to your news server then this section can be i gnored. you have a fast connection to your news server then this section can be i gnored.
If your news server doesn't support NOV index files or you have a ve If your news server doesn't support NOV index files or you have a very s
ry slow connection to your news low connection to your news
server then tin can cache the index for each newsgroup if cache_overview_ server then tin can cache the index for each newsgroup if cache_overview
files is set to ON. Note that _files is set to ON. Note that
this cache can use up large amounts of disk space if you read a lo this cache can use up large amounts of disk space if you read a lot of
t of groups and/or high traffic groups and/or high traffic
groups. groups.
Each user creates/updates his/her own index files that are stored in ${ Each user creates/updates his/her own index files that are stored in ${
TIN_INDEX_NEWSDIR:-"${TIN_HOME- TIN_INDEX_NEWSDIR:-"${TIN_HOME-
DIR:-"$HOME"}/.tin"}/.news/. If you are reading via NNTP then the news DIR:-"$HOME"}/.tin"}/.news/. If you are reading via NNTP then the news se
server name will be appended to rver name will be appended to
keep the indexes for different servers separate. If you are reading off t keep the indexes for different servers separate. If you are reading off
he local spool and local over- the local spool and local over-
view files already exist then turning on caching will have no effect. L view files already exist then turning on caching will have no effect. Lik
ikewise unless you see signifi- ewise unless you see signifi-
cant delays entering a group when reading via NNTP then turning on cach cant delays entering a group when reading via NNTP then turning on
ing will have little or no caching will have little or no
effect. effect.
Entering a group the first time tends to be slow because the index file Entering a group the first time tends to be slow because the index file m
must be built from scratch. To ust be built from scratch. To
alleviate the slowness start tin to create all index files for the groups alleviate the slowness start tin to create all index files for the grou
you subscribe to with tin -u ps you subscribe to with tin -u
-v and go for a coffee. Subsequent readings of a group will only need to -v and go for a coffee. Subsequent readings of a group will only need to
do incremental updating of the do incremental updating of the
index file and will be much faster as only new articles will need to be c ached. index file and will be much faster as only new articles will need to be c ached.
As indexing might take some time you may want to run tin form the system batcher cron(1) with the ”-u” As indexing might take some time you may want to run tin form the system batcher cron(1) with the ”-u”
option: option:
30 6 * * * /usr/local/bin/tin -u 30 6 * * * /usr/local/bin/tin -u
If you are low on local disk space you should consider to manually purge cached data for groups you are If you are low on local disk space you should consider to manually purge cached data for groups you are
not reading anymore with something like: not reading anymore with something like:
find ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news* \ find ${TIN_INDEX_NEWSDIR:-"${TIN_HOMEDIR:-"$HOME"}/.tin"}/.news* \
-type f -name "[0-9]*.[0-9]" -atime +28 | xargs rm -f -type f -name "[0-9]*.[0-9]" -atime +28 | xargs rm -f
FILES FILES
For a detailed description see tin(5). For a detailed description see tin(5).
$MAILCAPS $MAILCAPS
~/.mailcap ~/.mailcap
skipping to change at line 2588 skipping to change at line 2594
${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups ${TIN_LIBDIR:-NEWSLIBDIR}/newsgroups
${TIN_LIBDIR:-NEWSLIBDIR}/organization ${TIN_LIBDIR:-NEWSLIBDIR}/organization
${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt ${TIN_LIBDIR:-NEWSLIBDIR}/overview.fmt
${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions ${TIN_LIBDIR:-NEWSLIBDIR}/subscriptions
ENVIRONMENT ENVIRONMENT
TINRC Define this variable if you want to specify command-line options t TINRC Define this variable if you want to specify command-line options
hat tin should be started with that tin should be started with
to save typing them each time it is started. The contents of the to save typing them each time it is started. The contents of the e
environment variable are added nvironment variable are added
to the front of the command-line options before it is parsed there to the front of the command-line options before it is parsed ther
fore allowing an option speci- efore allowing an option speci-
fied on the command-line to override the same option specified in the environment. fied on the command-line to override the same option specified in the environment.
TIN_HOMEDIR TIN_HOMEDIR
Define this variable if you do not want the .tin directory in $HOM E/. E.g., if you want all tin's Define this variable if you do not want the .tin directory in $HOM E/. E.g., if you want all tin's
private files in /tmp/.tin you would set $TIN_HOMEDIR to /tmp. private files in /tmp/.tin you would set $TIN_HOMEDIR to /tmp.
TIN_INDEX_NEWSDIR TIN_INDEX_NEWSDIR
Define this variable if you do not want the .news directory in Define this variable if you do not want the .news directory in
${TIN_HOMEDIR:-"$HOME"}/.tin/. ${TIN_HOMEDIR:-"$HOME"}/.tin/.
E.g., if you want all tin's news index files in /tmp/.news you E.g., if you want all tin's news index files in /tmp/.news you wou
would set $TIN_INDEX_NEWSDIR to ld set $TIN_INDEX_NEWSDIR to
/tmp. /tmp.
TIN_INDEX_MAILDIR TIN_INDEX_MAILDIR
Define this variable if you do not want the .mail directory in Define this variable if you do not want the .mail directory in
${TIN_HOMEDIR:-"$HOME"}/.tin/. ${TIN_HOMEDIR:-"$HOME"}/.tin/.
E.g., if you want all tin's mail index files in /tmp/.mail you E.g., if you want all tin's mail index files in /tmp/.mail you wou
would set $TIN_INDEX_MAILDIR to ld set $TIN_INDEX_MAILDIR to
/tmp. /tmp.
TIN_INDEX_SAVEDIR TIN_INDEX_SAVEDIR
Define this variable if you do not want the .save directory in Define this variable if you do not want the .save directory in
${TIN_HOMEDIR:-"$HOME"}/.tin/. ${TIN_HOMEDIR:-"$HOME"}/.tin/.
E.g., if you want all tin's save index files in /tmp/.save you E.g., if you want all tin's save index files in /tmp/.save you wou
would set $TIN_INDEX_SAVEDIR to ld set $TIN_INDEX_SAVEDIR to
/tmp. /tmp.
TIN_LIBDIR TIN_LIBDIR
Define this variable if you want to override the NEWSLIBDIR path t Define this variable if you want to override the NEWSLIBDIR path
hat was compiled into the tin that was compiled into the tin
binary, default is /usr/lib/news. If tin is running in NNTP mo binary, default is /usr/lib/news. If tin is running in NNTP mode
de setting this variable has no setting this variable has no
effect. effect.
TIN_SPOOLDIR TIN_SPOOLDIR
Define this variable if you want to override the SPOOLDIR path tha Define this variable if you want to override the SPOOLDIR path
t was compiled into the tin that was compiled into the tin
binary, default is /var/spool/news. If tin is running in NNTP mo binary, default is /var/spool/news. If tin is running in NNTP mod
de setting this variable has no e setting this variable has no
effect. effect.
TIN_NOVROOTDIR TIN_NOVROOTDIR
Define this variable if you want to override the NOVROOTDIR path t hat was compiled into the tin Define this variable if you want to override the NOVROOTDIR path that was compiled into the tin
binary, default is SPOOLDIR (see above). If tin is running in NNTP mode setting this variable has binary, default is SPOOLDIR (see above). If tin is running in NNTP mode setting this variable has
no effect. no effect.
TIN_NOVFILENAME TIN_NOVFILENAME
Define this variable if you want to override the OVERVIEW_FILE fil ename that was compiled into Define this variable if you want to override the OVERVIEW_FILE filename that was compiled into
the tin binary, default is .overview. If tin is running in NNTP mo de setting this variable has no the tin binary, default is .overview. If tin is running in NNTP mo de setting this variable has no
effect. effect.
TIN_ACTIVEFILE TIN_ACTIVEFILE
Define this variable if you want to override the NEWSLIBDIR/active Define this variable if you want to override the NEWSLIBDIR/act
path that was compiled into ive path that was compiled into
the tin binary. If tin is running in NNTP mode setting this varia the tin binary. If tin is running in NNTP mode setting this variab
ble has no effect. If $TIN_LIB- le has no effect. If $TIN_LIB-
DIR is set it is prefixed to $TIN_ACTIVEFILE. DIR is set it is prefixed to $TIN_ACTIVEFILE.
NNTPSERVER NNTPSERVER
The default NNTP server to remotely read news from. This variable The default NNTP server to remotely read news from. This varia
only needs to be set if the ble only needs to be set if the
”-r” command-line option is specified and the file /etc/nntpserve ”-r” command-line option is specified and the file /etc/nntpserver
r does not exist. The ”-g” com- does not exist. The ”-g” com-
mand line option overrides $NNTPSERVER. mand line option overrides $NNTPSERVER.
NNTPPORT NNTPPORT
The NNTP TCP-port to read news from. This variable only needs to b e set if the TCP-port is not The NNTP TCP-port to read news from. This variable only needs t o be set if the TCP-port is not
119 (the default). The ”-p” command-line option overrides $NNTPPO RT. 119 (the default). The ”-p” command-line option overrides $NNTPPO RT.
DISTRIBUTION DISTRIBUTION
Set the article header field ”Distribution:” to the contents of t he variable instead of the sys- Set the article header field ”Distribution:” to the contents of th e variable instead of the sys-
tem default. tem default.
ISO2ASC ISO2ASC
Set the ISO to ASCII charset decoding table character to use in de coding an article text. Values Set the ISO to ASCII charset decoding table character to use in d ecoding an article text. Values
can range from -1 to 6. can range from -1 to 6.
-1 no conversion -1 no conversion
0 universal table for many languages 0 universal table for many languages
1 single-spacing universal table 1 single-spacing universal table
2 table for Danish, Dutch, German, Norwegian and Swedish 2 table for Danish, Dutch, German, Norwegian and Swedish
3 table for Danish, Finnish, Norwegian and Swedish using the ap propriate ISO 646 variant 3 table for Danish, Finnish, Norwegian and Swedish using the ap propriate ISO 646 variant
4 table with RFC1345 codes in brackets 4 table with RFC1345 codes in brackets
5 table for printers that allow overstriking with backspace 5 table for printers that allow overstriking with backspace
6 table for IBM PC character set (code page 437) 6 table for IBM PC character set (code page 437)
ORGANIZATION ORGANIZATION
Set the article header field ”Organization:” to the contents of t Set the article header field ”Organization:” to the contents of th
he variable instead of the sys- e variable instead of the sys-
tem default. If reading news on an Apollo DomainOS machine the env tem default. If reading news on an Apollo DomainOS machine the en
ironment variable $NEWSORG has vironment variable $NEWSORG has
to be used instead of $ORGANIZATION. to be used instead of $ORGANIZATION.
NEWSORG (DomainOS) NEWSORG (DomainOS)
DomainOS specific, same as $ORGANIZATION on other OSs (see above). DomainOS specific, same as $ORGANIZATION on other OSs (see above).
REPLYTO REPLYTO
Set the article header field ”Reply-To:” to the return address spe cified by the variable. This is Set the article header field ”Reply-To:” to the return address spe cified by the variable. This is
useful if you wish to receive replies at a different address. useful if you wish to receive replies at a different address.
NAME Overrides the full name given in the gecos-files in /etc/passwd, s ee also mail_address. NAME Overrides the full name given in the gecos-files in /etc/passwd, s ee also mail_address.
REALNAME REALNAME
Same as $NAME. Same as $NAME.
HOME Pathname of the user's home directory. See environ(5) for more in fo. HOME Pathname of the user's home directory. See environ(5) for more in fo.
MAILER This variable has precedence over the default mailer that is use d in all mailing operations MAILER This variable has precedence over the default mailer that is used in all mailing operations
within tin. within tin.
MAIL Full path to the user's mailbox. MAIL Full path to the user's mailbox.
VISUAL This variable has precedence over the default editor (i.e., vi( VISUAL This variable has precedence over the default editor (i.e., vi(1))
1)) that is used in all editing that is used in all editing
operations within tin (e.g., posting, replying, follow-ups, ...). operations within tin (e.g., posting, replying, follow-ups, .
Evaluation order is ${VIS- ..). Evaluation order is ${VIS-
UAL:-"${EDITOR:-vi}"}. See environ(5) for more info. UAL:-"${EDITOR:-vi}"}. See environ(5) for more info.
EDITOR If $VISUAL is unset, then this variable is looked up for a default editor. If $EDITOR and $VISUAL EDITOR If $VISUAL is unset, then this variable is looked up for a default editor. If $EDITOR and $VISUAL
are both unset, tin uses the systems default editor (i.e. v i(1)) on UNIX-systems). See are both unset, tin uses the systems default editor (i.e. vi(1)) on UNIX-systems). See
environ(5) for more info. environ(5) for more info.
AUTOSUBSCRIBE AUTOSUBSCRIBE
A new group is checked against the list of patterns; if it matc A new group is checked against the list of patterns; if it matches
hes, tin subscribes the user to , tin subscribes the user to
the group without further query. See the section "NEWSGROUP LISTS the group without further query. See the section "NEWSGROUP LIS
& WILDCARDS" for an explana- TS & WILDCARDS" for an explana-
tion of the valid syntax. For example, setting tion of the valid syntax. For example, setting
AUTOSUBSCRIBE=comp.os.unix.*,talk.*,!talk.politics.* AUTOSUBSCRIBE=comp.os.unix.*,talk.*,!talk.politics.*
will automatically subscribe the user to all new groups in the will automatically subscribe the user to all new groups in the com
comp.os.unix hierarchy, and all p.os.unix hierarchy, and all
talk groups other than talk.politics groups (which will be queried talk groups other than talk.politics groups (which will be querie
for as usual). Of course this d for as usual). Of course this
does not work if tin is started with the ”-X” command-line switch. does not work if tin is started with the ”-X” command-line switch.
AUTOUNSUBSCRIBE AUTOUNSUBSCRIBE
Is handled like the $AUTOSUBSCRIBE variable, but groups matching the list are unsubscribed from Is handled like the $AUTOSUBSCRIBE variable, but groups matching t he list are unsubscribed from
without further query. For example, setting without further query. For example, setting
AUTOUNSUBSCRIBE=alt.flame.*,u*,!uk.* AUTOUNSUBSCRIBE=alt.flame.*,u*,!uk.*
will automatically unsubscribe the user from all new alt.flame gro ups and all groups starting will automatically unsubscribe the user from all new alt.flame groups and all groups starting
with u (university groups) other than UK groups (which will be que ried for as usual). with u (university groups) other than UK groups (which will be que ried for as usual).
TMPDIR A pathname of a directory made available for tin to create tempora ry files. TMPDIR A pathname of a directory made available for tin to create tempora ry files.
MAILCAPS MAILCAPS
This variable can be used to override the default path search for mailcap(5) files. See also This variable can be used to override the default path search for mailcap(5) files. See also
tin(5). tin(5).
NOMETAMAIL NOMETAMAIL
Set this variable to disable the use of metamail(1) or a replacem ent (e.g. metamutt). Set this variable to disable the use of metamail(1) or a replacem ent (e.g. metamutt).
MM_CHARSET MM_CHARSET
MIME character set used if not configured via the tinrc variable m m_charset. MIME character set used if not configured via the tinrc variable m m_charset.
ISPELL Set this variable to point to ispell(1) or a replacement and its cmd-line options. ISPELL Set this variable to point to ispell(1) or a replacement and its cmd-line options.
PGPOPTS PGPOPTS
Define any additional options that you wish to pass to your pgp(1) or gpg(1) program. Define any additional options that you wish to pass to your pgp(1) or gpg(1) program.
PGPPATH PGPPATH
Override the name of the pgp(1) directory in $HOME that holds you r keys etc.. Override the name of the pgp(1) directory in $HOME that holds you r keys etc..
GNUPGHOME GNUPGHOME
Override the name of the gpg(1) directory in $HOME that holds you r keys etc.. Override the name of the gpg(1) directory in $HOME that holds you r keys etc..
LC_CTYPE LC_CTYPE
This variable determines the locale(5) category for character ha This variable determines the locale(5) category for character
ndling functions. Usually it handling functions. Usually it
determines the character classes for pattern matching character determines the character classes for pattern matching character cl
classification and case conver- assification and case conver-
sion. Currently this is not true for tin (which temporary unsets $ LC_CTYPE right before any match sion. Currently this is not true for tin (which temporary unsets $ LC_CTYPE right before any match
is done to avoid confusion). It's value should be of the f orm language[_territory][.code- is done to avoid confusion). It's value should be of the fo rm language[_territory][.code-
set][@modifier]. See environ(5) for more information. set][@modifier]. See environ(5) for more information.
LC_MESSAGES LC_MESSAGES
Formats of informative and diagnostic messages and interactive res Formats of informative and diagnostic messages and interactive r
ponses. It's value should be esponses. It's value should be
of the form language[_territory][.codeset][@modifier]. See loc of the form language[_territory][.codeset][@modifier]. See locale(
ale(5) and environ(5) for more 5) and environ(5) for more
information. information.
LC_TIME LC_TIME
Date and time formats. It's value should be of the form langua ge[_territory][.codeset][@modi- Date and time formats. It's value should be of the form langua ge[_territory][.codeset][@modi-
fier]. See locale(5) and environ(5) for more information. fier]. See locale(5) and environ(5) for more information.
LC_ALL This variable overrides the value of the $LANG variable and any LC_ALL This variable overrides the value of the $LANG variable and any ot
other $LC_ variable. It's value her $LC_ variable. It's value
should be of the form language[_territory][.codeset]. See locale(5 should be of the form language[_territory][.codeset]. See loca
) and environ(5) for more le(5) and environ(5) for more
information. information.
LANG This variable determines the locale(5) category for any category LANG This variable determines the locale(5) category for any category
not specifically selected with not specifically selected with
a variable starting with $LC_. It's value should be of the form a variable starting with $LC_. It's value should be of the form
language[_territory][.codeset]. language[_territory][.codeset].
See environ(5) for more information. See environ(5) for more information.
LANGUAGE LANGUAGE
This variable defines a priority list for translations. Whenever This variable defines a priority list for translations. Whenever a
a translation is not available translation is not available
in the language selected via $LC_ALL or $LANG the next language fr in the language selected via $LC_ALL or $LANG the next langua
om the list is tried. It's ge from the list is tried. It's
value should be of the form language:language[:language]. See envi ron(5) for more information. value should be of the form language:language[:language]. See envi ron(5) for more information.
COLUMNS COLUMNS
A decimal integer > 0 used to indicate the user's preferred wi A decimal integer > 0 used to indicate the user's preferred width
dth in column positions for the in column positions for the
terminal screen or window. If this variable is unset or null, the terminal screen or window. If this variable is unset or null, th
implementation determines the e implementation determines the
number of columns, appropriate for the terminal or window. W number of columns, appropriate for the terminal or window. When
hen $COLUMNS is set, any termi- $COLUMNS is set, any termi-
nal-width information implied by $TERM will be overridden. Users a nd portable applications should nal-width information implied by $TERM will be overridden. Users a nd portable applications should
not set $COLUMNS unless they wish to override the system selecti on and produce output unrelated not set $COLUMNS unless they wish to override the system selection and produce output unrelated
to the terminal characteristics. to the terminal characteristics.
LINES A decimal integer > 0 used to indicate the user's preferred number of lines on a page or the ver- LINES A decimal integer > 0 used to indicate the user's preferred number of lines on a page or the ver-
tical screen or window size in lines. A line in this case is a v tical screen or window size in lines. A line in this case is a ver
ertical measure large enough to tical measure large enough to
hold the tallest character in the character set being displayed. I hold the tallest character in the character set being displaye
f this variable is unset or d. If this variable is unset or
null, the implementation determines the number of lines, appropri null, the implementation determines the number of lines, appropria
ate for the terminal or window. te for the terminal or window.
When $LINES is set, any terminal-height information implied by $TE When $LINES is set, any terminal-height information implied by
RM will be overridden. Users $TERM will be overridden. Users
and portable applications should not set $LINES unless they wis and portable applications should not set $LINES unless they wish t
h to override the system selec- o override the system selec-
tion. tion.
TERM The type of terminal in use. This is used when looking up termcap sequences. See environ(5) for TERM The type of terminal in use. This is used when looking up termcap sequences. See environ(5) for
more information. more information.
DISPLAY DISPLAY
Display name, pointing to the X server; required for xface. Display name, pointing to the X server; required for xface.
WINDOWID WINDOWID
Used for determining terminal's X window id; required for xface . Should be set by the terminal Used for determining terminal's X window id; required for xface. S hould be set by the terminal
emulator. emulator.
SHELL The pathname of the user's login shell. Used to set default_shell_ command. SHELL The pathname of the user's login shell. Used to set default_shell_ command.
XDG_RUNTIME_DIR XDG_RUNTIME_DIR
The pathname of the user's dir to put non-essential run time files into. The pathname of the user's dir to put non-essential run time files into.
SIGNALS SIGNALS
tin handles a couple of signals: tin handles a couple of signals:
skipping to change at line 2820 skipping to change at line 2826
SIGTERM SIGTERM
Terminate gracefully. Terminate gracefully.
SIGUSR1 SIGUSR1
Terminate gracefully but do not restore terminal (tty). Terminate gracefully but do not restore terminal (tty).
SIGUSR2 SIGUSR2
Write out ${TIN_HOMEDIR:-"$HOME"}/.newsrc-file. Write out ${TIN_HOMEDIR:-"$HOME"}/.newsrc-file.
SECURITY SECURITY
If tin is started in debug mode (”-D n”) it will create world readable fi If tin is started in debug mode (”-D n”) it will create world readable
les in $TMPDIR which may con- files in $TMPDIR which may con-
tain the users NNTP password in cleartext. On multi-user systems $TMPDI tain the users NNTP password in cleartext. On multi-user systems $TMPDIR
R should be set to a safe loca- should be set to a safe loca-
tion before starting tin in debug mode (e.g. TMPDIR=$HOME tin -D 1). tion before starting tin in debug mode (e.g. TMPDIR=$HOME tin -D 1).
CONFORMING TO CONFORMING TO
tin does conform to the Base Definitions volume of IEEE Std 1003.1-2008, Section 12, Utility Conventions tin does conform to the Base Definitions volume of IEEE Std 1003.1-2008, Section 12, Utility Conventions
(Utility Argument Syntax, Utility Syntax Guidelines). (Utility Argument Syntax, Utility Syntax Guidelines).
NOTES NOTES
Regular expression support is provided by the PCRE library package pcre (3), which is open source soft- Regular expression support is provided by the PCRE library package pcre(3 ), which is open source soft-
ware, written by Philip Hazel, and copyright by the University of Cambrid ge, England. ware, written by Philip Hazel, and copyright by the University of Cambrid ge, England.
<ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/> <ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/>
BUGS BUGS
CNews NNTPd, noffle(1) (<= V1.0-pre5) and NewsCache (<= V1.1.91) can't h andle pipelined GROUP commands. CNews NNTPd, noffle(1) (<= V1.0-pre5) and NewsCache (<= V1.1.91) can't h andle pipelined GROUP commands.
If you run into trouble with any of the mentioned servers define DISA BLE_PIPELINING in include/auto- If you run into trouble with any of the mentioned servers define DISABL E_PIPELINING in include/auto-
conf.h and recompile. conf.h and recompile.
Before mailing a bug-report to <tin-bugs@tin.org> please check if you ar Before mailing a bug-report to <tin-bugs@tin.org> please check if yo
e using the latest (stable) u are using the latest (stable)
release, and if not, please upgrade first! Have a look at the doc/T release, and if not, please upgrade first! Have a look at the doc/TODO f
ODO file for known bugs. If you ile for known bugs. If you
still think you've found a bug, please use the BugReport ('R') function and write in English. Please do still think you've found a bug, please use the BugReport ('R') function and write in English. Please do
NOT enclose a core-file in your bug-report until we request it. NOT enclose a core-file in your bug-report until we request it.
HISTORY HISTORY
tin is based on the tass(1) newsreader that was developed by Rich Skren tin is based on the tass(1) newsreader that was developed by Rich Skrent
ta and posted to alt.sources in a and posted to alt.sources in
March 1991; its first version was released on August 23rd 1991. tass(1) March 1991; its first version was released on August 23rd 1991. tass(1)
itself was heavily influenced itself was heavily influenced
by notesfiles a public domain UNIX version of PLATO Notes, developed a by notesfiles a public domain UNIX version of PLATO Notes, developed at t
t the University of Illinois by he University of Illinois by
Ray Essick and Rob Kolstad in 1982. For a version overview see Ray Essick and Rob Kolstad in 1982. For a version overview see
<http://www.tin.org/history.html>. <http://www.tin.org/history.html>.
CREDITS CREDITS
Rich Skrenta Rich Skrenta
author of tass(1) v3.2 which this newsreader used as its base. author of tass(1) v3.2 which this newsreader used as its base.
Bill Davidsen Bill Davidsen
author of envarg.c environment variable reading routine. author of envarg.c environment variable reading routine.
skipping to change at line 2890 skipping to change at line 2896
Patrick Powell <papowell@astart.com> Patrick Powell <papowell@astart.com>
for snprintf(3) and vsnprintf(3) fallbacks. for snprintf(3) and vsnprintf(3) fallbacks.
AUTHOR AUTHOR
Iain Lea <iain@bricbrac.de> Iain Lea <iain@bricbrac.de>
MAINTAINER MAINTAINER
Urs Janssen <urs@tin.org> Urs Janssen <urs@tin.org>
SEE ALSO SEE ALSO
cron(1), elm(1), emacs(1), gpg(1), inews(1), ispell(1), lp(1), lpr(1), me cron(1), elm(1), emacs(1), gpg(1), inews(1), ispell(1), lp(1), lpr(1), m
tamail(1), noffle(1), perl(1), etamail(1), noffle(1), perl(1),
perlre(1), pgp(1), rn(1), sendmail(1), shar(1), slrnface(1), tass(1), perlre(1), pgp(1), rn(1), sendmail(1), shar(1), slrnface(1), tass(1), u
unshar(1), uudecode(1), vi(1), nshar(1), uudecode(1), vi(1),
xterm(1x), heapsort(3), iconv(3), iconv_open(3), nl_langinfo(3), pcre( xterm(1x), heapsort(3), iconv(3), iconv_open(3), nl_langinfo(3), pcr
3), pcrepattern(3), qsort(3), e(3), pcrepattern(3), qsort(3),
snprintf(3), strftime(3), vsnprintf(3), wildmat(3), environ(5), locale(5) , mailcap(5), mbox(5), mmdf(5), snprintf(3), strftime(3), vsnprintf(3), wildmat(3), environ(5), locale(5) , mailcap(5), mbox(5), mmdf(5),
newsoverview(5), tin(5), RFC1345, RFC1524, RFC2045, RFC2046, RFC2047, RFC 2048, RFC2231, RFC2980, RFC- newsoverview(5), tin(5), RFC1345, RFC1524, RFC2045, RFC2046, RFC2047, RFC2048, RFC2231, RFC2980, RFC-
3977, RFC4155, RFC4643, RFC5322, RFC5536, RFC5537, RFC6048 3977, RFC4155, RFC4643, RFC5322, RFC5536, RFC5537, RFC6048
2.4.1 December 24th, 2016 tin(1) 2.4.2 December 24th, 2017 tin(1)
 End of changes. 137 change blocks. 
399 lines changed or deleted 407 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)