comparison zlib/README @ 111:04ced10e8804

gcc 7
author kono
date Fri, 27 Oct 2017 22:46:09 +0900
parents ae3a4bfb450b
children
comparison
equal deleted inserted replaced
68:561a7518be6b 111:04ced10e8804
1 This directory contains the zlib package, which is not part of GCC but 1 This directory contains the zlib package, which is not part of GCC but
2 shipped with GCC as convenience. 2 shipped with GCC as convenience.
3 3
4 ZLIB DATA COMPRESSION LIBRARY 4 ZLIB DATA COMPRESSION LIBRARY
5 5
6 zlib 1.2.3 is a general purpose data compression library. All the code is 6 zlib 1.2.11 is a general purpose data compression library. All the code is
7 thread safe. The data format used by the zlib library is described by RFCs 7 thread safe. The data format used by the zlib library is described by RFCs
8 (Request for Comments) 1950 to 1952 in the files 8 (Request for Comments) 1950 to 1952 in the files
9 http://www.ietf.org/rfc/rfc1950.txt (zlib format), rfc1951.txt (deflate format) 9 http://tools.ietf.org/html/rfc1950 (zlib format), rfc1951 (deflate format) and
10 and rfc1952.txt (gzip format). These documents are also available in other 10 rfc1952 (gzip format).
11 formats from ftp://ftp.uu.net/graphics/png/documents/zlib/zdoc-index.html
12 11
13 All functions of the compression library are documented in the file zlib.h 12 All functions of the compression library are documented in the file zlib.h
14 (volunteer to write man pages welcome, contact zlib@gzip.org). A usage example 13 (volunteer to write man pages welcome, contact zlib@gzip.org). A usage example
15 of the library is given in the file example.c which also tests that the library 14 of the library is given in the file test/example.c which also tests that
16 is working correctly. Another example is given in the file minigzip.c. The 15 the library is working correctly. Another example is given in the file
17 compression library itself is composed of all source files except example.c and 16 test/minigzip.c. The compression library itself is composed of all source
18 minigzip.c. 17 files in the root directory.
19 18
20 To compile all files and run the test program, follow the instructions given at 19 To compile all files and run the test program, follow the instructions given at
21 the top of Makefile. In short "make test; make install" should work for most 20 the top of Makefile.in. In short "./configure; make test", and if that goes
22 machines. For Unix: "./configure; make test; make install". For MSDOS, use one 21 well, "make install" should work for most flavors of Unix. For Windows, use
23 of the special makefiles such as Makefile.msc. For VMS, use make_vms.com. 22 one of the special makefiles in win32/ or contrib/vstudio/ . For VMS, use
23 make_vms.com.
24 24
25 Questions about zlib should be sent to <zlib@gzip.org>, or to Gilles Vollant 25 Questions about zlib should be sent to <zlib@gzip.org>, or to Gilles Vollant
26 <info@winimage.com> for the Windows DLL version. The zlib home page is 26 <info@winimage.com> for the Windows DLL version. The zlib home page is
27 http://www.zlib.org or http://www.gzip.org/zlib/ Before reporting a problem, 27 http://zlib.net/ . Before reporting a problem, please check this site to
28 please check this site to verify that you have the latest version of zlib; 28 verify that you have the latest version of zlib; otherwise get the latest
29 otherwise get the latest version and check whether the problem still exists or 29 version and check whether the problem still exists or not.
30 not.
31 30
32 PLEASE read the zlib FAQ http://www.gzip.org/zlib/zlib_faq.html before asking 31 PLEASE read the zlib FAQ http://zlib.net/zlib_faq.html before asking for help.
33 for help.
34 32
35 Mark Nelson <markn@ieee.org> wrote an article about zlib for the Jan. 1997 33 Mark Nelson <markn@ieee.org> wrote an article about zlib for the Jan. 1997
36 issue of Dr. Dobb's Journal; a copy of the article is available in 34 issue of Dr. Dobb's Journal; a copy of the article is available at
37 http://dogma.net/markn/articles/zlibtool/zlibtool.htm 35 http://marknelson.us/1997/01/01/zlib-engine/ .
38 36
39 The changes made in version 1.2.3 are documented in the file ChangeLog. 37 The changes made in version 1.2.11 are documented in the file ChangeLog.
40 38
41 Unsupported third party contributions are provided in directory "contrib". 39 Unsupported third party contributions are provided in directory contrib/ .
42 40
43 A Java implementation of zlib is available in the Java Development Kit 41 zlib is available in Java using the java.util.zip package, documented at
44 http://java.sun.com/j2se/1.4.2/docs/api/java/util/zip/package-summary.html 42 http://java.sun.com/developer/technicalArticles/Programming/compression/ .
45 See the zlib home page http://www.zlib.org for details.
46 43
47 A Perl interface to zlib written by Paul Marquess <pmqs@cpan.org> is in the 44 A Perl interface to zlib written by Paul Marquess <pmqs@cpan.org> is available
48 CPAN (Comprehensive Perl Archive Network) sites 45 at CPAN (Comprehensive Perl Archive Network) sites, including
49 http://www.cpan.org/modules/by-module/Compress/ 46 http://search.cpan.org/~pmqs/IO-Compress-Zlib/ .
50 47
51 A Python interface to zlib written by A.M. Kuchling <amk@amk.ca> is 48 A Python interface to zlib written by A.M. Kuchling <amk@amk.ca> is
52 available in Python 1.5 and later versions, see 49 available in Python 1.5 and later versions, see
53 http://www.python.org/doc/lib/module-zlib.html 50 http://docs.python.org/library/zlib.html .
54 51
55 A zlib binding for TCL written by Andreas Kupries <a.kupries@westend.com> is 52 zlib is built into tcl: http://wiki.tcl.tk/4610 .
56 availlable at http://www.oche.de/~akupries/soft/trf/trf_zip.html
57 53
58 An experimental package to read and write files in .zip format, written on top 54 An experimental package to read and write files in .zip format, written on top
59 of zlib by Gilles Vollant <info@winimage.com>, is available in the 55 of zlib by Gilles Vollant <info@winimage.com>, is available in the
60 contrib/minizip directory of zlib. 56 contrib/minizip directory of zlib.
61 57
75 necessary to get gzprintf working correctly. This is done by configure. 71 necessary to get gzprintf working correctly. This is done by configure.
76 72
77 - zlib doesn't work on HP-UX 9.05 with some versions of /bin/cc. It works with 73 - zlib doesn't work on HP-UX 9.05 with some versions of /bin/cc. It works with
78 other compilers. Use "make test" to check your compiler. 74 other compilers. Use "make test" to check your compiler.
79 75
80 - gzdopen is not supported on RISCOS, BEOS and by some Mac compilers. 76 - gzdopen is not supported on RISCOS or BEOS.
81 77
82 - For PalmOs, see http://palmzlib.sourceforge.net/ 78 - For PalmOs, see http://palmzlib.sourceforge.net/
83
84 - When building a shared, i.e. dynamic library on Mac OS X, the library must be
85 installed before testing (do "make install" before "make test"), since the
86 library location is specified in the library.
87 79
88 80
89 Acknowledgments: 81 Acknowledgments:
90 82
91 The deflate format used by zlib was defined by Phil Katz. The deflate 83 The deflate format used by zlib was defined by Phil Katz. The deflate and
92 and zlib specifications were written by L. Peter Deutsch. Thanks to all the 84 zlib specifications were written by L. Peter Deutsch. Thanks to all the
93 people who reported problems and suggested various improvements in zlib; 85 people who reported problems and suggested various improvements in zlib; they
94 they are too numerous to cite here. 86 are too numerous to cite here.
95 87
96 Copyright notice: 88 Copyright notice:
97 89
98 (C) 1995-2004 Jean-loup Gailly and Mark Adler 90 (C) 1995-2017 Jean-loup Gailly and Mark Adler
99 91
100 This software is provided 'as-is', without any express or implied 92 This software is provided 'as-is', without any express or implied
101 warranty. In no event will the authors be held liable for any damages 93 warranty. In no event will the authors be held liable for any damages
102 arising from the use of this software. 94 arising from the use of this software.
103 95
114 3. This notice may not be removed or altered from any source distribution. 106 3. This notice may not be removed or altered from any source distribution.
115 107
116 Jean-loup Gailly Mark Adler 108 Jean-loup Gailly Mark Adler
117 jloup@gzip.org madler@alumni.caltech.edu 109 jloup@gzip.org madler@alumni.caltech.edu
118 110
119 If you use the zlib library in a product, we would appreciate *not* 111 If you use the zlib library in a product, we would appreciate *not* receiving
120 receiving lengthy legal documents to sign. The sources are provided 112 lengthy legal documents to sign. The sources are provided for free but without
121 for free but without warranty of any kind. The library has been 113 warranty of any kind. The library has been entirely written by Jean-loup
122 entirely written by Jean-loup Gailly and Mark Adler; it does not 114 Gailly and Mark Adler; it does not include third-party code.
123 include third-party code.
124 115
125 If you redistribute modified sources, we would appreciate that you include 116 If you redistribute modified sources, we would appreciate that you include in
126 in the file ChangeLog history information documenting your changes. Please 117 the file ChangeLog history information documenting your changes. Please read
127 read the FAQ for more information on the distribution of modified source 118 the FAQ for more information on the distribution of modified source versions.
128 versions.