Move zlib to top-level root.
[ira/wip.git] / lib / zlib / contrib / vstudio / readme.txt
1 Building instructions for the DLL versions of Zlib 1.2.3\r
2 ========================================================\r
3 \r
4 This directory contains projects that build zlib and minizip using\r
5 Microsoft Visual C++ 7.0/7.1, and Visual C++ .\r
6 \r
7 You don't need to build these projects yourself. You can download the\r
8 binaries from:\r
9   http://www.winimage.com/zLibDll\r
10 \r
11 More information can be found at this site.\r
12 \r
13 \r
14 Build instructions for Visual Studio 7.x (32 bits)\r
15 --------------------------------------------------\r
16 - Uncompress current zlib, including all contrib/* files\r
17 - Download the crtdll library from\r
18     http://www.winimage.com/zLibDll/crtdll.zip\r
19   Unzip crtdll.zip to extract crtdll.lib on contrib\vstudio\vc7.\r
20 - Open contrib\vstudio\vc7\zlibvc.sln with Microsoft Visual C++ 7.x\r
21   (Visual Studio .Net 2002 or 2003).\r
22 \r
23 Build instructions for Visual Studio 2005 (32 bits or 64 bits)\r
24 --------------------------------------------------------------\r
25 - Uncompress current zlib, including all contrib/* files\r
26 - For 32 bits only: download the crtdll library from\r
27     http://www.winimage.com/zLibDll/crtdll.zip\r
28   Unzip crtdll.zip to extract crtdll.lib on contrib\vstudio\vc8.\r
29 - Open contrib\vstudio\vc8\zlibvc.sln with Microsoft Visual C++ 8.0\r
30 \r
31 Build instructions for Visual Studio 2005 64 bits, PSDK compiler\r
32 ----------------------------------------------------------------\r
33 at the time of writing this text file, Visual Studio 2005 (and \r
34   Microsoft Visual C++ 8.0) is on the beta 2 stage.\r
35 Using you can get the free 64 bits compiler from Platform SDK, \r
36   which is NOT a beta, and compile using the Visual studio 2005 IDE\r
37 see http://www.winimage.com/misc/sdk64onvs2005/ for instruction\r
38 \r
39 - Uncompress current zlib, including all contrib/* files\r
40 - start Visual Studio 2005 from a platform SDK command prompt, using\r
41   the /useenv switch\r
42 - Open contrib\vstudio\vc8\zlibvc.sln with Microsoft Visual C++ 8.0\r
43 \r
44 \r
45 Important\r
46 ---------\r
47 - To use zlibwapi.dll in your application, you must define the\r
48   macro ZLIB_WINAPI when compiling your application's source files.\r
49 \r
50 \r
51 Additional notes\r
52 ----------------\r
53 - This DLL, named zlibwapi.dll, is compatible to the old zlib.dll built\r
54   by Gilles Vollant from the zlib 1.1.x sources, and distributed at\r
55     http://www.winimage.com/zLibDll\r
56   It uses the WINAPI calling convention for the exported functions, and\r
57   includes the minizip functionality. If your application needs that\r
58   particular build of zlib.dll, you can rename zlibwapi.dll to zlib.dll.\r
59 \r
60 - The new DLL was renamed because there exist several incompatible\r
61   versions of zlib.dll on the Internet.\r
62 \r
63 - There is also an official DLL build of zlib, named zlib1.dll. This one\r
64   is exporting the functions using the CDECL convention. See the file\r
65   win32\DLL_FAQ.txt found in this zlib distribution.\r
66 \r
67 - There used to be a ZLIB_DLL macro in zlib 1.1.x, but now this symbol\r
68   has a slightly different effect. To avoid compatibility problems, do\r
69   not define it here.\r
70 \r
71 \r
72 Gilles Vollant\r
73 info@winimage.com\r