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 Makefile after the variables
   9 # have been initialized appropriately for the particular project being
  10 # compiled.  The user 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 #hmmm: 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   # finds the crypto code on macos.
 108   HEADER_SEARCH_PATH += /usr/local/opt/openssl/include
 109   LIBRARY_SEARCH_PATH += /usr/local/opt/openssl/lib/
 110
 111   ifneq "$(USE_XWIN)" ""
 112     DEFINITIONS += __XWINDOWS__ __X__
 113     LIBS_USED +=
 114 #Xm Xt X11 Xft Xp
 115 #need to separate out with a USE_MOTIF kind of thing.
 116 #LIBS_USED += Xmu
 117     HEADER_SEARCH_PATH += /usr/include/X11 /usr/X11R6/include /usr/include/g++
 118     LIBRARY_SEARCH_PATH += /usr/X11R6/lib
 119   endif
 120
 121   ifneq "$(USE_SSL)" ""
 122     LIBS_USED += crypto ssl
 123   endif
 124
 125   ifneq "$(USE_WXWIDGETS)" ""
 126     DEFINITIONS += __WXWIDGETS__
 127     use_unicode =
 128     ifneq "$(findstring UNICODE, $(DEFINITIONS))" ""
 129         use_unicode = true
 130     endif
 131
 132     # decide whether to turn on the unicode flag or not.
 133 ###    ifneq "$(findstring UNICODE, $(DEFINITIONS))" ""
 134     ifneq "$(use_unicode)" ""
 135       UNICODE_FLAG_ADD = --unicode=yes
 136       DEFINITIONS += wxUSE_UNICODE
 137     else
 138       UNICODE_FLAG_ADD = --unicode=no
 139     endif
 140
 141     COMPILER_FLAGS += $(shell wx-config --cxxflags $(UNICODE_FLAG_ADD) )
 142     LOAD_FLAG_PREFIX += $(shell wx-config --libs $(UNICODE_FLAG_ADD) )
 143   endif
 144
 145   ifneq "$(USE_CURL)" ""
 146     COMPILER_FLAGS += `curl-config --cflags`
 147     LOAD_FLAG_SUFFIX += `curl-config --libs`
 148   endif
 149
 150 endif
 151
 152 ###############################################################################
 153
 154 # Create the real list of local libraries needed.
 155 TEMP_LOC1 = $(LOCAL_LIBS_USED:%=%$(TRIPART_VERSION))
 156 ACTUAL_LOCAL_LIBS = $(TEMP_LOC1)
 157
 158 # Create the list of objects from the list of source files.
 159 TEMP_OBJ1 = $(SOURCE:%.cpp=%.obj)
 160 TEMP_OBJ2 = $(TEMP_OBJ1:%.c=%.obj)
 161
 162 # replace this when supporting resource files on unix.
 163 TEMP_OBJ3 = $(TEMP_OBJ2:%.rc=)
 164
 165 TEMP_OBJ4 = $(TEMP_OBJ3:%.h=%.bad)
 166 OBJECTS = $(TEMP_OBJ4)
 167
 168 # special case for multi-build and res files that need to be rebuilt.
 169 #RES_OBJECTS_0 = $(SOURCE:%.cpp=)
 170 #RES_OBJECTS_1 = $(RES_OBJECTS_0:%.c=)
 171 #RES_OBJECTS = $(RES_OBJECTS_1:%.rc=$(OBJECT_DIR)/%.res)
 172
 173 # not much conversion anymore...
 174 ACTUAL_OBJECTS = $(OBJECTS) $(EXTRA_OBJECTS)
 175
 176 # Updates the search path for the compiler and local libraries.
 177 BASE_HEADER_PATH = $(CODEBASE_HEADERS) $(LOCAL_HEADERS) $(HOOPLE_HEADERS) $(SEARCH_DIRS)
 178 HEADER_SEARCH_PATH += $(BASE_HEADER_PATH) $(COMPILER_HEADER_DIR)
 179
 180 LIBRARY_SEARCH_PATH += $(LOCAL_LIBRARIES) $(HOOPLE_LIBRARIES) \
 181   $(STATIC_LIBRARY_DIR) $(COMPILER_LIBRARY_DIR) $(SEARCH_DIRS)
 182
 183 # Adds some directories that must be searched onto the search path for
 184 # header files, such as the header file directory for the compiler.
 185 COMPILER_FLAGS += $(HEADER_SEARCH_PATH:%=-I%) $(DEFINITIONS:%=-D%) $(UNDEFINITIONS:%=-U%) -DGLOBAL_PRODUCT_NAME="$(GLOBAL_PRODUCT_NAME)"
 186
 187 # The load flags are updated by looking for code libraries in the directories
 188 # to search and by adding all of the code libraries that are used.
 189 LOAD_FLAG_PREFIX += $(LIBRARY_SEARCH_PATH:%=$(LIBRARY_PATH_FLAG)%)
 190 ifeq "$(OP_SYSTEM)" "UNIX"
 191   ifneq "$(COMPILER)" "GNU_DARWIN"
 192     LOAD_FLAG_PREFIX += -Xlinker --start-group
 193     LOAD_FLAG_SUFFIX += -Xlinker --end-group
 194   endif
 195 endif
 196 # had to switch from prefix to suffix recently.  oddity.
 197 #LOAD_FLAG_PREFIX += $(LIBS_USED:%=$(LIBRARY_NAME_FLAG)%)
 198 LOAD_FLAG_SUFFIX += $(LIBS_USED:%=$(LIBRARY_NAME_FLAG)%)
 199
 200 # we steal the exe targets and represent their dependency from the hidden
 201 # cpp for the exe.
 202 EXE_TEMP_0 = $(TARGETS:%.dll=)
 203 EXE_TEMP_1 = $(EXE_TEMP_0:%.so=)
 204 EXE_TEMP_2 = $(EXE_TEMP_1:%.lib=)
 205 EXE_TEMP_3 = $(EXE_TEMP_2:%.elf=%.cpp)
 206 EXE_CPPS   = $(EXE_TEMP_3:%.exe=%.cpp)
 207
 208 # used for compiling multiple source files at the same time with visual cpp.
 209 MULTI_BUILD_CMD = $(CC) $(COMPILER_FLAGS) -c `cat $(BUILD_LIST_FILE)` $(OBJECT_NAME_FLAG)$(OBJECT_DIR)/
 210
 211 ifeq "$(OMIT_VERSIONS)" ""
 212   ifneq "$(VERSION_RC_ROOT)" ""
 213     VERSION_TARGET = $(VERSION_RC_ROOT)_version.rc
 214   endif
 215 endif
 216
 217 # if we are cleaning up, then do not generate dependency file.
 218 ifeq "$(CLEAN)" ""
 219   ifneq "$(GENDEPS)" ""
 220     EXTRA_FIRST_TARGETS += gendeps
 221   endif
 222
 223 # only do the deps generation for makefiles that are properly marked.
 224 ifneq "$(findstring __BUILD_STATIC_APPLICATION__, $(DEFINITIONS))" ""
 225   # generate static build dependencies for all targets in the makefile.
 226   GENERATED_DEPS_LIST = $(TARGETS:%.exe=%.gendeps)
 227 else
 228   GENERATED_DEPS_LIST =
 229 endif
 230
 231 endif
 232
 233 # Make sure that the directory for objects exists.
 234 ACTUAL_FIRST_TARGETS = check_requirements $(EXTRA_FIRST_TARGETS) $(VERSION_TARGET) $(FIRST_TARGETS) pre_compilation
 235
 236 # Adds the primary targets to the list of products to create.
 237 ACTUAL_TARGETS1 = $(TARGETS:%.exe=$(EXECUTABLE_DIR)/%)
 238 ACTUAL_TARGETS2 = $(ACTUAL_TARGETS1:%.dll=%.so)
 239 ACTUAL_TARGETS3 = $(ACTUAL_TARGETS2:%.so=$(DYNAMIC_LIBRARY_DIR)/%$(TRIPART_VERSION).so)
 240 ACTUAL_TARGETS4 = $(ACTUAL_TARGETS3:%.lib=$(STATIC_LIBRARY_DIR)/%$(TRIPART_VERSION).library)
 241 ACTUAL_TARGETS = $(ACTUAL_TARGETS4:%.elf=$(EXECUTABLE_DIR)/%.elf)
 242
 243 # Adds the last few targets that CLAM works on.
 244 ACTUAL_LAST_TARGETS = post_compilation $(LAST_TARGETS)
 245
 246 ############################################################################
 247
 248 # This section defines the rules used to generate various objects from their
 249 # source files.
 250
 251 ############################################################################
 252
 253 # The first section provides simplistic pseudo-targets for testing compilation
 254 # rather than generating built products.
 255
 256 # the blank target is used to (somewhat) safely remove items from the SOURCE
 257 # list.  it is an empty file that should be able to go in a library archive
 258 # without hosing it up.
 259 %.nil:
 260 ifeq "$(NO_COMPILE)" ""
 261         $(CATCHER)$(CC) -c $(CLAM_SCRIPTS)/cpp/blank_target.c -o $@
 262 endif
 263
 264 %.bad:
 265         @echo There is a problem with the makefile in the SOURCE variable.
 266         @echo The offending item is: $@
 267         $(HIDESH)$(CLAM_SCRIPTS)/exit_make.sh
 268
 269 ## faked debug object.
 270 #%.obj: %.cpp
 271 #ifeq "$(NO_COMPILE)" ""
 272 #       @echo Bogus [$@].
 273 #       $(CATCHER)$(CC) $(COMPILER_FLAGS) -c $< $(OBJECT_NAME_FLAG)$(TEMP)/$@
 274 #endif
 275
 276 ifeq "$(CLEAN)" ""
 277 # recreate dependencies for static applications.
 278 %.gendeps: %.cpp
 279         @echo "Generating Static Deps: $*.cpp"
 280         $(CATCHER)$(CLAM_SCRIPTS)/cpp/buildor_gen_deps.sh "$*.cpp"
 281 endif
 282
 283 ############################################################################
 284
 285 # trying to delay loading this as long as possible so the built in rule system for CLEANUPS can run with the right values.
 286 # so far not working right!
 287 #hmmm: fix this.
 288
 289 # Adds the main CLAM system in to get some work done.  This should be placed
 290 # after the module rules are defined and before the module targets are
 291 # defined.
 292 include rules.def
 293
 294 ############################################################################
 295
 296 # this adds in a customization for the cleanup variables, since the base
 297 # clam code has no idea about a dynamic library directory.
 298
 299 cpp_add_to_cleanups_variable:
 300 #       echo here is actual targets before hand $(ACTUAL_TARGETS)
 301         $(eval CLEANUPS = $(ACTUAL_TARGETS:%.exe=%) $(ACTUAL_TARGETS:$(STATIC_LIBRARY_DIR)/%.library=$(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)%.a) $(CLEANUPS) )
 302 #       echo "IN CPP, new CLEANUPS variable: $(CLEANUPS)"
 303 #fodder for anything missing a cleanup.
 304 #       $(eval CLEANUPS = $(ACTUAL_TARGETS) $(ACTUAL_TARGETS:%.dll=%.so) $(ACTUAL_TARGETS:%.so=%.dll) $(CLEANUPS) )
 305
 306 #dynamic is taken care of in clam base still?
 307 #DYNAMIC_LIBRARY_DIR
 308 #hmmm: still should change there in the base and do it
 309 # here instead.
 310
 311 ############################################################################
 312
 313 # C++ source to object file translation.
 314 # if there is a special set of flags for this source file, we use them
 315 # instead of the default compiler flags.
 316
 317 $(OBJECT_DIR)/%.obj: $(CURRENT_DIR)/%.cpp
 318 ifeq "$(NO_COMPILE)" ""
 319         @echo Compiling Object [$(notdir $@)]
 320         $(HIDESH)-c 'if [ ! -d $(@D) ]; then mkdir $(@D); fi'
 321         $(CATCHER)$(CC) $(COMPILER_FLAGS) -c $< $(OBJECT_NAME_FLAG)$@
 322 endif
 323
 324 ############################################################################
 325
 326 # C source to object file translation.
 327
 328 $(OBJECT_DIR)/%.obj: $(CURRENT_DIR)/%.c
 329 ifeq "$(NO_COMPILE)" ""
 330         @echo Compiling Object [$(notdir $@)]
 331         $(HIDESH)-c 'if [ ! -d $(@D) ]; then mkdir $(@D); fi'
 332         $(CATCHER)$(CC) $(COMPILER_FLAGS) -c $< $(OBJECT_NAME_FLAG)$@
 333 endif
 334
 335 ############################################################################
 336
 337 # resource compiler for windoze.
 338
 339 # we currently do not use rc files.
 340 $(OBJECT_DIR)/%.res: %.rc
 341   ifeq "$(NO_COMPILE)" ""
 342         @echo Bogus resource [$@]
 343         @echo >$@
 344   endif
 345
 346 ############################################################################
 347
 348 # creates static libraries.
 349 ifneq "$(NO_COMPILE)" ""
 350 $(STATIC_LIBRARY_DIR)/%.library:
 351 endif
 352
 353 ifeq "$(NO_COMPILE)" ""
 354 $(STATIC_LIBRARY_DIR)/%.library: $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_LOCAL_LIBS:%=$(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)%$(LIB_ENDING)) $(PARAMETER_FILE)
 355         $(HIDER)echo Building Static Library [$(notdir $@)]
 356         @echo $@ >$(DIRTY_FILE)
 357         $(CATCHER)$(LIBRARY_TOOL) $(LIBRARIAN_FLAGS) $(CREATE_LIBRARY_FLAG)$@ $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%)
 358   ifneq "$(OP_SYSTEM)" "UNIX"
 359         $(HIDER)ranlib $@
 360         $(HIDER)rm -f $(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)$*$(LIB_ENDING)
 361         $(HIDER)ln -s $@ $(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)$*$(LIB_ENDING)
 362   else
 363 #copied from unix above, not right yet, was not right before either though.
 364         $(HIDER)ranlib $@
 365         $(HIDER)rm -f $(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)$*$(LIB_ENDING)
 366         $(HIDER)ln -s $@ $(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)$*$(LIB_ENDING)
 367   endif
 368 endif #no_compile
 369
 370 ############################################################################
 371
 372 # creates dynamic libraries.
 373
 374 # we whack any existing LIB file, since we want to use changes in that file
 375 # as a clue for when we should rescan the dependencies.  we'd be fine if
 376 # visual c++ didn't keep an existing LIB if it does not change (even when the
 377 # DLL does).
 378
 379 ifneq "$(NO_COMPILE)" ""
 380 $(DYNAMIC_LIBRARY_DIR)/%.dll:
 381 endif
 382
 383 ifeq "$(NO_COMPILE)" ""
 384 $(DYNAMIC_LIBRARY_DIR)/%.dll: $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_LOCAL_LIBS:%=$(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)%$(LIB_ENDING)) $(ACTUAL_RESX) $(PARAMETER_FILE)
 385         $(HIDER)echo Building Dynamic Library [$(notdir $@)]
 386         @echo $@ >$(DIRTY_FILE)
 387         $(HIDER)rm -f $(@:%.dll=%.lib)
 388         echo about to run link tool.
 389         $(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)
 390         echo ran link tool.
 391   ifeq "$(COMPILER_VERSION)" "8"
 392         $(HIDESH)$(CLAM_SCRIPTS)/cpp/ms_manifest.sh "$@" "2"
 393   endif
 394   ifeq "$(COMPILER_VERSION)" "10"
 395         $(HIDESH)$(CLAM_SCRIPTS)/cpp/ms_manifest.sh "$@" "2"
 396   endif
 397   ifneq "$(VCPP_VISTA_ICON)" ""
 398         $(HIDER)ReplaceVistaIcon "$@" "$(VCPP_VISTA_ICON)"
 399   endif
 400 endif #no_compile
 401
 402 ifneq "$(NO_COMPILE)" ""
 403 $(DYNAMIC_LIBRARY_DIR)/%.so:
 404 endif
 405
 406 ifeq "$(NO_COMPILE)" ""
 407 $(DYNAMIC_LIBRARY_DIR)/%.so: $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_LOCAL_LIBS:%=$(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)%$(LIB_ENDING)) $(PARAMETER_FILE)
 408   ifeq "$(COMPILER:%_LINUX=LINUX)" "LINUX"
 409         $(HIDER)echo Shared [$@]
 410         @echo $@ >$(DIRTY_FILE)
 411         $(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)
 412         $(HIDER)rm -f $(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)$*$(LIB_ENDING)
 413         $(HIDER)ln -s $@ $(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)$*$(LIB_ENDING)
 414   endif
 415 endif #no_compile
 416
 417 ############################################################################
 418
 419 # creates "exe" executables using all of the appropriate objects.
 420
 421 ifneq "$(NO_COMPILE)" ""
 422 $(EXECUTABLE_DIR)/%:
 423 endif
 424
 425 ifeq "$(NO_COMPILE)" ""
 426 $(EXECUTABLE_DIR)/%: $(OBJECT_DIR)/%.obj $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_LOCAL_LIBS:%=$(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)%$(LIB_ENDING)) $(PARAMETER_FILE)
 427         $(HIDER)echo Building Application [$(notdir $@)]
 428         @echo $@ >$(DIRTY_FILE)
 429         $(CATCHER)$(LINK_TOOL) $(EXE_FLAGS) $(LOAD_FLAG_PREFIX) $< $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_LOCAL_LIBS:%=$(LIBRARY_NAME_FLAG)%) $(LOAD_FLAG_SUFFIX) $(LINKER_OUTPUT_FLAG)$@
 430 #hmmm: experimental item below.
 431 #$(^:force_rebuild=)
 432 endif #no_compile
 433
 434 ############################################################################
 435
 436 # creates firmware "elf" executables with the proper objects.
 437
 438 ifneq "$(NO_COMPILE)" ""
 439 $(EXECUTABLE_DIR)/%.elf:
 440 endif
 441
 442 ifeq "$(NO_COMPILE)" ""
 443 $(EXECUTABLE_DIR)/%.elf: $(OBJECT_DIR)/%.obj $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_LOCAL_LIBS:%=$(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)%$(LIB_ENDING)) $(PARAMETER_FILE)
 444         $(HIDER)echo Building Application [$(notdir $@)]
 445         @echo $@ >$(DIRTY_FILE)
 446         $(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)$@
 447 #$(^:force_rebuild=)
 448         @echo Hex [$(EXECUTABLE_DIR)/$*.out]
 449         $(CATCHER)$(DDUMP_TOOL) $(DDUMP_OPTIONS) $@ -o$(EXECUTABLE_DIR)/$*.out
 450         @echo Binary [$(EXECUTABLE_DIR)/$*.bin]
 451         $(CATCHER)$(DDUMP_TOOL) $(DDUMP_BIN_OPTIONS) $@ -o$(EXECUTABLE_DIR)/$*.bin
 452 endif #no_compile
 453
 454 ############################################################################
 455
 456 # handles creating version resource files if this project has a version.ini.
 457
 458 ifeq "$(OMIT_VERSIONS)" ""
 459   ifneq "$(VERSION_RC_ROOT)" ""
 460 # only redo the version resource if it or version.ini is out of date.
 461 %_version.rc: version.ini $(PARAMETER_FILE)
 462         $(CATCHER)$(CLAM_BINARIES)/version_stamper$(EXE_END) . $(FEISTY_MEOW_GENERATED_STORE)/versions $(PARAMETER_FILE)
 463   endif
 464 endif
 465
 466 ############################################################################
 467
 468 # Now the active part of the make process...
 469
 470 # make sure we really want to include the dependencies file.
 471 ifeq "$(TYPE)" "hierarchy"
 472   # no dependencies for a simple hierarchy builder.
 473   NO_DEPS = t
 474 endif
 475 ifneq "$(CLEAN)" ""
 476   NO_DEPS = t
 477   # no dependencies get left when we are cleaning up.
 478 #  $(shell rm -f $(DEPS_FILE))
 479 endif
 480 ifneq "$(NO_COMPILE)" ""
 481   # non compiling projects do not need dependencies.
 482   NO_DEPS = t
 483 endif
 484 ifneq "$(REBUILD)" ""
 485   NO_DEPS = t
 486   # if we are rebuilding everything, we zap the deps file.
 487   $(shell rm -f $(DEPS_FILE))
 488 endif
 489
 490 # preserves intermediate files from being deleted.
 491 ifeq "$(CLEAN)" ""
 492 .PRECIOUS: $(OBJECT_DIR)/%.obj $(OBJECT_DIR)/%.res $(OBJECT_DIR)/%.resources $(OBJECT_DIR)/%.deps
 493 #hmmm: added above deps.  maybe not right.
 494 endif
 495
 496 # zaps things when they could not be created correctly.
 497 ####.DELETE_ON_ERROR:
 498
 499 ############################################################################
 500
 501 # autodependency file creator.  See the make_dep man page for more info.
 502
 503 # we do the auto-dependencies unless the disabling flag is set.
 504 ifneq "$(NO_DEPS)" ""
 505     # makes the dependencies a no-op.
 506     deps: $(PARAMETER_FILE)
 507
 508     $(DEPS_FILE): $(PARAMETER_FILE)
 509
 510 else
 511   ifeq "$(CLEAN)" ""
 512   deps: $(DEPS_FILE)
 513
 514   # this causes the dependency file to be regenerated if the sources or libs
 515   # have changed.  we have to touch the deps file in case it is missing;
 516   # makedep does not deal well with that.  also, we touch the dirty flag file
 517   # to ensure that the fact we redid dependencies for some reason causes us
 518   # to re-promote.  we only bother with any of this if we know we are going
 519   # to really do some compilation; if in non-compile mode, we'll skip it.
 520   ifneq "$(NO_COMPILE)" ""
 521     # no dependencies in non-compile mode.
 522     $(DEPS_FILE):
 523
 524   else
 525     ifeq "$(LAX_DEPENDENCIES)" ""
 526       $(DEPS_FILE): $(SOURCE) $(ACTUAL_LOCAL_LIBS:%=$(STATIC_LIBRARY_DIR)/$(LIB_PREFIX)%$(LIB_ENDING)) $(wildcard *.h) $(EXE_CPPS)
 527     else  # lax dependencies means create if missing or if parm file changed.
 528       $(DEPS_FILE): $(PARAMETER_FILE)
 529     endif # !lax dependencies.
 530     ifneq "$(VERSION_RC_ROOT)" ""
 531       ifeq "$(OMIT_VERSIONS)" ""
 532         $(DEPS_FILE): $(VERSION_RC_ROOT)_version.rc
 533       endif
 534     endif
 535         @echo Dependencies [$(notdir $@)]
 536         -$(HIDESH)$(CLAM_SCRIPTS)/cpp/preconditions.sh
 537         @touch $@
 538 #       @echo dep adds: $(DEPENDENCY_ADDITIONS)
 539         @$(CLAM_BINARIES)/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)
 540 #       $(CATCHER)$(CLAM_BINARIES)/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)
 541         @echo $@ >$(SUBMAKE_FLAG)
 542   endif # non-compile.
 543  else # cleaning.
 544     # makes the dependencies a no-op for cleaning.
 545     deps: $(PARAMETER_FILE)
 546
 547     $(DEPS_FILE): $(PARAMETER_FILE)
 548  endif
 549 endif # no-deps.
 550
 551 ############################################################################
 552
 553 # examines the required variables and complains if they are missing.
 554 check_requirements:
 555         $(HIDESH) -c 'if [ -z "$(PROJECT)" ]; then echo the PROJECT variable is not defined!; . $(CLAM_SCRIPTS)/exit_make.sh; fi'
 556         $(HIDESH) -c 'if [ -z "$(TYPE)" ]; then echo the TYPE variable is not defined!; . $(CLAM_SCRIPTS)/exit_make.sh; fi'
 557         $(HIDESH) -c 'if [ ! -d $(FEISTY_MEOW_GENERATED_STORE)/versions ]; then mkdir $(FEISTY_MEOW_GENERATED_STORE)/versions; fi'
 558
 559 ############################################################################
 560
 561 # includes the auto-dependency information.  the dependency file is checked
 562 # for being up-to-date.  if not, it gets rebuilt and the make is restarted.
 563 ifeq "$(CLEAN)" ""
 564   ifeq "$(NO_DEPS)" ""
 565
 566     # thank the buddha for this bit of code, or at least thank this page:
 567     # http://stackoverflow.com/questions/5553352/how-do-i-check-if-file-exists-in-makefile
 568     ifneq ("$(wildcard $(DEPS_FILE))","")
 569       include $(DEPS_FILE)
 570     endif
 571
 572   endif
 573 endif
 574
 575 ############################################################################
 576
 577 # calls the script for preparing output directories and such.
 578 pre_compilation:
 579         $(HIDESH)$(CLAM_SCRIPTS)/cpp/preconditions.sh
 580
 581 ############################################################################
 582
 583 # calls the script for copying the final products to the library directory.
 584 # we don't bother reporting errors from touch since there will sometimes
 585 # not be any objects in the final directory.
 586 post_compilation:
 587         $(HIDESH)$(CLAM_SCRIPTS)/cpp/postconditions.sh
 588
 589 ############################################################################
 590
 591 # if REBUILD is defined, then we cause all objects to be recompiled.
 592 .PHONY: force_rebuild
 593 force_rebuild:
 594
 595 ifneq "$(REBUILD)" ""
 596   # the target below needs the blank rule that it has for this to work.
 597   $(FIRST_TARGETS) $(ACTUAL_OBJECTS:%=$(OBJECT_DIR)/%) $(ACTUAL_TARGETS) $(EXE_CPPS:%.cpp=$(OBJECT_DIR)/%.obj) $(LAST_TARGETS): force_rebuild
 598 endif
 599
 600 ############################################################################
 601
 602 # generate dependencies for any static targets if requested.
 603 gendeps: $(GENERATED_DEPS_LIST)
 604
 605 ############################################################################
 606