Prep for release 2.30.

Changes

@@ -1,5 +1,11 @@
 Revision history for Perl module Spreadsheet::WriteExcel.
 
+2.30 November 25 2009 - Minor
+
+    ! Updated Pod generator to include screenshots of example programs.
+
+
+
 2.29 November 25 2009 - Minor
 
     ! Made version 0.19 of OLE::Storage_Lite a prerequisite to avoid

INSTALL

@@ -26,7 +26,7 @@ INSTALLATION
 
     Unzip the module as follows or use winzip:
 
-           tar -zxvf Spreadsheet-WriteExcel-0.xx.tar.gz
+           tar -zxvf Spreadsheet-WriteExcel-2.xx.tar.gz
 
     The module can be installed using the standard Perl procedure:
 
@@ -116,8 +116,6 @@ UPDATES
     You will then receive mailed updates when a new version is
     released.
 
-    Alternatively you can keep an eye on news://comp.lang.perl.announce
-
 ======================================================================
 AUTHOR
 

MANIFEST

@@ -55,28 +55,17 @@ t/90_pod.t
 t/91_minimumversion.t
 t/92_meta.t
 
-doc/index.html
-doc/WriteExcel.html
-doc/examples.html
-doc/install.html
-doc/number_formats1.html
-doc/number_formats2.html
-doc/palette.html
-doc/rgb5-97.html
-doc/tpj.html
-doc/merge1.gif
-doc/merge2.gif
-doc/regions.gif
-doc/simple.gif
-doc/stats.gif
-doc/stocks.gif
-doc/textwrap.gif
-doc/tpj0503-0004-01.gif
-doc/tpj0503-0004-02.gif
-doc/tpj0503-0004-03.gif
-doc/tpj0503-0004-04.gif
-doc/tpj0503-0004-05.gif
-doc/win32ole.gif
+docs/Perl_Journal_Article.html
+docs/WriteExcel.html
+docs/WriteExcel_Install.html
+docs/number_formats1.html
+docs/number_formats2.html
+docs/palette.html
+docs/tpj_images/tpj0503-0004-01.gif
+docs/tpj_images/tpj0503-0004-02.gif
+docs/tpj_images/tpj0503-0004-03.gif
+docs/tpj_images/tpj0503-0004-04.gif
+docs/tpj_images/tpj0503-0004-05.gif
 
 examples/README
 examples/a_simple.pl

META.yml

@@ -1,6 +1,6 @@
 --- #YAML:1.0
 name:               Spreadsheet-WriteExcel
-version:            2.29
+version:            2.30
 abstract:           Write to a cross platform Excel binary file
 author:
     - John McNamara (jmcnamara@cpan.org)
@@ -12,7 +12,7 @@ build_requires:
     ExtUtils::MakeMaker:  0
 requires:
     File::Temp:         0
-    OLE::Storage_Lite:  0.14
+    OLE::Storage_Lite:  0.19
     Parse::RecDescent:  0
     perl:               5.005
 resources:

Makefile.PL

@@ -5,12 +5,7 @@ use ExtUtils::MakeMaker;
 #
 require 5.005;
 
