Move CGI from ext/ to cpan/
[perl.git] / ext / 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 =head2 Accessing Zip Files
81
82 This module does not support reading/writing zip files.
83
84 Support for reading/writing zip files is included with the
85 C<IO::Compress::Zip> and C<IO::Uncompress::Unzip> modules.
86
87 The primary focus of the C<IO::Compress::Zip> and C<IO::Uncompress::Unzip>
88 modules is to provide an C<IO::File> compatible streaming read/write
89 interface to zip files/buffers. They are not fully flegged archivers. If
90 you are looking for an archiver check out the C<Archive::Zip> module. You
91 can find it on CPAN at 
92
93     http://www.cpan.org/modules/by-module/Archive/Archive-Zip-*.tar.gz    
94
95 =head1 SEE ALSO
96
97 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::Lzop>, L<IO::Uncompress::UnLzop>, L<IO::Compress::Lzf>, L<IO::Uncompress::UnLzf>, L<IO::Uncompress::AnyInflate>, L<IO::Uncompress::AnyUncompress>
98
99 L<Compress::Zlib::FAQ|Compress::Zlib::FAQ>
100
101 L<File::GlobMapper|File::GlobMapper>, L<Archive::Zip|Archive::Zip>,
102 L<Archive::Tar|Archive::Tar>,
103 L<IO::Zlib|IO::Zlib>
104
105 =head1 AUTHOR
106
107 This module was written by Paul Marquess, F<pmqs@cpan.org>. 
108
109 =head1 MODIFICATION HISTORY
110
111 See the Changes file.
112
113 =head1 COPYRIGHT AND LICENSE
114
115 Copyright (c) 2005-2009 Paul Marquess. All rights reserved.
116
117 This program is free software; you can redistribute it and/or
118 modify it under the same terms as Perl itself.
119