source: archive/tin.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 4 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • 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.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/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 "e6ed45205020665c097556822b0d575b">
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 <date>$Date$</date>
20 </sect1info>
21
22 <title>TIN-&tin-version;</title>
23
24 <indexterm zone="tin">
25 <primary sortas="a-TIN">TIN</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to TIN</title>
30
31 <para><application>TIN</application> is a threaded NNTP and spool based
32 console-mode UseNet newsreader. It supports threading, scoring,
33 different charsets, and many other useful things. It has also support for
34 different languages.</para>
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing='compact'>
38 <listitem>
39 <para>Download (HTTP): <ulink url="&tin-download-http;"/></para>
40 </listitem>
41 <listitem>
42 <para>Download (FTP): <ulink url="&tin-download-ftp;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download MD5 sum: &tin-md5sum;</para>
46 </listitem>
47 <listitem>
48 <para>Download size: &tin-size;</para>
49 </listitem>
50 <listitem>
51 <para>Estimated disk space required: &tin-buildsize;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated build time: &tin-time;</para>
55 </listitem>
56 </itemizedlist>
57
58 <bridgehead renderas="sect3">TIN Dependencies</bridgehead>
59
60 <bridgehead renderas="sect4">Optional</bridgehead>
61 <para role="optional"><xref linkend="pcre"/>,
62 <xref linkend="libidn"/>,
63 an <xref linkend="server-mail"/> that provides the
64 <command>sendmail</command> command or <xref linkend="mailx"/>,
65 <xref linkend="gnupg"/>,
66 <!-- a spell checker (<xref linkend="ispell"/> or <xref linkend="aspell"/>), -->
67 <xref linkend="aspell"/>,
68 <ulink url="http://www.isc.org/index.pl?/sw/inn/">INN</ulink>,
69 <ulink url="http://www.fpx.de/fp/Software/UUDeview/">UUDeview</ulink>,
70 <ulink url="http://www.inet.no/dante/">Socks</ulink>,
71 <ulink
72 url="http://ftp4.de.freesbie.org/pub/misc/metamail/mm2.7.tar.Z">Metamail</ulink>,
73 and
74 <ulink url="http://dmalloc.com/">Dmalloc</ulink>
75 or
76 <ulink url="ftp://invisible-island.net/dbmalloc/">dbmalloc</ulink></para>
77
78 <para condition="html" role="usernotes">User Notes:
79 <ulink url="&blfs-wiki;/Tin"/></para>
80
81 </sect2>
82
83 <sect2 role="installation">
84 <title>Installation of TIN</title>
85
86 <para>Install <application>TIN</application> by running the following
87 commands:</para>
88
89<screen><userinput>./configure --prefix=/usr --with-screen=ncursesw \
90 --enable-nntp-only --disable-printing &amp;&amp;
91make build</userinput></screen>
92
93 <para>This package does not come with a test suite.</para>
94
95 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
96
97<screen role='root'><userinput>make install &amp;&amp;
98make install_sysdefs &amp;&amp;
99rm -vf doc/*.? &amp;&amp;
100install -v -m755 -d /usr/share/doc/tin-&tin-version; &amp;&amp;
101install -v -m644 doc/* /usr/share/doc/tin-&tin-version;</userinput></screen>
102
103 </sect2>
104
105 <sect2 role="commands">
106 <title>Command Explanations</title>
107
108 <para><parameter>--with-screen=ncursesw</parameter>: This switch forces
109 the use of wide-character functions from the ncursesw library (for UTF-8
110 and Asian languages support).</para>
111
112 <para><parameter>--enable-nntp-only</parameter>: Reading news from a local
113 spool is disabled with this switch. Don't use this if you have installed
114 INN and want to use its spool.</para>
115
116 <para><parameter>--disable-printing</parameter>: This switch disables
117 printing since <application>TIN</application> cannot send non-ASCII text
118 to the printer correctly. Remove this switch if you can tolerate this
119 limitation.</para>
120
121 <para><parameter>--with-editor</parameter>: This switch sets the default
122 editor used by <application>TIN</application>. The default is
123 <command>vi</command>.</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 can be 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.