win32/README.txt

   1
   2 Expat can be built on Windows in three ways:
   3   using MS Visual C++ (6.0 or .NET), Borland C++ Builder 5 or Cygwin.
   4
   5 * Cygwin:
   6   This follows the Unix build procedures.
   7
   8 * C++ Builder 5:
   9   Possible with make files in the BCB5 subdirectory.
  10   Details can be found in the ReadMe file located there.
  11
  12 * MS Visual C++ 6:
  13   Based on the workspace file expat.dsw. The related project
  14   files (.dsp) are located in the lib subdirectory.
  15
  16 * MS Visual Studio .NET 2002, 2003, 2005:
  17   The VC++ 6 workspace file (expat.dsw) and project files (.dsp)
  18   can be opened and imported in VS.NET without problems.
  19
  20 * All MS C/C++ compilers:
  21   The output for all projects will be generated in the win32\bin
  22   directory, intermediate files will be located in project-specific
  23   subdirectories of win32\tmp.
  24
  25 * Creating MinGW dynamic libraries from MS VC++ DLLs:
  26
  27   On the command line, execute these steps:
  28   pexports libexpat.dll > expat.def
  29   pexports libexpatw.dll > expatw.def
  30   dlltool -d expat.def -l libexpat.a
  31   dlltool -d expatw.def -l libexpatw.a
  32
  33   The *.a files are mingw libraries.
  34
  35 * Special note about MS VC++ and runtime libraries:
  36
  37   There are three possible configurations: using the
  38   single threaded or multithreaded run-time library,
  39   or using the multi-threaded run-time Dll. That is,
  40   one can build three different Expat libraries depending
  41   on the needs of the application.
  42
  43   Dynamic Linking:
  44
  45   By default the Expat Dlls are built to link statically
  46   with the multi-threaded run-time library.
  47   The libraries are named
  48   - libexpat(w).dll
  49   - libexpat(w).lib (import library)
  50   The "w" indicates the UTF-16 version of the library.
  51
  52   One rarely uses other versions of the Dll, but they can
  53   be built easily by specifying a different RTL linkage in
  54   the IDE on the C/C++ tab under the category Code Generation.
  55
  56   Static Linking:
  57
  58   The libraries should be named like this:
  59   Single-theaded:     libexpat(w)ML.lib
  60   Multi-threaded:     libexpat(w)MT.lib
  61   Multi-threaded Dll: libexpat(w)MD.lib
  62   The suffixes conform to the compiler switch settings
  63   /ML, /MT and /MD for MS VC++.
  64
  65   Note: In Visual Studio 2005 (Visual C++ 8.0) and later, the
  66   single-threaded runtime library is not supported anymore.
  67
  68   By default, the expat-static and expatw-static projects are set up
  69   to link statically against the multithreaded run-time library,
  70   so they will build libexpatMT.lib or libexpatwMT.lib files.
  71
  72   To build the other versions of the static library,
  73   go to Project - Settings:
  74   - specify a different RTL linkage on the C/C++ tab
  75     under the category Code Generation.
  76   - then, on the Library tab, change the output file name
  77     accordingly, as described above
  78
  79   An application linking to the static libraries must
  80   have the global macro XML_STATIC defined.