Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

Prep for release 2.38.

  • Loading branch information...
commit 8bbb8f5937802a522f06e1c396310618fe21ced8 1 parent 5bb77cf
John McNamara authored November 22, 2012
122  INSTALL
... ...
@@ -1,122 +0,0 @@
1  
-======================================================================
2  
-NAME
3  
-
4  
-    Spreadsheet::WriteExcel - Write formatted text and numbers to a
5  
-    cross-platform Excel binary file.
6  
-
7  
-======================================================================
8  
-REQUIREMENTS
9  
-
10  
-    This module requires Perl 5.005 (or later)
11  
-    Parse::RecDescent
12  
-        http://search.cpan.org/search?dist=Parse-RecDescent
13  
-    File::Temp
14  
-        http://search.cpan.org/search?dist=File-Temp
15  
-
16  
-
17  
-======================================================================
18  
-INSTALLATION
19  
-
20  
-    Method 1, standard install with make
21  
-    ====================================
22  
-    Download the zipped tar file from one of the following:
23  
-        http://search.cpan.org/search?dist=Spreadsheet-WriteExcel
24  
-        http://theoryx5.uwinnipeg.ca/mod_perl/cpan-search?idinfo=154
25  
-        ftp://ftp.funet.fi/pub/languages/perl/CPAN/authors/id/J/JM/JMCNAMARA/
26  
-
27  
-    Unzip the module as follows or use winzip:
28  
-
29  
-           tar -zxvf Spreadsheet-WriteExcel-2.xx.tar.gz
30  
-
31  
-    The module can be installed using the standard Perl procedure:
32  
-
33  
-        perl Makefile.PL
34  
-        make
35  
-        make test
36  
-        make install    # You may need to be root
37  
-        make clean      # or make realclean
38  
-
39  
-    Windows users without a working "make" can get nmake from:
40  
-
41  
-        ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe
42  
-
43  
-
44  
-    Method 2, CPAN.pm install
45  
-    =========================
46  
-    If you have CPAN.pm configured you can install the module as
47  
-    follows:
48  
-
49  
-        perl -MCPAN -e "install 'Spreadsheet::WriteExcel'"
50  
-
51  
-
52  
-    Method 3, ActivePerl ppm
53  
-    ========================
54  
-    ActivePerl users can use PPM as follows:
55  
-
56  
-        C:\> ppm
57  
-        PPM> set repository tmp http://homepage.eircom.net/~jmcnamara/perl
58  
-        PPM> install Spreadsheet-WriteExcel
59  
-        PPM> quit
60  
-        C:\>
61  
-
62  
-        If this fails try the following:
63  
-
64  
-        PPM>install http://homepage.eircom.net/~jmcnamara/perl/Spreadsheet-WriteExcel.ppd
65  
-
66  
-    If both of these fail you should ensure that ppm is working
67  
-    correctly. Try to install the File::Slurp module as a test:
68  
-
69  
-        C:\> ppm
70  
-        PPM> install File-Test
71  
-        PPM> quit
72  
-        C:\>
73  
-
74  
-    A failure here will indicate that your ppm isn't configured
75  
-    correctly or, more likely, that you are behind a firewall. Have a
76  
-    look at the "Using PPM" documentation that comes with
77  
-    ActivePerl to see how to resolve these issues.
78  
-
79  
-    Method 4, ActivePerl local ppm
80  
-    ==============================
81  
-    If the previous ppm methods fail you can try a local ppm install
82  
-    as follows. Download the following two files (xx is the most
83  
-    recent version number):
84  
-
85  
-        http://homepage.eircom.net/~jmcnamara/perl/Spreadsheet-WriteExcel.ppd
86  
-        http://homepage.eircom.net/~jmcnamara/perl/Spreadsheet-WriteExcel-0.xx-PPM.tar.gz
87  
-
88  
-    Copy them to a temp directory. There is no need to un-tar or unzip
89  
-    the PPM file.
90  
-
91  
-    In the DOS shell change to the temp directory and run ppm:
92  
-
93  
-         C:\> cd c:\temp
94  
-         C:\Temp> ppm
95  
-
96  
-         PPM> install Spreadsheet-WriteExcel.ppd
97  
-         Install package 'Spreadsheet-WriteExcel.ppd?' (y/N): y
98  
-         Retrieving package 'Spreadsheet-WriteExcel.ppd'...
99  
-         Writing C:\perl\site\lib\auto\Spreadsheet\WriteExcel\.packlist
100  
-         PPM> quit
101  
-         Quit!
102  
-
103  
-    The module should now be installed. Note, you will also have to
104  
-    install Parse::RecDescent and possibly File::Temp if it isn't
105  
-    already installed .
106  
-
107  
-
108  
-======================================================================
109  
-UPDATES
110  
-
111  
-    You can keep up to date with future release by registering as a
112  
-    user with Freshmeat http://freshmeat.net/ and subscribing to
113  
-    Spreadsheet::WriteExcel at the project page:
114  
-    http://freshmeat.net/projects/writeexcel/
115  
-
116  
-    You will then receive mailed updates when a new version is
117  
-    released.
118  
-
119  
-======================================================================
120  
-AUTHOR
121  
-
122  
-    John McNamara (jmcnamara@cpan.org)
5,512  docs/WriteExcel.html
0 additions, 5512 deletions not shown
239  docs/WriteExcel_Install.html
... ...
@@ -1,239 +0,0 @@
1  
-<HTML>
2  
-<HEAD>
3  
-<TITLE>Installation instructions for Spreadsheet::WriteExcel</TITLE>
4  
-<LINK REV="made" HREF="mailto:">
5  
-</HEAD>
6  
-
7  
-<style type="text/css">   
8  
-
9  
-
10  
-
11  
-   <!--
12  
-   
13  
-   pre  {
14  
-        font-family : courier new, sans-serif;
15  
-        font-size : 10pt;
16  
-        color : #0066cc;
17  
-   }
18  
-
19  
-   CODE  {
20  
-        font-family : courier new, sans-serif;
21  
-        font-size : 10pt;
22  
-        color : #0066cc;
23  
-   }
24  
-   
25  
-         
26  
-   -->
27  
-</style>
28  
-
29  
-
30  
-<BODY>
31  
-
32  
-
33  
-<P>
34  
-<H1><A NAME="Spreadsheet_WriteExcel">Spreadsheet::WriteExcel</A></H1>
35  
-<P>
36  
-Installation instructions for <A
37  
-HREF="http://search.cpan.org/search?dist=Spreadsheet-WriteExcel">Spreadsheet::WriteExcel</A>
38  
-
39  
-
40  
-</P>
41  
-<P>
42  
-<HR>
43  
-<H1><A NAME="Requirements">Requirements</A></H1>
44  
-<P>
45  
-This module requires <CODE>Perl 5.005</CODE> (or later) and <CODE>Parse::RecDescent</CODE> and <CODE>File::Temp</CODE>:
46  
-
47  
-<PRE>    
48  
-    <A HREF="http://search.cpan.org/search?dist=Parse-RecDescent">Parse::RecDescent</A>
49  
-    <A HREF="http://search.cpan.org/search?dist=File-Temp">File::Temp</A>
50  
-</PRE>
51  
-</P>
52  
-<P>
53  
-<HR>
54  
-<H1><A NAME="Installation">Installation</A></H1>
55  
-<P>
56  
-<HR>
57  
-<H2><A NAME="Method_1_standard_install_with_">Method 1, standard install with make</A></H2>
58  
-<P>
59  
-Download the zipped tar file from one of the following:
60  
-
61  
-</P>
62  
-<P>
63  
-<PRE>
64  
-    <A HREF="http://search.cpan.org/search?dist=Spreadsheet-WriteExcel">http://search.cpan.org/search?dist=Spreadsheet-WriteExcel</A>
65  
-    <A HREF="http://theoryx5.uwinnipeg.ca/mod_perl/cpan-search?idinfo=154">http://theoryx5.uwinnipeg.ca/mod_perl/cpan-search?idinfo=154</A>
66  
-    <A HREF="ftp://ftp.funet.fi/pub/languages/perl/CPAN/authors/id/J/JM/JMCNAMARA/">ftp://ftp.funet.fi/pub/languages/perl/CPAN/authors/id/J/JM/JMCNAMARA/</A>
67  
-</PRE>
68  
-</P>
69  
-<P>
70  
-Untar and unzip the module as follows or use winzip:
71  
-
72  
-</P>
73  
-<P>
74  
-<PRE>
75  
-    tar -zxvf Spreadsheet-WriteExcel-0.xx.tar.gz
76  
-</PRE>
77  
-</P>
78  
-<P>
79  
-Change to the directory that <CODE>tar</CODE> creates. The module can be installed using the standard Perl procedure:
80  
-
81  
-</P>
82  
-<P>
83  
-<PRE>
84  
-    perl Makefile.PL
85  
-    make
86  
-    make test
87  
-    make install    # You may need to be root
88  
-    make clean      # optional
89  
-</PRE>
90  
-</P>
91  
-<P>
92  
-Windows users without a working <CODE>make</CODE> can get <CODE>nmake</CODE> from:
93  
-
94  
-</P>
95  
-<P>
96  
-<PRE>
97  
-    <A HREF="ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe">ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe</A>
98  
-</PRE>
99  
-</P>
100  
-<P>
101  
-<HR>
102  
-<H2><A NAME="Method_2_CPAN_pm_install">Method 2, CPAN.pm install</A></H2>
103  
-<P>
104  
-If you have <CODE>CPAN.pm</CODE> configured you can install the module as follows:
105  
-
106  
-</P>
107  
-<P>
108  
-<PRE>
109  
-    perl -MCPAN -e 'install &quot;Spreadsheet::WriteExcel&quot;'
110  
-</PRE>
111  
-</P>
112  
-<P>
113  
-<HR>
114  
-<H2><A NAME="Method_3_ActivePerl_ppm">Method 3, ActivePerl ppm</A></H2>
115  
-<P>
116  
-ActivePerl users can use PPM as follows. If you system has PPM2 and PPM3
117  
-you should use PPM2 for this task:
118  
-
119  
-</P>
120  
-<P>
121  
-<PRE>
122  
-    C:\&gt; ppm
123  
-    PPM&gt; set repository tmp http://homepage.eircom.net/~jmcnamara/perl
124  
-    PPM&gt; install Spreadsheet-WriteExcel
125  
-    PPM&gt; quit
126  
-    C:\&gt;
127  
-</PRE>
128  
-</P>
129  
-<P>
130  
-If this fails try the following:
131  
-
132  
-</P>
133  
-<P>
134  
-<PRE>
135  
-    PPM&gt;install http://homepage.eircom.net/~jmcnamara/perl/Spreadsheet-WriteExcel.ppd
136  
-</PRE>
137  
-</P>
138  
-<P>
139  
-If both of these fail you should ensure that ppm is working correctly. Try
140  
-to install the File::Slurp module as a test:
141  
-
142  
-</P>
143  
-<P>
144  
-<PRE>
145  
-    C:\&gt; ppm
146  
-    PPM&gt; install File-Test
147  
-    PPM&gt; quit
148  
-    C:\&gt;
149  
-</PRE>
150  
-</P>
151  
-<P>
152  
-A failure here will indicate that your ppm isn't configured correctly or,
153  
-more likely, that you are behind a firewall. Have a look at the
154  
-<A HREF="http://aspn.activestate.com//ASPN/Reference/Products/ActivePerl-5.6/faq/ActivePerl-faq2.html#ppm_and_proxies">Using PPM</A> documentation that comes with ActivePerl to see how to
155  
-resolve these issues.
156  
-
157  
-</P>
158  
-<P>
159  
-<HR>
160  
-<H2><A NAME="Method_4_ActivePerl_local_ppm">Method 4, ActivePerl local ppm</A></H2>
161  
-<P>
162  
-If the previous ppm methods fail you can try a local ppm install as
163  
-follows. Download the following two files (xx is the most recent version
164  
-number). Note, in order to prevent your browser from trying to display or
165  
-unzip these files you should use your browser's &quot;Save Target As&quot;
166  
-option:
167  
-
168  
-</P>
169  
-<P>
170  
-<PRE>
171  
-    <A HREF="http://homepage.eircom.net/~jmcnamara/perl/Spreadsheet-WriteExcel.ppd">http://homepage.eircom.net/~jmcnamara/perl/Spreadsheet-WriteExcel.ppd</A>
172  
-    <A HREF="http://homepage.eircom.net/~jmcnamara/perl/Spreadsheet-WriteExcel-0.xx-PPM.tar.gz">http://homepage.eircom.net/~jmcnamara/perl/Spreadsheet-WriteExcel-0.xx-PPM.tar.gz</A>
173  
-</PRE>
174  
-</P>
175  
-<P>
176  
-Copy them to a suitable temp directory. There is no need to un-tar or unzip
177  
-the PPM file.
178  
-
179  
-</P>
180  
-<P>
181  
-In the DOS shell change to the temp directory and run ppm:
182  
-
183  
-</P>
184  
-<P>
185  
-<PRE>
186  
-     C:\&gt; cd c:\temp
187  
-     C:\Temp&gt; ppm
188  
-</PRE>
189  
-</P>
190  
-<P>
191  
-<PRE>
192  
-     PPM&gt; install Spreadsheet-WriteExcel.ppd
193  
-     Install package 'Spreadsheet-WriteExcel.ppd?' (y/N): y
194  
-     Retrieving package 'Spreadsheet-WriteExcel.ppd'...
195  
-     Writing C:\perl\site\lib\auto\Spreadsheet\WriteExcel\.packlist
196  
-     PPM&gt; quit
197  
-     Quit!
198  
-</PRE>
199  
-</P>
200  
-<P>
201  
-The module should now be installed. Note, you will also have to install
202  
-Parse::RecDescent and possibly File::Temp if it isn't already installed .
203  
-
204  
-</P>
205  
-<P>
206  
-<HR>
207  
-<H1><A NAME="Updates">Updates</A></H1>
208  
-<P>
209  
-You can keep up to date with future release by registering as a user with
210  
-Freshmeat <A HREF="http://freshmeat.net/">http://freshmeat.net/</A> and
211  
-subscribing to
212  
-<CODE>Spreadsheet::WriteExcel</CODE> at the project page:
213  
-
214  
-</P>
215  
-<P>
216  
-<PRE>
217  
-    <A HREF="http://freshmeat.net/projects/writeexcel/">http://freshmeat.net/projects/writeexcel/</A>
218  
-</PRE>
219  
-</P>
220  
-<P>
221  
-You will then receive mailed updates when a new version is released.
222  
-
223  
-</P>
224  
-<P>
225  
-Alternatively you can keep an eye on <A
226  
-HREF="news://comp.lang.perl.announce">news://comp.lang.perl.announce</A>
227  
-
228  
-</P>
229  
-<P>
230  
-<HR>
231  
-<H1><A NAME="Author">Author</A></H1>
232  
-<P>
233  
-John McNamara (<A HREF="mailto:jmcnamara@cpan.org">jmcnamara@cpan.org</A>)
234  
-</P>
235  
-
236  
-</BODY>
237  
-
238  
-</HTML>
239  
-
33  t/90_pod.t
... ...
@@ -1,33 +0,0 @@
1  
-#!/usr/bin/perl
2  
-
3  
-# Test that the syntax of our POD documentation is valid
4  
-use strict;
5  
-BEGIN {
6  
-	$|  = 1;
7  
-	$^W = 1;
8  
-}
9  
-
10  
-my @MODULES = (
11  
-	'Pod::Simple 3.07',
12  
-	'Test::Pod 1.26',
13  
-);
14  
-
15  
-# Don't run tests during end-user installs
16  
-use Test::More;
17  
-unless ( $ENV{AUTOMATED_TESTING} or $ENV{RELEASE_TESTING} ) {
18  
-	plan( skip_all => "Author tests not required for installation" );
19  
-}
20  
-
21  
-# Load the testing modules
22  
-foreach my $MODULE ( @MODULES ) {
23  
-	eval "use $MODULE";
24  
-	if ( $@ ) {
25  
-		$ENV{RELEASE_TESTING}
26  
-		? die( "Failed to load required release-testing module $MODULE" )
27  
-		: plan( skip_all => "$MODULE not available for testing" );
28  
-	}
29  
-}
30  
-
31  
-all_pod_files_ok();
32  
-
33  
-1;
76  t/91_minimumversion.t
... ...
@@ -1,76 +0,0 @@
1  
-#!/usr/bin/perl
2  
-
3  
-# Test that our declared minimum Perl version matches our syntax
4  
-use strict;
5  
-
6  
-BEGIN {
7  
-	$|  = 1;
8  
-	$^W = 1;
9  
-}
10  
-
11  
-my @MODULES = (
12  
-	'Perl::MinimumVersion 1.20',
13  
-	'Test::MinimumVersion 0.008',
14  
-);
15  
-
16  
-# Don't run tests during end-user installs
17  
-use Test::More;
18  
-unless ( $ENV{AUTOMATED_TESTING} or $ENV{RELEASE_TESTING} ) {
19  
-	plan( skip_all => "Author tests not required for installation" );
20  
-}
21  
-
22  
-# Load the testing modules
23  
-foreach my $MODULE ( @MODULES ) {
24  
-	eval "use $MODULE";
25  
-	if ( $@ ) {
26  
-		$ENV{RELEASE_TESTING}
27  
-		? die( "Failed to load required release-testing module $MODULE" )
28  
-		: plan( skip_all => "$MODULE not available for testing" );
29  
-	}
30  
-}
31  
-
32  
-
33  
-skip_some_minimum_version_ok('5.005');
34  
-
35  
-###############################################################################
36  
-#
37  
-# This is a modified version of minimum_version_ok() from Test::MinimumVersion
38  
-# that skips modules that return false minumum versions due to the following
39  
-# issue in Perl::MinimumVersion:
40  
-#     http://rt.cpan.org/Public/Bug/Display.html?id=51256
41  
-#
42  
-sub skip_some_minimum_version_ok {
43  
-  my ($version, $arg) = @_;
44  
-  $arg ||= {};
45  
-  $arg->{paths} ||= [ qw(lib t xt/smoke), glob ("*.pm"), glob ("*.PL") ];
46  
-
47  
-  my $Test = Test::Builder->new;
48  
-
49  
-  $version = Test::MinimumVersion::_objectify_version($version);
50  
-
51  
-  my @perl_files;
52  
-  for my $path (@{ $arg->{paths} }) {
53  
-    if (-f $path and -s $path) {
54  
-      push @perl_files, $path;
55  
-    } elsif (-d $path) {
56  
-      push @perl_files, File::Find::Rule->perl_file->in($path);
57  
-    }
58  
-  }
59  
-
60  
-  unless ($Test->has_plan or $arg->{no_plan}) {
61  
-    $Test->plan(tests => scalar @perl_files);
62  
-  }
63  
-
64  
-  for (@perl_files) {
65  
-
66  
-      SKIP: {
67  
-          skip 'due to RT 51256 issue in Perl::Minimum version', 1
68  
-          if /(OLEwriter.pm|Workbook.pm)$/;
69  
-
70  
-          minimum_version_ok($_, $version);
71  
-      }
72  
-  }
73  
-}
74  
-
75  
-
76  
-1;
32  t/92_meta.t
... ...
@@ -1,32 +0,0 @@
1  
-#!/usr/bin/perl
2  
-
3  
-# Test that our META.yml file matches the specification
4  
-use strict;
5  
-BEGIN {
6  
-	$|  = 1;
7  
-	$^W = 1;
8  
-}
9  
-
10  
-my @MODULES = (
11  
-	'Test::CPAN::Meta 0.12',
12  
-);
13  
-
14  
-# Don't run tests during end-user installs
15  
-use Test::More;
16  
-unless ( $ENV{AUTOMATED_TESTING} or $ENV{RELEASE_TESTING} ) {
17  
-	plan( skip_all => "Author tests not required for installation" );
18  
-}
19  
-
20  
-# Load the testing modules
21  
-foreach my $MODULE ( @MODULES ) {
22  
-	eval "use $MODULE";
23  
-	if ( $@ ) {
24  
-		$ENV{RELEASE_TESTING}
25  
-		? die( "Failed to load required release-testing module $MODULE" )
26  
-		: plan( skip_all => "$MODULE not available for testing" );
27  
-	}
28  
-}
29  
-
30  
-meta_yaml_ok();
31  
-
32  
-1;

0 notes on commit 8bbb8f5

Please sign in to comment.
Something went wrong with that request. Please try again.