zlib 1.0.3 for BeBox README (96/07/21)
Ported by Jake Hamby (jehamby@lightside.com)
--------------------------------------------

This is a port of the latest version of zlib, a library used, among other
things, to decompress PNG images.  If you use libPNG, you will need to
install this library too.  However, zlib can be used by any program
which needs a fast, patent-free, compression/decompression library.

Installation:
-------------

Simply run the enclosed setup.sh shell script.  It will copy the zlib shared
library to /system/lib, along with its .xMAP file (used for debugging
programs which use zlib).  Finally, it runs the enclosed "example" program
which will look like this, if everything has been installed correctly:

uncompress(): hello, hello!
gzread(): hello, hello!
inflate(): hello, hello!
large_inflate(): OK
after inflateSync(): hello, hello!
inflate with dictionary: hello, hello!

Uninstallation:
---------------

If you decide to uninstall zlib, you only need to delete the files "zlib.so"
and "zlib.so.xMAP" from the /system/lib directory.

Compiling programs which use zlib:
----------------------------------

To compile programs which use zlib, you will need to copy the enclosed
zlib.h and zconf.h files to the directory in which that program expects
them (usually a zlib subdirectory, or in the case of libPNG, "../zlib"), or
put them in a standard place (I use /boot/local/include) and include
that directory in the Makefile (-I/boot/local/include).  In the linking
phase, if you are building a standard executable, use the "-lz" flag
to link with zlib.

Troubleshooting:
----------------
If you receive a "cannot execute binary file" or "Error launching..."
message when attempting to run a program which requires zlib, verify
that libz.so is present in /system/lib.  If you have any other problems,
please e-mail me:  jehamby@lightside.com

Building from source:
---------------------

Building zlib from source code is very simple.  Simply download the zlib
source code from one of the following locations:
    ftp://quest.jpl.nasa.gov/pub/zlib/zlib-1.0.3.tar.gz
    http://absinthe.lightside.net/~jehamby/Be/src/zlib-1.0.3.tar.gz

Extract the archive, and copy the enclosed Makefile and zlib.exp into the
zlib-1.0.3 directory.  Run "make test" to compile and test the shared
library.  "make install" will install the library into /system/lib, and
header files into /boot/local/include.  See the Makefile for more
information.

For more information:
---------------------

I've included the original README file for zlib, as well as "algorithm.doc"
which explains the compression algorithm in more detail.  New versions
of this, and other BeBox programs are available from my Web page:
    http://absinthe.lightside.net/~jehamby/Be/

Please send all comments and suggestions about the BeBox version of zlib to:
    jehamby@lightside.com

Enjoy!