Commit | Line | Data |
---|---|---|
25f0751f | 1 | |
80e5fcd6 | 2 | IO-Compress-Zlib |
25f0751f | 3 | |
9253672d | 4 | Version 2.015 |
25f0751f | 5 | |
9253672d | 6 | 2nd September 2008 |
25f0751f | 7 | |
d54256af | 8 | Copyright (c) 2005-2008 Paul Marquess. All rights reserved. |
25f0751f PM |
9 | This program is free software; you can redistribute it |
10 | and/or modify it under the same terms as Perl itself. | |
11 | ||
25f0751f PM |
12 | DESCRIPTION |
13 | ----------- | |
14 | ||
cb7abd7f | 15 | This module provides a Perl interface to allow reading and writing of RFC |
25f0751f PM |
16 | 1950, 1951, 1952 (i.e. gzip) and zip files/buffers. |
17 | ||
25f0751f PM |
18 | PREREQUISITES |
19 | ------------- | |
20 | ||
80e5fcd6 | 21 | Before you can build IO-Compress-Zlib you need to have the following |
25f0751f PM |
22 | installed on your system: |
23 | ||
25f0751f PM |
24 | * Perl 5.004 or better. |
25 | * Compress::Raw::Zlib | |
26 | * IO::Compress::Base | |
27 | ||
25f0751f PM |
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 PM |
38 | INSTALLATION |
39 | ------------ | |
40 | ||
80e5fcd6 | 41 | To install IO-Compress-Zlib, run the command below: |
25f0751f PM |
42 | |
43 | make install | |
44 | ||
25f0751f PM |
45 | TROUBLESHOOTING |
46 | --------------- | |
47 | ||
cb7abd7f | 48 | The t/020isize Test Suite |
25f0751f PM |
49 | ------------------------ |
50 | ||
80e5fcd6 | 51 | This test suite checks that IO-Compress-Zlib can cope with gzip files |
25f0751f PM |
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 PM |
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 PM |
63 | FEEDBACK |
64 | -------- | |
65 | ||
80e5fcd6 | 66 | How to report a problem with IO-Compress-Zlib. |
25f0751f PM |
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 PM |
83 | b. The version of IO-Compress-Zlib you have. |
84 | If you have successfully installed IO-Compress-Zlib, this one-liner | |
25f0751f PM |
85 | will tell you: |
86 | ||
80e5fcd6 | 87 | perl -MIO::Compress::Gzip -e 'print qq[ver $IO::Compress::Gzip::VERSION\n]' |
25f0751f PM |
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 PM |
94 | for a line like this: |
95 | ||
9253672d | 96 | $VERSION = "2.015" ; |
25f0751f | 97 | |
80e5fcd6 PM |
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 PM |
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> |