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.