Add static functions to clear singleton maps. Patch contributed by
[oota-llvm.git] / Makefile.rules
index 8b2af1a56c33d414a7faccf6d6332864a454acc1..1438f916943baad74ae4a0fc1df74ea67bef506a 100644 (file)
 #
 #===-----------------------------------------------------------------------====
 
-#
-# Set the VPATH so that we can find source files.
-#
-VPATH=$(BUILD_SRC_DIR)
-
-###############################################################################
+################################################################################
 # TARGETS: Define standard targets that can be invoked
-###############################################################################
+################################################################################
 
 #--------------------------------------------------------------------
 # Define the various target sets
 #--------------------------------------------------------------------
-RECURSIVE_TARGETS := all clean check install uninstall
-LOCAL_TARGETS     := all-local clean-local check-local install-local printvars\
-                     uninstall-local
-TOPLEV_TARGETS    := dist dist-check dist-clean tags
-INTERNAL_TARGETS  := preconditions \
-  install-config-dir install-shared-library install-bytecode-library \
-  install-archive-library install-relinked-library install-tool \
-  uninstall-config-dir uninstall-shared-library uninstall-bytecode-library \
-  uninstall-archive-library uninstall-relinked-library uninstall-tool
+RecursiveTargets := all clean clean-all check install uninstall
+LocalTargets     := all-local clean-local clean-all-local check-local \
+                    install-local printvars uninstall-local
+TopLevelTargets  := dist dist-check dist-clean tags dist-gzip dist-bzip2 \
+                    dist-zip
+UserTargets      := $(RecursiveTargets) $(LocalTargets) $(TopLevelTargets)
+InternalTargets  := preconditions distdir dist-hook
+
+################################################################################
+# INITIALIZATION: Basic things the makefile needs
+################################################################################
+
+#--------------------------------------------------------------------
+# Set the VPATH so that we can find source files.
+#--------------------------------------------------------------------
+VPATH=$(BUILD_SRC_DIR)
+
+#--------------------------------------------------------------------
+# Reset the list of suffixes we know how to build
+#--------------------------------------------------------------------
+.SUFFIXES:
+.SUFFIXES: .c .cpp .h .hpp .y .l .lo .o .a .bc .td .ps .dot 
+.SUFFIXES: $(SHLIBEXT) $(SUFFIXES)
 
 #--------------------------------------------------------------------
 # Mark all of these targets as phony to avoid implicit rule search
 #--------------------------------------------------------------------
-.PHONY: $(RECURSIVE_TARGETS) $(LOCAL_TARGETS) $(TOP_TARGETS) $(INTERNAL_TARGETS)
+.PHONY: $(UserTargets) $(InternalTargets)
 
 #--------------------------------------------------------------------
-# Make sure all the user-target rules are double colon rules and that
-# the preconditions are run first.
+# Make sure all the user-target rules are double colon rules and 
+# they are defined first.
 #--------------------------------------------------------------------
 
-all :: all-local
-check:: check-local
-clean:: clean-local 
-install :: install-local
-uninstall :: uninstall-local
+$(UserTargets)::
 
-all-local :: preconditions
-clean-local :: preconditions
-check-local :: all-local
-install-local :: all-local 
-printvars :: preconditions
-uninstall-local :: preconditions
+################################################################################
+# PRECONDITIONS: that which must be built/checked first
+################################################################################
 
-###############################################################################
-# SUFFIXES: Reset the list of suffixes we know how to build
-###############################################################################
-.SUFFIXES:
-.SUFFIXES: .c .cpp .h .hpp .y .l .lo .o .a $(SHLIBEXT) .bc .td .ps .dot $(SUFFIXES)
+SrcMakefiles       := $(filter %Makefile %Makefile.tests %Makefile.JIT,\
+                      $(wildcard $(BUILD_SRC_DIR)/Makefile*))
+ObjMakefiles       := $(subst $(BUILD_SRC_DIR),$(BUILD_OBJ_DIR),$(SrcMakefiles))
+ConfigureScript    := $(LLVM_SRC_ROOT)/configure
+ConfigStatusScript := $(LLVM_OBJ_ROOT)/config.status
+MakefileConfigIn   := $(LLVM_SRC_ROOT)/Makefile.config.in
+MakefileConfig     := $(LLVM_OBJ_ROOT)/Makefile.config
+PreConditions      := $(ConfigStatusScript) $(MakefileConfig) $(ObjMakefiles)
+
+preconditions : $(PreConditions)
+
+#------------------------------------------------------------------------
+# Make sure the BUILT_SOURCES are built first
+#------------------------------------------------------------------------
+$(filter-out clean clean-local,UserTargets):: $(BUILT_SOURCES)
+
+clean-local::
+ifneq ($(strip $(BUILT_SOURCES)),)
+       -$(Verb) $(RM) -f $(BUILT_SOURCES)
+endif
+
+$(BUILT_SOURCES) : $(ObjMakefiles)
+
+#------------------------------------------------------------------------
+# Make sure we're not using a stale configuration
+#------------------------------------------------------------------------
+.PRECIOUS: $(ConfigStatusScript)
+$(ConfigStatusScript): $(ConfigureScript)
+       $(Echo) Reconfiguring with $<
+       $(Verb) $(ConfigStatusScript) --recheck $(ConfigureScriptFLAGS)
+       $(Verb) $(ConfigStatusScript)
+
+#------------------------------------------------------------------------
+# Make sure the configuration makefile is up to date
+#------------------------------------------------------------------------
+$(MakefileConfig): $(MakefileConfigIn) $(ConfigStatusScript)
+       $(Echo) Regenerating $@
+       $(Verb) cd $(LLVM_OBJ_ROOT) ; $(ConfigStatusScript) Makefile.config
+
+#------------------------------------------------------------------------
+# If the Makefile in the source tree has been updated, copy it over into the
+# build tree. But, only do this if the source and object makefiles differ
+#------------------------------------------------------------------------
+ifneq ($(BUILD_OBJ_DIR),$(BUILD_SRC_DIR))
+
+Makefile: $(BUILD_SRC_DIR)/Makefile
+       $(Echo) "Updating Makefile"
+       $(Verb) $(MKDIR) $(@D)
+       $(Verb) cp -f $< $@
+
+# Copy the Makefile.* files unless we're in the root directory which avoids
+# the copying of Makefile.config.in or other things that should be explicitly
+# taken care of.
+$(BUILD_OBJ_DIR)/Makefile% : $(BUILD_SRC_DIR)/Makefile%
+       @case '$?' in \
+          *Makefile.rules) ;; \
+          *.in) ;; \
+          *) $(Echo) "Updating $(@F)" ; \
+            $(MKDIR) $(@D) ; \
+            cp -f $< $@ ;; \
+       esac
+         
+endif
+
+#------------------------------------------------------------------------
+# Set up the basic dependencies
+#------------------------------------------------------------------------
+$(UserTargets):: $(PreConditions)
+
+all:: all-local
+check:: check-local
+clean:: clean-local 
+clean-all:: clean-local clean-all-local
+install:: install-local
+uninstall:: uninstall-local
+check-local:: all-local
+install-local:: all-local 
 
 ###############################################################################
 # VARIABLES: Set up various variables based on configuration data
@@ -72,86 +146,115 @@ uninstall-local :: preconditions
 #--------------------------------------------------------------------
 
 ifdef ENABLE_PROFILING
-  CONFIGURATION := Profile
-  CXXFLAGS += -O3 -DNDEBUG -felide-constructors -finline-functions -pg
-  CFLAGS   += -O3 -DNDEBUG -pg
-  LDFLAGS  += -O3 -DNDEBUG -pg 
+  BuildMode := Profile
+  CXX.Flags := -O3 -DNDEBUG -felide-constructors -finline-functions -pg
+  C.Flags   := -O3 -DNDEBUG -pg
+  LD.Flags  := -O3 -DNDEBUG -pg 
 else
   ifdef ENABLE_OPTIMIZED
-    CONFIGURATION := Release
-    CXXFLAGS  += -O3 -DNDEBUG -finline-functions -felide-constructors -fomit-frame-pointer
-    CFLAGS    += -O3 -DNDEBUG -fomit-frame-pointer
-    LDFLAGS   += -O3 -DNDEBUG 
+    BuildMode := Release
+    CXX.Flags  := -O3 -DNDEBUG -finline-functions -felide-constructors -fomit-frame-pointer
+    C.Flags    := -O3 -DNDEBUG -fomit-frame-pointer
+    LD.Flags   := -O3 -DNDEBUG 
   else
-    CONFIGURATION := Debug
-    CXXFLAGS += -g -D_DEBUG 
-    CFLAGS   += -g -D_DEBUG
-    LDFLAGS  += -g -D_DEBUG 
+    BuildMode := Debug
+    CXX.Flags := -g -D_DEBUG 
+    C.Flags   := -g -D_DEBUG
+    LD.Flags  := -g -D_DEBUG 
     KEEP_SYMBOLS := 1
   endif
 endif
 
-ARFLAGS := cru
+CXX.Flags += $(CXXFLAGS)
+C.Flags   += $(CFLAGS)
+CPP.Flags += $(CPPFLAGS)
+LD.Flags  += $(LDFLAGS)
+AR.Flags  := cru
+LibTool.Flags := --tag=CXX
 
 #--------------------------------------------------------------------
 # Directory locations
 #--------------------------------------------------------------------
-OBJDIR      := $(BUILD_OBJ_DIR)/$(CONFIGURATION)
-LIBDIR      := $(BUILD_OBJ_ROOT)/lib/$(CONFIGURATION)
-TOOLDIR     := $(BUILD_OBJ_ROOT)/tools/$(CONFIGURATION)
-LLVMLIBDIR  := $(LLVM_OBJ_ROOT)/lib/$(CONFIGURATION)
-LLVMTOOLDIR := $(LLVM_OBJ_ROOT)/tools/$(CONFIGURATION)
+ObjDir      := $(BUILD_OBJ_DIR)/$(BuildMode)
+LibDir      := $(BUILD_OBJ_ROOT)/$(BuildMode)/lib
+ToolDir     := $(BUILD_OBJ_ROOT)/$(BuildMode)/bin
+ExmplDir    := $(BUILD_OBJ_ROOT)/$(BuildMode)/examples
+LLVMLibDir  := $(LLVM_OBJ_ROOT)/$(BuildMode)/lib
+LLVMToolDir := $(LLVM_OBJ_ROOT)/$(BuildMode)/bin
+LExmplDir   := $(LLVM_OBJ_ROOT)/$(BuildMode)/examples
 
 #--------------------------------------------------------------------
 # Full Paths To Compiled Tools and Utilities
 #--------------------------------------------------------------------
+EchoCmd  := $(ECHO) llvm[$(MAKELEVEL)]:
+Echo     := @$(EchoCmd)
+ifndef LIBTOOL
 LIBTOOL  := $(LLVM_OBJ_ROOT)/mklib
