annotate zlib/win32/README-WIN32.txt @ 138:fc828634a951

merge
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Thu, 08 Nov 2018 14:17:14 +0900
parents 04ced10e8804
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
111
kono
parents:
diff changeset
1 ZLIB DATA COMPRESSION LIBRARY
kono
parents:
diff changeset
2
kono
parents:
diff changeset
3 zlib 1.2.11 is a general purpose data compression library. All the code is
kono
parents:
diff changeset
4 thread safe. The data format used by the zlib library is described by RFCs
kono
parents:
diff changeset
5 (Request for Comments) 1950 to 1952 in the files
kono
parents:
diff changeset
6 http://www.ietf.org/rfc/rfc1950.txt (zlib format), rfc1951.txt (deflate format)
kono
parents:
diff changeset
7 and rfc1952.txt (gzip format).
kono
parents:
diff changeset
8
kono
parents:
diff changeset
9 All functions of the compression library are documented in the file zlib.h
kono
parents:
diff changeset
10 (volunteer to write man pages welcome, contact zlib@gzip.org). Two compiled
kono
parents:
diff changeset
11 examples are distributed in this package, example and minigzip. The example_d
kono
parents:
diff changeset
12 and minigzip_d flavors validate that the zlib1.dll file is working correctly.
kono
parents:
diff changeset
13
kono
parents:
diff changeset
14 Questions about zlib should be sent to <zlib@gzip.org>. The zlib home page
kono
parents:
diff changeset
15 is http://zlib.net/ . Before reporting a problem, please check this site to
kono
parents:
diff changeset
16 verify that you have the latest version of zlib; otherwise get the latest
kono
parents:
diff changeset
17 version and check whether the problem still exists or not.
kono
parents:
diff changeset
18
kono
parents:
diff changeset
19 PLEASE read DLL_FAQ.txt, and the the zlib FAQ http://zlib.net/zlib_faq.html
kono
parents:
diff changeset
20 before asking for help.
kono
parents:
diff changeset
21
kono
parents:
diff changeset
22
kono
parents:
diff changeset
23 Manifest:
kono
parents:
diff changeset
24
kono
parents:
diff changeset
25 The package zlib-1.2.11-win32-x86.zip will contain the following files:
kono
parents:
diff changeset
26
kono
parents:
diff changeset
27 README-WIN32.txt This document
kono
parents:
diff changeset
28 ChangeLog Changes since previous zlib packages
kono
parents:
diff changeset
29 DLL_FAQ.txt Frequently asked questions about zlib1.dll
kono
parents:
diff changeset
30 zlib.3.pdf Documentation of this library in Adobe Acrobat format
kono
parents:
diff changeset
31
kono
parents:
diff changeset
32 example.exe A statically-bound example (using zlib.lib, not the dll)
kono
parents:
diff changeset
33 example.pdb Symbolic information for debugging example.exe
kono
parents:
diff changeset
34
kono
parents:
diff changeset
35 example_d.exe A zlib1.dll bound example (using zdll.lib)
kono
parents:
diff changeset
36 example_d.pdb Symbolic information for debugging example_d.exe
kono
parents:
diff changeset
37
kono
parents:
diff changeset
38 minigzip.exe A statically-bound test program (using zlib.lib, not the dll)
kono
parents:
diff changeset
39 minigzip.pdb Symbolic information for debugging minigzip.exe
kono
parents:
diff changeset
40
kono
parents:
diff changeset
41 minigzip_d.exe A zlib1.dll bound test program (using zdll.lib)
kono
parents:
diff changeset
42 minigzip_d.pdb Symbolic information for debugging minigzip_d.exe
kono
parents:
diff changeset
43
kono
parents:
diff changeset
44 zlib.h Install these files into the compilers' INCLUDE path to
kono
parents:
diff changeset
45 zconf.h compile programs which use zlib.lib or zdll.lib
kono
parents:
diff changeset
46
kono
parents:
diff changeset
47 zdll.lib Install these files into the compilers' LIB path if linking
kono
parents:
diff changeset
48 zdll.exp a compiled program to the zlib1.dll binary
kono
parents:
diff changeset
49
kono
parents:
diff changeset
50 zlib.lib Install these files into the compilers' LIB path to link zlib
kono
parents:
diff changeset
51 zlib.pdb into compiled programs, without zlib1.dll runtime dependency
kono
parents:
diff changeset
52 (zlib.pdb provides debugging info to the compile time linker)
kono
parents:
diff changeset
53
kono
parents:
diff changeset
54 zlib1.dll Install this binary shared library into the system PATH, or
kono
parents:
diff changeset
55 the program's runtime directory (where the .exe resides)
kono
parents:
diff changeset
56 zlib1.pdb Install in the same directory as zlib1.dll, in order to debug
kono
parents:
diff changeset
57 an application crash using WinDbg or similar tools.
kono
parents:
diff changeset
58
kono
parents:
diff changeset
59 All .pdb files above are entirely optional, but are very useful to a developer
kono
parents:
diff changeset
60 attempting to diagnose program misbehavior or a crash. Many additional
kono
parents:
diff changeset
61 important files for developers can be found in the zlib127.zip source package
kono
parents:
diff changeset
62 available from http://zlib.net/ - review that package's README file for details.
kono
parents:
diff changeset
63
kono
parents:
diff changeset
64
kono
parents:
diff changeset
65 Acknowledgments:
kono
parents:
diff changeset
66
kono
parents:
diff changeset
67 The deflate format used by zlib was defined by Phil Katz. The deflate and
kono
parents:
diff changeset
68 zlib specifications were written by L. Peter Deutsch. Thanks to all the
kono
parents:
diff changeset
69 people who reported problems and suggested various improvements in zlib; they
kono
parents:
diff changeset
70 are too numerous to cite here.
kono
parents:
diff changeset
71
kono
parents:
diff changeset
72
kono
parents:
diff changeset
73 Copyright notice:
kono
parents:
diff changeset
74
kono
parents:
diff changeset
75 (C) 1995-2017 Jean-loup Gailly and Mark Adler
kono
parents:
diff changeset
76
kono
parents:
diff changeset
77 This software is provided 'as-is', without any express or implied
kono
parents:
diff changeset
78 warranty. In no event will the authors be held liable for any damages
kono
parents:
diff changeset
79 arising from the use of this software.
kono
parents:
diff changeset
80
kono
parents:
diff changeset
81 Permission is granted to anyone to use this software for any purpose,
kono
parents:
diff changeset
82 including commercial applications, and to alter it and redistribute it
kono
parents:
diff changeset
83 freely, subject to the following restrictions:
kono
parents:
diff changeset
84
kono
parents:
diff changeset
85 1. The origin of this software must not be misrepresented; you must not
kono
parents:
diff changeset
86 claim that you wrote the original software. If you use this software
kono
parents:
diff changeset
87 in a product, an acknowledgment in the product documentation would be
kono
parents:
diff changeset
88 appreciated but is not required.
kono
parents:
diff changeset
89 2. Altered source versions must be plainly marked as such, and must not be
kono
parents:
diff changeset
90 misrepresented as being the original software.
kono
parents:
diff changeset
91 3. This notice may not be removed or altered from any source distribution.
kono
parents:
diff changeset
92
kono
parents:
diff changeset
93 Jean-loup Gailly Mark Adler
kono
parents:
diff changeset
94 jloup@gzip.org madler@alumni.caltech.edu
kono
parents:
diff changeset
95
kono
parents:
diff changeset
96 If you use the zlib library in a product, we would appreciate *not* receiving
kono
parents:
diff changeset
97 lengthy legal documents to sign. The sources are provided for free but without
kono
parents:
diff changeset
98 warranty of any kind. The library has been entirely written by Jean-loup
kono
parents:
diff changeset
99 Gailly and Mark Adler; it does not include third-party code.
kono
parents:
diff changeset
100
kono
parents:
diff changeset
101 If you redistribute modified sources, we would appreciate that you include in
kono
parents:
diff changeset
102 the file ChangeLog history information documenting your changes. Please read
kono
parents:
diff changeset
103 the FAQ for more information on the distribution of modified source versions.