[blfs-book] r12762 - in trunk/BOOK: . archive introduction/welcome server/mail

igor at higgs.linuxfromscratch.org igor at higgs.linuxfromscratch.org
Sat Feb 22 00:41:20 PST 2014


Author: igor
Date: Sat Feb 22 00:41:20 2014
New Revision: 12762

Log:
Archive qpopper.

Added:
   trunk/BOOK/archive/qpopper.xml
      - copied unchanged from r12761, trunk/BOOK/server/mail/qpopper.xml
Deleted:
   trunk/BOOK/server/mail/qpopper.xml
Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/server/mail/mail.xml

Copied: trunk/BOOK/archive/qpopper.xml (from r12761, trunk/BOOK/server/mail/qpopper.xml)
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ trunk/BOOK/archive/qpopper.xml	Sat Feb 22 00:41:20 2014	(r12762, copy of r12761, trunk/BOOK/server/mail/qpopper.xml)
@@ -0,0 +1,203 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY qpopper-download-http " ">
+  <!ENTITY qpopper-download-ftp "ftp://ftp.qualcomm.com/eudora/servers/unix/popper/qpopper&qpopper-version;.tar.gz">
+  <!ENTITY qpopper-md5sum "3b62b70fbcd16bb17795e1762dd33765">
+  <!ENTITY qpopper-size "1.2 MB">
+  <!ENTITY qpopper-buildsize "7.2 MB">
+  <!ENTITY qpopper-time "0.1 SBU">
+]>
+
+<sect1 id="qpopper" xreflabel="Qpopper-&qpopper-version;">
+  <?dbhtml filename="qpopper.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>Qpopper-&qpopper-version;</title>
+
+  <indexterm zone="qpopper">
+    <primary sortas="a-Qpopper">Qpopper</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to Qpopper</title>
+
+    <para>The <application>Qpopper</application> package contains a
+    POP3 mail server.</para>
+
+    &lfs74_built;
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&qpopper-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&qpopper-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &qpopper-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &qpopper-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &qpopper-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &qpopper-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">Qpopper Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para role="required">An <xref linkend="server-mail"/></para>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional">
+      <xref linkend="openssl"/>,
+      <xref linkend="linux-pam"/>, and
+      <xref linkend="mitkrb"/>
+    </para>
+
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/qpopper"/></para>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of Qpopper</title>
+
+    <para>Install <application>Qpopper</application> with the following
+    commands:</para>
+
+<screen><userinput>./configure --prefix=/usr --enable-standalone &&
+make</userinput></screen>
+
+    <para>This package does not come with a test suite.</para>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>make install &&
+install -D -m644 GUIDE.pdf /usr/share/doc/qpopper-&qpopper-version;/GUIDE.pdf</userinput></screen>
+
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para><option>--enable-standalone</option>: This option gives the
+    flexibility to run <application>Qpopper</application> in
+    standalone mode.</para>
+
+  </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring Qpopper</title>
+
+    <sect3 id="qpopper-config">
+      <title>Configuration Information</title>
+
+      <para>Update the <application>Syslog</application> configuration file and
+      force the <command>syslogd</command> daemon to reread the new file so that
+      <application>Qpopper</application> events are logged:</para>
+
+      <indexterm zone="qpopper qpopper-config">
+        <primary sortas="e-etc-syslog.conf">/etc/syslog.conf</primary>
+      </indexterm>
+
+<screen role="root"><userinput>echo "local0.notice;local0.debug /var/log/POP.log" >> /etc/syslog.conf &&
+killall -HUP syslogd</userinput></screen>
+
+      <para id="qpopper-init">If you want <application>Qpopper</application> to
+      start automatically when the system is booted, install the
+      <filename>/etc/rc.d/init.d/qpopper</filename> init script included in the
+      <xref linkend="bootscripts"/> package.</para>
+
+      <indexterm zone="qpopper qpopper-init">
+        <primary sortas="f-qpopper">popper</primary>
+      </indexterm>
+
+<screen role="root"><userinput>make install-qpopper</userinput></screen>
+
+      <para>This startup procedure uses a configuration file.  The details of
+      the configuration file can be found in the documentation file
+      <filename>GUIDE.pdf</filename>.</para>
+
+<screen role="root"><userinput>cat > /etc/mail/qpopper.conf << "EOF"
+<literal># Qpopper configuration file
+
+set debug = false
+
+set spool-dir = /var/spool/mail/
+set temp-dir  = /var/spool/mail/
+
+set downcase-user = true
+set trim-domain = true
+
+set statistics = true
+
+# End /etc/shells</literal>
+EOF</userinput></screen>
+
+      <para>If you use <command>inetd</command>, the following command will
+      add the <application>Qpopper</application> entry to
+      <filename>/etc/inetd.conf</filename>:</para>
+
+      <indexterm zone="qpopper qpopper-config">
+        <primary sortas="e-etc-inetd.conf">/etc/inetd.conf</primary>
+      </indexterm>
+
+<screen role="root"><userinput>echo "pop3 stream tcp nowait root /usr/sbin/popper popper" >> /etc/inetd.conf &&
+killall inetd || inetd</userinput></screen>
+
+      <para>Issue a <command>killall -HUP inetd</command> to reread the
+      changed <filename>inetd.conf</filename> file.</para>
+
+    </sect3>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Program</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>popper</seg>
+        <seg>None</seg>
+        <seg>None</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="popper-qpopper">
+        <term><command>popper</command></term>
+        <listitem>
+          <para>is the POP3 server daemon.</para>
+          <indexterm zone="qpopper popper-qpopper">
+            <primary sortas="b-popper">popper</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>

