PageRenderTime 81ms CodeModel.GetById 79ms app.highlight 0ms RepoModel.GetById 1ms app.codeStats 0ms

/zlib/USAGE.txt

http://ghostcb.googlecode.com/
Plain Text | 94 lines | 65 code | 29 blank | 0 comment | 0 complexity | ed016219c663df6855f8181aa47c2067 MD5 | raw file
 1
 2Installing ZLIB1.DLL
 3====================
 4  Copy ZLIB1.DLL to the SYSTEM or the SYSTEM32 directory.
 5
 6
 7Using ZLIB1.DLL with Microsoft Visual C++
 8=========================================
 9   1. Install the supplied header files "zlib.h" and "zconf.h"
10      into a directory found in the INCLUDE path list.
11
12   2. Install the supplied library files "zdll.exp" and "zdll.lib"
13      into a directory found in the LIB path list.
14
15   3. Add "zdll.exp" or "zdll.lib" to your project.
16
17   Notes:
18   - Usually, you don't need both the .exp file and the .lib file.
19   - If you wish, you may rename "zdll.exp" to "zlib1.exp", and/or
20     rename "zdll.lib" to "zlib1.lib".
21
22
23Using ZLIB1.DLL with Borland C++
24================================
25   1. Install the supplied header files "zlib.h" and "zconf.h"
26      into a directory found in the INCLUDE path list.
27
28   2. Build the import library using the IMPLIB tool:
29        implib -a -c -f lib\zdllbor.lib zlib1.dll
30
31      OR
32
33   2' Convert the supplied library file "zdll.lib" to OMF format,
34      using the COFF2OMF tool:
35        coff2omf lib\zdll.lib lib\zdllbor.lib
36
37   3. Install "zdllbor.lib" into a directory found in the LIB path
38      list.
39
40   4. Add "zdllbor.lib" to your project.
41
42  Notes:
43  - The modules that are linked with "zdllbor.lib" must be compiled
44    using a 4-byte alignment (option -a):
45        bcc32 -a -c myprog.c
46        bcc32 myprog.obj zdllbor.lib
47  - If you wish, you may use "zlib1.lib" instead of "zdllbor.lib".
48
49
50Using ZLIB1.DLL with gcc/MinGW
51==============================
52   1. Install the supplied header files "zlib.h" and "zconf.h"
53      into the INCLUDE directory.
54
55   2. Build the import library from the supplied "zlib.def":
56        dlltool -D zlib1.dll -d lib/zlib.def -l lib/libzdll.a
57
58      OR
59
60   2' Copy the supplied library file "zdll.lib" to "libzdll.a":
61        cp lib/zdll.lib lib/libzdll.a
62
63   3. Install "libzdll.a" into the LIB directory.
64
65   4. Add "libzdll.a" to your project, or use the -lzdll option.
66
67
68Using ZLIB1.DLL with gcc/Cygwin
69===============================
70  ZLIB1.DLL is not designed to work with Cygwin.  The Cygwin
71  system has its own DLL build of zlib, named CYGZ.DLL.
72
73
74Rebuilding ZLIB1.DLL
75====================
76  Depending on your build environment, use the appropriate
77  makefile from the win32/ directory, found in the zlib source
78  distribution.
79
80  Your custom build has to comply with the requirements stated
81  in DLL_FAQ.txt, including (but not limited to) the following:
82    - It must be built from an unaltered zlib source distribution.
83    - It must be linked to MSVCRT.DLL.
84    - The macros that compile out certain portions of the zlib
85      code (such as NO_GZCOMPRESS, NO_GZIP) must not be enabled.
86    - The ZLIB_WINAPI macro must not be enabled.
87
88  Furthermore, it has to run successfully with the test suite
89  found in this package.
90
91  It is recommended, however, to use the supplied ZLIB1.DLL,
92  instead of rebuilding it yourself.  You should rebuild it
93  only if you have a special reason.
94