6 * Merged IO-Compress-Base, IO-Compress-Bzip2, IO-Compress-Zlib &
7 Compress-Zlib into IO-Compress.
9 * The interface to Compress-Raw-Zlib now uses the new LimitOutput
10 feature. This will make all of the zlib-related IO-Compress modules
11 less greedy in their memory consumption.
13 * Removed MAN3PODS from Makefile.PL
15 * A few changes to get the test harness to work on VMS courtesy of
18 * IO::Compress::Base & IO::Uncompress::Base
19 Downgraded some croaks in the constructors to just set $! (by letting
20 the code attempt to open a file and fail).
21 This makes the behavior more consistent to a standard open.
24 * IO::Uncompress::Base
25 Doing a seek with MultiStream could drop some of the uncompressed
29 - Fixed problem with the uncompressed & uncompressed fields when
30 zip64 is enabled. They were set to 0x0000FFFF instead of
31 0xFFFFFFFF. Also the ZIP64 extra field was 4 bytes short.
32 Problem spotted by Dino Chiesa.
34 * IO::Uncompress::Unzip
35 - use POSIX::mktime instead of Time::Local::timelocal to convert
36 the zip DOS time field into Unix time.
39 - Documented Compress::Zlib::zlib_version()
42 2.015 3 September 2008
45 Backout changes made in 2.014
47 2.014 2 September 2008
50 Updated to check for indirect dependencies.
55 - Allow IO::Compress::Base::Parameters::parse to accept an
56 IO::Compress::Base::Parameters object.
61 - Silenced an uninitialised value warning when reading a line
62 at a time from a zip file where the content uses ZIP_CM_STORE.
63 [Problem spotted & fixed by Jeff Holt]
65 * IO::Compress::Base & IO::Uncompress::Base
66 - local-ise $!, $? et al in the DESTROY methods.
71 - Fixed problem that prevented the creation of a zip file that
72 contained more than one compression method.
74 * IO::Compress::Base::Common
75 - The private Validator class in this module clashes with another
76 CPAN module. Moved Validator into the IO::Compress::Base::Common
80 * IO::Uncompress::Unzip
81 - Print an error message if the zip file contains a
82 member compressed with bzip2 and IO::Uncompress::Bunzip2 is
84 - Could not cope with mixed compression zip files. For example a
85 zip file that contains both STORED and DEFLATED content.
90 * Fixed problem that meant Perl 5.10 could not upgrade this module.
95 * Removed the alpha status from File::GlobMapper
98 When writing output never output a zero length buffer.
99 Done to improve interoperability with other tied filenandle
102 * Changed IO::Uncompress::Base to not use the offset parameter of
103 the read method when reading from a filehandle.
105 The object returned from Net::FTP::retr implements a non-standard
106 read method. The third parameter is used for a timeout value
107 rather than an offset.
110 * Changed IO::Uncompress::Base to not use the eof method when
111 reading from a filehandle.
113 The object returned from Net::FTP::retr implements both the read
114 method and the eof method. Unfortunately the implementation of
115 the read method uses non-buffered IO (by using sysread) while
116 the eof method uses buffered IO. Mixing buffered and non-buffered
117 IO results in data corruption.
121 - Added exUnix2 option to allow storing of UID & GID.
122 - When running on a Unix derivative the ExtAttr option now defaults
123 to the equivalent of 0666. For all other systems the default
127 - Minor documentation issue with flush.
131 2.008 2 November 2007
133 * Minor documentation changes in README
135 * t/compress/truncate.pl
138 * IO::Compress::Gzip::Constants.pm
139 Tidied up the character classes used to defined invalid
140 FNAME & FCOMMENT fields for EBCDIC.
143 lib/Compress/Zlib.pm -- 1.x Backward Compatability issues
144 gzclose - documented return value was wrong, should be 0 for ok.
145 gzflush - return value didn't match 1.x, should return 0 if ok.
146 [rt.cpan.org #29215] and Debian bug #440943 http://bugs.debian.org/440943
148 2.006 1 September 20007
151 Added INSTALLDIRS directive to install as a core module when built
154 * IO::Uncompress::RawDeflate
156 - Fixed export problem - "$RawDeflateError" and "rawdeflate" were
157 not being exported with ":all".
161 Fixed crc32 and adler32 tests in to remove ascii assumption.
163 - lib/Compress/Zlib.pm
164 Make gzreadline not support $/, just like in Compress::Zlib 1.x
165 Folk who want $/ with readline support can get it in
166 IO::Uncompress::Gunzip. [rt.cpan.org #28663] and
167 Debian bug #435656 http://bugs.debian.org/435656
172 * Stephen Turner reported a problem when using IO::Uncompress::Gunzip
173 with XML::Parser. Turns out there were two issues.
175 Firstly an IO::Uncompress object isn't an IO::Handle. It is now.
177 Secondly the implementation of "read" wasn't honouring this
179 SCALAR will be grown or shrunk to the length actually read.
181 In particular it didn't do the right thing on EOF.
184 * IO::Compress::Gzip & IO::Uncompress::Gunzip
186 - RFC1952 says that the FNAME & FCOMMENT header fields must be ISO
187 8859-1 (LATIN-1) characters. The code can optionally police this.
188 Added a fix for this logic when running on EBCDIC.
191 Added info about removing Compress::Zlib version 1, before
192 installing version 2.
196 * Made seek less wasteful of memory.
200 - Added Zip64 documentation.
202 - Fixed extended timestamp.
203 Creation time isn't available in Unix so only store the
204 modification time and the last access time in the extended field.
208 - Added ExtAttr option to control the value of the "external file
209 attributes" field in the central directory.
211 - Added Unix2 extended attribute ("Ux").
212 This stores the UID & GID.
216 - Fixed 050interop-gzip.t for Windows
218 * IO::Compress::Bzip2
220 - Fixed 050interop-bzip2.t for Windows
224 - rewrote memGzip using IO::Compress::Gzip::gzip
228 * Added explicit version checking
230 2.002 29 December 2006
232 * Documentation updates.
234 * Added IO::Handle to the ISA test in isaFilehandle
236 * Add an explicit use_ok test for Scalar::Util in the test harness.
237 The error message reported by 01misc implied the problem was
239 Also explictly check that 'dualvar' is available.
242 - Fix append mode with gzopen.
245 - Allow gzopen to read from and write to a scalar reference.
247 2.001 1 November 2006
249 * Remove beta status.
251 2.000_14 26 October 2006
253 * IO::Uncompress::Base
254 Added support for $/ in record mode
256 * IO::Uncompress::Base
257 The readline interface was substantially slower than the 1.x
258 equivalent. This has now been sorted.
259 Thanks to Andreas J. Koenig for spotting the problem.
261 * IO::Uncompress::AnyUncompress
262 Added IO::Uncompress::Lzf to the list of supported uncompresors.
264 * IO::Uncompress::Base
265 Added TrailingData to one-shot interface.
267 * IO::Uncompress::AnyUncompress
268 Remove raw-deflate (RFC1951) from the default list of compressors
270 It can still be included if the new RawInflate parameter is
272 This change was made because the only way to tell if content is
273 raw-deflate is to attempt to uncompress it - a few false positives
274 have popped up recently, which suggests that auto-detecting raw
275 deflate is far from perfect.
276 The equivalent change has been made to IO::Uncompress::AnyInflate.
279 * Don't check that filehandles are writable. It would seem that
280 "-w *STDOUT" on windows returns false.
283 * IO::Uncompress::Deflate
284 Beefed up the magic signature check. Means less false positives
285 when auto-detecting the compression type.
287 * IO::Uncompress::UnZip
288 Tighten up the zip64 extra field processing to cope with the case
289 wheere only some of the local header fields are superceeded.
291 * IO::Uncompress::AnyInflate
292 Remove raw-deflate (RFC 1951) from the default list of compressors
294 It can still be included if the new RawInflate parameter is
296 This change was made because the only way to tell if content is
297 raw-deflate is to attempt to uncompress it - a few false positives
298 have popped up recently, which suggests that auto-detecting raw
299 deflate is far from perfect.
300 The equivalent change has been made to IO::Uncompress::AnyUncompress.
303 2.000_13 20 June 2006
305 * Store compress & uncompressed sizes as 64-bit.
307 * For one-shot uncompression, like this
309 unzip "some.zip" => \@a, MultiStream => 1;
311 Push each uncompressed stream from "some.zip" onto @a.
313 * Added IO::Compress::Base::FilterEnvelope
315 * Added IO::Uncompress::Base::nextStream
317 * The '-' filehandle now maps to either *STDIN or *STDOUT.
318 This keeps mod_perl happier. Was using these before
323 * Preliminary support for reading zip files with zip64 members.
327 * Moved the code for creating and parsing the gzip extra field into
328 IO::Compress::Zlib::Extra.pm so that IO::Compress::Zip &
329 IO::Uncompress::Unzip can use it as well.
331 * Added ExtraFieldLocal & ExtraFieldCentral options to IO::Compress::Zip.
332 These allow the creation of user-defined extra fields in the local
333 and central headers, just like the ExtraField option in
336 * Moved the zip constants into IO::Compress::Zip::Constants
338 * Added exTime option to IO::Compress::Zip.
339 This allows creation of the extended timestamp extra field.
341 * Added Minimal option to IO::Compress::Zip.
342 This disables the creation of all extended fields.
344 * Added TextFlag option to IO::Compress::Zip.
346 * Documented Comment and ZipComment options in IO::Compress::Zip.
349 Fixed gzread to zap the output buffer to an empty string when zero
350 bytes are requested. This matches the behaviour of C::Z 1.x
352 2.000_11 10 April 2006
354 * Transparent + InputLength made more robust where input data is not
357 * Updated Documentation for zip modules.
359 * Changed IO::Compress::Zip 'Store' option to 'Method' and added
360 symbolic constants ZIP_CM_STORE, ZIP_CM_DEFLATE and ZIP_CM_BZIP2 to
361 allow the compression method to be picked by the user.
363 * Added support to allow bzip2 compressed data to be written/read
364 with IO::Compress::Zip and IO::Uncompress::Unzip.
366 * Beefed up 050interop-gzip.t to check that the external gzip command
367 works as expected before starting the tests. This means that
368 this test harness will just be skipped on problematic systems.
370 * Merged core patch 27565 from Steve Peters. This works around a
371 problem with gzip on OpenBSD where it doesn't seem to like
372 compressing files < 10 bytes long.
374 * Beefed up 050interop-bzip2.t to check that the external bzip2 command
375 works as expected before starting the tests. This means that
376 this test harness will just be skipped on problematic systems.
378 2.000_10 13 March 2006
380 * AnyUncompress doesn't assume that IO-Compress-Zlib is installed any
383 * Documentation updates.
386 Changed gzread so that its behaviour matches C::Z::gzread 1.x if it
387 is called after eof. In this case it will write an empty string
388 into the output parameter. This change is solely for backward
389 compatability reasons.
391 2.000_09 3 March 2006
395 2.000_08 2 March 2006
397 * Split IO::Compress::Base into its own distribution.
399 * Split IO::Compress::Bzip2 into its own distribution.
401 * Added opened, autoflush and input_line_number.
403 * Beefed up support for $.
405 * Split IO::Compress::Zlib into its own distribution.
407 * Beefed up support for zip/unzip
409 * Breakout zlib specific code into separate modules.
411 * Limited support for reading/writing zip files
413 2.000_06 5 October 2005
415 * Added eof parameter to Compress::Zlib::inflate method.
417 * Fixed issue with 64-bit
419 2.000_05 4 October 2005
421 * Renamed IO::* to IO::Compress::* & IO::Uncompress::*
423 2.000_04 23 September 2005
425 * Fixed some more non-portable test that were failing on VMS.
427 * fixed problem where error messages in the oneshot interface were
430 2.000_03 12 September 2005
432 * Fixed some non-portable test that were failing on VMS.
434 * Fixed export of zlib constants from the IO::* classes
436 2.000_02 6 September 2005
438 * Split Append mode into Append and Merge
440 * Fixed typos in the documentation.
444 * Added libscan to Makefile.PL
446 * Added InputLength for IO::Gunzip et al
448 2.000_01 22 August 2005
450 * Fixed VERSION in Compress::Gzip::Constants
452 * Removed Compress::Gzip::Info from the distribution.
454 2.000_00 21 August 2005
456 * First Beta relase of Compress::zlib rewrite.
458 Compress-Zlib version 1 Changes
460 1.38 - 6 September 2005
462 * Integrate core change 25304 -- Symbian Update
464 * Added libscan to Makefile.PL
466 1.37 - 12 August 2005
468 * Change to t/03examples.t for VMS from Abe Timmerman
472 * Renamed zlib-src-1.2.3 to zlib-src to help VMS
474 * Fixed Makefile.PL for VMS
476 * Fixed t/03examples.t for VMS
478 * Added a couple of notes about incompatibility with Unix compress.
482 * Updated zlib source to 1.2.3
484 * Fixed problem with where two calls to gzclose would hang the debugger.
485 See https://rt.cpan.org/Ticket/Display.html?id=13789
487 * Added code from Alexey Tourbin to use XSLoader when available,
488 and DynaLoader otherwise.
490 * Documented that the compress & uncompress functions were not
491 the same as the Unix utilities of the same name.
493 * Fixed 05gzsetp -- it left a temp file hanging around.
495 * Integrate core change 24787 - SvUPGRADE returns void in blead
497 * Integrate core change 24788 - Makefile.PL adjustments for the core
500 1.34 - 30 January 2005
502 * Fixed typo in the README
504 * Fixed examples.t on Win32 where paths have embedded whitespace.
506 * Fix for Cygwin and core integration from Jos I. Boumans
508 * Upgrade zlib source to 1.2.2
510 1.33 - 14 January 2004
512 * Reworked Makefile.PL to avoid creating a private copy of zlib.
513 This both simplifies the build, plus it makes life easier for VMS.
515 * Patches for Makefile.PL to get it to work on VMS supplied by
518 * memGunzip has very slow on FreeBSD. Turns out to be down to
519 the way realloc works on FreeBSD. Changed both inflate & deflate
520 to use exponentially increasing buffer sizes when they need to
521 realloc. Thanks to Peter Jeremy for the lowdown on FreeBSD
524 1.32 - 26 November 2003
526 * Steve Hay reported a problem on rt.cpan.org with Windows and
527 MSCV++ 6.0 where the source from the zlib directory was getting
528 installed with the rest of the module.
529 https://rt.cpan.org/Ticket/Display.html?id=1741
531 This has been fixed by renaming the "zlib" directory to "zlib-src"
532 thus avoiding a conflict with the name of this Perl module.
534 * Fixed a bug in the inflate method where the input buffer is an
535 lvalue (via substr). Problem & solution reported by Salvador Fandiqo.
537 * Tightened up the logic in Makefile.PL when BUILD_ZLIB is
538 True. Issue spotted by Ralf S. Engelschall.
540 1.31 - 29 October 2003
542 * Reinstated the creation of .bak files - $^I seems to need a
543 backup file on Windows. For OpenVMS, the extenstion _bak is used.
545 1.30 - 28 October 2003
547 * Bundled a sub-set of the zlib source with the module and changed
548 the default make behaviour to build with the included zlib source.
549 The previous behaviour of using a pre-built zlib library is
550 still available for those that want it.
552 * Added prototypes to the subs in Zlib.pm that didn't already have
553 them. Patch from Ed Avis.
555 * No .bak files are created by Makefile.PL any more - this keep
556 distclean much happier. Patch suggested by Ed Avis.
557 This also fixes a similar problem reported by Dr. Martin Zinser
560 * Documentation for some of the gz functions updated.
562 * Format strings modified in DispStream to keep OpenVMS happy.
563 Problem reported by Dr. Martin Zinser.
568 * Makefile.PL now displays a warning about not installing
569 Compress::Zlib via the CPAN shell.
571 * Fix to allow intermingling of gzread & gzreadline - patch
572 supplied by Doug Perham.
574 * memGunzip will silently now work if the gzip trailer is
575 missing. Some HTTP Origin Servers seem to leave it out.
579 * Tests 148 & 150 from t/02zlib.t were failing on redhat 9.
581 * Added a few words about the problems with Mac OS X to the README file.
585 * Fixed bug in gzopen where $gzerrno wasn't being set correctly.
586 The symptom was $gzerrno was set to Z_MEM_ERROR although the file
587 was opened ok. If gzopen failed, $gzerrno was being set correctly.
588 This problem wasn't spotted before because the typical test
589 to determine whether gzopen passed or failed was to check its
592 1.19 - 31 October 2002
594 * fixed a problem with t/02zlib.t that was failing with redhat 8.
596 1.18 - 24 October 2002
598 * fixed a Win32 problem in t/02zlib.t by changing sysread to read.
600 * zlib 1.0.5 & older doesn't have gzsetparams & gzeof. Added a new
601 variable to config.in to flag an old version of zlib. Split
602 out the tests for gzsetparams into t/05gzsetp.t
606 * Moved the test to check the versions of libz & zlib.h into a separate
607 file and added troubleshooting notes to README.
609 * In gzopen, only attempt to call "tell" for normal files.
611 * Fixed to work in taint mode.
613 * Broke changes out of README into Changes file.
615 * Replaced internal use of Z_PARTIAL_FLUSH symbol with Z_SYNC_FLUSH.
616 zlib.h says /* will be removed, use Z_SYNC_FLUSH instead */
618 1.16 - 13 December 2001
620 * Fixed bug in Makefile.PL that stopped "perl Makefile.PL PREFIX=..."
623 1.15 - 4th December 2001
625 * Changes a few types to get the module to build on 64-bit Solaris
627 * Changed the up/downgrade logic to default to the older constructs, and
628 to only call a downgrade if specifically requested. Some older versions
629 of Perl were having problems with the in-place edit.
631 * added the new XS constant code.
633 1.14 - 27th August 2001
635 * Memory overwrite bug fixed in "inflate". Kudos to Rob Simons for
636 reporting the bug and to Anton Berezin for fixing it for me.
638 1.13 - 31st June 2001
640 * Make sure config.in is consistant when released.
642 1.12 - 28th April 2001
644 * Modified Makefile.PL to only enable the warnings pragma if
645 using perl 5.6.1 or better.
647 1.11 - 17th February 2001
649 * Added logic in Makefile.PL to toggle between using $^W and
650 the warnings pragma in the module.
652 * The module, the examples & the test harness are now all strict
655 1.10 - 5th February 2001
657 * fixed a bug in memGunzip. Used Z_ERR instead of Z_DATA_ERROR.
659 1.09 - 15th January 2001
661 * Silenced a few compiler warnings.
663 * Updated zlib home site in README & Zlib.pm to www.info-zip.org
665 * Minor typo in Zlib.pm - a link used AUTHORS instead of AUTHOR
666 -- spotted by Frank Martini.
668 * Mention Archive::Zip
670 * added memGunzip. This is largely based on code provided by Jim Leonard.
672 * $deflate->flush can now take an optional parameter. Valid
673 values are Z_NO_FLUSH, Z_PARTIAL_FLUSH, Z_SYNC_FLUSH, Z_FULL_FLUSH
674 and Z_FINISH. The default is Z_FINISH.
678 * uncompress was clobbering its input parameter. Now it doesn't.
679 This bug was spotted by Deven T. Corzine.
681 * If a variable that only ever contained a number was given
682 to compress or deflate, it would not be compressed properly. Now
683 it will be coerced to a string and then compressed. This bug
684 was spotted by Deven T. Corzine.
688 * ANSI-ified the static functions in Zlib.xs
690 * Added the ability to build zlib along with the module.
691 This feature is 90% based on a Makefile provided by Gurusamy
696 * Fixed a nasty problem where inflate could truncate the data
697 returned. Thanks to Douglas Thomson <dougt@mugc.cc.monash.edu.au>
698 for both spotting the problem and fixing the bug.
700 * Added a note about the undocumented features in zlib that are
701 required when accessing zip files.
703 * gzclose will now get called automatically when the gzip object is
708 * Previous release used newSVpvn, which doesn't exist in 5.004_04
709 or earlier. Changed to use newSVpv instead.
711 * The module needs Perl 5.004 or better, so updated the version
712 checking in Zlib.pm and Makefile.PL
716 * Bug 19990527.001: compress(undef) core dumps -- Fixed.
720 * Updated to use the new PL_ symbols.
721 Means the module can be built with Perl 5.005_5*
725 * The return codes for gzread, gzreadline and gzwrite were
726 documented incorrectly as returning a status code.
728 * The test harness was missing a "gzclose". This caused problem
729 showed up on an amiga. Thanks to Erik van Roode for reporting
732 * Patched zlib.t for OS/2. Thanks to Ilya Zakharevich for the patch.
736 * A number of fixes to the test suite and the example scripts to
737 allow them to work under win32. All courtesy of Gurusamy
742 * Fixed crc32 & adler32. They were very broken.
744 * The following functions can now take a scalar reference in
745 place of a scalar for their buffer parameters:
754 This should mean applications that make use of the module don't
755 have to copy large buffers around.
758 * Normally the inflate method consumes I<all> of the input buffer
759 before returning. The exception to this is when inflate detects
760 the end of the stream (Z_STREAM_END). In this case the input
761 buffer need not be completely consumed. To allow processing of
762 file formats that embed a deflation stream (e.g. zip, gzip),
763 the inflate method now sets the buffer parameter to be what
764 remains after inflation.
766 When the return status is Z_STREAM_END, it will be what remains
767 of the buffer (if any) after deflation. When the status is Z_OK
768 it will be an empty string.
770 This change means that the buffer parameter must be a lvalue.
772 * Fixed crc32 and adler32. They were both very broken.
774 * Added the Compress::Zlib::memGzip function.
776 0.5 - Confirmed that no changes were necessary for zlib 1.0.3, or 1.0.4.
778 The optional parameters for deflateInit and inflateInit can now
779 be specified as an associative array in addition to a reference
780 to an associative array. They can also accept the -Name
783 gzopen can now optionally take a reference to an open
784 filehandle in place of a filename. In this case it will call
787 Added gzstream example script.
789 0.4 - Upgrade to support zlib 0.99
791 Added dictionary interface.
793 Fixed bug in gzreadline - previously it would keep returning
794 the same buffer. This bug was reported by Helmut Jarausch
796 Removed dependency to zutil.h and so dropped support for
798 DEF_MEM_LEVEL (use MAX_MEM_LEVEL instead)
799 DEF_WBITS (use MAX_WBITS instead)
801 0.3 - Added prototype specification.
803 0.2 - Fixed a minor allocation problem in Zlib.xs
805 0.1 - first alpha release. 2nd October 1995