source: trunk/third/libiconv/README.woe32 @ 20454

Installation on Woe32 (WinNT/2000/XP, Win95/98/ME):

- Requires MS Visual C/C++ 4.0 or 5.0 or 6.0 or 7.0.

  Note that binaries created with MSVC 7.0 should not be distributed: They
  depend on a closed-source library 'msvcr70.dll' which is not normally part
  of a Woe32 installation. You cannot distribute 'msvcr70.dll' with the
  binaries - this would be a violation of the GPL and of the Microsoft EULA.
  You can distribute the binaries without including 'msvcr70.dll', but this
  will cause problems for users that don't have this library on their system.
  Therefore it is not recommended. This problem does not occur with MSVC 6.0
  and earlier.

- Cannot build in a separate directory.

- Build instructions:

   Make sure that the MSVC4.0 or MSVC5.0 or MSVC6.0 or MSVC7.0 utilities
   ("cl" etc.) are found in PATH. In a typical MSVC6.0 installation, this
   can be achieved by running
        C:\Program Files\Microsoft Visual Studio\VC98\bin\vcvars32.bat
   In a typical MSVC7.0 installation, it can be achieved by running
        C:\Program Files\Microsoft Visual Studio .NET\Common7\Tools\vsvars32.bat

   Decide which compilation model you will use:
     MFLAGS=-ML (the default)  Single-threaded, statically linked - libc.lib
     MFLAGS=-MT                Multi-threaded, statically linked  - libcmt.lib
     MFLAGS=-MD                Multi-threaded, dynamically linked - msvcrt.lib

   Step 1: Build and install the libiconv library and the iconv.exe program
   without internationalization. (This step is only needed the first time
   you install GNU libiconv.)

      For shared library (DLL):

         nmake -f Makefile.msvc NO_NLS=1 DLL=1 MFLAGS=-MD
      or
         nmake -f Makefile.msvc NO_NLS=1 DLL=1 MFLAGS=-MD check
                                                   [This runs the testsuite.]

      For static library:

         nmake -f Makefile.msvc NO_NLS=1 MFLAGS=-MD
      or
         nmake -f Makefile.msvc NO_NLS=1 MFLAGS=-MD check
                                                   [This runs the testsuite.]

      If you want to build both the shared and static library, you have to
      unpack the libiconv sources twice in different directories. Don't mix
      the two formats; you cannot use the iconv.h generated for the static
      library together with the shared library or vice versa.

      Install it:

         nmake -f Makefile.msvc NO_NLS=1 DLL=1 MFLAGS=-MD install
      or
         nmake -f Makefile.msvc NO_NLS=1 MFLAGS=-MD install

      Remove traces of this preliminary build:

         nmake -f Makefile.msvc NO_NLS=1 DLL=1 MFLAGS=-MD distclean
      or
         nmake -f Makefile.msvc NO_NLS=1 MFLAGS=-MD distclean

   Step 2: Build and install the GNU gettext package (version 0.12 or newer,
   libintl library and various programs) using the same MFLAGS. Then come
   back to here, to build GNU libiconv. (This step is only needed if you
   haven't GNU gettext already installed.)

   Step 3: Build and install the libiconv library and the iconv.exe program
   with internationalization.

      For shared library (DLL):

         nmake -f Makefile.msvc DLL=1 MFLAGS=-MD
      or
         nmake -f Makefile.msvc DLL=1 MFLAGS=-MD check
                                                    [This runs the testsuite.]

      For static library:

         nmake -f Makefile.msvc MFLAGS=-MD
      or
         nmake -f Makefile.msvc MFLAGS=-MD check    [This runs the testsuite.]

      If you want to build both the shared and static library, you have to
      unpack the libiconv sources twice in different directories. Don't mix
      the two formats; you cannot use the iconv.h generated for the static
      library together with the shared library or vice versa.

      Install it:

         nmake -f Makefile.msvc DLL=1 MFLAGS=-MD install
      or
         nmake -f Makefile.msvc MFLAGS=-MD install

- Installation:

   Manual minimal installation:

      Copy include/iconv.h to your header file repository.
      Copy lib/iconv.lib to your library repository.
      If you built for shared library, also copy lib/iconv.dll into one of
      the directories listed in your PATH, or into the directory containing
      the executable which shall make use of libiconv.

   Complete and automatic installation:

         nmake -f Makefile.msvc DLL=1 MFLAGS=-MD install PREFIX=InstallBaseDirectory
      or
         nmake -f Makefile.msvc MFLAGS=-MD install PREFIX=InstallBaseDirectory

      By default, the compiled package is installed under c:\usr. You can
      specify a different directory by giving the installation base directory
      in a PREFIX=... option in the install step. (DON'T give the PREFIX
      already in the build step! This won't work.) You can also omit the
      PREFIX=... option, thus installing everything under c:\usr, and then
      move the installed package as a whole from c:\usr to a different
      location.