______________________
|O|  mutt-1.0.1us  |X|
^^^^^^^^^^^^^^^^^^^^^^
Contents of This File
---------------------
- General Notes
- Rebuild/SRPM Notes
- Red Hat Linux 5.2/i386 Notes
- Red Hat Linux 5.2/Sparc Notes
- Red Hat Linux 6.0/i386 Notes
- Red Hat Linux 6.0/Sparc Notes
- SuSE Linux 6.2/i386 Notes
- Changes
- Disclaimer

_______________________
|O|  General Notes  |X|
^^^^^^^^^^^^^^^^^^^^^^^
====> This is the US version of mutt, i.e. *without* PGP support. <====

It was compiled with POP3 support, IMAP support and NLS support (all message
catalogs get installed).

The packages live on http://mutt.linuxatwork.at/~emgaron
and are signed with the packager's PGP key.

The packages are available both with and without the compressed
folder patch from  Roland Rosenfeld <roland@spinnaker.de> applied.
Here's how to tell the difference (using Red Hat Linux 5.2 as an example):

    Plain Red Hat Linux 5.2 (glibc 2.0) packages look like this:

        mutt-1.0.1us-2.rhl5.i386.rpm
                      ^^^^^^^^^

    Red Hat Linux 5.2 (glibc 2.0) packages with compressed folder
    patch look like this:

        mutt-1.0.1us-2.cfp.rhl5.i386.rpm
                      ^^^^^^^^^

The following patches were applied:
- patch to add colour definitions (commented out) to /etc/Muttrc
  (both versions)
- patch to add compressed folder settings for gzip and bzip2 to
  /etc/Muttrc (".cfp" version only)
- compressed folder patch from Roland Rosenfeld <roland@spinnaker.de>
  (".cfp" version only)

mutt was linked against ncurses. This has the advantage of providing a
slighty better colour support than S-Lang (default colours work
better) but the disadvantage, that ncurses/mutt won't display colours
if the TERM variable is set to xterm. To take advantage of the colour
display, you'll have to either set TERM to xterm-color or use the
cmutt script I provided. cmutt is a simple shell script which sets
TERM to xterm-color if necessary and then calls mutt.

NOTE: *No* default colours are actually defined in /etc/Muttrc. However,
      I did provide a sample colour setup in /etc/Muttrc, though commented 
      out. To enable it, you either need to uncomment those lines, or
      (recommended) copy the file into your home directory as ".muttrc"
      and edit that file.
      In addition, this file contains a list of all mutt variables and the
      global PGP, POP3 and compressed folder settings (".cfp" version
      only!). All of this can be overridden in a personal $HOME/.muttrc file.

Be sure to read mutt's manual /usr/doc/mutt-1.0.1us/manual.txt!
If you're using mutt's standard configuration, F1 should also display the
manual.

____________________________
|O|  Rebuild/SRPM Notes  |X|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

           IMPORTANT if you'd like to build your own RPMs!

The Meta Spec File
------------------
Based on the experience with another, similar project (RPMs for the Window
Maker window manager, for RHL 4.x i386, 5.x i386, 5.x Alpha, 6.x i386), I
decided to use a slightly different approach to building the RPMs.
Instead of simply writing a "mutt.spec" file, I use a so called "Meta Spec
File". After installing the SRPM, it can be found in
/usr/src/redhat/SOURCE (on a Red Hat system - on other systems, it
should end up wherever the distro puts the sources of a SRPM) and is
named "mutt-VERSION.spec.in"

The Meta Spec File is basically a mixture of a bash shell script with
a couple of m4 macros embedded. To build an RPM, simply execute the file
using bash:
bash mutt-VERSION.spec.in <options>

This produces the actual mutt-VERSION.spec file, suited to the distribution
and architecture it was run on. The script contains code to determine both
automatically and currently is able to recognise RHL 4.x, 5.x and 6.x
systems on Alpha, Intel and Sparc, as well as support for SuSE 6.2.

