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