source: basicnet/mailnews/tin.xml@ 7f5c97e

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 7f5c97e was 7f5c97e, checked in by Manuel Canales Esparcia <manuel@…>, 16 years ago

Made all dependencies an a mail server actual cross-references.

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

  • Property mode set to 100644
File size: 10.0 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 "efeecdf72683213d9e705c28de87ea2e">
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 </sect2>
126
127 <sect2 role="configuration">
128 <title>Configuring TIN</title>
129
130 <sect3 id="tin-config">
131 <title>Config Files</title>
132
133 <para><filename>/etc/tin/tinrc</filename>,
134 <filename>~/.tin/tinrc</filename>,
135 <filename>~/.newsrc</filename>,
136 <filename>/etc/tin/tin.defaults</filename>,
137 <filename>/etc/tin/mime.types</filename>,
138 <filename>/etc/tin/keymap</filename> and
139 <filename>/etc/mailcap</filename></para>
140
141 <indexterm zone="tin tin-config">
142 <primary sortas="e-etc-tinrc">/etc/tin/tinrc</primary>
143 </indexterm>
144
145 <indexterm zone="tin tin-config">
146 <primary sortas="e-AA.tinrc">~/.tin/tinrc</primary>
147 </indexterm>
148
149 <indexterm zone="tin tin-config">
150 <primary sortas="e-AA.newsrc">~/.newsrc</primary>
151 </indexterm>
152
153 <indexterm zone="tin tin-config">
154 <primary sortas="e-etc-tindefaults">/etc/tin/tin.defaults</primary>
155 </indexterm>
156
157 <indexterm zone="tin tin-config">
158 <primary sortas="e-etc-tinkeymap">/etc/tin/keymap</primary>
159 </indexterm>
160
161 <indexterm zone="tin tin-config">
162 <primary sortas="e-etc-mailcap">/etc/mailcap</primary>
163 </indexterm>
164
165 </sect3>
166
167 <sect3>
168 <title>Configuration Information</title>
169
170 <para>Set some global defaults for <application>TIN</application> by
171 running the following commands as the
172 <systemitem class="username">root</systemitem> user:</para>
173
174<screen role='root'><userinput>cat &gt; /etc/tin/tinrc &lt;&lt; "EOF"
175use_mouse=ON
176getart_limit=100
177translit=ON
178EOF</userinput></screen>
179
180 <para>Now, as an unprivileged user, subscribe to some newsgroups,
181 specify the news server, and run <command>tin</command>:</para>
182
183<screen><userinput>cat &gt;&gt; ~/.newsrc &lt;&lt; "EOF"
184gmane.linux.lfs.devel:
185gmane.linux.lfs.beyond.devel:
186EOF
187export NNTPSERVER=news.gmane.org
188tin -Q</userinput></screen>
189
190 <para>For printing, <application>TIN</application> executes the
191 <command>lpr</command> command. This is provided by
192 <xref linkend="cups"/> or <xref linkend="LPRng"/>.</para>
193
194 <para>If you do not have the <command>metamail</command> program,
195 <application>TIN</application> will use an internal parser for multipart
196 MIME articles. Alternatively, you can use <application>Mutt</application>
197 for MIME parsing through the <command>metamutt</command> shell script.
198 This requires both the <xref linkend="mutt"/> and
199 <xref linkend="procmail"/> programs. To use <command>metamutt</command>,
200 set <option>metamail_prog=metamutt</option> in
201 <command>tin</command>.</para>
202
203 </sect3>
204
205 </sect2>
206
207 <sect2 role="content">
208 <title>Contents</title>
209
210 <segmentedlist>
211 <segtitle>Installed Programs</segtitle>
212 <segtitle>Installed Libraries</segtitle>
213 <segtitle>Installed Directory</segtitle>
214
215 <seglistitem>
216 <seg>tin, rtin, tinews.pl, metamutt, opt-case.pl, w2r.pl,
217 and url_handler.sh</seg>
218 <seg>None</seg>
219 <seg>/etc/tin</seg>
220 </seglistitem>
221 </segmentedlist>
222
223 <variablelist>
224 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
225 <?dbfo list-presentation="list"?>
226 <?dbhtml list-presentation="table"?>
227
228 <varlistentry id="tin-prog">
229 <term><command>tin</command></term>
230 <listitem>
231 <para>is a UseNet news reader.</para>
232 <indexterm zone="tin tin-prog">
233 <primary sortas="b-tin">tin</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238 <varlistentry id="rtin">
239 <term><command>rtin</command></term>
240 <listitem>
241 <para>is a symbolic link to <command>tin</command>.</para>
242 <indexterm zone="tin rtin">
243 <primary sortas="b-rtin">rtin</primary>
244 </indexterm>
245 </listitem>
246 </varlistentry>
247
248 <varlistentry id="tinews.pl">
249 <term><command>tinews.pl</command></term>
250 <listitem>
251 <para>posts and signs an article via NNTP.</para>
252 <indexterm zone="tin tinews.pl">
253 <primary sortas="b-tinews.pl">tinews.pl</primary>
254 </indexterm>
255 </listitem>
256 </varlistentry>
257
258 <varlistentry id="metamutt">
259 <term><command>metamutt</command></term>
260 <listitem>
261 <para>is a replacement of <command>metamail</command> using
262 <application>Mutt</application>.</para>
263 <indexterm zone="tin metamutt">
264 <primary sortas="b-metamutt">metamutt</primary>
265 </indexterm>
266 </listitem>
267 </varlistentry>
268
269 <varlistentry id="opt-case.pl">
270 <term><command>opt-case.pl</command></term>
271 <listitem>
272 <para>optimizes case insensitive regexp filters for tin.</para>
273 <indexterm zone="tin opt-case.pl">
274 <primary sortas="b-opt-case.pl">opt-case.pl</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 <varlistentry id="w2r.pl">
280 <term><command>w2r.pl</command></term>
281 <listitem>
282 <para>converts tin wildmat filters to tin regexp filters.</para>
283 <indexterm zone="tin w2r.pl">
284 <primary sortas="b-w2r.pl">w2r.pl</primary>
285 </indexterm>
286 </listitem>
287 </varlistentry>
288
289 <varlistentry id="url_handler.sh">
290 <term><command>url_handler.sh</command></term>
291 <listitem>
292 <para>calls a web browser for viewing hyperlinks.</para>
293 <indexterm zone="tin url_handler.sh">
294 <primary sortas="b-url_handler.sh">url_handler.sh</primary>
295 </indexterm>
296 </listitem>
297 </varlistentry>
298
299 </variablelist>
300
301 </sect2>
302
303</sect1>
Note: See TracBrowser for help on using the repository browser.