NAME

Spreadsheet::WriteExcel - Write formatted text and numbers to a cross-platform Excel binary file.


REQUIREMENTS

This module requires Perl 5.005 (or later) Parse::RecDescent

http://search.cpan.org/search?dist=Parse-RecDescent File::Temp

http://search.cpan.org/search?dist=File-Temp


INSTALLATION

Method 1, standard install with make

Download the zipped tar file from one of the following:

        http://search.cpan.org/search?dist=Spreadsheet-WriteExcel
        http://theoryx5.uwinnipeg.ca/mod_perl/cpan-search?idinfo=154
        ftp://ftp.funet.fi/pub/languages/perl/CPAN/authors/id/J/JM/JMCNAMARA/

Unzip the module as follows or use winzip:

tar -zxvf Spreadsheet-WriteExcel-2.xx.tar.gz

The module can be installed using the standard Perl procedure:

        perl Makefile.PL
        make
        make test
        make install    # You may need to be root
        make clean      # or make realclean

Windows users without a working "make" can get nmake from:

ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe

Method 2, CPAN.pm install

If you have CPAN.pm configured you can install the module as

follows

perl -MCPAN -e "install 'Spreadsheet::WriteExcel'"

Method 3, ActivePerl ppm

ActivePerl users can use PPM as follows:

        C:\> ppm
        PPM> set repository tmp http://homepage.eircom.net/~jmcnamara/perl
        PPM> install Spreadsheet-WriteExcel
        PPM> quit
        C:\>

        If this fails try the following:

        PPM>install http://homepage.eircom.net/~jmcnamara/perl/Spreadsheet-WriteExcel.ppd

If both of these fail you should ensure that ppm is working correctly. Try to install the File::Slurp module as a test:

        C:\> ppm
        PPM> install File-Test
        PPM> quit
        C:\>

A failure here will indicate that your ppm isn't configured correctly or, more likely, that you are behind a firewall. Have a look at the "Using PPM" documentation that comes with ActivePerl to see how to resolve these issues.

Method 4, ActivePerl local ppm

If the previous ppm methods fail you can try a local ppm install as follows. Download the following two files (xx is the most recent version number):

        http://homepage.eircom.net/~jmcnamara/perl/Spreadsheet-WriteExcel.ppd
        http://homepage.eircom.net/~jmcnamara/perl/Spreadsheet-WriteExcel-0.xx-PPM.tar.gz

Copy them to a temp directory. There is no need to un-tar or unzip the PPM file.

In the DOS shell change to the temp directory and run ppm:

         C:\> cd c:\temp
         C:\Temp> ppm

         PPM> install Spreadsheet-WriteExcel.ppd
         Install package 'Spreadsheet-WriteExcel.ppd?' (y/N): y
         Retrieving package 'Spreadsheet-WriteExcel.ppd'...
         Writing C:\perl\site\lib\auto\Spreadsheet\WriteExcel\.packlist
         PPM> quit
         Quit!

The module should now be installed. Note, you will also have to install Parse::RecDescent and possibly File::Temp if it isn't already installed .


UPDATES

You can keep up to date with future release by registering as a user with Freshmeat http://freshmeat.net/ and subscribing to Spreadsheet::WriteExcel at the project page: http://freshmeat.net/projects/writeexcel/

You will then receive mailed updates when a new version is released.


AUTHOR

John McNamara (jmcnamara@cpan.org)