The "options" determine, whether the resulting spec file is for the
international or the U.S. version, whether it includes the
compressed folder patch or not and whether mutt is linked against
ncurses or S-Lang. Obviously, you will have to have the
right tarball installed (for either the US or the international
version) to build the corresponding version.

In all cases, the resulting spec file will set the file extensions
correctly, thus resulting in e.g. ....cfp.rhl6.i386.rpm for a RHL 6.0 RPM
with compressed folder support.

To get to know further details, have a look at the Meta Spec File
itself.

Note: Due to the usage of the Meta Spec File, it is not recommended to 
      simply use "rpm --rebuild" to build a new RPM!

____________________________________________________
|O|  Red Hat Linux 5.x / i386 (glibc 2.0) Notes  |X|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
THOMAS:  The package was built on a i586 (AMD K6-2/300) system running
Red Hat Linux 5.2 (Apollo), with all official Red Hat updates applied.
NOTE: This means rpm-3.0 was used to build this package!

This system has the following library versions:

    libc.so.6.0.7       <--(glibc 2.0.7)
    libnsl.so.1         <--(glibc 2.0.7)
    libncurses.so.4     <--(ncurses-4.2-10)
    /lib/ld-linux.so.2  <--(glibc 2.0.7)

and the following other relevant packages:

    gcc-2.7.2.3-14
    rpm-3.0.2-5.x
    autoconf-2.12-6
    automake-1.3-2
    gettext-0.10.35-3
    m4-1.4-10

Important SRPM/Rebuild Notes on Red Hat Linux:
- mutt was compiled with "--with-sgid" (i.e. "mutt_dotlock" gets
  installed in /usr/bin with "set group ID mail"). That way mutt should
  work with Red Hat's default permissions on /var/spool/mail!
- You might encounter problems when rebuilding if you changed the
  permissions on /var/spool/mail from the stock Red Hat value
  (-rwxrwxr-x root mail).
  If you changed the permissions to -rwxrwxrwx root mail,
  "mutt_dotlock" will not get built and the rebuild will fail with an
  error (as that file is missing). To succeed in rebuilding, either
  change the permissions back (at least temprarily during the build)
  or change the spec file (remove the %files entry for mutt_dotlock).

A message to Red Hat 5.0 users: This package is built against a newer
versions of glibc than ships with Red Hat 5.0. I would personally
recommend upgrading your system to Red Hat 5.2, which is much more
stable and mature, but if that is not possible, I recommend that you
at least apply all of the official errata updates (especially the
glibc updates).  These updates can be found at ftp://updates.redhat.com

_____________________________________________________
|O|  Red Hat Linux 5.x / Sparc (glibc 2.0) Notes  |X|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
REMI:  The package was built on a SparcStation 10 system running
Red Hat Linux 5.2 (Apollo), with all official Red Hat updates applied.
NOTE: This means rpm-3.0 was used to build this package!

This system has the following library versions:

    libc.so.6.0.7       <--(glibc 2.0.7-29)
    libncurses.so.4     <--(ncurses-4.2-10)
    /lib/ld-linux.so.2  <--(glibc 2.0.7-29)

and the following other relevant packages:

    egcs-1.1.2-12
    rpm-3.0.2-5.x
    autoconf-2.13-5
    automake-1.4-4
    gettext-0.10.35-3
    m4-1.4-10
                                                                                
Important SRPM/Rebuild Notes on Red Hat Linux:
- See RHL 5.2/i386

_____________________________________________________
|O|  Red Hat Linux 5.x / Alpha (glibc 2.0) Notes  |X|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
HELGE:  The package was built on a 20164a/LX system running
Red Hat Linux 5.2 (Apollo), with all official Red Hat updates applied.
NOTE: This means rpm-3.0 was used to build this package!

This system has the following library versions:

    libc.so.6.0.7       <--(glibc 2.0.7-29)
    libncurses.so.4     <--(ncurses-4.2-10)
    /lib/ld-linux.so.2  <--(glibc 2.0.7-29)

