Changeset 38ef567


Ignore:
Timestamp:
04/29/2005 05:22:39 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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:
bf8ac01
Parents:
97063a43
Message:

Tagged slrn.xml.

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • basicnet/mailnews/slrn.xml

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