Home | History | Annotate | Download | only in doc
      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 
     82