source: archive/slrn.xml@ 45ab6c7

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

more SVN prop clean up

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

  • Property mode set to 100644
File size: 6.9 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 slrn-download-http "&sourceforge-repo;/slrn/slrn-&slrn-version;.tar.bz2">
8 <!ENTITY slrn-download-ftp "ftp://ftp.fh-heilbronn.de/pub/mirrors/slrn/slrn-&slrn-version;.tar.bz2">
9 <!ENTITY slrn-md5sum "9b613007df537444a5f8a4a2994fadb7">
10 <!ENTITY slrn-size "1011 KB">
11 <!ENTITY slrn-buildsize "9.3 MB">
12 <!ENTITY slrn-time "0.19 SBU">
13]>
14
15<sect1 id="slrn" xreflabel="slrn-&slrn-version;">
16 <?dbhtml filename="slrn.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>Slrn-&slrn-version;</title>
23
24 <indexterm zone="slrn">
25 <primary sortas="a-Slrn">Slrn</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to Slrn</title>
30
31 <para><application>slrn</application> is a slang-based news reader, capable of
32 reading local news spools as well as groups from an NNTP server. Small local news
33 spools can also be created with the use of the <command>slrnpull</command>
34 program included in the <application>slrn</application> distribution.</para>
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing='compact'>
38 <listitem>
39 <para>Download (HTTP): <ulink url="&slrn-download-http;"/></para>
40 </listitem>
41 <listitem>
42 <para>Download (FTP): <ulink url="&slrn-download-ftp;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download MD5 sum: &slrn-md5sum;</para>
46 </listitem>
47 <listitem>
48 <para>Download size: &slrn-size;</para>
49 </listitem>
50 <listitem>
51 <para>Estimated disk space required: &slrn-buildsize;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated build time: &slrn-time;</para>
55 </listitem>
56 </itemizedlist>
57
58 <bridgehead renderas="sect3">Slrn Dependencies</bridgehead>
59
60 <bridgehead renderas="sect4">Required</bridgehead>
61 <para role="required"><xref linkend="slang"/> and
62 an <xref linkend="server-mail"/></para>
63
64 <bridgehead renderas="sect4">Optional</bridgehead>
65 <para role="optional"><xref linkend="openssl"/>,
66 <ulink url="http://www.gnu.org/software/gnutls/">GnuTLS</ulink>,
67 <ulink url="http://www.fpx.de/fp/Software/UUDeview/">UUDeview</ulink>,
68 <ulink url="http://www.isc.org/index.pl?/sw/inn/">INN</ulink> and
69 <ulink url="http://homepage.mac.com/imeowbot/iblog/C1355421991/">libcanlock</ulink></para>
70
71 <para condition="html" role="usernotes">User Notes:
72 <ulink url="&blfs-wiki;/slrn"/></para>
73
74 </sect2>
75
76 <sect2 role="installation">
77 <title>Installation of Slrn</title>
78
79 <para>Install <application>slrn</application> by running the following
80 commands:</para>
81
82<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc \
83 --with-slrnpull --enable-spool &amp;&amp;
84make</userinput></screen>
85
86 <para>This package does not come with a test suite.</para>
87
88 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
89
90<screen role='root'><userinput>make install</userinput></screen>
91
92 </sect2>
93
94 <sect2 role="commands">
95 <title>Command Explanations</title>
96
97 <para><parameter>--with-slrnpull --enable-spool</parameter>: These
98 switches enable building the <command>slrnpull</command>
99 executable.</para>
100
101 <para><option>--with-ssl</option>: This switch adds
102 <application>OpenSSL</application> support to
103 <application>slrn</application>.</para>
104
105 <para><option>--with-uudeview</option>: This switch adds
106 <application>UUDeview</application> support to
107 <application>slrn</application>.</para>
108
109 </sect2>
110
111 <sect2 role="configuration">
112 <title>Configuring Slrn</title>
113
114 <sect3 id="slrn-config">
115 <title>Config Files</title>
116
117 <para><filename>/etc/slrn.rc</filename>,
118 <filename>~/.slrnrc</filename></para>
119
120 <indexterm zone="slrn slrn-config">
121 <primary sortas="e-etc-slrn.rc">/etc/slrn.rc</primary>
122 </indexterm>
123
124 <indexterm zone="slrn slrn-config">
125 <primary sortas="e-AA.slrnrc">~/.slrnrc</primary>
126 </indexterm>
127
128 </sect3>
129
130 <sect3>
131 <title>Configuration Information</title>
132
133 <para>The first time <command>slrn</command> is run, the
134 <filename>~/.jnewsrc</filename> file must be created. For this configuration
135 to work, you must have an environmental variable, <envar>NNTPSERVER</envar>,
136 set. In normal operation it would be exported into the environment by a startup file,
137 like <filename>/etc/profile</filename> or <filename>~/.bashrc</filename>. Here it
138 is just put it into the environment of the configuration step. For now, the LFS news
139 server is used in this example, but you should use whatever server you prefer.</para>
140
141 <para>Create the <filename>~/.jnewsrc</filename> file with the following
142 command:</para>
143
144<screen><userinput>NNTPSERVER=<replaceable>&lt;news.&lfs-domainname;&gt;</replaceable> \
145 slrn -f ~/.jnewsrc --create</userinput></screen>
146
147 <indexterm zone="slrn slrn-config">
148 <primary sortas="e-AA.jnewsrc">~/.jnewsrc</primary>
149 </indexterm>
150
151 <para>You will also have to edit one of the configuration files. There is a sample
152 startup <filename>/usr/share/doc/slrn/slrn.rc</filename> file that comes with
153 <application>slrn</application>. It is extensively documented but if you need more
154 information, look at <ulink url="http://slrn.sourceforge.net/docs/">the
155 <application>slrn</application> website</ulink>.</para>
156
157 </sect3>
158
159 </sect2>
160
161 <sect2 role="content">
162 <title>Contents</title>
163
164 <segmentedlist>
165 <segtitle>Installed Programs</segtitle>
166 <segtitle>Installed Libraries</segtitle>
167 <segtitle>Installed Directories</segtitle>
168
169 <seglistitem>
170 <seg>slrn and slrnpull</seg>
171 <seg>None</seg>
172 <seg>/usr/share/slrn and usr/share/doc/slrn</seg>
173 </seglistitem>
174 </segmentedlist>
175
176 <variablelist>
177 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
178 <?dbfo list-presentation="list"?>
179 <?dbhtml list-presentation="table"?>
180
181 <varlistentry id="slrn-prog">
182 <term><command>slrn</command></term>
183 <listitem>
184 <para>is the slang-based news reader.</para>
185 <indexterm zone="slrn slrn-prog">
186 <primary sortas="b-slrn">slrn</primary>
187 </indexterm>
188 </listitem>
189 </varlistentry>
190
191 <varlistentry id="slrnpull">
192 <term><command>slrnpull</command></term>
193 <listitem>
194 <para>is used to pull a small news feed from an NNTP server for offline
195 reading.</para>
196 <indexterm zone="slrn slrnpull">
197 <primary sortas="b-slrnpull">slrnpull</primary>
198 </indexterm>
199 </listitem>
200 </varlistentry>
201
202 </variablelist>
203
204 </sect2>
205
206</sect1>
Note: See TracBrowser for help on using the repository browser.