This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Update Compress-Raw-Bzip2 to CPAN version 2.033
[perl5.git] / cpan / Compress-Raw-Bzip2 / pod / FAQ.pod
1
2 =head1 NAME
3
4 Compress::Raw::Bzip2::FAQ -- Frequently Asked Questions about Compress::Raw::Bzip2
5
6 =head1 DESCRIPTION
7
8 Common questions answered.
9
10 =head2 Compatibility with Unix compress/uncompress.
11
12 This module is not compatible with Unix C<compress>.
13
14 If you have the C<uncompress> program available, you can use this to read
15 compressed files
16
17     open F, "uncompress -c $filename |";
18     while (<F>)
19     {
20         ...
21
22 Alternatively, if you have the C<gunzip> program available, you can use
23 this to read compressed files
24
25     open F, "gunzip -c $filename |";
26     while (<F>)
27     {
28         ...
29
30 and this to write compress files, if you have the C<compress> program
31 available
32
33     open F, "| compress -c $filename ";
34     print F "data";
35     ...
36     close F ;
37
38 =head2 Accessing .tar.Z files
39
40 See previous FAQ item.
41
42 If the C<Archive::Tar> module is installed and either the C<uncompress> or
43 C<gunzip> programs are available, you can use one of these workarounds to
44 read C<.tar.Z> files.
45
46 Firstly with C<uncompress>
47
48     use strict;
49     use warnings;
50     use Archive::Tar;
51
52     open F, "uncompress -c $filename |";
53     my $tar = Archive::Tar->new(*F);
54     ...
55
56 and this with C<gunzip>
57
58     use strict;
59     use warnings;
60     use Archive::Tar;
61
62     open F, "gunzip -c $filename |";
63     my $tar = Archive::Tar->new(*F);
64     ...
65
66 Similarly, if the C<compress> program is available, you can use this to
67 write a C<.tar.Z> file
68
69     use strict;
70     use warnings;
71     use Archive::Tar;
72     use IO::File;
73
74     my $fh = new IO::File "| compress -c >$filename";
75     my $tar = Archive::Tar->new();
76     ...
77     $tar->write($fh);
78     $fh->close ;
79
80 =head1 SEE ALSO
81
82 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>
83
84 L<Compress::Zlib::FAQ|Compress::Zlib::FAQ>
85
86 L<File::GlobMapper|File::GlobMapper>, L<Archive::Zip|Archive::Zip>,
87 L<Archive::Tar|Archive::Tar>,
88 L<IO::Zlib|IO::Zlib>
89
90 =head1 AUTHOR
91
92 This module was written by Paul Marquess, F<pmqs@cpan.org>. 
93
94 =head1 MODIFICATION HISTORY
95
96 See the Changes file.
97
98 =head1 COPYRIGHT AND LICENSE
99
100 Copyright (c) 2005-2011 Paul Marquess. All rights reserved.
101
102 This program is free software; you can redistribute it and/or
103 modify it under the same terms as Perl itself.
104