_____________________
|O|  mutt-1.2.5.1  |X|
^^^^^^^^^^^^^^^^^^^^^

Contents of This File
---------------------
- General Notes
- Rebuild/SRPM Notes
- Red Hat Linux 7.x/i386 Notes
- Changes
- Disclaimer

NOTE: AS THIS RPM IS ONLY FOR LEGACY SUPPORT AND AS WE ONLY HAVE
      LIMITED RESOURCES AT HAND, ONLY RHL 7.x RPMs ARE PROVIDED - FOR ALL
      OTHER DISTRIBUTIONS, PLEASE USE THE SRPM AND FOLLOW THE INSTRUCTIONS
      BELOW!

_______________________
|O|  General Notes  |X|
^^^^^^^^^^^^^^^^^^^^^^^
It was compiled with POP3 support, IMAP support and NLS support (all message
catalogs get installed). PGP and GPG are supported.

The packages live on http://www.ribbrock.org/muttix

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.x (glibc 2.0) packages look like this:

        mutt-1.2.5.1-2.rhl5.i386.rpm
                      ^^^^^^^^^

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

        mutt-1.2.5.1-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 or rxvt if necessary and then calls mutt.

NOTE: *No* default colours are actually defined in the global
      configuration file /etc/Muttrc. For a sample setup, please refer
      to the "sample.muttrc" in /usr/doc/mutt-1.2.5.

Be sure to read mutt's manual /usr/doc/mutt-1.2.5.1/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 and make sure you also read the section relevant to your Linux
distribution and architecture!

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 7.x / i386 (glibc 2.2) Notes  |X|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
THOMAS: The package was built on a AMD Athlon XP1800+ system running
Red Hat Linux 7.3 (Valhalla) with updates applied.

This system has the following library versions:
                                               
    libc-2.2.5.so           <---(glibc 2.2.5-42)
    libnsl-2.2.5.so         <---(glibc 2.2.5-42)
    libncurses.so.5.2       <---(ncurses 5.2-26)

and the folowing other relevant packages:
                                         
    gcc-2.96-113
    rpm-4.0.4-7x.18
    autoconf-2.13-17
    automake-1.4p5-4
    gettext-0.11.1-2
    libtool-1.4.2-7

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|  Changes  |X|
^^^^^^^^^^^^^^^^^
* mutt-1.2.5.1-1 *
  - at long last a security release for legacy support. Only RHL7.x/i386 RPM
    is available, for the rest, the SRPM will be available.
  - Full RHL 7.x support

* mutt-1.2.5i-2 *
  - first stab at RHL 7.x support (alpha!)
  - first stab at AIX, PLD (and OSF/1 aka True64) support (alpha!)


* mutt-1.2.5i-1 *
  - new version


* mutt-1.2.5i-0.1 *
  - new version - internal-only test release
  - Removed BuildPrereq's (caused problems with older rpm versions)
  - Minor fix in info text


* mutt-1.2.4i-1 *
  - improved Caldera support - thanks to Matthew R. Kasun <mkasun@ces.on.ca>
  - added BuildPrereq's for autoconf 2.13 and automake 1.4 (mutt now
    requires these for the build!)
  - The %files entries for man pages are now more flexible (to match
    gzipped man pages as well)


* mutt-1.2.4i-0.1 *
  - new version - internal-only test release
  - added Caldera support - thanks to Matthew R. Kasun <mkasun@ces.on.ca>
  - Matthew will form now on supply RPMs for Caldera 2.x


* mutt-1.2i-1 *
  - new version
  - removed US version support, as only international version exists
    now (i.e. with pgp/gpg support)
  - removed colour configuration example in Muttrc, as sample.muttrc
    scripts in /usr/doc/mutt-x.x/samples already provide such informations.


* mutt-1.1.14i-0.1 *
  - new version - internal-only test release


* mutt-1.1.12i-0.1 *
  - new version - internal-only test release
  - Improved the "cmutt" script further - thanks to Thomas E. Dickey
  - Added "xmutt" script to start mutt in a terminal window under X.
    This is also used by the wmconfig entry on the systems with wmconfig.
    xmutt checks for rxvt and runs it if it exists, otherwise it runs
    xterm. xmutt uses cmutt.


* mutt-1.1.11i-0.1 *
  - new version - internal-only test release
  - Helge will from now on also build RHL 6.x/Alpha RPMs
  - Fabio will from now on build Mandrake 7.x/i386 RPMs


* mutt-1.1.9i-0.2 *
  - new version - internal-only test release
  - RPM can now be built as non-root
  - only international version from now on


* 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.2.5i/

____________________
|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>