Please enter the commit message for your changes. Lines starting

[eos/base.git] / util / src / TclTk / tcl8.6.12 / compat / zlib / win32 / USAGE.txt

diff --git a/util/src/TclTk/tcl8.6.12/compat/zlib/win32/USAGE.txt b/util/src/TclTk/tcl8.6.12/compat/zlib/win32/USAGE.txt
new file mode 100644 (file)
index 0000000..22829eb
--- /dev/null
+++ b/util/src/TclTk/tcl8.6.12/compat/zlib/win32/USAGE.txt
@@ -0,0 +1,97 @@
+\r
+Installing ZLIB1.DLL\r
+====================\r
+  Copy ZLIB1.DLL to the SYSTEM or the SYSTEM32 directory.\r
+  \r
+  If you want to install the 32-bit dll on a 64-bit\r
+  machine, use the SysWOW64 directory instead.\r
+\r
+\r
+Using ZLIB1.DLL with Microsoft Visual C++\r
+=========================================\r
+   1. Install the supplied header files "zlib.h" and "zconf.h"\r
+      into a directory found in the INCLUDE path list.\r
+\r
+   2. Install the supplied library file "zdll.lib" into a\r
+      directory found in the LIB path list.\r
+\r
+   3. Add "zdll.lib" to your project.\r
+\r
+\r
+Using ZLIB1.DLL with gcc/MinGW\r
+==============================\r
+   1. Install the supplied header files "zlib.h" and "zconf.h"\r
+      into the INCLUDE directory.\r
+\r
+   2. (32-bit): Copy the supplied library file "zdll.lib" to "libzdll.a":\r
+        cp lib/zdll.lib lib/libzdll.a\r
+\r
+      OR\r
+\r
+   2'. (64-bit): Copy the supplied library file "libz.dll.a" to "libzdll.a":\r
+        cp lib/libz.dll.a lib/libzdll.a\r
+\r
+      OR\r
+\r
+   2'' Build the import library from the supplied "zlib.def":\r
+        dlltool -D zlib1.dll -d lib/zlib.def -l lib/libzdll.a\r
+\r
+   3. Install "libzdll.a" into the LIB directory.\r
+\r
+   4. Add "libzdll.a" to your project, or use the -lzdll option.\r
+\r
+\r
+Using ZLIB1.DLL with gcc/Cygwin\r
+===============================\r
+  ZLIB1.DLL is not designed to work with Cygwin.  The Cygwin\r
+  system has its own DLL build of zlib, named CYGZ.DLL.\r
+\r
+\r
+Using ZLIB1.DLL with Borland C++\r
+================================\r
+   1. Install the supplied header files "zlib.h" and "zconf.h"\r
+      into a directory found in the INCLUDE path list.\r
+\r
+   2. Build the import library using the IMPLIB tool:\r
+        implib -a -c -f lib\zdllbor.lib zlib1.dll\r
+\r
+      OR\r
+\r
+   2' Convert the supplied library file "zdll.lib" to OMF format,\r
+      using the COFF2OMF tool:\r
+        coff2omf lib\zdll.lib lib\zdllbor.lib\r
+\r
+   3. Install "zdllbor.lib" into a directory found in the LIB path\r
+      list.\r
+\r
+   4. Add "zdllbor.lib" to your project.\r
+\r
+  Notes:\r
+  - The modules that are linked with "zdllbor.lib" must be compiled\r
+    using a 4-byte alignment (option -a):\r
+        bcc32 -a -c myprog.c\r
+        bcc32 myprog.obj zdllbor.lib\r
+  - If you wish, you may use "zlib1.lib" instead of "zdllbor.lib".\r
+\r
+\r
+Rebuilding ZLIB1.DLL\r
+====================\r
+  Depending on your build environment, use the appropriate\r
+  makefile from the win32/ directory, found in the zlib source\r
+  distribution.\r
+\r
+  Your custom build has to comply with the requirements stated\r
+  in DLL_FAQ.txt, including (but not limited to) the following:\r
+    - It must be built from an unaltered zlib source distribution.\r
+    - It must be linked to MSVCRT.DLL.\r
+    - The macros that compile out certain portions of the zlib\r
+      code (such as NO_GZCOMPRESS, NO_GZIP) must not be enabled.\r
+    - The ZLIB_WINAPI macro must not be enabled.\r
+\r
+  Furthermore, it has to run successfully with the test suite\r
+  found in this package.\r
+\r
+  It is recommended, however, to use the supplied ZLIB1.DLL,\r
+  instead of rebuilding it yourself.  You should rebuild it\r
+  only if you have a special reason.\r
+\r