sdk/lib/3rdparty/stlport/doc/README.dmc

   1 ==================================================
   2 STLport README for Digital Mars C++ compilers.
   3 ==================================================
   4
   5 Build of STLport with Digital Mars C++ compiler is very similar
   6 to the one for Microsoft Visual Studio compiler (see README.msvc).
   7
   8 Below are some additional hints. [DMC users are encouraged to
   9 contribute additional information.]
  10
  11 =============
  12 Prerequisites
  13 =============
  14
  15  - Digital Mars C++ 8.49 or above
  16
  17  - A GNU environment with make tool. Prefer MinGW/MSys to Cygwin because the
  18    latter contains a link command that is also the name of the Digital Mars linker
  19    and you might experiment collision between both commands.
  20    See README.mingw for additional information.
  21
  22 ===================
  23 Installing STLport
  24 ===================
  25
  26  - STLport directory can be almost anywhere EXCEPT native dm\include directory.
  27
  28 ===================
  29 Configuring STLport
  30 ===================
  31
  32  - In a console window go to the STLport build\lib folder. Run
  33
  34           configure -c dmc
  35
  36 ================
  37 Building STLport
  38 ================
  39
  40  - To build STLport libraries:
  41
  42     cd [STLport dir]\build\lib
  43     [mingw32-make] -f dmc.mak install
  44
  45  - To build STLport (dynamic) unit tests:
  46
  47     cd [STLport dir]\build\test\unit
  48     [mingw32-make] -f dmc.mak install
  49
  50 ============
  51 Known issues
  52 ============
  53
  54 1. typeinfo.h
  55
  56   DMC forces inclusion of typeinfo.h header at the begining of any
  57 translation unit. This breaks the STLport include schema, especially
  58 when building the library. As a workaround STLport typeinfo.h simply
  59 include native DMC header not performing any internal STLport work as
  60 importing things to STLport namespace. As a result typeinfo.h should
  61 never be reference in user code, as it is neither a C nor a C++ header
  62 this is not considered as a major limitation. The C++ Standard header
  63 is typeinfo.
  64
  65 2. link.exe and lib.exe
  66
  67   STLport makefiles for DMC use dm_link and dm_lib instead of link and lib to
  68 avoid conflicts with other vendors' linkers and archivers.  To build STLport
  69 with DMC, please copy or rename the following files:
  70
  71   copy dm\bin\link.exe dm\bin\dm_link.exe
  72   copy dm\bin\lib.exe dm\bin\dm_lib.exe
  73
  74 3. Free online version.
  75
  76   If DMC's free online version reports compiler or linker errors, the
  77 solution may be in a free online CD update.  Download and unzip all free
  78 CD patches for versions 8.30 and above, in consecutive order, overwriting
  79 previous files. Then install free online version 8.49 or above, overwriting
  80 previous files.
  81