glfs/basicnet/mailnews/mutt.xml
Dan Nichilson 5ed9bd0a77 Added note about development release to Mutt-1.5.11. Updated FTP link.
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5698 af4574ff-66df-0310-9fd7-8a98e5e911e0
2006-03-02 20:43:38 +00:00

242 lines
8.0 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY mutt-download-http "http://prdownloads.sourceforge.net/mutt/mutt-&mutt-version;.tar.gz">
<!ENTITY mutt-download-ftp "ftp://ftp.mutt.org/mutt/devel/mutt-&mutt-version;.tar.gz">
<!ENTITY mutt-md5sum "00e6f8f7c37d4840e5e30583ebee21ce">
<!ENTITY mutt-size "3.1 MB">
<!ENTITY mutt-buildsize "24.2 MB">
<!ENTITY mutt-time "0.4 SBU">
]>
<sect1 id="mutt" xreflabel="Mutt-&mutt-version;">
<?dbhtml filename="mutt.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
<keywordset>
<keyword role="package">mutt-&mutt-version;.tar</keyword>
<keyword role="ftpdir">mutt</keyword>
</keywordset>
</sect1info>
<title>Mutt-&mutt-version;</title>
<sect2 role="package">
<title>Introduction to Mutt</title>
<para>The <application>Mutt</application> package contains a Mail User Agent.
This is useful for reading, writing, replying to, saving, and deleting your email.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing='compact'>
<listitem>
<para>Download (HTTP): <ulink url="&mutt-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&mutt-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &mutt-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &mutt-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &mutt-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &mutt-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Mutt Dependencies</bridgehead>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="gnupg"/>,
<xref linkend="openssl"/> or
<ulink url="http://www.gnu.org/software/gnutls/">GnuTLS</ulink> (which
needs <ulink
url="ftp://ftp.gnupg.org/gcrypt/alpha/libgpg-error/">libgpg-error</ulink>
then <ulink url="ftp://ftp.gnupg.org/gcrypt/libgcrypt/">libgcrypt</ulink>),
<ulink url="../server/mail.html">MTA</ulink>,
<xref linkend="ispell"/>,
<xref linkend="mitkrb"/> or <xref linkend="heimdal"/>,
<xref linkend="cyrus-sasl"/>,
<xref linkend="slang"/>,
<xref linkend="libidn"/>,
<xref linkend="gdbm"/>, and
<!-- <xref linkend="db"/> -->
<ulink url="http://www.gnu.org/software/gdb/gdb.html">GDB</ulink></para>
</sect2>
<sect2 role="installation">
<title>Installation of Mutt</title>
<note>
<para>This version of <application>Mutt</application> is a development
release. The BLFS staff has determined that it provides a stable
program and fixes two issues in the current stable version of
<application>Mutt</application>: a segmentation fault that occurs under
certain conditions and a compilation problem when building with
<application>GCC-&gcc-version;</application>. To find the current
stable release, please refer to the
<ulink url="http://www.mutt.org/">Mutt home page</ulink>.</para>
</note>
<para><application>Mutt</application> requires a group named
<systemitem class="groupname">mail</systemitem>. You can
add this group, if it does not exist, with this command:</para>
<screen role="root"><userinput>groupadd -g 34 mail</userinput></screen>
<para>If you did not install a MTA, such as <xref linkend="postfix"/> or
<xref linkend="sendmail"/>, you need to modify the ownership of
<filename class="directory">/var/mail</filename> with this command:</para>
<screen role="root"><userinput>chgrp -v mail /var/mail</userinput></screen>
<para>Install <application>Mutt</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc \
--enable-pop --enable-imap &amp;&amp;
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</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><parameter>--enable-pop</parameter>: This switch enables
POP3 support.</para>
<para><parameter>--enable-imap</parameter>: This switch enables
IMAP support.</para>
<para><parameter>--with-...</parameter>: This switch enables the various
dependencies.</para>
</sect2>
<sect2 role="configuration">
<title>Configuring Mutt</title>
<sect3 id="mutt-config">
<title>Config Files</title>
<para><filename>/etc/Muttrc</filename>, <filename>~/.muttrc</filename>,
<filename>/etc/mime.types</filename>, <filename>~/.mime.types</filename></para>
<indexterm zone="mutt mutt-config">
<primary sortas="e-etc-Muttrc">/etc/Muttrc</primary>
</indexterm>
<indexterm zone="mutt mutt-config">
<primary sortas="e-AA.muttrc">~/.muttrc</primary>
</indexterm>
<indexterm zone="mutt mutt-config">
<primary sortas="e-etc-mime.types">/etc/mime.types</primary>
</indexterm>
<indexterm zone="mutt mutt-config">
<primary sortas="e-AA.mime.types">~/.mime.types</primary>
</indexterm>
</sect3>
<sect3>
<title>Configuration Information</title>
<para>No changes in these files are necessary to begin using
<application>Mutt</application>. When you are ready to make changes, the
man page for <filename>muttrc</filename> is a good starting place.</para>
<para>In order to utilize <application>GnuPG</application>, use the following
command:</para>
<screen><userinput>cat /usr/share/doc/mutt/samples/gpg.rc &gt;&gt; ~/.muttrc</userinput></screen>
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>flea, mutt, mutt_dotlock, muttbug, pgpring, and pgpwrap</seg>
<seg>None</seg>
<seg>/usr/doc/mutt</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="flea">
<term><command>flea</command></term>
<listitem>
<para>is a bug submitter for <application>Mutt</application>.</para>
<indexterm zone="mutt flea">
<primary sortas="b-flea">flea</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="mutt-prog">
<term><command>mutt</command></term>
<listitem>
<para>is a Mail User Agent (MUA) which enables you to read, write and delete
your email.</para>
<indexterm zone="mutt mutt-prog">
<primary sortas="b-mutt">mutt</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="mutt_dotlock">
<term><command>mutt_dotlock</command></term>
<listitem>
<para>implements the mail spool file lock.</para>
<indexterm zone="mutt mutt_dotlock">
<primary sortas="b-mutt_dotlock">mutt_dotlock</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="muttbug">
<term><command>muttbug</command></term>
<listitem>
<para>is a script that executes <command>flea</command>.</para>
<indexterm zone="mutt muttbug">
<primary sortas="c-muttbug">muttbug</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>