git.sesse.net Git - casparcg/blob - zlib/USAGE.txt

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