# Digital Mars C++
# (C) Copyright Christof Meerwald 2003.
# (C) Copyright Aleksey Gurtovoy 2004.
# (C) Copyright Arjan Knepper 2006.
#
# Distributed under the Boost Software License, Version 1.0. (See
# accompanying file LICENSE_1_0.txt or copy at
# http://www.boost.org/LICENSE_1_0.txt)
#| tag::doc[]
[[bbv2.reference.tools.compiler.dmc]]
= Digital Mars C/C++ Compiler
The `dmc` module supports the http://www.digitalmars.com/[Digital Mars
C++ compiler.]
The module is initialized using the following syntax:
----
using dmc : [version] : [c++-compile-command] : [compiler options] ;
----
This statement may be repeated several times, if you want to configure
several versions of the compiler.
If the command is not specified, B2 will search for a binary
named `dmc` in PATH.
The following options can be provided, using
_`option-value syntax`_:
`cflags`::
Specifies additional compiler flags that will be used when compiling C
sources.
`cxxflags`::
Specifies additional compiler flags that will be used when compiling C++
sources.
`compileflags`::
Specifies additional compiler flags that will be used when compiling both C
and C++ sources.
`linkflags`::
Specifies additional command line options that will be passed to the linker.
|# # end::doc[]
# The following #// line will be used by the regression test table generation
# program as the column heading for HTML tables. Must not include version number.
#//Digital Mars C++
import feature generators common ;
import toolset : flags ;
import sequence regex ;
feature.extend toolset : dmc ;
rule init ( version ? : command * : options * )
{
local condition = [ common.check-init-parameters dmc : version $(version) ] ;
local command = [ common.get-invocation-command dmc : dmc : $(command) ] ;
command ?= dmc ;
common.handle-options dmc : $(condition) : $(command) : $(options) ;
if $(command)
{
command = [ common.get-absolute-tool-path $(command[-1]) ] ;
}
root = $(command:D) ;
if $(root)
{
# DMC linker is sensitive the the direction of slashes, and
# won't link if forward slashes are used in command.
root = [ sequence.join [ regex.split $(root) "/" ] : "\\" ] ;
flags dmc .root $(condition) : $(root)\\bin\\ ;
}
else
{
flags dmc .root $(condition) : "" ;
}
}
# Declare generators
generators.register-linker dmc.link : OBJ SEARCHED_LIB STATIC_LIB IMPORT_LIB : EXE : dmc ;
generators.register-linker dmc.link.dll : OBJ SEARCHED_LIB STATIC_LIB IMPORT_LIB : SHARED_LIB IMPORT_LIB : dmc ;
generators.register-archiver dmc.archive : OBJ : STATIC_LIB : dmc ;
generators.register-c-compiler dmc.compile.c++ : CPP : OBJ : dmc ;
generators.register-c-compiler dmc.compile.c : C : OBJ : dmc ;
# Declare flags
# dmc optlink has some limitation on the amount of debug-info included. Therefore only linenumbers are enabled in debug builds.
# flags dmc.compile OPTIONS on : -g ;
flags dmc.compile OPTIONS on : -gl ;
flags dmc.link OPTIONS on : /CO /NOPACKF /DEBUGLI ;
flags dmc.link OPTIONS off : /PACKF ;
flags dmc.compile OPTIONS off : -S -o+none ;
flags dmc.compile OPTIONS speed : -o+time ;
flags dmc.compile OPTIONS space : -o+space ;
flags dmc.compile OPTIONS on : -Ae ;
flags dmc.compile OPTIONS on : -Ar ;
# FIXME:
# Compiling sources to be linked into a shared lib (dll) the -WD cflag should be used
# Compiling sources to be linked into a static lib (lib) or executable the -WA cflag should be used
# But for some reason the -WD cflag is always in use.
# flags dmc.compile OPTIONS shared : -WD ;
# flags dmc.compile OPTIONS static : -WA ;
# Note that these two options actually imply multithreading support on DMC
# because there is no single-threaded dynamic runtime library. Specifying
# multi would be a bad idea, though, because no option would be
# matched when the build uses the default settings of dynamic
# and single.
flags dmc.compile OPTIONS off/shared : -ND ;
flags dmc.compile OPTIONS on/shared : -ND ;
flags dmc.compile OPTIONS off/static/single : ;
flags dmc.compile OPTIONS on/static/single : ;
flags dmc.compile OPTIONS off/static/multi : -D_MT ;
flags dmc.compile OPTIONS on/static/multi : -D_MT ;
flags dmc.compile OPTIONS : ;
flags dmc.compile.c++ OPTIONS : ;
flags dmc.compile DEFINES : ;
flags dmc.compile INCLUDES : ;
flags dmc.link ;
flags dmc.archive OPTIONS ;
flags dmc LIBPATH ;
flags dmc LIBRARIES ;
flags dmc FINDLIBS ;
flags dmc FINDLIBS ;
actions together link bind LIBRARIES
{
"$(.root)link" $(OPTIONS) /NOI /DE /XN "$(>)" , "$(<[1])" ,, $(LIBRARIES) user32.lib kernel32.lib "$(FINDLIBS:S=.lib)" , "$(<[2]:B).def"
}
actions together link.dll bind LIBRARIES
{
echo LIBRARY "$(<[1])" > $(<[2]:B).def
echo DESCRIPTION 'A Library' >> $(<[2]:B).def
echo EXETYPE NT >> $(<[2]:B).def
echo SUBSYSTEM WINDOWS >> $(<[2]:B).def
echo CODE EXECUTE READ >> $(<[2]:B).def
echo DATA READ WRITE >> $(<[2]:B).def
"$(.root)link" $(OPTIONS) /NOI /DE /XN /ENTRY:_DllMainCRTStartup /IMPLIB:"$(<[2])" "$(>)" $(LIBRARIES) , "$(<[1])" ,, user32.lib kernel32.lib "$(FINDLIBS:S=.lib)" , "$(<[2]:B).def"
}
actions compile.c
{
"$(.root)dmc" -c $(OPTIONS) -D$(DEFINES) -I"$(INCLUDES)" -o"$(<)" "$(>)"
}
actions compile.c++
{
"$(.root)dmc" -cpp -c -Ab $(OPTIONS) -D$(DEFINES) -I"$(INCLUDES)" -o"$(<)" "$(>)"
}
actions together piecemeal archive
{
"$(.root)lib" $(OPTIONS) -c -n -p256 "$(<)" "$(>)"
}