diff options
author | Chris 'BinGOs' Williams <chris@bingosnet.co.uk> | 2011-12-04 20:48:57 +0000 |
---|---|---|
committer | Chris 'BinGOs' Williams <chris@bingosnet.co.uk> | 2011-12-04 20:48:57 +0000 |
commit | 9505dd85d99e2fdda86d779b39c88370f29e71d3 (patch) | |
tree | 95468dec2e73b39a6cb75bab753d5b6749cfc8d9 /cpan/Compress-Raw-Zlib | |
parent | 6475ddc2205b2f1bb01cf4662db2e38a19a15db0 (diff) | |
download | perl-9505dd85d99e2fdda86d779b39c88370f29e71d3.tar.gz |
Update Compress-Raw-Zlib to CPAN version 2.045
[DELTA]
2.045 3 December 2011
* Moved FAQ.pod into Zlib.pm
Diffstat (limited to 'cpan/Compress-Raw-Zlib')
-rw-r--r-- | cpan/Compress-Raw-Zlib/Changes | 4 | ||||
-rw-r--r-- | cpan/Compress-Raw-Zlib/README | 4 | ||||
-rw-r--r-- | cpan/Compress-Raw-Zlib/lib/Compress/Raw/Zlib.pm | 97 | ||||
-rw-r--r-- | cpan/Compress-Raw-Zlib/lib/Compress/Raw/Zlib/FAQ.pod | 127 |
4 files changed, 102 insertions, 130 deletions
diff --git a/cpan/Compress-Raw-Zlib/Changes b/cpan/Compress-Raw-Zlib/Changes index 57fe2a1673..bc0a1a8adc 100644 --- a/cpan/Compress-Raw-Zlib/Changes +++ b/cpan/Compress-Raw-Zlib/Changes @@ -1,6 +1,10 @@ CHANGES ------- + 2.045 3 December 2011 + + * Moved FAQ.pod into Zlib.pm + 2.044 2 December 2011 * Moved FAQ.pod under the lib directory so it can get installed diff --git a/cpan/Compress-Raw-Zlib/README b/cpan/Compress-Raw-Zlib/README index f43547a6f7..bd90ff4e95 100644 --- a/cpan/Compress-Raw-Zlib/README +++ b/cpan/Compress-Raw-Zlib/README @@ -1,7 +1,7 @@ Compress-Raw-Zlib - Version 2.044 + Version 2.045 3rd December 2011 @@ -355,7 +355,7 @@ To help me help you, I need all of the following information: If you haven't installed Compress-Raw-Zlib then search Compress::Raw::Zlib.pm for a line like this: - $VERSION = "2.044" ; + $VERSION = "2.045" ; c. The version of zlib you have used. If you have successfully installed Compress-Raw-Zlib, this one-liner diff --git a/cpan/Compress-Raw-Zlib/lib/Compress/Raw/Zlib.pm b/cpan/Compress-Raw-Zlib/lib/Compress/Raw/Zlib.pm index 090a2b5bfe..69076879a8 100644 --- a/cpan/Compress-Raw-Zlib/lib/Compress/Raw/Zlib.pm +++ b/cpan/Compress-Raw-Zlib/lib/Compress/Raw/Zlib.pm @@ -13,7 +13,7 @@ use warnings ; use bytes ; our ($VERSION, $XS_VERSION, @ISA, @EXPORT, $AUTOLOAD); -$VERSION = '2.044'; +$VERSION = '2.045'; $XS_VERSION = $VERSION; $VERSION = eval $VERSION; @@ -1409,6 +1409,101 @@ to access .zip files, there are other perl modules available that will do all the hard work for you. Check out C<Archive::Zip>, C<IO::Compress::Zip> and C<IO::Uncompress::Unzip>. +=head1 FAQ + +=head2 Compatibility with Unix compress/uncompress. + +This module is not compatible with Unix C<compress>. + +If you have the C<uncompress> program available, you can use this to read +compressed files + + open F, "uncompress -c $filename |"; + while (<F>) + { + ... + +Alternatively, if you have the C<gunzip> program available, you can use +this to read compressed files + + open F, "gunzip -c $filename |"; + while (<F>) + { + ... + +and this to write compress files, if you have the C<compress> program +available + + open F, "| compress -c $filename "; + print F "data"; + ... + close F ; + +=head2 Accessing .tar.Z files + +See previous FAQ item. + +If the C<Archive::Tar> module is installed and either the C<uncompress> or +C<gunzip> programs are available, you can use one of these workarounds to +read C<.tar.Z> files. + +Firstly with C<uncompress> + + use strict; + use warnings; + use Archive::Tar; + + open F, "uncompress -c $filename |"; + my $tar = Archive::Tar->new(*F); + ... + +and this with C<gunzip> + + use strict; + use warnings; + use Archive::Tar; + + open F, "gunzip -c $filename |"; + my $tar = Archive::Tar->new(*F); + ... + +Similarly, if the C<compress> program is available, you can use this to +write a C<.tar.Z> file + + use strict; + use warnings; + use Archive::Tar; + use IO::File; + + my $fh = new IO::File "| compress -c >$filename"; + my $tar = Archive::Tar->new(); + ... + $tar->write($fh); + $fh->close ; + +=head2 Zlib Library Version Support + +By default C<Compress::Raw::Zlib> will build with a private copy of version +1.2.5 of the zlib library. (See the F<README> file for details of +how to override this behaviour) + +If you decide to use a different version of the zlib library, you need to be +aware of the following issues + +=over 5 + +=item * + +First off, you must have zlib 1.0.5 or better. + +=item * + +You need to have zlib 1.2.1 or better if you want to use the C<-Merge> +option with C<IO::Compress::Gzip>, C<IO::Compress::Deflate> and +C<IO::Compress::RawDeflate>. + +=back + =head1 CONSTANTS All the I<zlib> constants are automatically imported when you make use diff --git a/cpan/Compress-Raw-Zlib/lib/Compress/Raw/Zlib/FAQ.pod b/cpan/Compress-Raw-Zlib/lib/Compress/Raw/Zlib/FAQ.pod deleted file mode 100644 index a11994694d..0000000000 --- a/cpan/Compress-Raw-Zlib/lib/Compress/Raw/Zlib/FAQ.pod +++ /dev/null @@ -1,127 +0,0 @@ - -=head1 NAME - -Compress::Raw::Zlib::FAQ -- Frequently Asked Questions about Compress::Raw::Zlib - -=head1 DESCRIPTION - -Common questions answered. - -=head2 Compatibility with Unix compress/uncompress. - -This module is not compatible with Unix C<compress>. - -If you have the C<uncompress> program available, you can use this to read -compressed files - - open F, "uncompress -c $filename |"; - while (<F>) - { - ... - -Alternatively, if you have the C<gunzip> program available, you can use -this to read compressed files - - open F, "gunzip -c $filename |"; - while (<F>) - { - ... - -and this to write compress files, if you have the C<compress> program -available - - open F, "| compress -c $filename "; - print F "data"; - ... - close F ; - -=head2 Accessing .tar.Z files - -See previous FAQ item. - -If the C<Archive::Tar> module is installed and either the C<uncompress> or -C<gunzip> programs are available, you can use one of these workarounds to -read C<.tar.Z> files. - -Firstly with C<uncompress> - - use strict; - use warnings; - use Archive::Tar; - - open F, "uncompress -c $filename |"; - my $tar = Archive::Tar->new(*F); - ... - -and this with C<gunzip> - - use strict; - use warnings; - use Archive::Tar; - - open F, "gunzip -c $filename |"; - my $tar = Archive::Tar->new(*F); - ... - -Similarly, if the C<compress> program is available, you can use this to -write a C<.tar.Z> file - - use strict; - use warnings; - use Archive::Tar; - use IO::File; - - my $fh = new IO::File "| compress -c >$filename"; - my $tar = Archive::Tar->new(); - ... - $tar->write($fh); - $fh->close ; - -=head2 Zlib Library Version Support - -By default C<Compress::Raw::Zlib> will build with a private copy of version -1.2.5 of the zlib library. (See the F<README> file for details of -how to override this behaviour) - -If you decide to use a different version of the zlib library, you need to be -aware of the following issues - -=over 5 - -=item * - -First off, you must have zlib 1.0.5 or better. - -=item * - -You need to have zlib 1.2.1 or better if you want to use the C<-Merge> -option with C<IO::Compress::Gzip>, C<IO::Compress::Deflate> and -C<IO::Compress::RawDeflate>. - -=back - -=head1 SEE ALSO - -L<Compress::Zlib>, L<IO::Compress::Gzip>, L<IO::Uncompress::Gunzip>, L<IO::Compress::Deflate>, L<IO::Uncompress::Inflate>, L<IO::Compress::RawDeflate>, L<IO::Uncompress::RawInflate>, L<IO::Compress::Bzip2>, L<IO::Uncompress::Bunzip2>, L<IO::Compress::Lzma>, L<IO::Uncompress::UnLzma>, L<IO::Compress::Xz>, L<IO::Uncompress::UnXz>, L<IO::Compress::Lzop>, L<IO::Uncompress::UnLzop>, L<IO::Compress::Lzf>, L<IO::Uncompress::UnLzf>, L<IO::Uncompress::AnyInflate>, L<IO::Uncompress::AnyUncompress> - -L<IO::Compress::FAQ|IO::Compress::FAQ> - -L<File::GlobMapper|File::GlobMapper>, L<Archive::Zip|Archive::Zip>, -L<Archive::Tar|Archive::Tar>, -L<IO::Zlib|IO::Zlib> - -=head1 AUTHOR - -This module was written by Paul Marquess, F<pmqs@cpan.org>. - -=head1 MODIFICATION HISTORY - -See the Changes file. - -=head1 COPYRIGHT AND LICENSE - -Copyright (c) 2005-2011 Paul Marquess. All rights reserved. - -This program is free software; you can redistribute it and/or -modify it under the same terms as Perl itself. - |