* update_version: Add some documentation.
[official-gcc.git] / zlib / FAQ
blob47a7d60c6de3950778dedf10d631da929e27a227
2                 Frequently Asked Questions about zlib
5 If your question is not there, please check the zlib home page 
6 http://www.zlib.org which may have more recent information.
7 The lastest zlib FAQ is at http://www.gzip.org/zlib/zlib_faq.html
10  1. Is zlib Y2K-compliant?
12     Yes. zlib doesn't handle dates.
14  2. Where can I get a Windows DLL version?
16     The zlib sources can be compiled without change to produce a DLL. If you
17     want a precompiled DLL, see http://www.winimage.com/zLibDll/ . Questions
18     about the zlib DLL should be sent to Gilles Vollant (info@winimage.com).
20  3. Where can I get a Visual Basic interface to zlib?
22     See
23         * http://www.winimage.com/zLibDll/cmp-z-it.zip
24         * http://www.dogma.net/markn/articles/zlibtool/zlibtool.htm
25         * contrib/visual-basic.txt in the zlib distribution
27  4. compress() returns Z_BUF_ERROR
29     Make sure that before the call of compress, the length of the compressed
30     buffer is equal to the total size of the compressed buffer and not
31     zero. For Visual Basic, check that this parameter is passed by reference
32     ("as any"), not by value ("as long").
34  5. deflate() or inflate() returns Z_BUF_ERROR
36     Before making the call, make sure that avail_in and avail_out are not
37     zero. When setting the parameter flush equal to Z_FINISH, also make sure
38     that avail_out is big enough to allow processing all pending input.
40  6. Where's the zlib documentation (man pages, etc.)?
42     It's in zlib.h for the moment, and Francis S. Lin has converted it to a
43     web page zlib.html. Volunteers to transform this to Unix-style man pages,
44     please contact Jean-loup Gailly (jloup@gzip.org). Examples of zlib usage
45     are in the files example.c and minigzip.c.
47  7. Why don't you use GNU autoconf or libtool or ...?
49     Because we would like to keep zlib as a very small and simple
50     package. zlib is rather portable and doesn't need much configuration.
52  8. I found a bug in zlib.
54     Most of the time, such problems are due to an incorrect usage of
55     zlib. Please try to reproduce the problem with a small program and send
56     the corresponding source to us at zlib@gzip.org . Do not send
57     multi-megabyte data files without prior agreement.
59  9. Why do I get "undefined reference to gzputc"?
61     If "make test" produces something like
63        example.o(.text+0x154): undefined reference to `gzputc'
64       
65     check that you don't have old files libz.* in /usr/lib, /usr/local/lib or
66     /usr/X11R6/lib. Remove any old versions, then do "make install".
68 10. I need a Delphi interface to zlib.
70     See the directories contrib/delphi and contrib/delphi2 in the zlib
71     distribution.
73 11. Can zlib handle .zip archives?
75     See the directory contrib/minizip in the zlib distribution.
77 12. Can zlib handle .Z files?
79     No, sorry. You have to spawn an uncompress or gunzip subprocess, or adapt
80     the code of uncompress on your own.
82 13. How can I make a Unix shared library?
84     make clean
85     ./configure -s
86     make
88 14. Why does "make test" fail on Mac OS X?
90     Mac OS X already includes zlib as a shared library, and so -lz links the
91     shared library instead of the one that the "make" compiled. For zlib
92     1.1.3, the two are incompatible due to different compile-time
93     options. Simply change the -lz in the Makefile to libz.a, and it will use
94     the compiled library instead of the shared one and the "make test" will
95     succeed.
97 15. I have a question about OttoPDF
99     We are not the authors of OttoPDF. The real author is on the OttoPDF web
100     site Joel Hainley jhainley@myndkryme.com.