and the following other relevant packages:

    egcs-1.1.1-4
    rpm-3.0.2-5.x
    autoconf-2.13-1
    automake-1.4-1
    gettext-0.10.35-3
    m4-1.4-10
                                                                                
Important SRPM/Rebuild Notes on Red Hat Linux:
- See RHL 5.2/i386

____________________________________________________
|O|  Red Hat Linux 6.0 / i386 (glibc 2.1) Notes  |X|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
RALPH: The package was built on a i586 (AMD K6-2/380) system running
Red Hat Linux 6.0 (Hedwig) with updates applied.
NOTE: This means rpm-3.0 was used to build this package!

This system has the following library versions:

        libc.so.6.1.1           <---(glibc 2.1.1)
        libnsl-2.1.1-so         <---(glibc 2.1.1)
        libncurses.so.4         <---(ncurses 4.2.18)

and the folowing other relevant packages:

        egcs-1.1.2-12
        rpm-3.0-6.0
        autoconf-2.13-5
        automake-1.4-4
        gettext-0.10.35-8

Important SRPM/Rebuild Notes on Red Hat Linux:
- mutt was compiled with "--with-sgid" (i.e. "mutt_dotlock" gets
  installed in /usr/bin with "set group ID mail"). That way mutt should
  work with Red Hat's default permissions on /var/spool/mail!
- You might encounter problems when rebuilding if you changed the
  permissions on /var/spool/mail from the stock Red Hat value
  (-rwxrwxr-x root mail).
  If you changed the permissions to -rwxrwxrwx root mail,
  "mutt_dotlock" will not get built and the rebuild will fail with an
  error (as that file is missing). To succeed in rebuilding, either
  change the permissions back (at least temprarily during the build)
  or change the spec file (remove the %files entry for mutt_dotlock).

_________________________________________
|O|  Red Hat Linux 6.0 / Sparc Notes  |X|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ALEC: The sparc packages were built on a SPARCstation 5 system running
Red Hat Linux 6.0 (Hedwig), with all official Red Hat updates applied.
NOTE: This means rpm-3.0 was used to build this package!

This system has the following library versions:

    libc.so.6           <--(glibc-2.1.1-6)
    libncurses.so.4     <--(ncurses-4.2-18)
    /lib/ld-linux.so.2  <--(glibc-2.1.1-6)

and the following other relevant packages:

    egcs-1.1.2-13
    rpm-3.0.2-6.0
    autoconf-2.13-5
    automake-1.4-4
    gettext-0.10.35-8

Important SRPM/Rebuild Notes on Red Hat Linux:
- See RHL 6.0/i386.

_____________________________________
|O|  SuSE Linux 6.2 / i386 Notes  |X|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
REMI: The packages were built on a i486 DX4/100 system running
SuSE Linux 6.2, with all official SuSE updates applied.

This system has the following library versions:

    libc.so.6           <--(glibc-2.1.1-7)
    libncurses.so.4     <--(ncurses-4.2-17)
    /lib/ld-linux.so.2  <--(glibc-2.1.1-7)

and the following other relevant packages:

    egcs-990708-6
    rpm-3.0.3-6
    autoconf-2.13-36
    automake-1.4-31
    gettext-0.10.35-45
    sgmltool-1.0.9-44

Important SRPM/Rebuild Notes on SuSE Linux:
- mutt was *NOT* compiled with "--with-sgid" (i.e. no "mutt_dotlock")
  That way mutt should work with SuSE's default permissions on
  /var/spool/mail!
- You might encounter problems when rebuilding if you changed the
  permissions on /var/spool/mail from the stock SuSE value
  (drwxrwxrwt root root).

_________________
|O|  Changes  |X|
^^^^^^^^^^^^^^^^^
* mutt-1.0.1XX-1 *
  - new version
  - new maintainers for SuSE 6.3/i386 and RHL 5.x/Alpha

  
