add pine and slrn

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

basicnet/mailnews/pine.xml

@@ -1,8 +1,12 @@
-<sect1 id="pine" xreflabel="pine">
+<sect1 id="pine" xreflabel="pine-&pine-version;">
 <?dbhtml filename="pine.html" dir="basicnet"?>
-<title>pine</title>
+<title>pine-&pine-version;</title>
 
-<para>TO BE DONE</para>
+&pine-intro;
+&pine-inst;
+&pine-exp;
+&pine-config;
+&pine-desc;
 
 </sect1>
 

basicnet/mailnews/pine/pine-config.xml

@@ -0,0 +1,14 @@
+<sect2>
+<title>Configuring Pine</title>
+
+<sect3><title>Config files</title>
+<para><userinput>~/.pinerc</userinput></para>
+</sect3>
+
+<sect3><title>Configuration Information</title>
+
+<para>The pine executable needs no global configuration to use.  Users
+set Pine options in ~/.pinerc using an internal configuration menu.</para>
+</sect3>
+
+</sect2>

basicnet/mailnews/pine/pine-desc.xml

@@ -0,0 +1,50 @@
+<sect2>
+<title>Contents</title>
+<para>The pine package contains
+<userinput>pine</userinput>,
+<userinput>pico</userinput>,
+<userinput>pilot</userinput>,
+<userinput>imapd</userinput>,
+<userinput>ipop2d</userinput>,
+<userinput>ipop3d</userinput>,
+<userinput>mtest</userinput>,
+<userinput>rpload</userinput> and
+<userinput>rpdump</userinput>.</para>
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>pine</title>
+<para>pine is the Pine mail user agent.</para></sect3>
+
+<sect3><title>pico</title>
+<para>pico is a stand-alone editor, similar to the Pine internal
+message composer.</para></sect3>
+
+<sect3><title>pilot</title>
+<para>pilot is a file and directory navigator and browser.</para></sect3>
+
+<sect3><title>imapd</title>
+<para>imapd is the IMAP server daemon.</para></sect3>
+
+<sect3><title>ipop2d</title>
+<para>ipop2d is an IMAP to POP2 conversion server.</para></sect3>
+
+<sect3><title>ipop3d</title>
+<para>ipop3d is an IMAP to POP3 conversion server.</para></sect3>
+
+<sect3><title>mtest</title>
+<para>mtest is a minimal IMAP mail user agent, used for debugging.</para></sect3>
+
+<sect3><title>rpload</title>
+<para>rpload is the Pine remote data utility, used to convert local
+Pine configuration files or address  books into remote configurations
+or address books.</para></sect3>
+
+
+<sect3><title>rpdump</title>
+<para>rpdump is used to copy data from remote Pine configuration files
+or address books into a local file.</para></sect3>
+
+</sect2>
+

basicnet/mailnews/pine/pine-exp.xml

@@ -0,0 +1,25 @@
+<sect2>
+<title>Command explanations</title>
+<para>The build procedure for Pine is somewhat unusual, in that
+options usually passed as ./configure options or housed in $CFLAGS
+must all be passed on the command line to the ./build script.</para>
+
+<para><userinput>./build sl5</userinput>
+Pine offers quite a few target platforms, slx specifies Linux using
+-lcrypt to get the crypt function.  See the
+<filename>doc/pine-ports</filename> file for more information and
+other authentication options.</para>
+
+<para><userinput>DEBUG='-Os '</userinput>
+Optimize binaries for size.</para>
+
+<para><userinput>MAILSPOOL='/var/mail'</userinput>
+Location of mail spool files, <filename>/var/mail.</filename></para>
+
+<para><userinput>cd bin &amp;&amp;
+install pine /usr/bin</userinput>
+This is all that is required to install Pine, all other executables
+may be installed in the same manner.</para>
+
+</sect2>
+

basicnet/mailnews/pine/pine-inst.xml

@@ -0,0 +1,13 @@
+<sect2>
+<title>Installation of Pine</title>
+
+<para>Install Pine by running the following commands:</para>
+
+<para><screen>
+<userinput>./build slx DEBUG='-Os ' MAILSPOOL='/var/mail' &amp;&amp;
+cd bin &amp;&amp;
+install pine /usr/bin </userinput>
+</screen></para>
+
+</sect2>
+

basicnet/mailnews/pine/pine-intro.xml

@@ -0,0 +1,13 @@
+<sect2>
+<title>Introduction to pine</title>
+
+<screen>Download location (HTTP):       <ulink url="&pine-download-http;"/>
+Download location (FTP):        <ulink url="&pine-download-ftp;"/>
+Version used:                   &pine-version;
+Package size:                   &pine-size;
+Estimated Disk space required:  &pine-buildsize;</screen>
+
+<para>The Pine package contains the Pine Mail User Agent and several
+server daemons for various mail protocols, in addition to some nice
+file and directory editing/browsing programs.</para>
+</sect2>

basicnet/mailnews/pine/pine.ent

@@ -1 +1,11 @@
 <!ENTITY pine SYSTEM "../pine.xml">
+<!ENTITY pine-intro SYSTEM "pine-intro.xml">
+<!ENTITY pine-inst SYSTEM "pine-inst.xml">
+<!ENTITY pine-exp SYSTEM "pine-exp.xml">
+<!ENTITY pine-desc SYSTEM "pine-desc.xml">
+<!ENTITY pine-config SYSTEM "pine-config.xml">
+<!ENTITY pine-buildsize "13 MB">
+<!ENTITY pine-version "4.44">
+<!ENTITY pine-download-http "http://mirror.sit.wisc.edu/pub/net/mail/pine/pine4.44.tar.gz">
+<!ENTITY pine-download-ftp "ftp://ftp.cac.washington.edu/pine/pine4.44.tar.gz">
+<!ENTITY pine-size "3.4 MB">

