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.