* mutt-1.0XX-2 *
  - BUGFIX: wmconfig entry didn't get installed properly


* mutt-1.0XX-1 *
  - New version: mutt-1.0 released!
  - added support for new language catalogs


* mutt-1.0pre4XX-1 *
  - New version
  - Meta Spec File now uses common script to determine distro


* mutt-1.0pre3XX-2 *
  - updated compressed folder patch - BUGFIX (filedescriptor leak)


* mutt-1.0pre3XX-1 *
  - SuSE 6.2 support added (thanks to Remi Guyomarch <rguyom@mail.dotcom.fr>)
  - IMAP support added
  - added Meta Spec File section to this README


* mutt-1.0pre2XX-2 *
  - Added switch to compile with Slang
  - changed doc installation so that F1 works again


* mutt-1.0pre2XX-1 *
  - New version


* mutt-1.0pre1XX-3 *
  - BUGFIX: Added %dir entry for /usr/share/mutt/charsets to ensure
    working uninstall
  - both US and international version can be built from the same spec.in
    now
  - more comments in spec.in file


* mutt-1.0pre1XX-2 *
  - first US version RPM!
  - BUGFIX: Files got installed on the life filesystem in
    /usr/share/mutt during rebuild - see next point
  - Back to using DESTDIR during install. Redefined --with-docdir
    to get docs installed where rpm can deal with them.
    Thereby, all "stray install" problems seem to be solved in one go -
    oh joy!
  - Re-checked and updated %files section
    => BUGFIX: The charsets never got installed! (unless one rebuilt
    the SRPM, see first point)
  - spec.in file can now be used for both international and US version


* mutt-1.0pre1i-1 *
  No major changes. I really intend to get out a RHL 6.0 i386 RPM soon...


* mutt-0.95.7i-1 *
  A few improvements, based on the feedback I got after the 0.95.6i-1
  release:
  - the patch to add colour definitions to Muttrc now only adds
    commented lines. That way, it's really up to the user to either
    uncomment those or (recommended) to copy Muttrc to $HOME/.muttrc
    and edit that.
  - cmutt has been improved and now uses "tput" to determine the
    colour capabilities of the terminal it's in. Thanks to
    Thomas E. Dickey for the suggestion.
  - BUGFIX: During "install" (while building the RPM), the directory
    "html" got installed on the life system rather than in the
    RPM_BUILD_ROOT. Fixed by using "docdir" in install.
  
  The same (well - except for the changes mentioned above) three
  patches were applied to the sources as in mutt-0.95.6i-1 (see
  below).


* mutt-0.95.6i-1 *
  I changed the naming conventions. ".cfp" in the name now marks RPMs with
  the compressed folder patch applied. It is now possible to build
  both the plain and the patched version from the same spec.in file by 
  simply providing a command line switch when running bash over the
  spec.in file.

  Three patches were applied to the source in this RPM:
  - patch to add colour definitions /etc/Muttrc
  - patch to add compressed folder settings to /etc/Muttrc ("cfp" version only)
  - compressed folder patch ("cfp" version only)


* mutt-0.95.5i-1 *
  This is the first time I release a mutt RPM with this type of spec
  file (m4 based).

  Several patches were applied to the original source:
  - fcc bugfix patch
  - function key bugfix patch
  - menu bugfix patch
  - compressed folder patch
  - patch to add colour definitions and compressed folder settings to
    /etc/Muttrc

  Added a shell script cmutt to set TERM before running mutt.
  Added menu entry in /etc/X11/wmconfig.
  
* Please please read the documentation in /usr/doc/mutt-1.0pre3i/

____________________
|O|  Disclaimer  |X|
^^^^^^^^^^^^^^^^^^^^

No warranties, even the implied ones, not valid where probited by law,
your mileage may vary, don't take candy from strangers, read the NEWS
file, etc., etc.

-- 
Thomas Ribbrock <emgaron@gmx.net>