1zip-archive
2===========
3
4The zip-archive library provides functions for creating, modifying,
5and extracting files from zip archives.  The zip archive format
6is documented in
7<http://www.pkware.com/documents/casestudies/APPNOTE.TXT>.
8
9Certain simplifying assumptions are made about the zip archives:
10in particular, there is no support for strong encryption, zip
11files that span multiple disks, ZIP64, OS-specific file
12attributes, or compression methods other than Deflate.  However,
13the library should be able to read the most common zip archives,
14and the archives it produces should be readable by all standard
15unzip programs.
16
17Archives are built and extracted in memory, so manipulating
18large zip files will consume a lot of memory.  If you work with
19large zip files or need features not supported by this library,
20a better choice may be [zip](http://hackage.haskell.org/package/zip),
21which uses a memory-efficient streaming approach.  However, zip
22can only read and write archives inside instances of MonadIO, so
23zip-archive is a better choice if you want to manipulate zip
24archives in "pure" contexts.
25
26As an example of the use of the library, a standalone zip archiver
27and extracter is provided in the source distribution.
28