README file for XMail::Install.

See also: Changes.txt.

Warning: WinZip 8.1 and 9.0 both contain an 'accidental' bug which stops
them recognizing POSIX-style directory structures in valid tar files.
You are better off using a reliable tool such as InfoZip:
ftp://ftp.info-zip.org/pub/infozip/

1 Installing from a Unix-like distro
------------------------------------
shell>gunzip XMail-Install-1.00-1.00.tgz
shell>tar mxvf XMail-Install-1.00-1.00.tar

On Unix-like systems, assuming you have installed Module::Build V 0.25+:

shell>perl Build.PL
shell>./Build
shell>./Build test
shell>./Build install

On MS Windows-like systems, assuming you have installed Module::Build V 0.25+:

shell>perl Build.PL
shell>perl Build
shell>perl Build test
shell>perl Build install

Alternately, without Module::Build, you do this:

Note: 'make' on MS Windows-like systems may be called 'nmake' or 'dmake'.

shell>perl Makefile.PL
shell>make
shell>make test
shell>su              (for Unix-like systems)
shell>make install
shell>exit            (for Unix-like systems)

On all systems:

Run Install.pm through you favourite pod2html translator.

If you are using my fancy-pom2.pl, with its 'default.css' file installed in
/apache2/htdocs/assets/css/, you'd do:

shell>perl fancy-pom2.pl html -css Install.pm > /apache2/htdocs/assets/Install.html

or perhaps something like:

shell>perl fancy-pom2.pl html -css Install.pm > /perl/html/site/lib/XMail/Install.html

2 Installing from an ActiveState distro
---------------------------------------
shell>unzip XMail-Install-1.00-1.00.zip
shell>ppm install --location=. XMail-Install-1.00
shell>del XMail-Install-1.00-1.00.ppd
shell>del PPM-XMail-Install-1.00-1.00.tar.gz

3 What to do next
-----------------
Download xmail-1.24.win32bin.zip from http://xmailserver.org/.
Unpack into c:\, creating c:\xmail-1.24.
Unpack the distro.

shell>cd examples
shell>perl install-xmail-1.pl -h
shell>perl install-xmail-1.pl -v -other -options
shell>perl install-xmail-2.pl -v -other -options

The reason for having 2 install programs is that I could not get 1 to work properly, neither under Win2FK nor WinXFP.
Sometimes it would work, and sometimes it would not.