basicnet/mailnews/slrn.xml

@@ -1,8 +1,12 @@
-<sect1 id="slrn" xreflabel="slrn">
+<sect1 id="slrn" xreflabel="slrn-&slrn-version;">
 <?dbhtml filename="slrn.html" dir="basicnet"?>
-<title>slrn</title>
+<title>slrn-&slrn-version;</title>
 
-<para>TO BE DONE</para>
+&slrn-intro;
+&slrn-inst;
+&slrn-exp;
+&slrn-config;
+&slrn-desc;
 
 </sect1>
 

basicnet/mailnews/slrn/slrn-config.xml

@@ -0,0 +1,20 @@
+<sect2>
+<title>Configuring slrn</title>
+
+<sect3><title>Config files</title>
+<para><userinput>$HOME/.jnewsrc, $HOME/.jnewsrc.time, $HOME/.slrnrc</userinput></para>
+</sect3>
+
+<sect3><title>Configuration Information</title>
+
+<para>The first time slrn is run, the $HOME/.jnewsrc file must be
+created.Create the $HOME/.jnewsrc file with the following
+command:</para>
+
+<para><screen>
+<userinput> slrn -f $HOME/.jnewsrc --create &amp;&amp; </userinput>
+</screen></para>
+
+</sect3>
+
+</sect2>

basicnet/mailnews/slrn/slrn-desc.xml

@@ -0,0 +1,18 @@
+<sect2>
+<title>Contents</title>
+<para>The slrn package contains 
+<userinput>slrn</userinput> and
+<userinput>slrnpull</userinput>.</para>
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>slrn</title>
+<para>slrn is the slang-based news reader.</para></sect3>
+
+<sect3><title>slrnpull</title>
+<para>slrnpull is used to pull a small news feed from an NNTP server
+for offline reading.</para></sect3>
+
+</sect2>
+

basicnet/mailnews/slrn/slrn-exp.xml

@@ -0,0 +1,11 @@
+<sect2>
+<title>Command explanations</title>
+
+<para><userinput>./configure --prefix=/usr</userinput>
+Specify /usr to install to instead of /usr/local.</para>
+
+<para><userinput>./configure --with-slrnpull</userinput>
+Build the slrnpull executable.</para>
+
+</sect2>
+

basicnet/mailnews/slrn/slrn-inst.xml

@@ -0,0 +1,13 @@
+<sect2>
+<title>Installation of slrn</title>
+
+<para>Install slrn by running the following commands:</para>
+
+<para><screen>
+<userinput>./configure --prefix=/usr --with-slrnpull &amp;&amp;
+make &amp;&amp;
+make install</userinput>
+</screen></para>
+
+</sect2>
+

basicnet/mailnews/slrn/slrn-intro.xml

@@ -0,0 +1,14 @@
+<sect2>
+<title>Introduction to slrn</title>
+
+<screen>Download location (HTTP):       <ulink url="&slrn-download-http;"/>
+Download location (FTP):        <ulink url="&slrn-download-ftp;"/>
+Version used:                   &slrn-version;
+Package size:                   &slrn-size;
+Estimated Disk space required:  &slrn-buildsize;</screen>
+
+<para>slrn is a slang-based newsreader, capable of reading local news
+spools as well as groups from an NNTP server.  Small local news spools
+can also be created with the use of the slrnpull program included in
+the slrn distribution.</para>
+</sect2>

basicnet/mailnews/slrn/slrn.ent

@@ -1 +1,11 @@
 <!ENTITY slrn SYSTEM "../slrn.xml">
+<!ENTITY slrn-intro SYSTEM "slrn-intro.xml">
+<!ENTITY slrn-inst SYSTEM "slrn-inst.xml">
+<!ENTITY slrn-exp SYSTEM "slrn-exp.xml">
+<!ENTITY slrn-desc SYSTEM "slrn-desc.xml">
+<!ENTITY slrn-config SYSTEM "slrn-config.xml">
+<!ENTITY slrn-buildsize "2.1 MB">
+<!ENTITY slrn-version "0.9.7.4">
+<!ENTITY slrn-download-http "http://telia.dl.sourceforge.net/sourceforge/slrn/slrn-0.9.7.4.tar.bz2">
+<!ENTITY slrn-download-ftp "ftp://ftp.fu-berlin.de/pub/unix/news/slrn/slrn-0.9.7.4.tar.gz">
+<!ENTITY slrn-size "850 KB">

introduction/welcome/changelog.xml

@@ -10,6 +10,9 @@ page in Chapter 1 for details on who wrote what.</para>
 
 <itemizedlist>
 
+<listitem><para>August 9th, 2002 [larry]: Basic Networking: Added
+pine-4.44 and slrn-0.9.7.4.</para></listitem>
+
 <listitem><para>August 9th, 2002 [larry]: Basic Networking: Added
 w3m-0.3.1.</para></listitem>
 

introduction/welcome/credits.xml

@@ -89,7 +89,7 @@ Bauman</emphasis></para></listitem>
 <listitem><para>db and lcms: <emphasis>Jeremy Jones and Mark
 Hymers</emphasis></para></listitem>
 
-<listitem><para>emacs: <emphasis>Billy O'Connor</emphasis></para></listitem>
+<listitem><para>emacs, pine and slrn: <emphasis>Billy O'Connor</emphasis></para></listitem>
 
 <listitem><para>fetchmail and wvdial: <emphasis>Paul
 Campbell</emphasis></para></listitem>