INSTALL mutt-1.4 (win32)
========================

First read the short /README.w32 about Mutt and Mutt under Windows.


  Unpacking
  ---------

The files of Mutt are organized into a directory structure that need
to be preserved when unpacking the zip file. The top-level directory
in the zip is named 'mutt/'. It would typically be named /usr/local/
in a Unix environment. You are free to rename it to, for instance,
"C:/Program Files/mutt-1.4/" as long as all sub-directories remain.


  Needed Dll:s
  ------------

The original reason to compile Mutt as a native Windows application
was to no more depend on installing extra Dll:s (in contrast to the
Cygwin versions of Mutt for Windows). Today this is only true for a
minimal install of Mutt. To have conversion between character sets and
support for SSL (Secure Socket Layer) you need extra dll:s.

 . msvcrt.dll:
Mutt is compiled against Microsofts run-time library (msvcrt.dll).
Users of a later version of Windows (or a later version of internet
explorer) already have this dll installed. If your system lack this
dll you can download it for free from microsoft.

 . libiconv.dll: (+HAVE_ICONV)
One of the bigger changes from Mutt-1.2.5 to Mutt-1.4 is that Mutt now
requires an iconv library to help convert between different character
sets. This is not possible with the minimal installation.

 . libssl32.dll + libeay32.dll: (+USE_SSL)
Mutt can connect securely over imap and pop (imaps and pops) by using
a library for secure socket layer (SSL).  Read further in the manual
how to enable this. The minimal install cannot do this.

You either place the dll:s in the same directory as mutt.exe or any
directory in your search PATH. With all parts installed you should now
be able to run Mutt. Try a simple 
  C:\mutt\bin> mutt -h
to see a short help message about command parameters.


  Post install
  ------------

Mutt expects each user to have a "home directory". This is where the
user saves all kinds of files, such as mail and configuration files.
If Mutt fails to find your user name and home directory you can simply
write a short mutt.bat file to set the USER and HOME environment
variables. There is an example mutt.bat included, but first try to run
the mutt.exe directly since this can often be enough. You should
probably adjust the window and screen buffer to be of equal size, such
that you have no scroll bar in the window you will run Mutt.

If you want any desktop icons, shortcuts or start menu entries you
will have to add them yourself.


  Configure
  ---------

There is no difference setting Mutt up for Windows or for Unix. If you
are not happy with the default settings you can alter them either
system wide, for all users, or personally, for you alone. The system
wide configuration file is named /mutt/etc/Muttrc. (C:\mutt\etc\Muttrc
if you installed Mutt at top-level on C:) Your personal muttrc is
located in your home directory (or in a .mutt or mutt subdirectory)
where you may choose to name it either .muttrc, muttrc or mutt.rc.

The manual is available from wihin Mutt by pressing the <f1> key.
There is also a html version in the /doc/mutt/html/ subdirectory.
Both have been updated to include the added patches.

An almost minimal .muttrc sample is available in /doc as well as a
slightly more advanced one which uses some of the patched features.
The samples included in any Mutt distribution are available in the 
/doc/mutt/samples directory.


  National language support (+ENABLE_NLS)
  ---------------------------------------

Mutt can present menus and help text in several languages. You pick
your language by setting the environment variable LANG. The possible
values are the same as the directory names in /share/locale:
  ca  da  el  es  fr  hu  it  ko  nl  pt_BR  sk  tr  zh_CN
  cs  de  eo  et  gl  id  ja  lt  pl  ru     sv  uk  zh_TW


  National characters and umlauts (+HAVE_ICONV)
  ---------------------------------------------

All character conversions are handled by the libiconv library.  There
are three details you need to synchronise to be able to show national
characters and umlauts:
 1. You need a windows code page containing your characters
 2. The code page must be supported by libiconv
 3. You need a font that shows your characters at command prompt
The code pages supported by libiconv are listed on their homepage.  
  http://www.gnu.org/software/libiconv/
In a "Command Promt" window you can issue a
  C:\> chcp
command to see and alter your current code page. Use the small
dump.exe from the mutt binary directory to get all characters printed.
Find your font and code page. Alter your mutt.bat or shortcut to take
care of this for you in the future. Before you run Mutt alter your
muttrc file too. Set 'charset' to the code page you will use and set
'send_charset' to contain an appropriate iso standard charset.


UNINSTALL mutt-1.4 (win32)
==========================

Since Mutt is a Unix program it knows nothing about Windows Registry.
All you need to do to uninstall Mutt is remove the files. If you have
added any desktop icons, shortcuts or start menu entries you should
remove them as well.


/Ulf
