Commit | Line | Data |
25f0751f |
1 | |
80e5fcd6 |
2 | IO-Compress-Zlib |
25f0751f |
3 | |
d54256af |
4 | Version 2.009 |
25f0751f |
5 | |
d54256af |
6 | 20th April 2008 |
25f0751f |
7 | |
d54256af |
8 | Copyright (c) 2005-2008 Paul Marquess. All rights reserved. |
25f0751f |
9 | This program is free software; you can redistribute it |
10 | and/or modify it under the same terms as Perl itself. |
11 | |
25f0751f |
12 | DESCRIPTION |
13 | ----------- |
14 | |
cb7abd7f |
15 | This module provides a Perl interface to allow reading and writing of RFC |
25f0751f |
16 | 1950, 1951, 1952 (i.e. gzip) and zip files/buffers. |
17 | |
25f0751f |
18 | PREREQUISITES |
19 | ------------- |
20 | |
80e5fcd6 |
21 | Before you can build IO-Compress-Zlib you need to have the following |
25f0751f |
22 | installed on your system: |
23 | |
25f0751f |
24 | * Perl 5.004 or better. |
25 | * Compress::Raw::Zlib |
26 | * IO::Compress::Base |
27 | |
25f0751f |
28 | BUILDING THE MODULE |
29 | ------------------- |
30 | |
31 | Assuming you have met all the prerequisites, the module can now be built |
32 | using this sequence of commands: |
33 | |
34 | perl Makefile.PL |
35 | make |
36 | make test |
37 | |
25f0751f |
38 | INSTALLATION |
39 | ------------ |
40 | |
80e5fcd6 |
41 | To install IO-Compress-Zlib, run the command below: |
25f0751f |
42 | |
43 | make install |
44 | |
25f0751f |
45 | TROUBLESHOOTING |
46 | --------------- |
47 | |
cb7abd7f |
48 | The t/020isize Test Suite |
25f0751f |
49 | ------------------------ |
50 | |
80e5fcd6 |
51 | This test suite checks that IO-Compress-Zlib can cope with gzip files |
25f0751f |
52 | that are larger than 2^32 bytes. |
53 | |
d54256af |
54 | By default these tests are NOT run when you do a "make test". If you |
25f0751f |
55 | really want to run them, you need to execute "make longtest". |
56 | |
57 | Be warned though -- this test suite can take hours to run on a slow box. |
58 | |
59 | Also, due to the way the tests are constructed, some architectures will |
60 | run out of memory during this test. This should not be considered a bug |
80e5fcd6 |
61 | in the IO-Compress-Zlib module. |
25f0751f |
62 | |
25f0751f |
63 | FEEDBACK |
64 | -------- |
65 | |
80e5fcd6 |
66 | How to report a problem with IO-Compress-Zlib. |
25f0751f |
67 | |
68 | To help me help you, I need all of the following information: |
69 | |
70 | 1. The Versions of everything relevant. |
71 | This includes: |
72 | |
73 | a. The *complete* output from running this |
74 | |
75 | perl -V |
76 | |
77 | Do not edit the output in any way. |
78 | Note, I want you to run "perl -V" and NOT "perl -v". |
79 | |
80 | If your perl does not understand the "-V" option it is too |
81 | old. This module needs Perl version 5.004 or better. |
82 | |
80e5fcd6 |
83 | b. The version of IO-Compress-Zlib you have. |
84 | If you have successfully installed IO-Compress-Zlib, this one-liner |
25f0751f |
85 | will tell you: |
86 | |
80e5fcd6 |
87 | perl -MIO::Compress::Gzip -e 'print qq[ver $IO::Compress::Gzip::VERSION\n]' |
25f0751f |
88 | |
89 | If you are running windows use this |
90 | |
80e5fcd6 |
91 | perl -MIO::Compress::Gzip -e "print qq[ver $IO::Compress::Gzip::VERSION\n]" |
25f0751f |
92 | |
80e5fcd6 |
93 | If you haven't installed IO-Compress-Zlib then search IO::Compress::Gzip.pm |
25f0751f |
94 | for a line like this: |
95 | |
d54256af |
96 | $VERSION = "2.009" ; |
25f0751f |
97 | |
80e5fcd6 |
98 | 2. If you are having problems building IO-Compress-Zlib, send me a |
99 | complete log of what happened. Start by unpacking the IO-Compress-Zlib |
25f0751f |
100 | module into a fresh directory and keep a log of all the steps |
101 | |
102 | [edit config.in, if necessary] |
103 | perl Makefile.PL |
104 | make |
105 | make test TEST_VERBOSE=1 |
106 | |
25f0751f |
107 | Paul Marquess <pmqs@cpan.org> |