-LLVMAS   := $(LLVMTOOLDIR)/llvm-as$(EXEEXT)
-BURG     := $(LLVMTOOLDIR)/burg$(EXEEXT)
-TBLGEN   := $(LLVMTOOLDIR)/tblgen$(EXEEXT)
-GCCLD    := $(LLVMTOOLDIR)/gccld$(EXEEXT)
-LLVMGCC  := PATH=$(LLVMTOOLDIR):$(PATH) $(LLVMGCCDIR)/bin/gcc
-LLVMGXX  := PATH=$(LLVMTOOLDIR):$(PATH) $(LLVMGCCDIR)/bin/g++
+endif
+ifndef LLVMAS
+LLVMAS   := $(LLVMToolDir)/llvm-as$(EXEEXT)
+endif
+ifndef BURG
+BURG     := $(LLVMToolDir)/burg$(EXEEXT)
+endif
+ifndef TBLGEN
+TBLGEN   := $(LLVMToolDir)/tblgen$(EXEEXT)
+endif
+ifndef GCCLD
+GCCLD    := $(LLVMToolDir)/gccld$(EXEEXT)
+endif
+ifndef LLVMGCC
+LLVMGCC  := PATH=$(LLVMToolDir):$(PATH) $(LLVMGCCDIR)/bin/gcc
+endif
+ifndef LLVMGXX
+LLVMGXX  := PATH=$(LLVMToolDir):$(PATH) $(LLVMGCCDIR)/bin/g++
+endif
 
 # Need a better way to compute this.
-LLVMGCCLIBDIR := $(dir $(shell $(LLVMGCC) -print-file-name=libgcc.a))/
+LLVMGCCLibDir := $(dir $(shell $(LLVMGCC) -print-file-name=libgcc.a))/
 
 #--------------------------------------------------------------------
 # Adjust to user's request
 #--------------------------------------------------------------------
 
-# Adjust LIBTOOL options for shared libraries, or not.
+# Adjust LIBTOOL flags for shared libraries, or not.
 ifndef SHARED_LIBRARY
-  LIBTOOL += --tag=disable-shared
+  LibTool.Flags += --tag=disable-shared
 else
-  LDFLAGS += -rpath $(LIBDIR)
+  LD.Flags += -rpath $(LibDir)
+endif
+
+ifdef TOOL_VERBOSE
+  C.Flags += -v
+  CXX.Flags += -v
+  LD.Flags += -v
+  BCLinkLib.Flags += -v
+  VERBOSE := 1
 endif
 
 # Adjust settings for verbose mode
 ifndef VERBOSE
-  VERB := @
-  LIBTOOL += --silent
-  AR += >/dev/null 2>/dev/null
+  Verb := @
+  LibTool.Flags += --silent
+  AR.Flags += >/dev/null 2>/dev/null
+  ConfigureScriptFLAGS += >$(BUILD_OBJ_DIR)/configure.out 2>&1
+else
+  ConfigureScriptFLAGS := 
 endif
 
 # By default, strip symbol information from executable
 ifndef KEEP_SYMBOLS
-  STRIP = $(PLATFORMSTRIPOPTS)
-  STRIP_WARN_MSG = "(without symbols)"
+  Strip := $(PLATFORMSTRIPOPTS)
+  StripWarnMsg := "(without symbols)"
 endif
 
 # Adjust linker flags for building an executable
 ifdef TOOLNAME
-  LDFLAGS += -rpath $(TOOLDIR) -export-dynamic $(TOOLLINKOPTS)
+ifdef EXAMPLE_TOOL
+  LD.Flags += -rpath $(ExmplDir) -export-dynamic
+else
+  LD.Flags += -rpath $(ToolDir) -export-dynamic
 endif
-
-# Use TOOLLINKOPTSB to pass options to the linker like library search 
-# path etc.
-# Note that this is different from TOOLLINKOPTS, these options
-# are passed to the linker *before* the USEDLIBS options are passed.
-# e.g. usage TOOLLINKOPTSB =  -L/home/xxx/lib
-ifdef TOOLLINKOPTSB
-LDFLAGS += $(TOOLLINKOPTSB)
 endif
 
 #----------------------------------------------------------
@@ -160,28 +263,31 @@ endif
 
 CompileCommonOpts := -Wall -W -Wwrite-strings -Wno-unused
 
-LDFLAGS  += -L$(LIBDIR) -L$(LLVMLIBDIR)
-CPPFLAGS += -I$(BUILD_OBJ_DIR) \
-            -I$(BUILD_SRC_DIR) \
-            -I$(BUILD_SRC_ROOT)/include \
-            -I$(BUILD_OBJ_ROOT)/include \
-            -I$(LLVM_OBJ_ROOT)/include \
-            -I$(LLVM_SRC_ROOT)/include \
-            -D_GNU_SOURCE -D__STDC_LIMIT_MACROS
-
-Compile.C     = $(CC) $(CPPFLAGS) $(CompileCommonOpts) -c $(CFLAGS)
-Compile.CXX   = $(CXX) $(CPPFLAGS) $(CompileCommonOpts) $(CXXFLAGS) -c
-LTCompile.C   = $(LIBTOOL) --mode=compile $(Compile.C)
-LTCompile.CXX = $(LIBTOOL) --tag=CXX --mode=compile $(Compile.CXX)
-BCCompile.CXX = $(LLVMGXX) $(CPPFLAGS) $(CompileCommonOpts) $(CXXFLAGS) -c
-BCCompile.C   = $(LLVMGCC) $(CPPFLAGS) $(CompileCommonOpts) $(CFLAGS) -c
-Link          = $(LIBTOOL) --tag=CXX --mode=link $(CXX) $(CPPFLAGS) \
-                $(CompileCommonOpts) $(LDFLAGS) $(STRIP)
-Relink        = $(LIBTOOL) --tag=CXX --mode=link $(CXX)
-BCLinkLib     = $(LLVMGCC) -shared -nostdlib
+LD.Flags  += -L$(LibDir) -L$(LLVMLibDir)
+CPP.Flags += -I$(BUILD_OBJ_DIR) \
+           -I$(BUILD_SRC_DIR) \
+           -I$(BUILD_SRC_ROOT)/include \
+           -I$(BUILD_OBJ_ROOT)/include \
+           -I$(LLVM_OBJ_ROOT)/include \
+           -I$(LLVM_SRC_ROOT)/include \
+           -D_GNU_SOURCE -D__STDC_LIMIT_MACROS
+
+Compile.C     = $(CC) $(CPP.Flags) $(CompileCommonOpts) -c $(C.Flags)
+LTCompile.C   = $(LIBTOOL) $(LibTool.Flags) --mode=compile $(Compile.C)
+BCCompile.C   = $(LLVMGCC) $(CPP.Flags) $(CompileCommonOpts) $(C.Flags) -c
+Compile.CXX   = $(CXX) $(CPP.Flags) $(CompileCommonOpts) $(CXX.Flags) -c
+LTCompile.CXX = $(LIBTOOL) $(LibTool.Flags) --mode=compile $(Compile.CXX)
+BCCompile.CXX = $(LLVMGXX) $(CPP.Flags) $(CompileCommonOpts) $(CXX.Flags) -c
+Link          = $(LIBTOOL) $(LibTool.Flags) --mode=link $(CXX) $(CPP.Flags) \
+               $(CompileCommonOpts) $(LD.Flags) $(Strip)
+Relink        = $(LIBTOOL) $(LibTool.Flags) --mode=link $(CXX) $(CPP.Flags) \
+                $(CompileCommonOpts)
+BCLinkLib     = $(LLVMGCC) -shared -nostdlib $(BCLinkLib.Flags)
+LTInstall     = $(LIBTOOL) $(LibTool.Flags) --mode=install $(INSTALL)
 Burg          = $(BURG) -I $(BUILD_SRC_DIR)
 TableGen      = $(TBLGEN) -I $(BUILD_SRC_DIR)
-Archive       = $(AR) $(ARFLAGS)
+Archive       = $(AR) $(AR.Flags)
+LArchive      = $(ToolDir)/llvm-ar rcsf
 ifdef RANLIB
 Ranlib        = $(RANLIB)
 else
@@ -192,40 +298,68 @@ endif
 # Get the list of source files
 #----------------------------------------------------------
 ifndef SOURCES
