scripts/clam/cpp/rules.def

   1 ###############################################################################
   2
   3 # CLAM System default rules and targets for C++ compilation.
   4
   5 # This file composite macros and rules for creating compilation objects
   6 # (such as library archives, object files, executable programs, and others).
   7
   8 # This file should be included in the user's Makefile after the variables
   9 # have been initialized appropriately for the particular project being
  10 # compiled.  The user's own targets should be placed after the include
  11 # directive that specifies this file.
  12
  13 ###############################################################################
  14
  15 # This section manipulates variable values to prepare them for their use
  16 # in the standard CLAM support.
  17
  18 # see if they have got the clean flag set.  if so, we will not build anything.
  19 ifneq "$(CLEAN)" ""
  20   NO_COMPILE = t
  21 endif
  22 # also omit version compilation and some logging when not compiling.
  23 ifneq "$(NO_COMPILE)" ""
  24   QUIET = t
  25 endif
  26
  27 # implement special bits for gnu on unix.
  28 ifeq "$(COMPILER)" "GNU_LINUX"
  29   ifneq "$(USE_XWIN)" ""
  30     DEFINITIONS += __XWINDOWS__ __X__
  31     LIBS_USED += Xm Xt X11 Xft Xp
  32 #need to separate out with a USE_MOTIF kind of thing.
  33 LIBS_USED += Xmu
  34     HEADER_SEARCH_PATH += /usr/include/X11 /usr/X11R6/include /usr/include/g++
  35     LIBRARY_SEARCH_PATH += /usr/X11R6/lib
  36   endif
  37
  38   ifneq "$(USE_SSL)" ""
  39     LIBS_USED += ssl crypto
  40   endif
  41
  42   ifneq "$(USE_WXWIDGETS)" ""
  43     DEFINITIONS += __WXWIDGETS__
  44     use_unicode =
  45     ifneq "$(findstring UNICODE, $(DEFINITIONS))" ""
  46       use_unicode = true
  47     endif
  48
  49     # decide whether to turn on the unicode flag or not.
  50     ifneq "$(use_unicode)" ""
  51       DEFINITIONS += wxUSE_UNICODE
  52       UNICODE_FLAG_ADD = --unicode=yes
  53     else
  54       UNICODE_FLAG_ADD = --unicode=no
  55     endif
  56     # could add for debugging: --debug=yes
  57     COMPILER_FLAGS += $(shell wx-config --cxxflags $(UNICODE_FLAG_ADD) )
  58
  59     LOAD_FLAG_PREFIX += $(shell wx-config --libs $(UNICODE_FLAG_ADD) )
  60   endif
  61
  62   ifneq "$(USE_CURL)" ""
  63     COMPILER_FLAGS += `curl-config --cflags`
  64     LOAD_FLAG_SUFFIX += `curl-config --libs`
  65   endif
  66 endif
  67
  68 # some special code for gnu compiler on windows.
  69 ifeq "$(COMPILER)" "GNU_WINDOWS"
  70
  71   ifneq "$(USE_SSL)" ""
  72     LIBS_USED += ssl crypto
  73   endif
  74
  75   ifneq "$(USE_WXWIDGETS)" ""
  76     DEFINITIONS += __WXWIDGETS__
  77     use_unicode =
  78     ifneq "$(findstring UNICODE, $(DEFINITIONS))" ""
  79       use_unicode = true
  80     endif
  81
  82     # decide whether to turn on the unicode flag or not.
  83     ifneq "$(use_unicode)" ""
  84       DEFINITIONS += wxUSE_UNICODE
  85       UNICODE_FLAG_ADD = --unicode=yes
  86     else
  87       UNICODE_FLAG_ADD = --unicode=no
  88     endif
  89     # could add for debugging: --debug=yes
  90     COMPILER_FLAGS += $(shell wx-config --cxxflags $(UNICODE_FLAG_ADD) )
  91
  92     LOAD_FLAG_PREFIX += $(shell wx-config --libs $(UNICODE_FLAG_ADD) )
  93   endif
  94
  95 LOAD_FLAG_PREFIX += -lwsock32 -lmswsock -shared
  96
  97   ifneq "$(USE_CURL)" ""
  98     COMPILER_FLAGS += `curl-config --cflags`
  99     LOAD_FLAG_SUFFIX += `curl-config --libs`
 100   endif
 101
 102 endif
 103
 104 ###############################################################################
 105
 106 ifeq "$(COMPILER)" "GNU_DARWIN"
 107   ifneq "$(USE_XWIN)" ""
 108     DEFINITIONS += __XWINDOWS__ __X__
 109     LIBS_USED +=
 110 #Xm Xt X11 Xft Xp
 111 #need to separate out with a USE_MOTIF kind of thing.
 112 #LIBS_USED += Xmu
 113     HEADER_SEARCH_PATH += /usr/include/X11 /usr/X11R6/include /usr/include/g++
 114     LIBRARY_SEARCH_PATH += /usr/X11R6/lib
 115   endif
 116
 117   ifneq "$(USE_SSL)" ""
 118     LIBS_USED += crypto
 119   endif
 120
 121   ifneq "$(USE_WXWIDGETS)" ""
 122     DEFINITIONS += __WXWIDGETS__
 123     use_unicode =
 124     ifneq "$(findstring UNICODE, $(DEFINITIONS))" ""
 125         use_unicode = true
 126     endif
 127
 128     # decide whether to turn on the unicode flag or not.
 129 ###    ifneq "$(findstring UNICODE, $(DEFINITIONS))" ""
 130     ifneq "$(use_unicode)" ""
 131       UNICODE_FLAG_ADD = --unicode=yes
 132       DEFINITIONS += wxUSE_UNICODE
 133     else
 134       UNICODE_FLAG_ADD = --unicode=no
 135     endif
 136
 137     COMPILER_FLAGS += $(shell wx-config --cxxflags $(UNICODE_FLAG_ADD) )
 138     LOAD_FLAG_PREFIX += $(shell wx-config --libs $(UNICODE_FLAG_ADD) )
 139   endif
 140
 141   ifneq "$(USE_CURL)" ""
 142     COMPILER_FLAGS += `curl-config --cflags`
 143     LOAD_FLAG_SUFFIX += `curl-config --libs`
 144   endif
 145
 146 endif
 147
 148 ###############################################################################
 149
 150
 151 # additions for gnu x86 and arm compilers.
 152 ifneq "$(OP_SYSTEM)" "WIN32"
 153   # is the freetds library support available on this host.
 154   ifneq "$(ENABLE_FREETDS)" ""
 155     # establish the headers if freetds is enabled.  that just means things
 156     # can be compiled against it.  to link in the db-lib, the makefile should
 157     # have a 'USE_FREETDS = true' statement.
 158
 159     # is this particular library or app using freetds?
 160     ifneq "$(USE_FREETDS)" ""
 161       DEFINITIONS += ENABLE_FREETDS _FREETDS_LIBRARY_SOURCE
 162       LIBS_USED += rt sybdb
 163     endif
 164   endif
 165 endif
 166
 167 # win32 compiler additions.
 168 #ifeq "$(OP_SYSTEM)" "WIN32"
 169 ifeq "$(COMPILER)" "VISUAL_CPP"
 170   # processes the def file for linkage, if one has been specified.
 171   ifneq "$(DEF_FILE)" ""
 172     LOAD_FLAG_PREFIX += -def:$(DEF_FILE)
 173   endif
 174
 175   ifneq "$(TYPE)" "library"
 176     ifneq "$(USE_MFC)" ""
 177       ifneq "$(findstring UNICODE, $(DEFINITIONS))" ""
 178         # specify the winmain type for unicode explicitly.
 179         LOAD_FLAG_PREFIX += -entry:wWinMainCRTStartup
 180       endif
 181     endif
 182   endif
 183
 184   # these are loaded after any special debugging libs.
 185   ifneq "$(VCPP_USE_BASE)" ""
 186     # the first set will be included in almost any old program.  we include
 187     # winmm for multimedia in the base support since we make heavy use of the
 188     # more accurate uptime function.
 189     LOAD_FLAG_PREFIX += kernel32.lib user32.lib advapi32.lib shell32.lib \
 190       version.lib winmm.lib shlwapi.lib
 191   endif
 192
 193   ifneq "$(USE_WXWIDGETS)" ""
 194     DEFINITIONS += __WXWIDGETS__ __WXMSW__
 195     LOCAL_HEADERS += $(THIRD_PARTY_DIR)/wxwidgets/include
 196     LIBRARY_SEARCH_PATH += $(THIRD_PARTY_DIR)/wxwidgets/lib
 197 #    ifeq "$(findstring UNICODE, $(DEFINITIONS))" ""
 198       LIBS_USED += wxmsw28_core.lib
 199       LOCAL_HEADERS += $(THIRD_PARTY_DIR)/wxwidgets/lib/msw
 200 #    else
 201 #      DEFINITIONS += wxUSE_UNICODE
 202 #      LIBS_USED += wxmsw28u_core.lib
 203 #      LOCAL_HEADERS += $(THIRD_PARTY_DIR)/wxwidgets/lib/mswu
 204 #    endif
 205
 206 ##    LOAD_FLAG_PREFIX += comctl32.lib shell32.lib
 207     VCPP_USE_GUI = t
 208     VCPP_USE_OLE = t
 209   endif
 210
 211   ifneq "$(USE_CURL)" ""
 212 #    # curl wants this win32 flag?
 213     DEFINITIONS += WIN32
 214     LOCAL_HEADERS += $(THIRD_PARTY_DIR)/curl/include
 215     LIBRARY_SEARCH_PATH += $(THIRD_PARTY_DIR)/curl/lib
 216 #    LIBS_USED += libcurl.dll.a
 217     LIBS_USED += libcurl.lib
 218   endif
 219
 220   ifneq "$(VCPP_USE_GUI)" ""
 221     LOAD_FLAG_PREFIX += comctl32.lib comdlg32.lib gdi32.lib winspool.lib
 222   endif
 223
 224   ifneq "$(VCPP_USE_OLE)" ""
 225     LOAD_FLAG_PREFIX += ole32.lib oleaut32.lib uuid.lib
 226     VCPP_USE_RPC = t
 227   endif
 228   ifneq "$(VCPP_USE_RPC)" ""
 229     ifeq "$(COMPILER_VERSION)" "8"
 230       LOAD_FLAG_PREFIX += rpcndr.lib rpcns4.lib rpcrt4.lib
 231     endif
 232     ifeq "$(COMPILER_VERSION)" "10"
 233       LOAD_FLAG_PREFIX += rpcrt4.lib
 234     endif
 235     VCPP_USE_SOCK = t
 236   endif
 237   ifneq "$(VCPP_USE_SOCK)" ""
 238     LOAD_FLAG_PREFIX += netapi32.lib ws2_32.lib
 239   endif
 240   ifneq "$(VCPP_USE_CLR)" ""
 241     LOAD_FLAG_PREFIX += -noentry -include:"__DllMainCRTStartup@12"
 242     COMPILER_FLAGS += -EHa -clr -AI "$(FRAMEWORK_DIR)" -AI "$(DYNAMIC_LIBRARY_DIR)" -FU "mscorlib.dll" -FU "System.dll" -FU "System.Data.dll" -FU "System.Windows.Forms.dll" -FU "System.Drawing.dll"
 243   endif
 244
 245   ifneq "$(USE_SSL)" ""
 246     LOCAL_HEADERS += $(THIRD_PARTY_DIR)/openssl/include
 247     LIBRARY_SEARCH_PATH += $(THIRD_PARTY_DIR)/openssl/lib
 248     LIBS_USED += libcrypto.lib libssl.lib
 249     $(shell cp $(THIRD_PARTY_DIR)/openssl/lib/*dll $(EXECUTABLE_DIR) )
 250   endif
 251
 252 endif
 253
 254 #ifeq "$(OP_SYSTEM)" "WIN32"
 255 ifeq "$(COMPILER)" "VISUAL_CPP"
 256   # prep the actual source variable so that certain file names are translated.
 257   ACTUAL_RESX = $(RESX:%.resx=$(OBJECT_DIR)/%.resources)
 258   ACTUAL_RESX_FLAGS = $(ACTUAL_RESX:%=-ASSEMBLYLINKRESOURCE:%)
 259 else
 260   ACTUAL_RESX =
 261   ACTUAL_RESX_FLAGS =
 262 endif
 263
 264 # Create the real list of local libraries needed.
 265 TEMP_LOC1 = $(LOCAL_LIBS_USED:%=%$(TRIPART_VERSION))
 266 ACTUAL_LOCAL_LIBS = $(TEMP_LOC1)
 267
 268 # Create the list of objects from the list of source files.
 269 TEMP_OBJ1 = $(SOURCE:%.cpp=%.obj)
 270 TEMP_OBJ2 = $(TEMP_OBJ1:%.c=%.obj)
 271 ifeq "$(COMPILER)" "VISUAL_CPP"
 272   ifneq "$(OMIT_VERSIONS)" ""
 273     # remove version rc files if we're not dealing with versions.
 274     TEMP_OBJ3a = $(TEMP_OBJ2:%_version.rc=)
 275   else
 276     TEMP_OBJ3a = $(TEMP_OBJ2)
 277   endif
 278   ifeq "$(COMPILER)" "VISUAL_CPP"
 279     TEMP_OBJ3 = $(TEMP_OBJ3a:%.rc=%.res)
 280   else
 281     TEMP_OBJ3 = $(TEMP_OBJ3a)
 282   endif
 283 else
 284   # replace this when supporting resource files on unix.
 285   TEMP_OBJ3 = $(TEMP_OBJ2:%.rc=)
 286 endif
 287 TEMP_OBJ4 = $(TEMP_OBJ3:%.h=%.bad)
 288 OBJECTS = $(TEMP_OBJ4)
 289
 290 # special case for multi-build and res files that need to be rebuilt.
 291 #RES_OBJECTS_0 = $(SOURCE:%.cpp=)
 292 #RES_OBJECTS_1 = $(RES_OBJECTS_0:%.c=)
 293 #RES_OBJECTS = $(RES_OBJECTS_1:%.rc=$(OBJECT_DIR)/%.res)
 294
 295 # not much conversion anymore...
 296 ACTUAL_OBJECTS = $(OBJECTS) $(EXTRA_OBJECTS)
 297
 298 # Updates the search path for the compiler and local libraries.
 299 BASE_HEADER_PATH = $(CODEBASE_HEADERS) $(LOCAL_HEADERS) $(HOOPLE_HEADERS) $(SEARCH_DIRS)
 300 HEADER_SEARCH_PATH += $(BASE_HEADER_PATH) $(COMPILER_HEADER_DIR)
 301
 302 LIBRARY_SEARCH_PATH += $(LOCAL_LIBRARIES) $(HOOPLE_LIBRARIES) \
 303   $(STATIC_LIBRARY_DIR) $(COMPILER_LIBRARY_DIR) $(SEARCH_DIRS)
 304
 305 # Adds some directories that must be searched onto the search path for
 306 # header files, such as the header file directory for the compiler.
 307 COMPILER_FLAGS += $(HEADER_SEARCH_PATH:%=-I%) $(DEFINITIONS:%=-D%) $(UNDEFINITIONS:%=-U%) -DGLOBAL_PRODUCT_NAME="$(GLOBAL_PRODUCT_NAME)"
 308
 309 # The load flags are updated by looking for code libraries in the directories
 310 # to search and by adding all of the code libraries that are used.
 311 LOAD_FLAG_PREFIX += $(LIBRARY_SEARCH_PATH:%=$(LIBRARY_PATH_FLAG)%)
 312 ifeq "$(OP_SYSTEM)" "UNIX"
 313   ifneq "$(COMPILER)" "GNU_DARWIN"
 314     LOAD_FLAG_PREFIX += -Xlinker --start-group
 315     LOAD_FLAG_SUFFIX += -Xlinker --end-group
 316   endif
 317 endif
 318 # had to switch from prefix to suffix recently.  oddity.
 319 #LOAD_FLAG_PREFIX += $(LIBS_USED:%=$(LIBRARY_NAME_FLAG)%)
 320 LOAD_FLAG_SUFFIX += $(LIBS_USED:%=$(LIBRARY_NAME_FLAG)%)
 321
 322 # we steal the exe targets and represent their dependency from the hidden
 323 # cpp for the exe.
 324 EXE_TEMP_0 = $(TARGETS:%.dll=)
 325 EXE_TEMP_1 = $(EXE_TEMP_0:%.so=)
 326 EXE_TEMP_2 = $(EXE_TEMP_1:%.lib=)
 327 EXE_TEMP_3 = $(EXE_TEMP_2:%.elf=%.cpp)
 328 EXE_CPPS   = $(EXE_TEMP_3:%.exe=%.cpp)
 329
 330 # used for compiling multiple source files at the same time with visual cpp.
 331 MULTI_BUILD_CMD = $(CC) $(COMPILER_FLAGS) -c `cat $(BUILD_LIST_FILE)` $(OBJECT_NAME_FLAG)$(OBJECT_DIR)/
 332
 333 # prepare for mfc style DLLs.  currently we plan on all dlls we create being
 334 # based on MFC.  this is an unfortunate requirement for using the mfc debug
 335 # support for allocations; if regular new and DEBUG_NEW get mixed together,
 336 # crashes used to result.  supposedly these are gone now at least.
 337 ifneq "$(USE_MFC)" ""
 338 #  ifeq "$(OP_SYSTEM)" "WIN32"
 339   ifeq "$(COMPILER)" "VISUAL_CPP"
 340     # set the flag that says we are doing mfc extension dlls.
 341     DEFINITIONS += _AFXDLL
 342     DEPENDENCY_DEFINITIONS += _MT _DLL
 343     DEPENDENCY_DEFINITIONS += __AFXWIN_H__  # add this flag to shut stdafx up.
 344   endif
 345 endif
 346
 347 ifeq "$(OMIT_VERSIONS)" ""
 348   ifneq "$(VERSION_RC_ROOT)" ""
 349     VERSION_TARGET = $(VERSION_RC_ROOT)_version.rc
 350   endif
 351 endif
 352
 353 # if we are cleaning up, then do not generate dependency file.
 354 ifeq "$(CLEAN)" ""
 355   ifneq "$(GENDEPS)" ""
 356     EXTRA_FIRST_TARGETS += gendeps
 357   endif
 358
 359 # only do the deps generation for makefiles that are properly marked.
 360 ifneq "$(findstring __BUILD_STATIC_APPLICATION__, $(DEFINITIONS))" ""
 361   # generate static build dependencies for all targets in the makefile.
 362   GENERATED_DEPS_LIST = $(TARGETS:%.exe=%.gendeps)
 363 else
 364   GENERATED_DEPS_LIST =
 365 endif
 366
 367 endif
 368
 369 # Make sure that the directory for objects exists.
 370 ACTUAL_FIRST_TARGETS = check_requirements $(EXTRA_FIRST_TARGETS) $(VERSION_TARGET) $(FIRST_TARGETS) pre_compilation
 371
 372 # Adds the primary targets to the list of products to create.
 373 #ifeq "$(NO_COMPILE)" ""
 374
 375   ifneq "$(COMPILER)" "VISUAL_CPP"
 376     ACTUAL_TARGETS1 = $(TARGETS:%.exe=$(EXECUTABLE_DIR)/%)
 377   else
 378     ACTUAL_TARGETS1 = $(TARGETS:%.exe=$(EXECUTABLE_DIR)/%.exe)
 379   endif
 380
 381   ifneq "$(COMPILER)" "VISUAL_CPP"
 382     ACTUAL_TARGETS2 = $(ACTUAL_TARGETS1:%.dll=%.so)
 383     ACTUAL_TARGETS3 = $(ACTUAL_TARGETS2:%.so=$(DYNAMIC_LIBRARY_DIR)/%$(TRIPART_VERSION).so)
 384   else
 385     ACTUAL_TARGETS2 = $(ACTUAL_TARGETS1:%.so=%.dll)
 386     ACTUAL_TARGETS3 = $(ACTUAL_TARGETS2:%.dll=$(DYNAMIC_LIBRARY_DIR)/%$(TRIPART_VERSION).dll)
 387   endif
 388
 389   ACTUAL_TARGETS4 = $(ACTUAL_TARGETS3:%.lib=$(STATIC_LIBRARY_DIR)/%$(TRIPART_VERSION).library)
 390   ACTUAL_TARGETS = $(ACTUAL_TARGETS4:%.elf=$(EXECUTABLE_DIR)/%.elf)
 391
 392 #else #is no_compile
 393 #  ACTUAL_TARGETS1 = $(TARGETS:%.exe=)
 394 #  ACTUAL_TARGETS2 = $(ACTUAL_TARGETS1:%.dll=)
 395 #  ACTUAL_TARGETS3 = $(ACTUAL_TARGETS2:%.so=)
 396 #  ACTUAL_TARGETS4 = $(ACTUAL_TARGETS3:%.lib=)
 397 #  ACTUAL_TARGETS = $(ACTUAL_TARGETS4:%.elf=)
 398 #endif
 399
 400 # Adds the last few targets for CLAM to do.
 401 ACTUAL_LAST_TARGETS = post_compilation $(LAST_TARGETS)
 402
 403 ############################################################################
 404
 405 # This section defines the rules used to generate various objects from their
 406 # source files.
 407
 408 ############################################################################
 409
 410 # The first section provides simplistic pseudo-targets for testing compilation
 411 # rather than generating built products.
 412
 413 # the blank target is used to (somewhat) safely remove items from the SOURCE
 414 # list.  it is an empty file that should be able to go in a library archive
 415 # without hosing it up.
 416 %.nil:
 417 ifeq "$(NO_COMPILE)" ""
 418         $(CATCHER)$(CC) -c $(CLAM_DIR)/cpp/blank_target.c -o $@
 419 endif
 420
 421 %.bad:
 422         @echo There is a problem with the makefile in the SOURCE variable.
 423         @echo The offending item is: $@
 424         $(HIDESH)$(CLAM_DIR)/exit_make.sh
 425
 426 ## faked debug object.
 427 #%.obj: %.cpp
 428 #ifeq "$(NO_COMPILE)" ""
 429 #       @echo Bogus [$@].
 430 #       $(CATCHER)$(CC) $(COMPILER_FLAGS) -c $< $(OBJECT_NAME_FLAG)$(TEMP)/$@
 431 #endif
 432
 433 ifeq "$(CLEAN)" ""
 434 # recreate dependencies for static applications.
 435 %.gendeps: %.cpp
 436         @echo "Generating Static Deps: $*.cpp"
 437         $(CATCHER)$(CLAM_DIR)/cpp/buildor_gen_deps.sh "$*.cpp"
 438 endif
 439
 440 ############################################################################
 441
 442 # trying to delay loading this as long as possible so the built in rule system for CLEANUPS can run with the right values.
 443 # so far not working right!
 444 #hmmm: fix this.
 445
 446 # Adds the main CLAM system in to get some work done.  This should be placed
 447 # after the module's rules are defined and before the module's targets are
 448 # defined.
 449 include rules.def
 450
 451 ############################################################################
 452
 453 # C++ source to object file translation.
 454 # if there is a special set of flags for this source file, we use them
 455 # instead of the default compiler flags.
 456
 457 $(OBJECT_DIR)/%.obj: $(CURRENT_DIR)/%.cpp
 458 ifeq "$(NO_COMPILE)" ""
 459   ifneq "$(COMPILER)" "VISUAL_CPP"
 460         @echo Compiling Object [$(notdir $@)]
 461         $(HIDESH)-c 'if [ ! -d $(@D) ]; then mkdir $(@D); fi'
 462         $(CATCHER)$(CC) $(COMPILER_FLAGS) -c $< $(OBJECT_NAME_FLAG)$@
 463   else
 464         @echo $< >>$(BUILD_LIST_FILE)
 465         @echo $@ >>$(BUILD_WHACK_FILE)
 466         @echo >$@
 467   endif
 468 endif
 469
 470 ############################################################################
 471
 472 # C source to object file translation.
 473
 474 $(OBJECT_DIR)/%.obj: $(CURRENT_DIR)/%.c
 475 ifeq "$(NO_COMPILE)" ""
 476   ifneq "$(COMPILER)" "VISUAL_CPP"
 477         @echo Compiling Object [$(notdir $@)]
 478         $(HIDESH)-c 'if [ ! -d $(@D) ]; then mkdir $(@D); fi'
 479         $(CATCHER)$(CC) $(COMPILER_FLAGS) -c $< $(OBJECT_NAME_FLAG)$@
 480   else
 481         @echo $< >>$(BUILD_LIST_FILE)
 482         @echo $@ >>$(BUILD_WHACK_FILE)
 483         @echo >$@
 484   endif
 485 endif
 486
 487 ############################################################################
 488
 489 # resource compiler for win32.
 490
 491 ifeq "$(COMPILER)" "VISUAL_CPP"
 492 $(OBJECT_DIR)/%.res: %.rc $(PARAMETER_FILE)
 493   ifeq "$(NO_COMPILE)" ""
 494         @echo Resource [$@]
 495         $(HIDESH)-c 'if [ ! -d $(@D) ]; then mkdir $(@D); fi'
 496         $(CATCHER)$(RC) -r $(DEFINITIONS:%=-D%) $(HEADER_SEARCH_PATH:%=-i%) -fo $@ $<
 497   endif
 498
 499 $(OBJECT_DIR)/%.resources: %.resx $(PARAMETER_FILE)
 500   ifeq "$(NO_COMPILE)" ""
 501         @echo Resource [$@]
 502         $(HIDESH)-c 'if [ ! -d $(@D) ]; then mkdir $(@D); fi'
 503         $(VCS_ROOT)/../SDK/v1.1/bin/resgen $< $@
 504   endif
 505 else #non-visual studio
 506   # this platform probably does not use rc files.
 507 $(OBJECT_DIR)/%.res: %.rc
 508   ifeq "$(NO_COMPILE)" ""
 509         @echo Bogus resource [$@]
 510         @echo >$@
 511   endif
 512 endif #win32
 513
 514 ############################################################################
 515
 516 # creates static libraries.
 517 ifneq "$(NO_COMPILE)" ""
 518 $(STATIC_LIBRARY_DIR)/%.library:
 519 endif
 520
 521 ifeq "$(NO_COMPILE)" ""
 522 $(STATIC_LIBRARY_DIR)/%.library: $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_LOCAL_LIBS:%=$(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)%$(LIB_ENDING)) $(PARAMETER_FILE)
 523         $(HIDER)echo Building Static Library [$(notdir $@)]
 524         @echo $@ >$(DIRTY_FILE)
 525   ifeq "$(COMPILER)" "VISUAL_CPP"
 526         $(HIDESH)-c 'if [ -f $(BUILD_LIST_FILE) ]; then $(SHELL) $(CLAM_DIR)/cpp/rebuild_oldies.sh $(MULTI_BUILD_CMD); fi'
 527   endif
 528         $(CATCHER)$(LIBRARY_TOOL) $(LIBRARIAN_FLAGS) $(CREATE_LIBRARY_FLAG)$@ $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%)
 529   ifneq "$(OP_SYSTEM)" "UNIX"
 530         $(HIDER)mv $@ $(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)$*$(LIB_ENDING)
 531         $(HIDER)echo nil >$@
 532   else
 533         $(HIDER)ranlib $@
 534         $(HIDER)rm -f $(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)$*$(LIB_ENDING)
 535         $(HIDER)ln -s $@ $(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)$*$(LIB_ENDING)
 536   endif
 537 endif #no_compile
 538
 539 ############################################################################
 540
 541 # creates dynamic libraries.
 542
 543 # we whack any existing LIB file, since we want to use changes in that file
 544 # as a clue for when we should rescan the dependencies.  we'd be fine if
 545 # visual c++ didn't keep an existing LIB if it doesn't change (even when the
 546 # DLL does).
 547
 548 ifneq "$(NO_COMPILE)" ""
 549 $(DYNAMIC_LIBRARY_DIR)/%.dll:
 550 endif
 551
 552 ifeq "$(NO_COMPILE)" ""
 553 $(DYNAMIC_LIBRARY_DIR)/%.dll: $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_LOCAL_LIBS:%=$(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)%$(LIB_ENDING)) $(ACTUAL_RESX) $(PARAMETER_FILE)
 554 #hmmm: use the res objects variable to rebuild res files as needed.
 555 ###$(RES_OBJECTS)
 556         $(HIDER)echo Building Dynamic Library [$(notdir $@)]
 557         @echo $@ >$(DIRTY_FILE)
 558   ifeq "$(COMPILER)" "VISUAL_CPP"
 559         $(HIDESH)-c 'if [ -f $(BUILD_LIST_FILE) ]; then $(SHELL) $(CLAM_DIR)/cpp/rebuild_oldies.sh $(MULTI_BUILD_CMD); fi'
 560   endif
 561         $(HIDER)rm -f $(@:%.dll=%.lib)
 562         echo about to run link tool.
 563         $(CATCHER)$(LINK_TOOL) $(LINKER_OUTPUT_FLAG)$@ -dll $(LOAD_FLAG_PREFIX) $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_RESX_FLAGS) $(ACTUAL_LOCAL_LIBS:%=$(LIBRARY_NAME_FLAG)$(LIB_PREFIX)%$(LIB_ENDING)) $(LOAD_FLAG_SUFFIX)
 564         echo ran link tool.
 565   ifeq "$(COMPILER_VERSION)" "8"
 566         $(HIDESH)$(CLAM_DIR)/cpp/ms_manifest.sh "$@" "2"
 567   endif
 568   ifeq "$(COMPILER_VERSION)" "10"
 569         $(HIDESH)$(CLAM_DIR)/cpp/ms_manifest.sh "$@" "2"
 570   endif
 571   ifneq "$(VCPP_VISTA_ICON)" ""
 572         $(HIDER)ReplaceVistaIcon "$@" "$(VCPP_VISTA_ICON)"
 573   endif
 574 endif #no_compile
 575
 576 ifneq "$(NO_COMPILE)" ""
 577 $(DYNAMIC_LIBRARY_DIR)/%.so:
 578 endif
 579
 580 ifeq "$(NO_COMPILE)" ""
 581 $(DYNAMIC_LIBRARY_DIR)/%.so: $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_LOCAL_LIBS:%=$(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)%$(LIB_ENDING)) $(PARAMETER_FILE)
 582   ifeq "$(COMPILER:%_LINUX=LINUX)" "LINUX"
 583         $(HIDER)echo Shared [$@]
 584         @echo $@ >$(DIRTY_FILE)
 585         $(CATCHER)$(LINK_TOOL) $(LINKER_OUTPUT_FLAG)$@ $(LOAD_FLAG_PREFIX) -shared -Wl,-soname,$*.so $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_LOCAL_LIBS:%=$(LIBRARY_NAME_FLAG)%) $(LOAD_FLAG_SUFFIX)
 586         $(HIDER)rm -f $(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)$*$(LIB_ENDING)
 587         $(HIDER)ln -s $@ $(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)$*$(LIB_ENDING)
 588   endif
 589 endif #no_compile
 590
 591 ############################################################################
 592
 593 # creates "exe" executables using all of the appropriate objects.
 594
 595 ifeq "$(COMPILER)" "VISUAL_CPP"
 596   ifneq "$(NO_COMPILE)" ""
 597 $(EXECUTABLE_DIR)/%.exe:
 598   endif
 599
 600   ifeq "$(NO_COMPILE)" ""
 601 $(EXECUTABLE_DIR)/%.exe: $(OBJECT_DIR)/%.obj $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_LOCAL_LIBS:%=$(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)%$(LIB_ENDING)) $(ACTUAL_RESX) $(PARAMETER_FILE)
 602         $(HIDER)echo Building Application [$(notdir $@)]
 603         @echo $@ >$(DIRTY_FILE)
 604     ifeq "$(COMPILER)" "VISUAL_CPP"
 605         $(HIDESH)-c 'if [ -f $(BUILD_LIST_FILE) ]; then $(SHELL) $(CLAM_DIR)/cpp/rebuild_oldies.sh $(MULTI_BUILD_CMD); fi'
 606     endif
 607         $(CATCHER)$(LINK_TOOL) $(EXE_FLAGS) $(LOAD_FLAG_PREFIX) $< $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_RESX_FLAGS) $(ACTUAL_LOCAL_LIBS:%=$(LIBRARY_NAME_FLAG)$(LIB_PREFIX)%$(LIB_ENDING)) $(LOAD_FLAG_SUFFIX) $(LINKER_OUTPUT_FLAG)$@
 608 #$(^:force_rebuild=)
 609     ifeq "$(COMPILER_VERSION)" "8"
 610         $(HIDESH)$(CLAM_DIR)/cpp/ms_manifest.sh "$@" "1"
 611     endif
 612     ifeq "$(COMPILER_VERSION)" "10"
 613         $(HIDESH)$(CLAM_DIR)/cpp/ms_manifest.sh "$@" "1"
 614     endif
 615     ifneq "$(VCPP_VISTA_ICON)" ""
 616         $(HIDER)ReplaceVistaIcon "$@" "$(VCPP_VISTA_ICON)"
 617     endif
 618   endif #no_compile
 619 endif #visual studio
 620
 621 ifneq "$(COMPILER)" "VISUAL_CPP"
 622   ifneq "$(NO_COMPILE)" ""
 623 $(EXECUTABLE_DIR)/%:
 624   endif
 625
 626   ifeq "$(NO_COMPILE)" ""
 627 $(EXECUTABLE_DIR)/%: $(OBJECT_DIR)/%.obj $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_LOCAL_LIBS:%=$(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)%$(LIB_ENDING)) $(PARAMETER_FILE)
 628         $(HIDER)echo Building Application [$(notdir $@)]
 629         @echo $@ >$(DIRTY_FILE)
 630         $(CATCHER)$(LINK_TOOL) $(EXE_FLAGS) $(LOAD_FLAG_PREFIX) $< $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_LOCAL_LIBS:%=$(LIBRARY_NAME_FLAG)%) $(LOAD_FLAG_SUFFIX) $(LINKER_OUTPUT_FLAG)$@
 631 #hmmm: experimental item below.
 632 #$(^:force_rebuild=)
 633   endif #no_compile
 634 endif #unix
 635
 636 ############################################################################
 637
 638 # creates firmware "elf" executables with the proper objects.
 639
 640 ifneq "$(NO_COMPILE)" ""
 641 $(EXECUTABLE_DIR)/%.elf:
 642 endif
 643
 644 ifeq "$(NO_COMPILE)" ""
 645 $(EXECUTABLE_DIR)/%.elf: $(OBJECT_DIR)/%.obj $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_LOCAL_LIBS:%=$(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)%$(LIB_ENDING)) $(PARAMETER_FILE)
 646         $(HIDER)echo Building Application [$(notdir $@)]
 647         @echo $@ >$(DIRTY_FILE)
 648         $(CATCHER)$(LINK_TOOL) $(MAP) $(LOAD_FLAG_PREFIX) $< $(LINKER_COMMAND_FILE) $(STARTUP_OBJECT_FILE) $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_LOCAL_LIBS:%=$(LIBRARY_NAME_FLAG)%) $(LOAD_FLAG_SUFFIX) $(LINKER_OUTPUT_FLAG)$@
 649 #$(^:force_rebuild=)
 650         @echo Hex [$(EXECUTABLE_DIR)/$*.out]
 651         $(CATCHER)$(DDUMP_TOOL) $(DDUMP_OPTIONS) $@ -o$(EXECUTABLE_DIR)/$*.out
 652         @echo Binary [$(EXECUTABLE_DIR)/$*.bin]
 653         $(CATCHER)$(DDUMP_TOOL) $(DDUMP_BIN_OPTIONS) $@ -o$(EXECUTABLE_DIR)/$*.bin
 654 endif #no_compile
 655
 656 ############################################################################
 657
 658 # handles creating version resource files if this project has a version.ini.
 659
 660 ifeq "$(OMIT_VERSIONS)" ""
 661   ifneq "$(VERSION_RC_ROOT)" ""
 662 # only redo the version resource if it or version.ini is out of date.
 663 %_version.rc: version.ini $(PARAMETER_FILE)
 664         $(CATCHER)$(CLAM_BINARY_DIR)/version_stamper$(EXE_END) . $(PARAMETER_FILE)
 665   endif
 666 endif
 667
 668 ############################################################################
 669
 670 # Now the active part of the make process...
 671
 672 # make sure we really want to include the dependencies file.
 673 ifeq "$(TYPE)" "hierarchy"
 674   # no dependencies for a simple hierarchy builder.
 675   NO_DEPS = t
 676 endif
 677 ifneq "$(CLEAN)" ""
 678   NO_DEPS = t
 679   # no dependencies get left when we are cleaning up.
 680 #  $(shell rm -f $(DEPS_FILE))
 681 endif
 682 ifneq "$(NO_COMPILE)" ""
 683   # non compiling projects do not need dependencies.
 684   NO_DEPS = t
 685 endif
 686 ifneq "$(REBUILD)" ""
 687   NO_DEPS = t
 688   # if we are rebuilding everything, we zap the deps file.
 689   $(shell rm -f $(DEPS_FILE))
 690 endif
 691
 692 # preserves intermediate files from being deleted.
 693 ifeq "$(CLEAN)" ""
 694 .PRECIOUS: $(OBJECT_DIR)/%.obj $(OBJECT_DIR)/%.res $(OBJECT_DIR)/%.resources $(OBJECT_DIR)/%.deps
 695 #hmmm: added above deps.  maybe not right.
 696 endif
 697
 698 # zaps things when they could not be created correctly.
 699 ####.DELETE_ON_ERROR:
 700
 701 ############################################################################
 702
 703 # autodependency file creator.  See the make_dep man page for more info.
 704
 705 # we do the auto-dependencies unless the disabling flag is set.
 706 ifneq "$(NO_DEPS)" ""
 707     # makes the dependencies a no-op.
 708     deps: $(PARAMETER_FILE)
 709
 710     $(DEPS_FILE): $(PARAMETER_FILE)
 711
 712 else
 713   ifeq "$(CLEAN)" ""
 714   deps: $(DEPS_FILE)
 715
 716   # this causes the dependency file to be regenerated if the sources or libs
 717   # have changed.  we have to touch the deps file in case it's missing;
 718   # makedep doesn't deal well with that.  also, we touch the dirty flag file
 719   # to ensure that the fact we redid dependencies for some reason causes us
 720   # to re-promote.  we only bother with any of this if we know we're going
 721   # to really do some compilation; if in non-compile mode, we'll skip it.
 722   ifneq "$(NO_COMPILE)" ""
 723     # no dependencies in non-compile mode.
 724     $(DEPS_FILE):
 725
 726   else
 727     ifeq "$(LAX_DEPENDENCIES)" ""
 728       $(DEPS_FILE): $(SOURCE) $(ACTUAL_LOCAL_LIBS:%=$(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)%$(LIB_ENDING)) $(wildcard *.h) $(EXE_CPPS)
 729     else  # lax dependencies means create if missing or if parm file changed.
 730       $(DEPS_FILE): $(PARAMETER_FILE)
 731     endif # !lax dependencies.
 732     ifneq "$(VERSION_RC_ROOT)" ""
 733       ifeq "$(OMIT_VERSIONS)" ""
 734         $(DEPS_FILE): $(VERSION_RC_ROOT)_version.rc
 735       endif
 736     endif
 737         @echo Dependencies [$(notdir $@)]
 738         -$(HIDESH)$(CLAM_DIR)/cpp/preconditions.sh
 739         @touch $@
 740 #       @echo dep adds: $(DEPENDENCY_ADDITIONS)
 741         @$(CLAM_BINARY_DIR)/makedep$(EXE_END) $(DEPENDENCY_DEFINITIONS:%=-D%) $(DEPENDENCY_ADDITIONS) -f$@ -o.obj -p$(OBJECT_DIR)/ -w 420 $(COMPILER_HEADER_DIR:%=-X%) $(THIRD_PARTY_DIR:%=-X%) -- $(COMPILER_FLAGS) $(SOURCE) $(EXE_CPPS)
 742 #       $(CATCHER)$(CLAM_BINARY_DIR)/makedep$(EXE_END) $(DEPENDENCY_DEFINITIONS:%=-D%) $(DEPENDENCY_ADDITIONS) -f$@ -o.obj -p$(OBJECT_DIR)/ -w 420 $(COMPILER_HEADER_DIR:%=-X%) $(THIRD_PARTY_DIR:%=-X%) -- $(COMPILER_FLAGS) $(SOURCE) $(EXE_CPPS)
 743         @echo $@ >$(SUBMAKE_FLAG)
 744   endif # non-compile.
 745  else # cleaning.
 746     # makes the dependencies a no-op for cleaning.
 747     deps: $(PARAMETER_FILE)
 748
 749     $(DEPS_FILE): $(PARAMETER_FILE)
 750  endif
 751 endif # no-deps.
 752
 753 ############################################################################
 754
 755 # examines the required variables and complains if they're missing.
 756 check_requirements:
 757         $(HIDESH) -c 'if [ -z "$(PROJECT)" ]; then echo the PROJECT variable is not defined!; . $(CLAM_DIR)/exit_make.sh; fi'
 758         $(HIDESH) -c 'if [ -z "$(TYPE)" ]; then echo the TYPE variable is not defined!; . $(CLAM_DIR)/exit_make.sh; fi'
 759
 760 ############################################################################
 761
 762 # includes the auto-dependency information.  the dependency file is checked
 763 # for being up-to-date.  if not, it gets rebuilt and the make is restarted.
 764 ifeq "$(CLEAN)" ""
 765   ifeq "$(NO_DEPS)" ""
 766
 767     # thank the buddha for this bit of code, or at least thank this page:
 768     # http://stackoverflow.com/questions/5553352/how-do-i-check-if-file-exists-in-makefile
 769     ifneq ("$(wildcard $(DEPS_FILE))","")
 770       include $(DEPS_FILE)
 771     endif
 772
 773   endif
 774 endif
 775
 776 ############################################################################
 777
 778 # calls the script for preparing output directories and such.
 779 pre_compilation:
 780         $(HIDESH)$(CLAM_DIR)/cpp/preconditions.sh
 781
 782 ############################################################################
 783
 784 # calls the script for copying the final products to the library directory.
 785 # we don't bother reporting errors from touch since there will sometimes
 786 # not be any objects in the final directory.
 787 post_compilation:
 788         $(HIDESH)$(CLAM_DIR)/cpp/postconditions.sh
 789
 790 ############################################################################
 791
 792 # if REBUILD is defined, then we cause all objects to be recompiled.
 793 .PHONY: force_rebuild
 794 force_rebuild:
 795
 796 ifneq "$(REBUILD)" ""
 797   # the target below needs the blank rule that it has for this to work.
 798   $(FIRST_TARGETS) $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_TARGETS) $(EXE_CPPS:%.cpp=$(OBJECT_DIR)/%.obj) $(LAST_TARGETS): force_rebuild
 799 endif
 800
 801 ############################################################################
 802
 803 # generate dependencies for any static targets if requested.
 804 gendeps: $(GENERATED_DEPS_LIST)
 805
 806 ############################################################################
 807