Quick summary:
./configure
make
make install

See the Upgrading section at the end for changes that might affect users
of older versions.
==========================

   SECURITY WARNING: Do not put hypermail's output anyplace where a web
   server might have server side includes (SSI) enabled, unless you are sure
   you know what you are doing. If in doubt, check your web server
   configuration. If you are using Apache, look for an Options line
   that mentions Includes or IncludesNOEXEC. The author of an email
   normally has substantial control over what files hypermail creates,
   particularly via attachments. Hypermail is designed to insure that
   filenames don't end in .shtml and don't contain characters like / or \,
   which prevent some security problems, but there are few restrictions
   on what can go in a file (e.g. possibly malicious html tags - try the
   "text_types = *" option or "ignore_types = $NONPLAIN" option if you want
   to restrict this). You might also want to look at the attachmentlink
   and unsafe_chars options to restrict attachment filenames.
   Also, it is probably a bad idea to enable cgi execution on a directory
   that hypermail puts files in.
   Do not use the crappy cgi program called "mail".

Before Building Hypermail:
==========================

   Hypermail now uses "configure" to generate the Makefiles. In the
   top level directory, type "configure" to create the Makefiles.
   If it does not work on your system, please let me know. 

Building Hypermail:
===================

   Hypermail has been normally compiled and run on Unix-based systems
   in the past. Today it can be configured and built using Cygwin 
   software.  I have either compiled and tested this code successfully 
   on the following platforms or others have told me of their success.

        Solaris 2.5.x, SunOS 4.1.3, FreeBSD 2.2.5, FreeBSD 3.0-RELEASE,
        BSDI/3.x, Linux kernel 2.0.18 and 2.0.30, Redhat 5.x && 6.x,
        NT using CygWin-b19 <http://www.cygnus.com/misc/gnu-win32>,
        Irix6.2, HP-UX 10.20, SCO OS 5.0.5, and TRU64/OSF1 on a DEC Alpha

   For more information on Cygwin and build hypermail on a Windows-based 
   system, see the file docs/Install-win32.txt.  

   Generic Build:

    1) Type "./configure". This creates the makefiles and the
       config.h file needed to build the software.

    2) Type "make". This will build the software.
       If it has trouble finding gdbm (e.g. if it fails with a message such as
       "cannot open -lgdbm", you may need to disable gdbm with:
        ./configure  --without-gdbm
       and type "make clean" and then "make" again. (Note that without gdbm,
       you can't do incremental updates using the folder_by_date option).

 On some systems you may need to add "-R/usr/local/lib -L/usr/local/lib"
to the CFLAGS variable in the Makefiles, or alter your LD_LIBRARY_PATH
environment variable (Willi Kernen reports that on a 64-bit Solaris,
changing LD_LIBRARY_PATH to:
/usr/lib:/usr/local/lib:/usr/ccs/lib:/usr/ucb/lib:/usr/openwin/lib
fixed a problem).

 If the make fails at this line: 
        ar cq libpcre.a maketables.o get.o study.o pcre.o
and the configure had said:
  checking whether to build static libraries... no
then you probably should try:
./configure --disable-shared

Testing Hypermail:
==================

    If you wish to test the new hypermail before installing it

       	- chdir to tests/

	- copy a mailbox you have to a local file named "testmail"

	- type "sh ./testhm"

    This will generate an archive under a newly created "testdir/"
    directory.  Check it out with your favorite browser.

    When you are done testing, 

        - remove the testdir directory,

        - remove the testmail file.

    (See the README in tests/ for more information.)

Installing Hypermail:
=====================

    Now that you are ready to install Hypermail, 

        - chdir to the src/ directory

        - Type "make install". 

Documentation:
==============

    To install the HTML documentation:

    1) Edit the Makefile and change "htmldir" to point to the
       directory in which you want the documentation.

    2) Type "make html.install". You should be able to view the
       HTML documentation using any World-Wide Web browser. 

Upgrading:
==============
 The body option has been disabled as of version 2.1.4 for strict HTML 4.01
compatibility. You should replace any body command you have in your .hmrc
with a style sheet (such as a file called hypermail.css in the archive
directory), and set icss_url and mcss_url to the url of that style
sheet. If you want the appearance that was the default before 2.1.4, your
style sheet should contain this:

body {color: black; background: #ffffff}
h1.center {text-align: center}
div.center {text-align: center}

 Also, if you have been using the icss_url and/or mcss_url options and
are upgrading to 2.1.4 or higher, you might want to add those statements
to your style sheet, as their style is no longer being provided by <body ...>
tags, etc. (For users not specifying an icss_url and mcss_url, default
style sheets have been put in all files to maintain that style.)

 The overwrite option defaulted to On for many versions. Starting with
version 2.1.4, it defaults to off again. You may want to turn it on
again occasionally to insure that all of your archive uses the same style
(assuming you have a copy of the archive in mbox format).

 The cgi program called "mail" has been disabled. If you've been using
it, you should either stop using it or look carefully enough at what
it does to understand whether it is safe for you to enable its functionality.
