Changeset bfe245f for basicnet/mailnews/slrn.xml

Timestamp:

06/12/2004 06:27:56 AM (20 years ago)

Author:

Bruce Dubbs <bdubbs@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.0, 6.1, 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, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

52d29f7

Parents:

3bba7e2

Message:

XML Update -- Chapter 20

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

File:

• basicnet/mailnews/slrn.xml (modified) (1 diff)

basicnet/mailnews/slrn.xml

@@ +1 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY slrn-download-http "http://prdownloads.sourceforge.net/slrn/slrn-&slrn-version;.tar.bz2">
+  <!ENTITY slrn-download-ftp  "ftp://ftp.fh-heilbronn.de/pub/mirrors/slrn/slrn-&slrn-version;.tar.bz2">
+  <!ENTITY slrn-size          "972 KB">
+  <!ENTITY slrn-buildsize     "9.3 MB">
+  <!ENTITY slrn-time          "0.19 SBU">
+]>
+
 <sect1 id="slrn" xreflabel="slrn-&slrn-version;">
 <?dbhtml filename="slrn.html"?>
 <title>slrn-&slrn-version;</title>
 
-&slrn-intro;
-&slrn-inst;
-&slrn-exp;
-&slrn-config;
-&slrn-desc;
+<sect2>
+<title>Introduction to <application>slrn</application></title>
+
+<para><application>slrn</application> is a slang-based news reader, capable of reading local news
+spools as well as groups from an <acronym>NNTP</acronym> server.  Small local news spools
+can also be created with the use of the slrnpull program included in
+the slrn distribution.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&slrn-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&slrn-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &slrn-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &slrn-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &slrn-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application>slrn</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="slang"/> and <acronym>MTA</acronym> (See <xref linkend="server-mail"/>)</para></sect4>
+
+<sect4><title>Optional</title>
+<para><xref linkend="openssl"/></para></sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>slrn</application></title>
+
+<para>Install <application>slrn</application> by running the following commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc \
+    --with-slrnpull &amp;&amp;
+make LDFLAGS="-ldl" &amp;&amp;
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Command explanations</title>
+
+<para><command>./configure --with-slrnpull</command>: Build the slrnpull executable.</para>
+
+</sect2>
+
+<sect2>
+<title>Configuring <application>slrn</application></title>
+
+<sect3><title>Config files</title>
+<para><filename>/etc/slrn.rc</filename>,
+<filename>~/.slrnrc</filename></para>
+</sect3>
+
+<sect3><title>Configuration Information</title>
+
+<para>The first time <command>slrn</command> is run, the
+<filename>~/.jnewsrc</filename> file must be
+created. For this configuration to work, you must have an environmental
+variable, <envar>NNTPSERVER</envar>, set. In normal operation it would be exported into
+the environment by a startup file, like <filename>/etc/profile</filename>
+or <filename>~/.bashrc</filename>. Here we will just put it into the
+environment of the configuration step. We will use the
+<acronym>LFS</acronym> news server in this example, but you should use
+whatever server you prefer.</para>
+
+<para>Create the <filename>~/.jnewsrc</filename> file with the following
+command:</para>
+
+<screen><userinput><command>NNTPSERVER=<replaceable>news.linuxfromscratch.org</replaceable> \
+    slrn -f ~/.jnewsrc --create</command></userinput></screen>
+
+<para>You will also have to edit one of the configuration files. There
+is a sample startup <filename>/usr/share/doc/slrn/slrn.rc</filename>
+file that comes with slrn. It is extensively documented but if you
+need more information, look at <ulink
+url="http://slrn.sourceforge.net/docs/">the slrn
+website</ulink>.</para>
+
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+<para>The <application>slrn</application> package contains 
+<command>slrn</command> and
+<command>slrnpull</command>.</para>
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>slrn</title>
+<para><command>slrn</command> is the slang-based news reader.</para></sect3>
+
+<sect3><title>slrnpull</title>
+<para><command>slrnpull</command> is used to pull a small news feed from
+an <acronym>NNTP</acronym> server for offline reading.</para></sect3>
+
+</sect2>
 
 </sect1>