~ubuntu-branches/ubuntu/trusty/rsync/trusty

« back to all changes in this revision

Viewing changes to zlib/README

  • Committer: Package Import Robot
  • Author(s): Paul Slootman
  • Date: 2013-10-27 12:01:10 UTC
  • mfrom: (1.1.13) (2.1.11 sid)
  • Revision ID: package-import@ubuntu.com-20131027120110-mpr03n5scqmf40mi
Tags: 3.1.0-2
fix build failure if zlib1g-dev package is not installed;
solved by building without the included zlib source and adding a
build-depends on zlib1g-dev >= 1:1.2.8
closes:32379

Show diffs side-by-side

added added

removed removed

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