-SOURCES  := $(notdir $(wildcard $(BUILD_SRC_DIR)/*.cpp \
-            $(BUILD_SRC_DIR)/*.cc $(BUILD_SRC_DIR)/*.c $(BUILD_SRC_DIR)/*.y \
-            $(BUILD_SRC_DIR)/*.l))
+  Sources := $(notdir $(wildcard $(BUILD_SRC_DIR)/*.cpp \
+             $(BUILD_SRC_DIR)/*.cc $(BUILD_SRC_DIR)/*.c $(BUILD_SRC_DIR)/*.y \
+             $(BUILD_SRC_DIR)/*.l))
+else
+  Sources := $(SOURCES)
 endif
 
 ifdef BUILT_SOURCES
-SOURCES += $(filter %.cpp %.c %.cc %.y %.l,$(BUILT_SOURCES))
+Sources += $(filter %.cpp %.c %.cc %.y %.l,$(BUILT_SOURCES))
 endif
 
 #----------------------------------------------------------
 # Types of objects that can be built from sources
 #----------------------------------------------------------
-BASENAME_SOURCES := $(sort $(basename $(SOURCES)))
-ObjectsO  := $(BASENAME_SOURCES:%=$(OBJDIR)/%.o)
-ObjectsLO := $(BASENAME_SOURCES:%=$(OBJDIR)/%.lo)
-ObjectsBC := $(BASENAME_SOURCES:%=$(OBJDIR)/%.bc)
-
+BaseNameSources := $(sort $(basename $(Sources)))
+ObjectsO  := $(BaseNameSources:%=$(ObjDir)/%.o)
+ObjectsLO := $(BaseNameSources:%=$(ObjDir)/%.lo)
+ObjectsBC := $(BaseNameSources:%=$(ObjDir)/%.bc)
 
 ###############################################################################
 # DIRECTORIES: Handle recursive descent of directory structure
 ###############################################################################
 
+#---------------------------------------------------------
+# Provide rules to make install dirs. This must be early
+# in the file so they get built before dependencies
+#---------------------------------------------------------
+
+$(bindir):
+       $(Verb) $(MKDIR) $(bindir)
+
+$(libdir):
+       $(Verb) $(MKDIR) $(libdir)
+
+$(bytecode_libdir):
+       $(Verb) $(MKDIR) $(bytecode_libdir)
+
+$(sysconfdir):
+       $(Verb) $(MKDIR) $(sysconfdir)
+
+# To create other directories, as needed, and timestamp their creation
+%/.dir:
+       $(Verb) $(MKDIR) $* > /dev/null
+       @$(DATE) > $@
+
+.PRECIOUS: $(ObjDir)/.dir $(LibDir)/.dir $(ToolDir)/.dir $(ExmplDir)/.dir
+.PRECIOUS: $(LLVMLibDir)/.dir $(LLVMToolDir)/.dir $(LLVMExmplDir)/.dir
+
 #---------------------------------------------------------
 # Handle the DIRS options for sequential construction
 #---------------------------------------------------------
 
+SubDirs := 
 ifdef DIRS
-$(RECURSIVE_TARGETS)::
-       $(VERB) for dir in $(DIRS); do \
+SubDirs += $(DIRS)
+$(RecursiveTargets)::
+       $(Verb) for dir in $(DIRS); do \
          if [ ! -f $$dir/Makefile ]; then \
            $(MKDIR) $$dir; \
            cp $(BUILD_SRC_DIR)/$$dir/Makefile $$dir/Makefile; \
          fi; \
-         ($(MAKE) -C $$dir $@ $(MFLAGS)) || exit 1; \
+         ($(MAKE) -C $$dir $@ ) || exit 1; \
        done
 endif
 
@@ -234,13 +368,13 @@ endif
 # after each directory is built.
 #---------------------------------------------------------
 ifdef EXPERIMENTAL_DIRS
-$(RECURSIVE_TARGETS)::
-       $(VERB) for dir in $(EXPERIMENTAL_DIRS); do \
+$(RecursiveTargets)::
+       $(Verb) for dir in $(EXPERIMENTAL_DIRS); do \
          if [ ! -f $$dir/Makefile ]; then \
            $(MKDIR) $$dir; \
            cp $(BUILD_SRC_DIR)/$$dir/Makefile $$dir/Makefile; \
          fi; \
-         ($(MAKE) -C $$dir $@ $(MFLAGS)) || exit 0; \
+         ($(MAKE) -C $$dir $@ ) || exit 0; \
        done
 endif
 
@@ -249,22 +383,25 @@ endif
 #---------------------------------------------------------
 ifdef PARALLEL_DIRS
 
+SubDirs += $(PARALLEL_DIRS)
+
 # Unfortunately, this list must be maintained if new 
 # recursive targets are added.
-all      :: $(addsuffix /.makeall     , $(PARALLEL_DIRS))
-clean    :: $(addsuffix /.makeclean   , $(PARALLEL_DIRS))
-check    :: $(addsuffix /.makecheck   , $(PARALLEL_DIRS))
-install  :: $(addsuffix /.makeinstall , $(PARALLEL_DIRS))
+all      :: $(addsuffix /.makeall      ,$(PARALLEL_DIRS))
+clean    :: $(addsuffix /.makeclean    ,$(PARALLEL_DIRS))
+clean-all:: $(addsuffix /.makeclean-all,$(PARALLEL_DIRS))
+check    :: $(addsuffix /.makecheck    ,$(PARALLEL_DIRS))
+install  :: $(addsuffix /.makeinstall  ,$(PARALLEL_DIRS))
 uninstall:: $(addsuffix /.makeuninstall,$(PARALLEL_DIRS))
 
-Parallel_Targets := $(foreach T,$(RECURSIVE_TARGETS),%/.make$(T))
+Parallel_Targets := $(foreach T,$(RecursiveTargets),%/.make$(T))
 
 $(Parallel_Targets) :
-       $(VERB) if [ ! -f $(@D)/Makefile ]; then \
+       $(Verb) if [ ! -f $(@D)/Makefile ]; then \
          $(MKDIR) $(@D); \
          cp $(BUILD_SRC_DIR)/$(@D)/Makefile $(@D)/Makefile; \
        fi; \
-       $(MAKE) -C $(@D) $(subst $(@D)/.make,,$@) $(MFLAGS)
+       $(MAKE) -C $(@D) $(subst $(@D)/.make,,$@)
 endif
 
 #---------------------------------------------------------
@@ -272,14 +409,17 @@ endif
 # or may not exist.
 #---------------------------------------------------------
 ifdef OPTIONAL_DIRS
-$(RECURSIVE_TARGETS)::
-       $(VERB) for dir in $(OPTIONAL_DIRS); do \
+
+SubDirs += $(OPTIONAL_DIRS)
+
+$(RecursiveTargets)::
+       $(Verb) for dir in $(OPTIONAL_DIRS); do \
          if [ -d $(BUILD_SRC_DIR)/$$dir ]; then\
            if [ ! -f $$dir/Makefile ]; then \
              $(MKDIR) $$dir; \
              cp $(BUILD_SRC_DIR)/$$dir/Makefile $$dir/Makefile; \
            fi; \
-           ($(MAKE) -C$$dir $@ $(MFLAGS)) || exit 1; \
+           ($(MAKE) -C$$dir $@ ) || exit 1; \
          fi \
        done
 endif
@@ -289,25 +429,18 @@ endif
 #---------------------------------------------------------
 ifdef CONFIG_FILES
 
-install-local:: install-config-dir 
-
-install-config-dir: $(sysconfdir) $(CONFIG_FILES)
-       $(VERB)$(ECHO) Installing Configuration Files To $(sysconfdir)
-       $(VERB)for file in $(CONFIG_FILES); do \
+install-local:: $(sysconfdir) $(CONFIG_FILES)
+       $(Echo) Installing Configuration Files To $(sysconfdir)
+       $(Verb)for file in $(CONFIG_FILES); do \
                $(INSTALL) $(BUILD_SRC_DIR)/$${file} $(sysconfdir) ; \
        done
 
-uninstall-local:: uninstall-config-dir
-
-uninstall-config-dir:
-       $(VERB)$(ECHO) Uninstalling Configuration Files From $(sysconfdir)
-       $(VERB)for file in $(CONFIG_FILES); do \
-          $(RM) -f $(sysconfdir)/$${file} ; \
+uninstall-local::
+       $(Echo) Uninstalling Configuration Files From $(sysconfdir)
+       $(Verb)for file in $(CONFIG_FILES); do \
+         $(RM) -f $(sysconfdir)/$${file} ; \
        done
 
-$(sysconfdir):
-       $(MKDIR) $(sysconfdir)
-
 endif
 
 ###############################################################################
@@ -320,10 +453,10 @@ ifdef LIBRARYNAME
 
 # Make sure there isn't any extranous whitespace on the LIBRARYNAME option
 LIBRARYNAME := $(strip $(LIBRARYNAME))
-LIBNAME_LA := $(LIBDIR)/lib$(LIBRARYNAME).la
-LIBNAME_A  := $(LIBDIR)/lib$(LIBRARYNAME).a
-LIBNAME_O  := $(LIBDIR)/$(LIBRARYNAME).o
-LIBNAME_BC := $(LIBDIR)/lib$(LIBRARYNAME).bc
+LibName.LA := $(LibDir)/lib$(LIBRARYNAME).la
+LibName.A  := $(LibDir)/lib$(LIBRARYNAME).a
+LibName.O  := $(LibDir)/$(LIBRARYNAME).o
+LibName.BC := $(LibDir)/lib$(LIBRARYNAME).bc
 
 #---------------------------------------------------------
 # Shared Library Targets:
@@ -333,34 +466,30 @@ LIBNAME_BC := $(LIBDIR)/lib$(LIBRARYNAME).bc
 #---------------------------------------------------------
 ifdef SHARED_LIBRARY
 
-all-local:: $(LIBNAME_LA)
+all-local:: $(LibName.LA)
 
-$(LIBNAME_LA): $(BUILT_SOURCES) $(ObjectsLO) $(LIBDIR)/.dir
-       @$(ECHO) Linking shared library $(notdir $@)
-       $(VERB) $(Link) -o $@ $(ObjectsLO)
-       $(VERB) $(LIBTOOL) --mode=install $(INSTALL) $@ $(LIBDIR)
+$(LibName.LA): $(BUILT_SOURCES) $(ObjectsLO) $(LibDir)/.dir
+       $(Echo) Linking $(BuildMode) Shared Library $(LIBRARYNAME)$(SHLIBEXT)
+       $(Verb) $(Link) -o $@ $(ObjectsLO)
+       $(Verb) $(LTInstall) $@ $(LibDir)
 
 clean-local::
-ifneq ($(strip $(LIBNAME_LA)),)
-       $(VERB) $(RM) -f $(LIBNAME_LA)
+ifneq ($(strip $(LibName.LA)),)
+       -$(Verb) $(RM) -f $(LibName.LA)
 endif
 
 DestSharedLib = $(libdir)/lib$(LIBRARYNAME)$(SHLIBEXT)
-install-local:: install-shared-library
-
-install-shared-library: $(DestSharedLib)
 
-$(DestSharedLib): $(LIBNAME_LA)
-       @$(ECHO) Installing shared library $(DestSharedLib)
-       $(VERB) $(MKDIR) $(libdir)
-       $(VERB) $(LIBTOOL) --mode=install $(INSTALL) $(LIBNAME_LA) $(DestSharedLib)
-       $(VERB) $(LIBTOOL) --finish $(libdir)
+install-local:: $(DestSharedLib)
 
-uninstall-local:: uninstall-shared-library
+$(DestSharedLib): $(libdir) $(LibName.LA)
+       $(Echo) Installing $(BuildMode) Shared Library $(DestSharedLib)
+       $(Verb) $(LTInstall) $(LibName.LA) $(DestSharedLib)
+       $(Verb) $(LIBTOOL) --finish $(libdir)
 
-uninstall-shared-library:
-       @$(ECHO) Uninstalling shared library $(DestSharedLib)
-       $(VERB) $(RM) -f $(DestSharedLib)
+uninstall-local:: 
+       $(Echo) Uninstalling $(BuildMode) Shared Library $(DestSharedLib)
+       -$(Verb) $(RM) -f $(libdir)/lib$(LIBRARYNAME).*
 
 endif
 
@@ -382,368 +511,402 @@ else
   endif
 endif
 
-all-local:: $(LIBNAME_BC)
+all-local:: $(LibName.BC)
 
-$(LIBNAME_BC): $(BUILT_SOURCES) $(ObjectsBC) $(LIBDIR)/.dir
-       @$(ECHO) Linking bytecode library $(notdir $@)
-       $(VERB) $(BCLinkLib) -o $@ $(ObjectsBC)
+$(LibName.BC): $(BUILT_SOURCES) $(ObjectsBC) $(LibDir)/.dir
+       $(Echo) Linking $(BuildMode) Bytecode Library $(notdir $@)
+       $(Verb) $(BCLinkLib) -o $@ $(ObjectsBC)
 
 clean-local::
-ifneq ($(strip $(LIBNAME_BC)),)
-       $(VERB) $(RM) -f $(LIBNAME_BC)
+ifneq ($(strip $(LibName.BC)),)
+       -$(Verb) $(RM) -f $(LibName.BC)
 endif
 
 DestBytecodeLib = $(bytecode_libdir)/lib$(LIBRARYNAME).bc
-install-local:: install-bytecode-library
 
-install-bytecode-library: $(DestBytecodeLib)
+install-local:: $(DestBytecodeLib)
 
-$(DestBytecodeLib): $(LIBNAME_BC) $(bytecode_libdir)
-       @$(ECHO) Installing bytecode library $(DestBytecodeLib)
-       $(VERB) $(INSTALL) $< $@
+$(DestBytecodeLib): $(bytecode_libdir) $(LibName.BC) 
+       $(Echo) Installing $(BuildMode) Bytecode Library $(DestBytecodeLib)
+       $(Verb) $(INSTALL) $(LibName.BC) $@
 
-uninstall-local:: uninstall-bytecode-library
-
-uninstall-bytecode-library: 
-       @$(ECHO) Uninstalling bytecode library $(DestBytecodeLib)
-       $(VERB) $(RM) -f $(DestBytecodeLib)
+uninstall-local::
+       $(Echo) Uninstalling $(BuildMode) Bytecode Library $(DestBytecodeLib)
+       -$(Verb) $(RM) -f $(DestBytecodeLib)
 
 endif
 
-# Does the library want a .o version built?
+#---------------------------------------------------------
+# ReLinked Library Targets:
+#   If the user didn't explicitly forbid building a 
+#   relinked then we provide targets for building them.
+#---------------------------------------------------------
 ifndef DONT_BUILD_RELINKED
-all-local:: $(LIBNAME_O)
 
-$(LIBNAME_O): $(BUILT_SOURCES) $(ObjectsO) $(LIBDIR)/.dir
-       @$(ECHO) Linking object library $(notdir $@)
-       $(VERB) $(Relink) -o $@ $(ObjectsO)
+all-local:: $(LibName.O)
+
+$(LibName.O): $(BUILT_SOURCES) $(ObjectsO) $(LibDir)/.dir
+       $(Echo) Linking $(BuildMode) Object Library $(notdir $@)
+       $(Verb) $(Relink) -o $@ $(ObjectsO)
 
 clean-local::
-ifneq ($(strip $(LIBNAME_O)),)
-       $(VERB) $(RM) -f $(LIBNAME_O)
+ifneq ($(strip $(LibName.O)),)
+       -$(Verb) $(RM) -f $(LibName.O)
 endif
 
 DestRelinkedLib = $(libdir)/$(LIBRARYNAME).o
 
-install-local:: install-relinked-library 
-
-install-relinked-library: $(DestRelinkedLib)
+install-local:: $(DestRelinkedLib)
 
-$(DestRelinkedLib): $(LIBNAME_O)
-       @$(ECHO) Installing object library $(DestRelinkedLib)
-       $(VERB) $(MKDIR) $(libdir)
-       $(VERB) $(LIBTOOL) --mode=install $(INSTALL) $(LIBNAME_O) $(DestRelinkedLib)
+$(DestRelinkedLib): $(libdir) $(LibName.O)
+       $(Echo) Installing $(BuildMode) Object Library $(DestRelinkedLib)
+       $(Verb) $(LTInstall) $(LibName.O) $(DestRelinkedLib)
 
-uninstall-local:: uninstall-relinked-library 
-
-uninstall-relinked-library: 
-       @$(ECHO) Uninstalling object library $(DestRelinkedLib)
-       $(VERB) $(RM) -f $(DestRelinkedLib)
+uninstall-local::
+       $(Echo) Uninstalling $(BuildMode) Object Library $(DestRelinkedLib)
+       -$(Verb) $(RM) -f $(DestRelinkedLib)
 
 endif
 
-# Does the library want an archive version built?
+#---------------------------------------------------------
+# Archive Library Targets:
+#   If the user wanted a regular archive library built, 
+#   then we provide targets for building them.
+#---------------------------------------------------------
 ifdef BUILD_ARCHIVE
-all-local:: $(LIBNAME_A)
 
-$(LIBNAME_A): $(BUILT_SOURCES) $(ObjectsO) $(LIBDIR)/.dir
-       @$(ECHO) Building archive library $(notdir $@)
-       $(VERB)$(RM) -f $@
-       $(VERB) $(Archive) $@ $(ObjectsO)
-       $(VERB) $(Ranlib) $@
+all-local:: $(LibName.A)
+
+$(LibName.A): $(BUILT_SOURCES) $(ObjectsO) $(LibDir)/.dir
+       $(Echo) Building $(BuildMode) Archive Library $(notdir $@)
+       -$(Verb) $(RM) -f $@
+       $(Verb) $(Archive) $@ $(ObjectsO)
+       $(Verb) $(Ranlib) $@
 
 clean-local::
-ifneq ($(strip $(LIBNAME_A)),)
-       $(VERB) $(RM) -f $(LIBNAME_A)
+ifneq ($(strip $(LibName.A)),)
+       -$(Verb) $(RM) -f $(LibName.A)
 endif
 
 DestArchiveLib := $(libdir)/lib$(LIBRARYNAME).a
 
-install-local:: install-archive-library
-
-install-archive-library: $(DestArchiveLib)
+install-local:: $(DestArchiveLib)
 
-$(DestArchiveLib): $(LIBNAME_A)
-       @$(ECHO) Installing archive library $(DestArchiveLib)
-       $(VERB) $(MKDIR) $(libdir)
-       $(VERB) $(LIBTOOL) --mode=install $(INSTALL) $(LIBNAME_A) $(DestArchiveLib)
+$(DestArchiveLib): $(libdir) $(LibName.A)
+       $(Echo) Installing $(BuildMode) Archive Library $(DestArchiveLib)
+       $(Verb) $(MKDIR) $(libdir)
+       $(Verb) $(LTInstall) $(LibName.A) $(DestArchiveLib)
 
-uninstall-local:: install-archive-library
-
-uninstall-archive-library: 
-       @$(ECHO) Uninstalling archive library $(DestArchiveLib)
-       $(VERB) $(RM) -f $(DestArchiveLib)
+uninstall-local::
+       $(Echo) Uninstalling $(BuildMode) Archive Library $(DestArchiveLib)
+       -$(Verb) $(RM) -f $(DestArchiveLib)
 
 endif
 
 # endif LIBRARYNAME
 endif 
 
-#------------------------------------------------------------------------
-# Handle the TOOLNAME option - used when building tool executables...
-#------------------------------------------------------------------------
-#
-# The TOOLNAME option should be used with a USEDLIBS variable that tells the
-# libraries (and the order of the libs) that should be linked to the
-# tool. USEDLIBS should contain a list of library names (some with .a extension)
-# that are automatically linked in as .o files unless the .a suffix is added.
-#
+###############################################################################
+# Tool Build Rules: Build executable tool based on TOOLNAME option
+###############################################################################
+
 ifdef TOOLNAME
 
-# TOOLLINKOPTSB to pass options to the linker like library search path etc
-# Note that this is different from TOOLLINKOPTS, these options
-# are passed to the linker *before* the USEDLIBS options are passed.
-# e.g. usage TOOLLINKOPTSB =  -L/home/xxx/lib
-ifdef TOOLLINKOPTSB
-Link    += $(TOOLLINKOPTSB) 
+#---------------------------------------------------------
+# Set up variables for building a tool.
+#---------------------------------------------------------
+ifdef EXAMPLE_TOOL
+ToolBuildPath   := $(ExmplDir)/$(TOOLNAME)$(EXEEXT)
+else
+ToolBuildPath   := $(ToolDir)/$(TOOLNAME)$(EXEEXT)
 endif
+ProjLibsOptions := $(patsubst %.a.o, -l%, $(addsuffix .o, $(USEDLIBS)))
+ProjLibsOptions := $(patsubst %.o, $(LibDir)/%.o,  $(ProjLibsOptions))
+LLVMLibsOptions := $(patsubst %.a.o, -l%, $(addsuffix .o, $(LLVMLIBS)))
+LLVMLibsOptions := $(patsubst %.o, $(LLVMLibDir)/%.o, $(LLVMLibsOptions))
+ProjUsedLibs    := $(patsubst %.a.o, lib%.a, $(addsuffix .o, $(USEDLIBS)))
+LLVMUsedLibs    := $(patsubst %.a.o, lib%.a, $(addsuffix .o, $(LLVMLIBS)))
+ProjLibsPaths   := $(addprefix $(LibDir)/,$(ProjUsedLibs))
+LLVMLibsPaths   := $(addprefix $(LLVMLibDir)/,$(LLVMUsedLibs))
 
-# TOOLEXENAME* - These compute the output filenames to generate...
-TOOLEXENAME := $(TOOLDIR)/$(TOOLNAME)
-
-# USED_LIBS_OPTIONS - Compute the options line that add -llib1 -llib2, etc.
-PROJ_LIBS_OPTIONS := $(patsubst %.a.o, -l%, $(addsuffix .o, $(USEDLIBS)))
-PROJ_LIBS_OPTIONS := $(patsubst %.o, $(LIBDIR)/%.o,  $(PROJ_LIBS_OPTIONS))
-LLVM_LIBS_OPTIONS := $(patsubst %.a.o, -l%, $(addsuffix .o, $(LLVMLIBS)))
-LLVM_LIBS_OPTIONS := $(patsubst %.o, $(LLVMLIBDIR)/%.o, $(LLVM_LIBS_OPTIONS))
-
-PROJ_USED_LIBS    := $(patsubst %.a.o, lib%.a, $(addsuffix .o, $(USEDLIBS)))
-LLVM_USED_LIBS    := $(patsubst %.a.o, lib%.a, $(addsuffix .o, $(LLVMLIBS)))
-PROJ_LIBS_PATHS   := $(addprefix $(LIBDIR)/,$(PROJ_USED_LIBS))
-LLVM_LIBS_PATHS   := $(addprefix $(LLVMLIBDIR)/,$(LLVM_USED_LIBS))
-
-LINK_OPTS := $(TOOLLINKOPTS) $(PROJ_LIBS_OPTIONS) $(LLVM_LIBS_OPTIONS)
-
-#
-# Libtool link options:
-#      Ensure that all binaries have their symbols exported so that they can
-#      by dlsym'ed.
-#
-
-# Handle compression libraries automatically
+#---------------------------------------------------------
+# Handle optional compression libraries automatically
+#---------------------------------------------------------
+ExtraLibs := $(LIBS)
 ifeq ($(HAVE_BZIP2),1)
-LIBS += -lbz2
+ExtraLibs += -lbz2
 endif
 ifeq ($(HAVE_ZLIB),1)
-LIBS += -lz
+ExtraLibs += -lz
 endif
 
-# Tell make that we need to rebuild subdirectories before we can link the tool.
-# This affects things like LLI which has library subdirectories.
-$(LIBS): $(addsuffix /.makeall, $(PARALLEL_DIRS))
+#---------------------------------------------------------
+# Tell make that we need to rebuild subdirectories before 
+# we can link the tool. This affects things like LLI which 
+# has library subdirectories.
+#---------------------------------------------------------
+$(ToolBuildPath): $(addsuffix /.makeall, $(PARALLEL_DIRS))
 
-all-local::   $(TOOLEXENAME)
+#---------------------------------------------------------
+# Provide targets for building the tools
+#---------------------------------------------------------
+all-local:: $(ToolBuildPath)
 
 clean-local::
-ifneq ($(strip $(TOOLEXENAME)),)
-       $(VERB) $(RM) -f $(TOOLEXENAME)
+ifneq ($(strip $(ToolBuildPath)),)
+       -$(Verb) $(RM) -f $(ToolBuildPath)
 endif
 
-$(TOOLEXENAME): $(BUILT_SOURCES) $(ObjectsO) $(PROJ_LIBS_PATHS) $(LLVM_LIBS_PATHS) $(TOOLDIR)/.dir
-       @$(ECHO) Linking $(CONFIGURATION) executable $(TOOLNAME) $(STRIP_WARN_MSG)
-       $(VERB) $(Link) -o $@ $(ObjectsO) $(PROJ_LIBS_OPTIONS) $(LLVM_LIBS_OPTIONS) $(LIBS)
-       @$(ECHO) ======= Finished linking $(CONFIGURATION) executable $(TOOLNAME) $(STRIP_WARN_MSG) 
+ifdef EXAMPLE_TOOL
+$(ToolBuildPath): $(ExmplDir)/.dir
+else
+$(ToolBuildPath): $(ToolDir)/.dir
+endif
 
-install-local:: install-tool
+$(ToolBuildPath): $(BUILT_SOURCES) $(ObjectsO) $(ProjLibsPaths) $(LLVMLibsPaths)
+       $(Echo) Linking $(BuildMode) executable $(TOOLNAME) $(StripWarnMsg)
+       $(Verb) $(Link) -o $@ $(TOOLLINKOPTS) $(ObjectsO) $(ProjLibsOptions) \
+          $(LLVMLibsOptions) $(ExtraLibs) $(TOOLLINKOPTSB)
+       $(Echo) ======= Finished Linking $(BuildMode) Executable $(TOOLNAME) $(StripWarnMsg) 
 
 DestTool = $(bindir)/$(TOOLNAME)
 
-install-tool: $(DestTool)
-
-$(DestTool): $(TOOLEXENAME)
-       @$(ECHO) Installing $(DestTool)
-       $(VERB) $(INSTALL) $(TOOLEXENAME) $(bindir)
+install-local:: $(DestTool)
 
-uninstall-local:: uninstall-tool
+$(DestTool): $(bindir) $(ToolBuildPath)
+       $(Echo) Installing $(BuildMode) $(DestTool)
+       $(Verb) $(INSTALL) $(ToolBuildPath) $(DestTool)
 
-uninstall-tool:
-       @$(ECHO) Uninstalling $(DestTool)
-       $(VERB) $(RM) -f $(DestTool)
+uninstall-local::
+       $(Echo) Uninstalling $(BuildMode) $(DestTool)
+       -$(Verb) $(RM) -f $(DestTool)
 
 endif
 
+###############################################################################
+# Object Build Rules: Build object files based on sources 
+###############################################################################
+
+# Provide rule sets for when dependency generation is enabled
 ifndef DISABLE_AUTO_DEPENDENCIES
 
-# Create .lo files in the OBJDIR directory from the .cpp and .c files...
+#---------------------------------------------------------
+# Create .lo files in the ObjDir directory from the .cpp and .c files...
+#---------------------------------------------------------
 ifdef SHARED_LIBRARY
 
-$(OBJDIR)/%.lo $(OBJDIR)/%.o: %.cpp $(OBJDIR)/.dir
-       @$(ECHO) "Compiling $(CONFIGURATION) $*.cpp For Shared Library"
-       $(VERB) if $(LTCompile.CXX) -MD -MT $@ -MP -MF $(OBJDIR)/$*.LACXXd $< -o $@ ; \
-       then $(MV) -f "$(OBJDIR)/$*.LACXXd" "$(OBJDIR)/$*.d"; \
-        else $(RM) -f "$(OBJDIR)/$*.LACXXd"; exit 1; fi
+$(ObjDir)/%.lo $(ObjDir)/%.o: %.cpp $(ObjDir)/.dir
+       $(Echo) "Compiling $*.cpp for $(BuildMode) build (PIC)"
+       $(Verb) if $(LTCompile.CXX) -MD -MT $@ -MP -MF $(ObjDir)/$*.LACXXd $< -o $@ ; \
+       then $(MV) -f "$(ObjDir)/$*.LACXXd" "$(ObjDir)/$*.d"; \
+       else $(RM) -f "$(ObjDir)/$*.LACXXd"; exit 1; fi
 
-$(OBJDIR)/%.lo $(OBJDIR)/%.o: %.c $(OBJDIR)/.dir 
-       @$(ECHO) "Compiling $(CONFIGURATION) $*.c For Shared Library"
-       $(VERB) if $(LTCompile.C) -MD -MT $@ -MP -MF $(OBJDIR)/$*.LACd $< -o $@ ; \
-       then $(MV) -f "$(OBJDIR)/$*.LACd" "$(OBJDIR)/$*.d"; \
-        else $(RM) -f "$(OBJDIR)/$*.LACd"; exit 1; fi
+$(ObjDir)/%.lo $(ObjDir)/%.o: %.c $(ObjDir)/.dir 
+       $(Echo) "Compiling $*.c for $(BuildMode) build (PIC)"
+       $(Verb) if $(LTCompile.C) -MD -MT $@ -MP -MF $(ObjDir)/$*.LACd $< -o $@ ; \
+       then $(MV) -f "$(ObjDir)/$*.LACd" "$(ObjDir)/$*.d"; \
+       else $(RM) -f "$(ObjDir)/$*.LACd"; exit 1; fi
 
+#---------------------------------------------------------
+# Create .o files in the ObjDir directory from the .cpp and .c files...
+#---------------------------------------------------------
 else
 
-$(OBJDIR)/%.o: %.cpp $(OBJDIR)/.dir
-       @$(ECHO) "Compiling $(CONFIGURATION) $*.cpp For Archive"
-       $(VERB) if $(Compile.CXX) -MD -MT $@ -MP -MF $(OBJDIR)/$*.CXXd $< -o $@ ; \
-       then $(MV) -f "$(OBJDIR)/$*.CXXd" "$(OBJDIR)/$*.d"; \
-        else $(RM) -f "$(OBJDIR)/$*.CXXd"; exit 1; fi
+$(ObjDir)/%.o: %.cpp $(ObjDir)/.dir
+       $(Echo) "Compiling $*.cpp for $(BuildMode) build"
+       $(Verb) if $(Compile.CXX) -MD -MT $@ -MP -MF $(ObjDir)/$*.CXXd $< -o $@ ; \
+       then $(MV) -f "$(ObjDir)/$*.CXXd" "$(ObjDir)/$*.d"; \
+       else $(RM) -f "$(ObjDir)/$*.CXXd"; exit 1; fi
 
-$(OBJDIR)/%.o: %.c $(OBJDIR)/.dir
-       @$(ECHO) "Compiling $(CONFIGURATION) $*.c For Archive"
-       $(VERB) if $(Compile.C) -MD -MT $@ -MP -MF $(OBJDIR)/$*.Cd $< -o $@ ; \
-       then $(MV) -f "$(OBJDIR)/$*.Cd" "$(OBJDIR)/$*.d"; \
-        else $(RM) -f "$(OBJDIR)/$*.Cd"; exit 1; fi
+$(ObjDir)/%.o: %.c $(ObjDir)/.dir
+       $(Echo) "Compiling $*.c for $(BuildMode) build"
+       $(Verb) if $(Compile.C) -MD -MT $@ -MP -MF $(ObjDir)/$*.Cd $< -o $@ ; \
+       then $(MV) -f "$(ObjDir)/$*.Cd" "$(ObjDir)/$*.d"; \
+       else $(RM) -f "$(ObjDir)/$*.Cd"; exit 1; fi
 
 endif
 
-# Create .bc files in the OBJDIR directory from .cpp and .c files...
-$(OBJDIR)/%.bc: %.cpp $(OBJDIR)/.dir
-       @$(ECHO) "Compiling $(CONFIGURATION) $*.cpp to bytecode"
-       $(VERB) if $(BCCompile.CXX) -MD -MT $@ -MP -MF "$(OBJDIR)/$*.BCCXXd" $< -o $@ ; \
-       then $(MV) -f "$(OBJDIR)/$*.BCCXXd" "$(OBJDIR)/$*.d"; \
-        else $(RM) -f "$(OBJDIR)/$*.BCCXXd"; exit 1; fi
-
-$(OBJDIR)/%.bc: %.c $(OBJDIR)/.dir
-       @$(ECHO) "Compiling $(CONFIGURATION) $*.c to bytecode"
-       $(VERB) if $(BCCompile.C) -MD -MT $@ -MP -MF "$(OBJDIR)/$*.BCCd" $< -o $@ ; \
-       then $(MV) -f "$(OBJDIR)/$*.BCCd" "$(OBJDIR)/$*.d"; \
-        else $(RM) -f "$(OBJDIR)/$*.BCCd"; exit 1; fi
-
+#---------------------------------------------------------
+# Create .bc files in the ObjDir directory from .cpp and .c files...
+#---------------------------------------------------------
+$(ObjDir)/%.bc: %.cpp $(ObjDir)/.dir
+       $(Echo) "Compiling $*.cpp for $(BuildMode) build (bytecode)"
+       $(Verb) if $(BCCompile.CXX) -MD -MT $@ -MP -MF "$(ObjDir)/$*.BCCXXd" $< -o $@ ; \
+       then $(MV) -f "$(ObjDir)/$*.BCCXXd" "$(ObjDir)/$*.d"; \
+       else $(RM) -f "$(ObjDir)/$*.BCCXXd"; exit 1; fi
+
+$(ObjDir)/%.bc: %.c $(ObjDir)/.dir
+       $(Echo) "Compiling $*.c for $(BuildMode) build (bytecode)"
+       $(Verb) if $(BCCompile.C) -MD -MT $@ -MP -MF "$(ObjDir)/$*.BCCd" $< -o $@ ; \
+       then $(MV) -f "$(ObjDir)/$*.BCCd" "$(ObjDir)/$*.d"; \
+       else $(RM) -f "$(ObjDir)/$*.BCCd"; exit 1; fi
+
+# Provide alternate rule sets if dependencies are disabled
 else
 
 ifdef SHARED_LIBRARY
 
-$(OBJDIR)/%.lo $(OBJDIR)/%.o: %.cpp $(OBJDIR)/.dir 
-       @$(ECHO) "Compiling $(CONFIGURATION) $*.cpp For Shared Library"
+$(ObjDir)/%.lo $(ObjDir)/%.o: %.cpp $(ObjDir)/.dir 
+       $(Echo) "Compiling $*.cpp for $(BuildMode) build (PIC)"
        $(LTCompile.CXX) $< -o $@ 
 
-$(OBJDIR)/%.lo $(OBJDIR)/%.o: %.c $(OBJDIR)/.dir 
-       @$(ECHO) "Compiling $(CONFIGURATION) $*.cpp For Shared Library"
+$(ObjDir)/%.lo $(ObjDir)/%.o: %.c $(ObjDir)/.dir 
+       $(Echo) "Compiling $*.cpp for $(BuildMode) build (PIC)"
        $(LTCompile.C) $< -o $@ 
 
 else
 
-$(OBJDIR)/%.o: %.cpp $(OBJDIR)/.dir
-       @$(ECHO) "Compiling $(CONFIGURATION) $*.cpp For Archive"
+$(ObjDir)/%.o: %.cpp $(ObjDir)/.dir
+       $(Echo) "Compiling $*.cpp for $(BuildMode) build"
        $(Compile.CXX) $< -o $@ 
 
-$(OBJDIR)/%.o: %.c $(OBJDIR)/.dir
-       @$(ECHO) "Compiling $(CONFIGURATION) $*.cpp For Archive"
+$(ObjDir)/%.o: %.c $(ObjDir)/.dir
+       $(Echo) "Compiling $*.cpp for $(BuildMode) build"
        $(Compile.C) $< -o $@ 
 endif
 
-# Create .bc files in the OBJDIR directory from .cpp and .c files...
-$(OBJDIR)/%.bc: %.cpp $(OBJDIR)/.dir
-       @$(ECHO) "Compiling $(CONFIGURATION) $*.cpp To Bytecode"
-       $(BCCompileCPP) $< -o $@ 
+$(ObjDir)/%.bc: %.cpp $(ObjDir)/.dir
+       $(Echo) "Compiling $*.cpp for $(BuildMode) build (bytecode)"
+       $(BCCompile.CXX) $< -o $@ 
 
-$(OBJDIR)/%.bc: %.c $(OBJDIR)/.dir
-       @$(ECHO) "Compiling $(CONFIGURATION) $*.c To Bytecode"
-       $(BCCompileC) $< -o $@
+$(ObjDir)/%.bc: %.c $(ObjDir)/.dir
+       $(Echo) "Compiling $*.c for $(BuildMode) build (bytecode)"
+       $(BCCompile.C) $< -o $@
 
 endif
 
-$(OBJDIR)/%.bc: %.ll $(OBJDIR)/.dir $(LLVMAS)
-       @$(ECHO) "Compiling $*.ll To Bytecode"
-       $(VERB) $(LLVMAS) $< -f -o $@
+#---------------------------------------------------------
+# Provide rule to build .bc files from .ll sources,
+# regardless of dependencies
+#---------------------------------------------------------
+$(ObjDir)/%.bc: %.ll $(ObjDir)/.dir $(LLVMAS)
+       $(Echo) "Compiling $*.ll for $(BuildMode) build"
+       $(Verb) $(LLVMAS) $< -f -o $@
+
+###############################################################################
+# TABLEGEN: Provide rules for running tblgen to produce *.inc files
+###############################################################################
 
 ifdef TARGET
 
-TDFILES := $(strip $(wildcard $(BUILD_SRC_DIR)/*.td) $(LLVM_SRC_ROOT)/lib/Target/Target.td)
+TDFiles := $(strip $(wildcard $(BUILD_SRC_DIR)/*.td) $(LLVM_SRC_ROOT)/lib/Target/Target.td)
+INCFiles := $(filter %.inc,$(BUILT_SOURCES))
 
-$(BUILT_SOURCES): $(TDFILES) 
+$(INCFiles) : $(TBLGEN) $(TDFiles)
 
-%GenRegisterNames.inc : %.td
-       @echo "Building $(<F) register names with tblgen"
-       $(VERB) $(TableGen) -gen-register-enums -o $@ $<
+%GenRegisterNames.inc : %.td 
+       $(Echo) "Building $(<F) register names with tblgen"
+       $(Verb) $(TableGen) -gen-register-enums -o $@ $<
 
-%GenRegisterInfo.h.inc : %.td
-       @echo "Building $(<F) register information header with tblgen"
-       $(VERB) $(TableGen) -gen-register-desc-header -o $@ $<
+%GenRegisterInfo.h.inc : %.td 
+       $(Echo) "Building $(<F) register information header with tblgen"
+       $(Verb) $(TableGen) -gen-register-desc-header -o $@ $<
 
 %GenRegisterInfo.inc : %.td
-       @echo "Building $(<F) register info implementation with tblgen"
-       $(VERB) $(TableGen) -gen-register-desc -o $@ $<
+       $(Echo) "Building $(<F) register info implementation with tblgen"
+       $(Verb) $(TableGen) -gen-register-desc -o $@ $<
 
 %GenInstrNames.inc : %.td
-       @echo "Building $(<F) instruction names with tblgen"
-       $(VERB) $(TableGen) -gen-instr-enums -o $@ $<
+       $(Echo) "Building $(<F) instruction names with tblgen"
+       $(Verb) $(TableGen) -gen-instr-enums -o $@ $<
 
 %GenInstrInfo.inc : %.td
-       @echo "Building $(<F) instruction information with tblgen"
-       $(VERB) $(TableGen) -gen-instr-desc -o $@ $<
+       $(Echo) "Building $(<F) instruction information with tblgen"
+       $(Verb) $(TableGen) -gen-instr-desc -o $@ $<
 
 %GenAsmWriter.inc : %.td
-       @echo "Building $(<F) assembly writer with tblgen"
-       $(VERB) $(TableGen) -gen-asm-writer -o $@ $<
+       $(Echo) "Building $(<F) assembly writer with tblgen"
+       $(Verb) $(TableGen) -gen-asm-writer -o $@ $<
 
 %GenATTAsmWriter.inc : %.td
-       @echo "Building $(<F) AT&T assembly writer with tblgen"
-       $(VERB) $(TableGen) -gen-asm-writer -o $@ $< 
+       $(Echo) "Building $(<F) AT&T assembly writer with tblgen"
+       $(Verb) $(TableGen) -gen-asm-writer -o $@ $< 
 
 %GenIntelAsmWriter.inc : %.td
-       @echo "Building $(<F) Intel assembly writer with tblgen"
-       $(VERB) $(TableGen) -gen-asm-writer -asmwriternum=1 -o $@ $< 
+       $(Echo) "Building $(<F) Intel assembly writer with tblgen"
+       $(Verb) $(TableGen) -gen-asm-writer -asmwriternum=1 -o $@ $< 
 
 %GenInstrSelector.inc: %.td
-       @echo "Building $(<F) instruction selector with tblgen"
-       $(VERB) $(TableGen) -gen-instr-selector -o $@ $< 
+       $(Echo) "Building $(<F) instruction selector with tblgen"
+       $(Verb) $(TableGen) -gen-instr-selector -o $@ $< 
 
 %GenCodeEmitter.inc:: %.td
-       @echo "Building $(<F) code emitter with tblgen"
-       $(VERB) $(TableGen) -gen-emitter -o $@ $<
+       $(Echo) "Building $(<F) code emitter with tblgen"
+       $(Verb) $(TableGen) -gen-emitter -o $@ $<
 
 clean-local::
-       $(VERB) rm -f *.inc
+       -$(Verb) $(RM) -f $(INCFiles)
 
 endif
 
-#
-# Rules for building lex/yacc files
-#
-LEX_FILES   = $(filter %.l, $(SOURCES))
-LEX_OUTPUT  = $(LEX_FILES:%.l=%.cpp)
-YACC_FILES  = $(filter %.y, $(SOURCES))
-YACC_OUTPUT = $(addprefix $(YACC_FILES:%.y=%), .h .cpp .output)
-.PRECIOUS: $(LEX_OUTPUT) $(YACC_OUTPUT)
-
-# Create a .cpp source file from a flex input file... this uses sed to cut down
-# on the warnings emited by GCC...
-#
-# The last line is a gross hack to work around flex aparently not being able to
-# resize the buffer on a large token input.  Currently, for uninitialized string
-# buffers in LLVM we can generate very long tokens, so this is a hack around it.
+###############################################################################
+# LEX AND YACC: Provide rules for generating sources with lex and yacc
+###############################################################################
+
+#---------------------------------------------------------
+# Provide rules for generating a .cpp source file from 
+# (f)lex input sources. 
+#---------------------------------------------------------
+
+LexFiles  := $(filter %.l,$(Sources))
+
+ifneq ($(LexFiles),)
+
+LexOutput := $(strip $(patsubst %.l,%.cpp,$(LexFiles)))
+
+.PRECIOUS: $(LexOutput)
+
+# Note the extra sed filtering here, used to cut down on the warnings emited 
+# by GCC.  The last line is a gross hack to work around flex aparently not 
+# being able to resize the buffer on a large token input.  Currently, for 
+# uninitialized string buffers in LLVM we can generate very long tokens, so 
+# this is a hack around it.
 # FIXME.  (f.e. char Buffer[10000] )
-#
 %.cpp: %.l
-       @$(ECHO) Flexing $<
-       $(VERB) $(FLEX) -t $< | \
-       $(SED) '/^find_rule/d' | \
+       $(Echo) Flexing $<
+       $(Verb) $(FLEX) -t $< | \
        $(SED) 's/void yyunput/inline void yyunput/' | \
        $(SED) 's/void \*yy_flex_realloc/inline void *yy_flex_realloc/' | \
        $(SED) 's/#define YY_BUF_SIZE 16384/#define YY_BUF_SIZE (16384*64)/' \
-         > $@.tmp
-       $(VERB) cmp -s $@ $@.tmp > /dev/null || $(MV) -f $@.tmp $@
-       @# remove the output of flex if it didn't get moved over...
-       @rm -f $@.tmp
+         > $@
+
+clean-local::
+       -$(Verb) $(RM) -f $(LexOutput)
+       $(Verb) $(RM) -f $(LexOutput)
+
+endif
+
+#---------------------------------------------------------
+# Provide rules for generating a .cpp and .h source files 
+# from yacc (bison) input sources.
+#---------------------------------------------------------
+
+YaccFiles  := $(filter %.y,$(Sources))
+ifneq ($(YaccFiles),)
+YaccOutput := $(addprefix $(patsubst %.y,%,$(YaccFiles)),.h .cpp .output)
+
+.PRECIOUS: $(YaccOutput)
+
+# Cancel built-in rules for yacc
+%.c: %.y 
+%.cpp: %.y
+%.h: %.y
 
 # Rule for building the bison parsers...
-%.c: %.y     # Cancel built-in rules for yacc
-%.h: %.y     # Cancel built-in rules for yacc
 %.cpp %.h : %.y
-       @$(ECHO) "Bisoning $*.y"
-       $(VERB) $(BISON) -v -d -p $(<F:%Parser.y=%) -o $*.tab.c  $<
-       $(VERB) cmp -s $*.tab.c $*.cpp > /dev/null || $(MV) -f $*.tab.c $*.cpp
-       $(VERB) cmp -s $*.tab.h $*.h   > /dev/null || $(MV) -f $*.tab.h $*.h
-       @# If the files were not updated, don't leave them lying around...
-       @rm -f $*.tab.c $*.tab.h
-
-# To create the directories...
-%/.dir:
-       $(VERB) $(MKDIR) $* > /dev/null
-       @$(DATE) > $@
+       $(Echo) "Bisoning $*.y"
+       $(Verb) $(BISON) -v -d -p $(<F:%Parser.y=%) -o $*.tab.c  $<
+       $(Verb) $(MV) -f $*.tab.c $*.cpp
+       $(Verb) $(MV) -f $*.tab.h $*.h
 
-.PRECIOUS: $(OBJDIR)/.dir $(LIBDIR)/.dir $(TOOLDIR)/.dir $(LLVMLIBDIR)/.dir
-.PRECIOUS: $(LLVMTOOLDIR)/.dir
+clean-local::
+       -$(Verb) $(RM) -f $(YaccOutput)
+       $(Verb) $(RM) -f $(YaccOutput)
+endif
+
+###############################################################################
+# OTHER RULES: Other rules needed
+###############################################################################
 
 # To create postscript files from dot files...
 ifneq ($(DOT),false)
@@ -751,103 +914,248 @@ ifneq ($(DOT),false)
        $(DOT) -Tps < $< > $@
 else
 %.ps: %.dot
-       $(ECHO) "Cannot build $@: The program dot is not installed"
+       $(Echo) "Cannot build $@: The program dot is not installed"
 endif
 
-#
 # This rules ensures that header files that are removed still have a rule for
 # which they can be "generated."  This allows make to ignore them and
 # reproduce the dependency lists.
-#
 %.h:: ;
 
-# 'make clean' nukes the tree
+# Define clean-local to clean the current directory. Note that this uses a
+# very conservative approach ensuring that empty variables do not cause 
+# errors or disastrous removal.
 clean-local::
-ifneq ($(strip $(OBJDIR)),)
-       $(VERB) $(RM) -rf $(OBJDIR)
+ifneq ($(strip $(ObjDir)),)
+       -$(Verb) $(RM) -rf $(ObjDir)
 endif
-       $(VERB) $(RM) -f core core.[0-9][0-9]* *.o *.d *~ *.flc
+       -$(Verb) $(RM) -f core core.[0-9][0-9]* *.o *.d *~ *.flc
 ifneq ($(strip $(SHLIBEXT)),) # Extra paranoia - make real sure SHLIBEXT is set
-       $(VERB) $(RM) -f *$(SHLIBEXT)
-endif
-ifneq ($(strip $(LEX_OUTPUT)),)
-       $(VERB) $(RM) -f $(LEX_OUTPUT) 
-endif
-ifneq ($(strip $(YACC_OUTPUT)),)
-       $(VERB) $(RM) -f $(YACC_OUTPUT)
+       -$(Verb) $(RM) -f *$(SHLIBEXT)
 endif
 
+clean-all-local::
+       -$(Verb) $(RM) -rf Debug Release Profile
+
+# Build tags database for Emacs/Xemacs:
+tags:: TAGS CTAGS
+
+TAGS: 
+       find $(BUILD_SRC_ROOT)/include $(BUILD_SRC_ROOT)/lib \
+          $(BUILD_SRC_ROOT)/tools $(BUILD_SRC_ROOT)/examples \
+          $(BUILD_OBJ_ROOT)/include $(BUILD_OBJ_ROOT)/lib \
+          $(BUILD_OBJ_ROOT)/tools $(BUILD_OBJ_ROOT)/examples \
+        -name '*.cpp' -o -name '*.h' | \
+        $(ETAGS) $(ETAGSFLAGS) -
+
+CTAGS:
+       find $(BUILD_SRC_ROOT)/include $(BUILD_SRC_ROOT)/lib \
+          $(BUILD_SRC_ROOT)/tools $(BUILD_SRC_ROOT)/examples \
+          $(BUILD_OBJ_ROOT)/include $(BUILD_OBJ_ROOT)/lib \
+          $(BUILD_OBJ_ROOT)/tools $(BUILD_OBJ_ROOT)/examples \
+          \( -name '*.cpp' -o -name '*.h' \) -print | \
+          ctags -ImtT -o $(BUILD_OBJ_ROOT)/CTAGS -L -
+
+
 ###############################################################################
 # DEPENDENCIES: Include the dependency files if we should
 ###############################################################################
 ifndef DISABLE_AUTO_DEPENDENCIES
 
 # If its not one of the cleaning targets
-ifneq ($strip($(filter-out clean clean-local dist-clean, $(MAKECMDGOALS))),)
+ifneq ($strip($(filter-out clean clean-local dist-clean,$(MAKECMDGOALS))),)
 
 # Get the list of dependency files
-DependFiles := $(basename $(filter %.cpp %.c %.cc, $(SOURCES)))
-DependFiles := $(patsubst %,$(BUILD_OBJ_DIR)/$(CONFIGURATION)/%.d,$(DependFiles))
+DependFiles := $(basename $(filter %.cpp %.c %.cc, $(Sources)))
+DependFiles := $(patsubst %,$(BUILD_OBJ_DIR)/$(BuildMode)/%.d,$(DependFiles))
 
 -include /dev/null $(DependFiles)
 
 endif
 
-endif  # ifndef DISABLE_AUTO_DEPENDENCIES
+endif 
 
-################################################################################
-# PRECONDITIONS - that which must be built/checked first
-################################################################################
+###############################################################################
+# DISTRIBUTION: Handle construction of a distribution tarball
+###############################################################################
 
-OBJMKFILE := $(BUILD_OBJ_DIR)/Makefile
-SRCMKFILE := $(BUILD_SRC_DIR)/Makefile
-CONFIGURE := $(LLVM_SRC_ROOT)/configure
-CONFIG_STATUS := $(LLVM_OBJ_ROOT)/config.status
-MAKE_CONFIG_IN := $(LLVM_SRC_ROOT)/Makefile.config.in
-MAKE_CONFIG := $(LLVM_OBJ_ROOT)/Makefile.config
+#------------------------------------------------------------------------
+# Define distribution related variables
+#------------------------------------------------------------------------
+DistName    := $(LLVM_TARBALL_NAME)
+DistDir     := $(BUILD_OBJ_ROOT)/$(DistName)
+TopDistDir  := $(BUILD_OBJ_ROOT)/$(DistName)
+DistTarGZip := $(BUILD_OBJ_ROOT)/$(DistName).tar.gz
+DistZip     := $(BUILD_OBJ_ROOT)/$(DistName).zip
+DistTarBZ2  := $(BUILD_OBJ_ROOT)/$(DistName).tar.bz2
+DistAlways  := CREDITS.TXT LICENSE.TXT README.txt README AUTHORS COPYING \
+              ChangeLog INSTALL NEWS Makefile Makefile.common Makefile.rules \
+              Makefile.config.in configure autoconf
+DistOther   := $(notdir $(wildcard \
+               $(BUILD_SRC_DIR)/*.h \
+               $(BUILD_SRC_DIR)/*.td \
+               $(BUILD_SRC_DIR)/*.def \
+               $(BUILD_SRC_DIR)/*.ll \
+               $(BUILD_SRC_DIR)/*.in))
+DistSources := $(Sources) $(EXTRA_DIST)
+DistSubDirs := $(SubDirs)
+DistFiles   := $(DistAlways) $(DistSources) $(DistOther)
 
 #------------------------------------------------------------------------
-# List of the preconditions
+# We MUST build distribution with OBJ_DIR != SRC_DIR
 #------------------------------------------------------------------------
-preconditions: $(CONFIG_STATUS) $(MAKE_CONFIG) $(OBJMKFILE) 
+ifeq ($(BUILD_SRC_DIR),$(BUILD_OBJ_DIR))
+dist dist-check dist-clean dist-gzip dist-bzip2 dist-zip ::
+       $(Echo) ERROR: Target $@ only available with OBJ_DIR != SRC_DIR
 
-all all-local check check-local dist dist-check install:: $(BUILT_SOURCES)
+DistCheckTop := 
+else
 
-clean-local::
-ifneq ($(strip $(BUILT_SOURCES)),)
-       $(VERB) $(RM) -f $(BUILT_SOURCES)
+DistCheckTop := check
+
+#------------------------------------------------------------------------
+# Prevent catastrophic remove
+#------------------------------------------------------------------------
+ifeq ($(LLVM_TARBALL_NAME),)
+$(error LLVM_TARBALL_NAME is empty.  Please rerun configure)
 endif
 
 #------------------------------------------------------------------------
-# Make sure we're not using a stale configuration
+# Prevent attempt to run dist targets from anywhere but the top level
 #------------------------------------------------------------------------
-.PRECIOUS: $(CONFIG_STATUS)
-$(CONFIG_STATUS): $(CONFIGURE)
-       @$(ECHO) Reconfiguring with $@
-       $(VERB) $(CONFIG_STATUS) --recheck
+ifneq ($(LEVEL),.)
+
+dist dist-check dist-clean dist-gzip dist-bzip2 dist-zip ::
+       $(Echo) ERROR: You must run $@ from $(BUILD_OBJ_ROOT)
+
+else
 
 #------------------------------------------------------------------------
-# Make sure the configuration makefile is up to date
+# Provide the top level targets
 #------------------------------------------------------------------------
-$(MAKE_CONFIG): $(MAKE_CONFIG_IN)
-       @$(ECHO) Regenerating $@
-       $(VERB) cd $(LLVM_OBJ_ROOT) ; $(CONFIG_STATUS) Makefile.config
-       $(VERB) $(MAKE) $(MFLAGS) $(MAKECMDGOALS)
-       @exit 0;
 
+dist-gzip:: $(DistTarGZip)
+
+$(DistTarGZip) : distdir
+       $(Echo) Packing gzipped distribution tar file.
+       $(Verb) cd $(BUILD_OBJ_ROOT) ; $(TAR) chf - "$(DistName)" | gzip -c > "$(DistTarGZip)"
+
+dist-bzip2:: $(DistTarBZ2)
+
+$(DistTarBZ2) : distdir
+       $(Echo) Packing bzipped distribution tar file.
+       $(Verb) cd $(BUILD_OBJ_ROOT) ; $(TAR) chf - $(DistName) | $(BZIP2) -c >$(DistTarBZ2)
+
+dist-zip:: $(DistZip)
+
+$(DistZip) : distdir
+       $(Echo) Packing zipped distribution file.
+       $(Verb) rm -f $(DistZip)
+       $(Verb) cd $(BUILD_OBJ_ROOT) ; $(ZIP) -rq $(DistZip) $(DistName)
+
+dist :: $(DistTarGZip) $(DistTarBZ2) $(DistZip) 
+       $(Echo) ===== DISTRIBUTION PACKAGING SUCESSFUL =====
+
+DistCheckDir := $(LLVM_OBJ_ROOT)/_distcheckdir
+
+dist-check:: $(DistCheckTop) $(DistTarGZip)
+       $(Echo) Checking distribution tar file.
+       $(Verb) if test -d $(DistCheckDir) ; then \
+         $(RM) -rf $(DistCheckDir) ; \
+       fi
+       $(Verb) $(MKDIR) $(DistCheckDir)
+       $(Verb) cd $(DistCheckDir) && \
+         $(MKDIR) $(DistCheckDir)/build && \
+         $(MKDIR) $(DistCheckDir)/install && \
+         gunzip -c $(DistTarGZip) | $(TAR) xf - && \
+         cd build && \
+         ../$(DistName)/configure --prefix="$(DistCheckDir)/install" \
+           --srcdir=../$(DistName) --with-llvmgccdir="$(LLVMGCCDIR)" && \
+         $(MAKE) check && \
+         $(MAKE) install && \
+         $(MAKE) uninstall && \
+         $(MAKE) dist && \
+         $(MAKE) clean && \
+         $(MAKE) dist-clean && \
+         $(EchoCmd) ===== $(DistTarGZip) Ready For Distribution =====
+
+dist-clean::
+       $(Echo) Cleaning distribution files
+       -$(Verb) $(RM) -rf $(DistTarGZip) $(DistTarBZ2) $(DistZip) $(DistName) $(DistCheckDir)
+
+endif
 
 #------------------------------------------------------------------------
-# If the Makefile in the source tree has been updated, copy it over into the
-# build tree. But, only do this if the source and object makefiles differ
+# Provide the recursive distdir target for building the distribution directory
 #------------------------------------------------------------------------
-ifneq ($(OBJMKFILE),$(SRCMKFILE))
-.PRECIOUS: $(OBJMKFILE)
-$(OBJMKFILE): $(SRCMKFILE)
-       @$(ECHO) "Updating Makefile from : $(dir $<)"
-       $(VERB) $(MKDIR) $(@D)
-       $(VERB) cp -f $< $@
-       $(VERB) $(MAKE) $(MFLAGS) $(MAKECMDGOALS)
-       @exit 0;
+distdir : $(DistSources)
+       $(Echo) Building Distribution Directory $(DistDir)
+       $(Verb) if test "$(DistDir)" = "$(TopDistDir)" ; then \
+         if test -d "$(DistDir)" ; then \
+           find $(DistDir) -type d ! -perm -200 -exec chmod u+w {} ';'  || \
+             exit 1 ; \
+         fi ; \
+         $(EchoCmd) Removing $(DistDir) ; \
+         $(RM) -rf $(DistDir); \
+       fi
+       $(Verb) $(MKDIR) $(DistDir) 
+       $(Verb) srcdirstrip=`echo "$(BUILD_SRC_DIR)" | sed 's|.|.|g'`; \
+       srcrootstrip=`echo "$(BUILD_SRC_ROOT)" | sed 's|.|.|g'`; \
+       for file in $(DistFiles) ; do \
+         case "$$file" in \
+           $(BUILD_SRC_DIR)/*) file=`echo "$$file" | sed "s#^$$srcdirstrip/##"`;; \
+           $(BUILD_SRC_ROOT)/*) file=`echo "$$file" | sed "s#^$$srcrootstrip/#$(BUILD_OBJ_ROOT)/#"`;; \
+         esac; \
+         if test -f "$$file" || test -d "$$file" ; then \
+           from_dir=. ; \
+         else \
+           from_dir=$(BUILD_SRC_DIR); \
+         fi; \
+         to_dir=`echo "$$file" | sed -e 's#/[^/]*$$##'`; \
+         if test "$$to_dir" != "$$file" && test "$$to_dir" != "."; then \
+           to_dir="$(DistDir)/$$dir"; \
+           $(MKDIR) "$$to_dir" ; \
+         else \
+           to_dir="$(DistDir)"; \
+         fi; \
+         mid_dir=`echo "$$file" | sed -n -e 's#^\(.*\)/[^/]*$$#\1#p'`; \
+         if test -n "$$mid_dir" ; then \
+            $(MKDIR) "$$to_dir/$$mid_dir" || exit 1; \
+          fi ; \
+         if test -d "$$from_dir/$$file"; then \
+           if test -d "$(BUILD_SRC_DIR)/$$file" && \
+              test "$$from_dir" != "$(BUILD_SRC_DIR)" ; then \
+             cp -pR "$(BUILD_SRC_DIR)/$$file" "$$to_dir" || exit 1; \
+           fi; \
+           cp -pR $$from_dir/$$file $$to_dir || exit 1; \
+         elif test -f "$$from_dir/$$file" ; then \
+           cp -p "$$from_dir/$$file" "$(DistDir)/$$file" || exit 1; \
+         elif test -L "$$from_dir/$$file" ; then \
+           cp -pd "$$from_dir/$$file" $(DistDir)/$$file || exit 1; \
+         elif echo "$(DistAlways)" | grep -v "$$file" >/dev/null ; then \
+           $(EchoCmd) "===== WARNING: Distribution Source $$from_dir/$$file Not Found!" ; \
+         elif test "$(Verb)" != '@' ; then \
+           $(EchoCmd) "Skipping non-existent $$from_dir/$$file" ; \
+         fi; \
+       done
+       $(Verb) for subdir in $(DistSubDirs) ; do \
+         if test "$$subdir" \!= "." ; then \
+           new_distdir="$(DistDir)/$$subdir" ; \
+           test -d "$$new_distdir" || $(MKDIR) "$$new_distdir" || exit 1; \
+           ( cd $$subdir && $(MAKE) DistDir="$$new_distdir" distdir ) || exit 1; \
+         fi; \
+       done
+       $(Verb) $(MAKE) DistDir="$(DistDir)" dist-hook || exit 1
+       -$(Verb) find $(DistDir) -type d ! -perm -777 -exec chmod a+rwx {} \; -o \
+         ! -type d ! -perm -444 -links 1 -exec chmod a+r {} \; -o \
+         ! -type d ! -perm -400 -exec chmod a+r {} \; -o \
+         ! -type d ! -perm -444 -exec $(SHELL) $(INSTALL_SH) -c -m a+r {} {} \; \
+       || chmod -R a+r $(DistDir)
+
+# This is invoked by distdir target, define it as a no-op to avoid errors if not
+# defined by user.
+dist-hook::
+
 endif
 
 ###############################################################################
@@ -856,24 +1164,13 @@ endif
 
 ifeq ($(LEVEL),.)
 
-#------------------------------------------------------------------------
-# Handle construction of a distribution 
-dist:: preconditions
-       @$(ECHO) Target dist is not implemented yet
-
-dist-check:: preconditions dist
-       @$(ECHO) Target dist-check is not implemented yet
-
-dist-clean:: preconditions
-       @$(ECHO) Target dist-clean is not implemented yet
-
 #------------------------------------------------------------------------
 # Install support for project's include files:
 #------------------------------------------------------------------------
 install-local::
-       @$(ECHO) Installing include files
-       $(VERB) $(MKDIR) $(includedir)
-       $(VERB) if [ -d "$(BUILD_SRC_ROOT)/include" ] ; then \
+       $(Echo) Installing include files
+       $(Verb) $(MKDIR) $(includedir)
+       $(Verb) if [ -d "$(BUILD_SRC_ROOT)/include" ] ; then \
          cd $(BUILD_SRC_ROOT)/include && \
            find . -path '*/Internal' -prune -o '(' -type f \
              '!' '(' -name '*~' -o -name '.cvsignore' -o -name '.#*' ')' \
@@ -881,56 +1178,42 @@ install-local::
        fi
 
 uninstall-local::
-       @$(ECHO) Uninstalling include files
-       $(VERB) if [ -d "$(BUILD_SRC_ROOT)/include" ] ; then \
+       $(Echo) Uninstalling include files
+       $(Verb) if [ -d "$(BUILD_SRC_ROOT)/include" ] ; then \
          cd $(BUILD_SRC_ROOT)/include && \
            $(RM) -f `find . -path '*/Internal' -prune -o '(' -type f \
              '!' '(' -name '*~' -o -name '.cvsignore' -o -name '.#*' ')' \
              -print ')' | grep -v CVS | sed 's#^#$(includedir)/#'` ; \
        fi 
 
-#------------------------------------------------------------------------
-# Build tags database for Emacs/Xemacs:
-#------------------------------------------------------------------------
-TAGS: tags
-
-tags::
-       find include lib tools examples -name '*.cpp' -o -name '*.h' | $(ETAGS) $(ETAGSFLAGS) -
-
-dist-clean:: clean
-       $(VERB) $(RM) -rf $(LEVEL)/Makefile.config \
-                         $(LEVEL)/include/llvm/Config/config.h \
-                         $(LEVEL)/autoconf/autom4te.cache \
-                         $(LEVEL)/config.log \
-                         $(LEVEL)/TAGS
 endif
 
-###############################################################################
-# MISCELLANEOUS - utility targets
-###############################################################################
-
 #------------------------------------------------------------------------
 # Print out the directories used for building
+#------------------------------------------------------------------------
 printvars::
-       @$(ECHO) "BUILD_SRC_ROOT: " $(BUILD_SRC_ROOT)
-       @$(ECHO) "BUILD_SRC_DIR : " $(BUILD_SRC_DIR)
-       @$(ECHO) "BUILD_OBJ_ROOT: " $(BUILD_OBJ_ROOT)
-       @$(ECHO) "BUILD_OBJ_DIR : " $(BUILD_OBJ_DIR)
-       @$(ECHO) "LLVM_SRC_ROOT : " $(LLVM_SRC_ROOT)
-       @$(ECHO) "LLVM_OBJ_ROOT : " $(LLVM_OBJ_ROOT)
-       @$(ECHO) "CONFIGURATION : " $(CONFIGURATION)
-       @$(ECHO) "OBJDIR: " $(OBJDIR)
-       @$(ECHO) "LIBDIR: " $(LIBDIR)
-       @$(ECHO) "TOOLDIR: " $(TOOLDIR)
-       @$(ECHO) "TDFILES:" '$(TDFILES)'
-       @$(ECHO) "Compile.CXX: " '$(Compile.CXX)'
-       @$(ECHO) "Compile.C: " '$(Compile.C)'
-
-# This frivolous target provided for Resistor who requested that the makefiles
-# be hardened and that he get a "pony" after the makefiles (accidentally) 
-# deleted his unix kernel.
-pony::
-       @wget -q \
-        http://search.cpan.org/src/ASAVIGE/Acme-EyeDrops-1.40/lib/Acme/EyeDrops/pony2.eye \
-        -O /tmp/resistor.pony
-       @cat /tmp/resistor.pony
+       $(Echo) "BuildMode      : " '$(BuildMode)'
+       $(Echo) "BUILD_SRC_ROOT : " '$(BUILD_SRC_ROOT)'
+       $(Echo) "BUILD_SRC_DIR  : " '$(BUILD_SRC_DIR)'
+       $(Echo) "BUILD_OBJ_ROOT : " '$(BUILD_OBJ_ROOT)'
+       $(Echo) "BUILD_OBJ_DIR  : " '$(BUILD_OBJ_DIR)'
+       $(Echo) "LLVM_SRC_ROOT  : " '$(LLVM_SRC_ROOT)'
+       $(Echo) "LLVM_OBJ_ROOT  : " '$(LLVM_OBJ_ROOT)'
+       $(Echo) "libdir         : " '$(libdir)'
+       $(Echo) "bindir         : " '$(bindir)'
+       $(Echo) "sysconfdir     : " '$(sysconfdir)'
+       $(Echo) "bytecode_libdir: " '$(bytecode_libdir)'
+       $(Echo) "UserTargets    : " '$(UserTargets)'
+       $(Echo) "ObjMakefiles   : " '$(ObjMakefiles)'
+       $(Echo) "SrcMakefiles   : " '$(SrcMakefiles)'
+       $(Echo) "ObjDir         : " '$(ObjDir)'
+       $(Echo) "LibDir         : " '$(LibDir)'
+       $(Echo) "ToolDir        : " '$(ToolDir)'
+       $(Echo) "ExmplDir       : " '$(ExmplDir)'
+       $(Echo) "TDFiles        : " '$(TDFiles)'
+       $(Echo) "INCFiles       : " '$(INCFiles)'
+       $(Echo) "Compile.CXX    : " '$(Compile.CXX)'
+       $(Echo) "Compile.C      : " '$(Compile.C)'
+       $(Echo) "Archive        : " '$(Archive)'
+       $(Echo) "YaccFiles      : " '$(YaccFiles)'
+       $(Echo) "LexFiles       : " '$(LexFiles)'