Instructions for installing muttzilla

Warning:  muttzilla is currently undergoing major changes to make it
easier to configure, particularly for non-programmers.  There are
still a number of rough edges however.  If you find these instructions
daunting or unintelligible come back in a couple weeks.

The enclosed makefile works for me under RedHat 6.x, but I have not
tested it on any other platform.  In particular, I suspect that the
arguments to ld can vary quite a bit from vendor to vendor.  I have
received reports that muttzilla works under Solaris.  I'm still
working with the lone HP/UX user I've heard from to figure out the
appropriate ld config.

If you wish to include news support you will need to read muttzilla.h
and edit the #defines accordingly.  You will also need to do this if
you wish to change where the global configuration file resides.  If
you change where the global configuration file resides, you will also
need to edit mz{mail,news}.sh and/or mz{mail,news}.py accordingly.

Now, cross your fingers and type 'make'.  You should get a file named
'muttzilla.so'.  If you wish you can manually move that library to
wherever you want it to live.  If you want things to just happen
automatically run 'make install'.

Make sure you have exited Netscape, and add the following lines to
~/.netscape/preferences.js:

user_pref("mail.use_altmail", true);
user_pref("mail.altmail_dll", "/usr/local/lib/muttzilla.so");

If you chose to install muttzilla.so elsewhere then fill in the
appropriate path.

Edit /etc/muttzilla.conf and/or ~/.muttzillarc.  Currently 'mutt',
'pine', 'dtmail' and 'VM' are valid settings for mailargs.  (Pine
hint:  change mailprog and mailargs to 'pine'.)  Currently only 'tin'
is valid for newsargs.

Fire up Netscape and test it out.  So long as you don't set "reread =
0", the library will reread the configuration files every time an
operation is performed.  This allows you to adjust the configuration
without having to restart Netscape, which is a big improvement over
the old way of doing things.

There are a number of known issues with various versions of Netscape
Communicator and Navigator.  Some of these issues are very
significant.  If you experience any unexpected behavior, please check
ERRATA first.

If you run into major problems and want to check up on muttzilla, the
first thing to do is to turn debugging on (see /etc/muttzilla.conf)
and make sure that appropriate messages are being printed.  If you see
any messages at all when debugging is turned off then there is
probably a configuration error of some sort.  If you can't find any
configuration errors, check ERRATA and TODO to see if your problem is
a known issue.  If you still don't have any answers let me know; it
may be a genuine bug.

Good luck!

-Brian
