This directory contains examples of the use of zlib and other relevant
programs and documentation.

enough.c
   calculation and justification of ENOUGH parameter in inftrees.h
   - calculates the maximum table space used in inflate tree
     construction over all possible Huffman codes

fitblk.c
   compress just enough input to nearly fill a requested output size
   - zlib isn't designed to do this, but fitblk does it anyway

gun.c
   uncompress a gzip file
   - illustrates the use of inflateBack() for high speed file-to-file
     decompression using call-back functions
   - is approximately twice as fast as gzip -d
   - also provides Unix uncompress functionality, again twice as fast

gzappend.c
   append to a gzip file
   - illustrates the use of the Z_BLOCK flush parameter for inflate()
   - illustrates the use of deflatePrime() to start at any bit

gzjoin.c
   join gzip files without recalculating the crc or recompressing
   - illustrates the use of the Z_BLOCK flush parameter for inflate()
   - illustrates the use of crc32_combine()

gzlog.c
gzlog.h
   efficiently and robustly maintain a message log file in gzip format
   - illustrates use of raw deflate, Z_PARTIAL_FLUSH, deflatePrime(),
     and deflateSetDictionary()
   - illustrates use of a gzip header extra field

gznorm.c
   normalize a gzip file by combining members into a single member
   - demonstrates how to concatenate deflate streams using Z_BLOCK

zlib_how.html
   painfully comprehensive description of zpipe.c (see below)
   - describes in excruciating detail the use of deflate() and inflate()

zpipe.c
   reads and writes zlib streams from stdin to stdout
   - illustrates the proper use of deflate() and inflate()
   - deeply commented in zlib_how.html (see above)

zran.c
zran.h
   index a zlib or gzip stream and randomly access it
   - illustrates the use of Z_BLOCK, inflatePrime(), and
     inflateSetDictionary() to provide random access