source: basicnet/mailnews/tin.xml@ 6788877

10.0 10.1 11.0 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 6788877 was 6788877, checked in by Dan Nichilson <dnicholson@…>, 16 years ago

Updated to TIN-1.8.2

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@6172 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 10.2 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY tin-download-http "http://gd.tuwien.ac.at/infosys/newsreaders/tin/v1.8/tin-&tin-version;.tar.bz2">
8 <!ENTITY tin-download-ftp "ftp://ftp.tin.org/pub/news/clients/tin/v1.8/tin-&tin-version;.tar.bz2">
9 <!ENTITY tin-md5sum "b6726c7f3e01b821b3b20d446ac2da9b">
10 <!ENTITY tin-size "1.4 MB">
11 <!ENTITY tin-buildsize "12.4 MB">
12 <!ENTITY tin-time "0.4 SBU">
13]>
14
15<sect1 id="tin" xreflabel="tin-&tin-version;">
16 <?dbhtml filename="tin.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 <keywordset>
22 <keyword role="package">tin-&tin-version;.tar</keyword>
23 <keyword role="ftpdir">tin</keyword>
24 </keywordset>
25 </sect1info>
26
27 <title>TIN-&tin-version;</title>
28
29 <indexterm zone="tin">
30 <primary sortas="a-TIN">TIN</primary>
31 </indexterm>
32
33 <sect2 role="package">
34 <title>Introduction to TIN</title>
35
36 <para><application>TIN</application> is a threaded NNTP and spool based
37 console-mode UseNet newsreader. It supports threading, scoring,
38 different charsets, and many other useful things. It has also support for
39 different languages.</para>
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing='compact'>
43 <listitem>
44 <para>Download (HTTP): <ulink url="&tin-download-http;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download (FTP): <ulink url="&tin-download-ftp;"/></para>
48 </listitem>
49 <listitem>
50 <para>Download MD5 sum: &tin-md5sum;</para>
51 </listitem>
52 <listitem>
53 <para>Download size: &tin-size;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated disk space required: &tin-buildsize;</para>
57 </listitem>
58 <listitem>
59 <para>Estimated build time: &tin-time;</para>
60 </listitem>
61 </itemizedlist>
62
63 <bridgehead renderas="sect3">TIN Dependencies</bridgehead>
64
65 <bridgehead renderas="sect4">Optional</bridgehead>
66 <para role="optional"><xref linkend="pcre"/>,
67 <xref linkend="libidn"/>,
68 an <xref linkend="server-mail"/> that provides the
69 <command>sendmail</command> command or <xref linkend="mailx"/>,
70 <xref linkend="gnupg"/>,
71 a spell checker (<xref linkend="ispell"/> or <xref linkend="aspell"/>),
72 <ulink url="http://www.isc.org/index.pl?/sw/inn/">INN</ulink>,
73 <ulink url="http://www.fpx.de/fp/Software/UUDeview/">UUDeview</ulink>,
74 <ulink url="http://www.inet.no/dante/">Socks</ulink>,
75 <ulink
76 url="ftp://ftp.research.telcordia.com/pub/nsb/mm2.7.tar.Z">Metamail</ulink>,
77 and
78 <ulink url="http://dmalloc.com/">Dmalloc</ulink>
79 or
80 <ulink url="ftp://invisible-island.net/dbmalloc/">dbmalloc</ulink></para>
81
82 <para condition="html" role="usernotes">User Notes:
83 <ulink url="&blfs-wiki;/Tin"/></para>
84
85 </sect2>
86
87 <sect2 role="installation">
88 <title>Installation of TIN</title>
89
90 <para>Install <application>TIN</application> by running the following
91 commands:</para>
92
93<screen><userinput>./configure --prefix=/usr --with-screen=ncursesw \
94 --enable-nntp-only --disable-printing &amp;&amp;
95make build</userinput></screen>
96
97 <para>This package does not come with a test suite.</para>
98
99 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
100
101<screen role='root'><userinput>make install &amp;&amp;
102make install_sysdefs &amp;&amp;
103rm -vf doc/*.? &amp;&amp;
104install -v -m755 -d /usr/share/doc/tin-&tin-version; &amp;&amp;
105install -v -m644 doc/* /usr/share/doc/tin-&tin-version;</userinput></screen>
106
107 </sect2>
108
109 <sect2 role="commands">
110 <title>Command Explanations</title>
111
112 <para><parameter>--with-screen=ncursesw</parameter>: This switch forces
113 the use of wide-character functions from the ncursesw library (for UTF-8
114 and Asian languages support).</para>
115
116 <para><parameter>--enable-nntp-only</parameter>: Reading news from a local
117 spool is disabled with this switch. Don't use this if you have installed
118 INN and want to use its spool.</para>
119
120 <para><parameter>--disable-printing</parameter>: This switch disables
121 printing since <application>TIN</application> cannot send non-ASCII text
122 to the printer correctly. Remove this switch if you can tolerate this
123 limitation.</para>
124
125 <para><parameter>--with-editor</paramater>: This switch sets the default
126 editor used by <application>TIN</application>. The default is
127 <command>vi</command>.</para>
128
129 </sect2>
130
131 <sect2 role="configuration">
132 <title>Configuring TIN</title>
133
134 <sect3 id="tin-config">
135 <title>Config Files</title>
136
137 <para><filename>/etc/tin/tinrc</filename>,
138 <filename>~/.tin/tinrc</filename>,
139 <filename>~/.newsrc</filename>,
140 <filename>/etc/tin/tin.defaults</filename>,
141 <filename>/etc/tin/mime.types</filename>,
142 <filename>/etc/tin/keymap</filename> and
143 <filename>/etc/mailcap</filename></para>
144
145 <indexterm zone="tin tin-config">
146 <primary sortas="e-etc-tinrc">/etc/tin/tinrc</primary>
147 </indexterm>
148
149 <indexterm zone="tin tin-config">
150 <primary sortas="e-AA.tinrc">~/.tin/tinrc</primary>
151 </indexterm>
152
153 <indexterm zone="tin tin-config">
154 <primary sortas="e-AA.newsrc">~/.newsrc</primary>
155 </indexterm>
156
157 <indexterm zone="tin tin-config">
158 <primary sortas="e-etc-tindefaults">/etc/tin/tin.defaults</primary>
159 </indexterm>
160
161 <indexterm zone="tin tin-config">
162 <primary sortas="e-etc-tinkeymap">/etc/tin/keymap</primary>
163 </indexterm>
164
165 <indexterm zone="tin tin-config">
166 <primary sortas="e-etc-mailcap">/etc/mailcap</primary>
167 </indexterm>
168
169 </sect3>
170
171 <sect3>
172 <title>Configuration Information</title>
173
174 <para>Set some global defaults for <application>TIN</application> by
175 running the following commands as the
176 <systemitem class="username">root</systemitem> user:</para>
177
178<screen role='root'><userinput>cat &gt; /etc/tin/tinrc &lt;&lt; "EOF"
179use_mouse=ON
180getart_limit=100
181translit=ON
182EOF</userinput></screen>
183
184 <para>Now, as an unprivileged user, subscribe to some newsgroups,
185 specify the news server, and run <command>tin</command>:</para>
186
187<screen><userinput>cat &gt;&gt; ~/.newsrc &lt;&lt; "EOF"
188gmane.linux.lfs.devel:
189gmane.linux.lfs.beyond.devel:
190EOF
191export NNTPSERVER=news.gmane.org
192tin -Q</userinput></screen>
193
194 <para>For printing, <application>TIN</application> executes the
195 <command>lpr</command> command. This is provided by
196 <xref linkend="cups"/> or <xref linkend="LPRng"/>.</para>
197
198 <para>If you do not have the <command>metamail</command> program,
199 <application>TIN</application> will use an internal parser for multipart
200 MIME articles. Alternatively, you can use <application>Mutt</application>
201 for MIME parsing through the <command>metamutt</command> shell script.
202 This requires both the <xref linkend="mutt"/> and
203 <xref linkend="procmail"/> programs. To use <command>metamutt</command>,
204 set <option>metamail_prog=metamutt</option> in
205 <command>tin</command>.</para>
206
207 </sect3>
208
209 </sect2>
210
211 <sect2 role="content">
212 <title>Contents</title>
213
214 <segmentedlist>
215 <segtitle>Installed Programs</segtitle>
216 <segtitle>Installed Libraries</segtitle>
217 <segtitle>Installed Directory</segtitle>
218
219 <seglistitem>
220 <seg>tin, rtin, tinews.pl, metamutt, opt-case.pl, w2r.pl,
221 and url_handler.sh</seg>
222 <seg>None</seg>
223 <seg>/etc/tin</seg>
224 </seglistitem>
225 </segmentedlist>
226
227 <variablelist>
228 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
229 <?dbfo list-presentation="list"?>
230 <?dbhtml list-presentation="table"?>
231
232 <varlistentry id="tin-prog">
233 <term><command>tin</command></term>
234 <listitem>
235 <para>is a UseNet news reader.</para>
236 <indexterm zone="tin tin-prog">
237 <primary sortas="b-tin">tin</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="rtin">
243 <term><command>rtin</command></term>
244 <listitem>
245 <para>is a symbolic link to <command>tin</command>.</para>
246 <indexterm zone="tin rtin">
247 <primary sortas="b-rtin">rtin</primary>
248 </indexterm>
249 </listitem>
250 </varlistentry>
251
252 <varlistentry id="tinews.pl">
253 <term><command>tinews.pl</command></term>
254 <listitem>
255 <para>posts and signs an article via NNTP.</para>
256 <indexterm zone="tin tinews.pl">
257 <primary sortas="b-tinews.pl">tinews.pl</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="metamutt">
263 <term><command>metamutt</command></term>
264 <listitem>
265 <para>is a replacement of <command>metamail</command> using
266 <application>Mutt</application>.</para>
267 <indexterm zone="tin metamutt">
268 <primary sortas="b-metamutt">metamutt</primary>
269 </indexterm>
270 </listitem>
271 </varlistentry>
272
273 <varlistentry id="opt-case.pl">
274 <term><command>opt-case.pl</command></term>
275 <listitem>
276 <para>optimizes case insensitive regexp filters for tin.</para>
277 <indexterm zone="tin opt-case.pl">
278 <primary sortas="b-opt-case.pl">opt-case.pl</primary>
279 </indexterm>
280 </listitem>
281 </varlistentry>
282
283 <varlistentry id="w2r.pl">
284 <term><command>w2r.pl</command></term>
285 <listitem>
286 <para>converts tin wildmat filters to tin regexp filters.</para>
287 <indexterm zone="tin w2r.pl">
288 <primary sortas="b-w2r.pl">w2r.pl</primary>
289 </indexterm>
290 </listitem>
291 </varlistentry>
292
293 <varlistentry id="url_handler.sh">
294 <term><command>url_handler.sh</command></term>
295 <listitem>
296 <para>calls a web browser for viewing hyperlinks.</para>
297 <indexterm zone="tin url_handler.sh">
298 <primary sortas="b-url_handler.sh">url_handler.sh</primary>
299 </indexterm>
300 </listitem>
301 </varlistentry>
302
303 </variablelist>
304
305 </sect2>
306
307</sect1>
Note: See TracBrowser for help on using the repository browser.