source: archive/slrn.xml@ 7df2e1ae

10.0 10.1 11.0 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 xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 7df2e1ae was 7df2e1ae, checked in by Bruce Dubbs <bdubbs@…>, 9 years ago

Cleanup IV. Networking

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

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