Modified: trunk/BOOK/general.ent
==============================================================================
--- trunk/BOOK/general.ent	Fri Feb 21 19:47:03 2014	(r12761)
+++ trunk/BOOK/general.ent	Sat Feb 22 00:41:20 2014	(r12762)
@@ -1,12 +1,12 @@
 <!-- $LastChangedBy$ $Date$ -->
 
-<!ENTITY day          "21">                   <!-- Always 2 digits -->
+<!ENTITY day          "22">                   <!-- Always 2 digits -->
 <!ENTITY month        "02">                   <!-- Always 2 digits -->
 <!ENTITY year         "2014">
 <!ENTITY copyrightdate "2001-&year;">
 <!ENTITY copyholder   "The BLFS Development Team">
 <!ENTITY version      "&year;-&month;-&day;">
-<!ENTITY releasedate  "February 21st, &year;">
+<!ENTITY releasedate  "February 22nd, &year;">
 <!ENTITY pubdate      "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
 <!ENTITY blfs-version "svn">                  <!-- svn|[release #] -->
 <!ENTITY lfs-version  "development">          <!-- version|testing|unstable|development] -->
@@ -504,7 +504,6 @@
 
 <!ENTITY exim-version                 "4.82">
 <!ENTITY postfix-version              "2.11.0">
-<!ENTITY qpopper-version              "4.1.0">
 <!ENTITY sendmail-version             "8.14.8">
 
 <!-- Chapter 22 -->

Modified: trunk/BOOK/introduction/welcome/changelog.xml
==============================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	Fri Feb 21 19:47:03 2014	(r12761)
+++ trunk/BOOK/introduction/welcome/changelog.xml	Sat Feb 22 00:41:20 2014	(r12762)
@@ -45,6 +45,16 @@
 -->
 
     <listitem>
+      <para>February 22nd, 2014</para>
+      <itemizedlist>
+        <listitem>
+          <para>[igor] - Archive qpopper. Fixes
+          <ulink url="&blfs-ticket-root;4722">#4722</ulink>.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>February 21st, 2014</para>
       <itemizedlist>
         <listitem>

Modified: trunk/BOOK/server/mail/mail.xml
==============================================================================
--- trunk/BOOK/server/mail/mail.xml	Fri Feb 21 19:47:03 2014	(r12761)
+++ trunk/BOOK/server/mail/mail.xml	Sat Feb 22 00:41:20 2014	(r12762)
@@ -25,7 +25,6 @@
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dovecot.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="exim.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="postfix.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="qpopper.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="sendmail.xml"/>
 
 </chapter>



More information about the blfs-book mailing list