-my %resources = (
-    repository  => 'http://github.com/jmcnamara/spreadsheet-writeexcel',
-    MailingList => 'http://groups.google.com/group/spreadsheet-writeexcel',
-);
-
-WriteMakefile(
+my %params = (
     'AUTHOR'        => 'John McNamara (jmcnamara@cpan.org)',
     'ABSTRACT'      => 'Write to a cross platform Excel binary file',
     'NAME'          => 'Spreadsheet::WriteExcel',
@@ -19,7 +14,6 @@ WriteMakefile(
     'dist'          => { COMPRESS => 'gzip --best', SUFFIX => 'gz' },
     'EXE_FILES'     => ['bin/chartex'],
     'LICENSE'       => 'perl',
-    'META_MERGE' => { 'resources' => \%resources },
     'PREREQ_PM'  => {
         Parse::RecDescent => 0,
         File::Temp        => 0,
@@ -28,11 +22,22 @@ WriteMakefile(
 
 );
 
+my %resources = (
+    repository  => 'http://github.com/jmcnamara/spreadsheet-writeexcel',
+    MailingList => 'http://groups.google.com/group/spreadsheet-writeexcel',
+);
+
+if ( $ExtUtils::MakeMaker::VERSION ge '6.46' ) {
+    $parms{META_MERGE} = { resources => \%resources };
+}
+
+WriteMakefile(%params);
+
 sub MY::postamble {
     "mydocs:\n"
       . "\tperl examples/gen_examples_pod.pl examples "
       . "> lib/Spreadsheet/WriteExcel/Examples.pm\n"
       . "\tpod2cpanhtml lib/Spreadsheet/WriteExcel.pm "
       . qq{ | perl -ne 'print unless /\\s+under Perl v[\\d.]+\\s/' }
-      . "> doc/WriteExcel.html";
+      . "> docs/WriteExcel.html";
 }

README

@@ -72,3 +72,4 @@ INSTALLATION
 AUTHOR
 
     John McNamara (jmcnamara@cpan.org)
+

docs/WriteExcel.html

@@ -224,8 +224,8 @@ <h1><a class='u' href='#___top' title='click to go to top of document'
 name="VERSION"
 >VERSION</a></h1>
 
-<p>This document refers to version 2.29 of Spreadsheet::WriteExcel,
-released November 25,
+<p>This document refers to version 2.30 of Spreadsheet::WriteExcel,
+released November 29,
 2009.</p>
 
 <h1><a class='u' href='#___top' title='click to go to top of document'
@@ -3167,7 +3167,7 @@ <h2><a class='u' href='#___top' title='click to go to top of document'
 
 <p>Alternatively you can specify the colour based on a colour index as follows: <code>[Color n]</code>, where n is a standard Excel colour index - 7. See the &#39;Standard colors&#39; worksheet created by formats.pl.</p>
 
-<p>For more information refer to the documentation on formatting in the <code>doc</code> directory of the Spreadsheet::WriteExcel distro, the Excel on-line help or <a href="http://office.microsoft.com/en-gb/assistance/HP051995001033.aspx" class="podlinkurl"
+<p>For more information refer to the documentation on formatting in the <code>docs</code> directory of the Spreadsheet::WriteExcel distro, the Excel on-line help or <a href="http://office.microsoft.com/en-gb/assistance/HP051995001033.aspx" class="podlinkurl"
 >http://office.microsoft.com/en-gb/assistance/HP051995001033.aspx</a>.</p>
 
 <p>You should ensure that the format string is valid in Excel prior to using it in WriteExcel.</p>
@@ -3213,7 +3213,7 @@ <h2><a class='u' href='#___top' title='click to go to top of document'
     48      0x30    ##0.0E+0
     49      0x31    @</pre>
 
-<p>For examples of these formatting codes see the &#39;Numerical formats&#39; worksheet created by formats.pl. See also the number_formats1.html and the number_formats2.html documents in the <code>doc</code> directory of the distro.</p>
+<p>For examples of these formatting codes see the &#39;Numerical formats&#39; worksheet created by formats.pl. See also the number_formats1.html and the number_formats2.html documents in the <code>docs</code> directory of the distro.</p>
 
 <p>Note 1. Numeric formats 23 to 36 are not documented by Microsoft and may differ in international versions.</p>
 
@@ -3645,9 +3645,9 @@ <h1><a class='u' href='#___top' title='click to go to top of document'
 
     $worksheet-&#62;write_blank(&#39;A1&#39;, $format);</pre>
 
-<p>The default Excel 97 colour palette is shown in <code>palette.html</code> in the <code>doc</code> directory of the distro. You can generate an Excel version of the palette using <code>colors.pl</code> in the <code>examples</code> directory.</p>
+<p>The default Excel 97 colour palette is shown in <code>palette.html</code> in the <code>docs</code> directory of the distro. You can generate an Excel version of the palette using <code>colors.pl</code> in the <code>examples</code> directory.</p>
 
-<p>A comparison of the colour components in the Excel 5 and Excel 97+ colour palettes is shown in <code>rgb5-97.txt</code> in the <code>doc</code> directory.</p>
+<p>A comparison of the colour components in the Excel 5 and Excel 97+ colour palettes is shown in <code>rgb5-97.txt</code> in the <code>docs</code> directory.</p>
 
 <p>You may also find the following links helpful:</p>
 
@@ -4555,6 +4555,9 @@ <h2><a class='u' href='#___top' title='click to go to top of document'
     # Write a hyperlink
     $worksheet-&#62;write(10, 0, &#39;http://www.perl.com/&#39;);</pre>
 
+<p><center><img src="http://homepage.eircom.net/~jmcnamara/perl/images/a_simple.jpg" width="640" height="599" alt="Output from a_simple.pl" /></center></p>
+
+
 <h2><a class='u' href='#___top' title='click to go to top of document'
 name="Example_2"
 >Example 2</a></h2>
@@ -4600,6 +4603,9 @@ <h2><a class='u' href='#___top' title='click to go to top of document'
     # Set the active cell
     $south-&#62;set_selection(0, 1);</pre>
 
+<p><center><img src="http://homepage.eircom.net/~jmcnamara/perl/images/regions.jpg" width="640" height="599" alt="Output from regions.pl" /></center></p>
+
+
 <h2><a class='u' href='#___top' title='click to go to top of document'
 name="Example_3"
 >Example 3</a></h2>
@@ -4669,6 +4675,9 @@ <h2><a class='u' href='#___top' title='click to go to top of document'
     $worksheet-&#62;write(3, 2, 321,      $f_volume); # 321
     $worksheet-&#62;write(3, 3, 0,        $f_change); # 0 in the font color (black)</pre>
 
+<p><center><img src="http://homepage.eircom.net/~jmcnamara/perl/images/stocks.jpg" width="640" height="599" alt="Output from stocks.pl" /></center></p>
+
+
 <h2><a class='u' href='#___top' title='click to go to top of document'
 name="Example_4"
 >Example 4</a></h2>
@@ -4736,6 +4745,9 @@ <h2><a class='u' href='#___top' title='click to go to top of document'
     $worksheet-&#62;write(10, 0, &#39;Kurtosis&#39;, $format);
     $worksheet-&#62;write(10, 1, &#39;=KURT(B2:I2)&#39;);</pre>
 
+<p><center><img src="http://homepage.eircom.net/~jmcnamara/perl/images/stats.jpg" width="640" height="599" alt="Output from stats.pl" /></center></p>
+
+
 <h2><a class='u' href='#___top' title='click to go to top of document'
 name="Example_5"
 >Example 5</a></h2>
@@ -4875,8 +4887,7 @@ <h2><a class='u' href='#___top' title='click to go to top of document'
     =========
     convertA1.pl            Helper functions for dealing with A1 notation.
     function_locale.pl      Add non-English function names to Formula.pm.
-    writeA1.pl              Example of how to extend the module.
-    gen_examples_pod.pl     Generate the S::WE::Examples.pm doc.</pre>
+    writeA1.pl              Example of how to extend the module.</pre>
 
 <h1><a class='u' href='#___top' title='click to go to top of document'
 name="LIMITATIONS"
@@ -4918,8 +4929,8 @@ <h1><a class='u' href='#___top' title='click to go to top of document'
 name="INSTALLATION"
 >INSTALLATION</a></h1>
 
-<p>See the INSTALL or install.html docs that come with the distribution or: <a href="http://search.cpan.org/src/JMCNAMARA/Spreadsheet-WriteExcel-2.29/INSTALL" class="podlinkurl"
->http://search.cpan.org/src/JMCNAMARA/Spreadsheet-WriteExcel-2.29/INSTALL</a>.</p>
+<p>See the INSTALL or install.html docs that come with the distribution or: <a href="http://search.cpan.org/src/JMCNAMARA/Spreadsheet-WriteExcel-2.30/INSTALL" class="podlinkurl"
+>http://search.cpan.org/src/JMCNAMARA/Spreadsheet-WriteExcel-2.30/INSTALL</a>.</p>
 
 <h1><a class='u' href='#___top' title='click to go to top of document'
 name="PORTABILITY"

lib/Spreadsheet/WriteExcel.pm

@@ -21,7 +21,7 @@ use Spreadsheet::WriteExcel::Workbook;
 use vars qw($VERSION @ISA);
 @ISA = qw(Spreadsheet::WriteExcel::Workbook Exporter);
 
-$VERSION = '2.29'; # Fleet foxes.
+$VERSION = '2.30'; # Fleet foxes.
 
 
 
@@ -64,7 +64,7 @@ Spreadsheet::WriteExcel - Write to a cross-platform Excel binary file.
 
 =head1 VERSION
 
-This document refers to version 2.29 of Spreadsheet::WriteExcel, released November 25, 2009.
+This document refers to version 2.30 of Spreadsheet::WriteExcel, released November 29, 2009.
 
 
 
@@ -3081,7 +3081,7 @@ The colour format should have one of the following values:
 
 Alternatively you can specify the colour based on a colour index as follows: C<[Color n]>, where n is a standard Excel colour index - 7. See the 'Standard colors' worksheet created by formats.pl.
 
-For more information refer to the documentation on formatting in the C<doc> directory of the Spreadsheet::WriteExcel distro, the Excel on-line help or L<http://office.microsoft.com/en-gb/assistance/HP051995001033.aspx>.
+For more information refer to the documentation on formatting in the C<docs> directory of the Spreadsheet::WriteExcel distro, the Excel on-line help or L<http://office.microsoft.com/en-gb/assistance/HP051995001033.aspx>.
 
 You should ensure that the format string is valid in Excel prior to using it in WriteExcel.
 
@@ -3127,7 +3127,7 @@ Excel's built-in formats are shown in the following table:
     49      0x31    @
 
 
-For examples of these formatting codes see the 'Numerical formats' worksheet created by formats.pl. See also the number_formats1.html and the number_formats2.html documents in the C<doc> directory of the distro.
+For examples of these formatting codes see the 'Numerical formats' worksheet created by formats.pl. See also the number_formats1.html and the number_formats2.html documents in the C<docs> directory of the distro.
 
 Note 1. Numeric formats 23 to 36 are not documented by Microsoft and may differ in international versions.
 
@@ -3590,9 +3590,9 @@ If the default palette does not provide a required colour you can override one o
 
     $worksheet->write_blank('A1', $format);
 
-The default Excel 97 colour palette is shown in C<palette.html> in the C<doc> directory  of the distro. You can generate an Excel version of the palette using C<colors.pl> in the C<examples> directory.
+The default Excel 97 colour palette is shown in C<palette.html> in the C<docs> directory  of the distro. You can generate an Excel version of the palette using C<colors.pl> in the C<examples> directory.
 
-A comparison of the colour components in the Excel 5 and Excel 97+ colour palettes is shown in C<rgb5-97.txt> in the C<doc> directory.
+A comparison of the colour components in the Excel 5 and Excel 97+ colour palettes is shown in C<rgb5-97.txt> in the C<docs> directory.
 
 
 You may also find the following links helpful:
@@ -4883,7 +4883,7 @@ Note, these aren't strict requirements. Spreadsheet::WriteExcel will work withou
 
 =head1 INSTALLATION
 
-See the INSTALL or install.html docs that come with the distribution or: L<http://search.cpan.org/src/JMCNAMARA/Spreadsheet-WriteExcel-2.29/INSTALL>.
+See the INSTALL or install.html docs that come with the distribution or: L<http://search.cpan.org/src/JMCNAMARA/Spreadsheet-WriteExcel-2.30/INSTALL>.
 
 
 

lib/Spreadsheet/WriteExcel/BIFFwriter.pm

@@ -24,7 +24,7 @@ use strict;
 use vars qw($VERSION @ISA);
 @ISA = qw(Exporter);
 
-$VERSION = '2.29';
+$VERSION = '2.30';
 
 ###############################################################################
 #

lib/Spreadsheet/WriteExcel/Big.pm

@@ -24,7 +24,7 @@ use Spreadsheet::WriteExcel::WorkbookBig;
 use vars qw($VERSION @ISA);
 @ISA = qw(Spreadsheet::WriteExcel::WorkbookBig Exporter);
 
-$VERSION = '2.29';
+$VERSION = '2.30';
 
 ###############################################################################
 #

lib/Spreadsheet/WriteExcel/Chart.pm

@@ -24,7 +24,7 @@ use Spreadsheet::WriteExcel::BIFFwriter;
 use vars qw($VERSION @ISA);
 @ISA = qw(Spreadsheet::WriteExcel::BIFFwriter);
 
-$VERSION = '2.29';
+$VERSION = '2.30';
 
 ###############################################################################
 #