Subversion Repositories DevTools

Rev

Rev 5991 | Blame | Compare with Previous | Last modification | View Log | RSS feed

##############################################################################
# File: rules.std
# Compat for older (embedded) makefiles
##############################################################################
#

SCM_ROOT        = $(GBE_ROOT)
SCM_TYPE        = $(GBE_TYPE)
SCM_BIN         = $(GBE_BIN)
SCM_PLATFORM    = $(GBE_PLATFORM)

#
###############################################################################
# Common definitions extracted from OPTIONS
#   CC_PRE      - Verbosity control: Compiler commands. Show on args, allargs
#   XX_PRE      - Verbosity control: General commands.  Show on args, allargs
#   AA_PRE      - Verbosity control: Internal commands. Only display for allargs
#
#   SHOWARGS    - Argument Showing Level: NONE, ALL, ARGS
#   VERBOSE_OPT - Verbosity option suitable for jats commands
##############################################################################
#
CC_PRE      := @
XX_PRE      := @
AA_PRE      := @

SHOWARGS    := NONE
VERBOSE_OPT :=

USE_FILTER  := 1
LEAVETMP    :=
SHOWENV     :=

ifdef OPTIONS

ifneq "$(findstring args,$(OPTIONS))" ""        # Show arguments (default)
CC_PRE :=
XX_PRE :=
SHOWARGS := ARGS
VERBOSE_OPT := -verbose
endif

ifneq "$(findstring noargs,$(OPTIONS))" ""      # Show no arguments
CC_PRE := @
XX_PRE := @
SHOWARGS := NONE
VERBOSE_OPT :=
endif

ifneq "$(findstring allargs,$(OPTIONS))" ""     #  Show ALL arguments
AA_PRE :=
SHOWARGS := ALL
VERBOSE_OPT := -verbose=3
endif

ifneq "$(findstring filter,$(OPTIONS))" ""      # Use filter (Default)
USE_FILTER := 1
endif

ifneq "$(findstring nofilter,$(OPTIONS))" ""    # Don't use filter
USE_FILTER  :=
endif

ifneq "$(findstring leavetmp,$(OPTIONS))" ""    # Leave temp files
LEAVETMP := 1
endif

ifneq "$(findstring noleavetmp,$(OPTIONS))" ""  # Don't leave temp files (Default)
LEAVETMP :=
endif

ifneq "$(findstring showenv,$(OPTIONS))" ""     # Display env before commands
SHOWENV := 1
endif

ifneq "$(findstring noshowenv,$(OPTIONS))" ""   # Don't display env before commands
SHOWENV :=
endif

endif

###############################################################################
# Some old VIX  uses have the following EnvVars set. These can confuse the
# gnu autoconfigure  process. Ensure that they are not set

unexport CC CXX CPP CPP_LINK CPPFLAGS
#unexport LD_LIBRARY_PATH

#
###############################################################################
# Brain hurts stuff... $(space) becomes a macro containing 1 space
# other aren't so bad.  These are used to make argument lists is a few 
# places where we have to translate from a space seperated list to a 
# something else seperated list (or vicky verka).
###############################################################################
#
comma           := ,
plus            := +
semicolon       := ;
empty           := 
space           := $(empty) $(empty)
spacealt        := %20

#
###############################################################################
# Macros to assist in the handling of paths with spaces
#       encodepath - Uses spacealt, uses /, space-sep-list
#                    Used to conatins lists of paths that may contain
#                    spaces. Used for INCLUDE and LIB paths
#
#       decodepath - Decodes an encoded path-list.
#                    User specifies the item prefix and suffix.
#                    Return list uses \ and may have spaces in pathnames
#                    Prefix items with 1st-arg
#                    Join items with 2nd arg
#
# Usage:
#       aa = $(call encodepath,c:\Program Files)
#       $(call decodepath,-I,;,$(aa))
#
###############################################################################
#
encodepath = $(subst //,/,$(subst \,/,$(subst $(space),$(spacealt),$(strip $(1)))))
decodepath = $(subst $(spacealt),$(space),$(subst $(space),$(empty),$(patsubst %,$(1)%$(2),$(subst /,\,$(3)))))

#
###############################################################################
#
#  Macros to convert relative to absolute paths
#
#   Work around for a bug in make 3.81 where abspath assumes that the input
#   is a relative path. The work around checks for paths that have a : or start
#   with a '/ - and assumes these are absolute.
#   It will only call makes 'abspath' for relative paths.
#
###############################################################################
#
myabspath = $(foreach dir,$1,$(call myabs1path,$(dir)))
myabs1path = $(if $(or $(findstring :,$1),$(filter /%,$1)),$1,$(abspath $1))

#
###############################################################################
# A little macro used within each of the rules for translating a file from 
# one type to another to print the environment if the variable SHOWENV has 
# been defined.
###############################################################################
#
ifdef SHOWENV
define show_environment
                $(printenv)
endef
else
define show_environment
endef
endif

#
################################################################################
# A macro to dump out command files if the ARGS or ALLARGS option is set
# Usage: $(call show_cmdfile,<PathOfCommandFile>)
################################################################################
#
ifeq ($(SHOWARGS),NONE)
show_cmdfile =
else
show_cmdfile = echo "Using command file: $(1)";cat $(1);echo "End of Command file"
endif

#
###############################################################################
# Support macros
###############################################################################
#

#..     Invoke RunTime support operations
#
#       Usage:
#               $(JatsRunTime) function_name -- args
#       Notes:
#               Don't use " to quote arguments as it will invoke a shell
#               under windows (and others). This can only slow it down.
#               Using ' is OK
#
define  JatsRunTime
    $(GBE_PERL) -Mjats_runtime -e
endef

#.. Remove files contained within the specified list
#   Used internally to delete generated files
#
#   Usage:      $(call RmFiles,VARIABLE_NAME)
#
define RmFiles
        $(AA_PRE)JatsFileUtil 'r0' '' $($1)
endef

#.. Install/uninstall the specified file
#
#   Usage:      $(call InstallFile,dest,file,fmode)
#               $(call UninstallFile,file)
#
define InstallFile
    $(call CopyFile,installing,$1,$2,$3,)
endef

define UninstallFile
    $(if $(wildcard $1),$(call UncopyFile,uninstalling,$1))
endef

#.. Package/Unpackage the specified file
#
#   Usage:      $(call PackageFile,dest,file,fmode)
#               $(call UnpackageFile,file)
#
define PackageFile
    $(call CopyFile,packaging,$1,$2,$3,)
endef

define UnpackageFile
    $(if $(wildcard $1),$(call UncopyFile,unpackaging,$1))
endef

#.. Generic Copy/Remove the specified file
#
#   Usage:      $(call CopyFile,Text,dest,file,fmode)
#               $(call UncopyFile,Text,file)
#
#   Notes:
#       dest, file and path
#       May have spaces in them
#               These will have been escaped with a '\' which will
#               need to be removed. The '\ ' is required to keep make
#               happy elsewhere.
#
#       Current implementation uses a dedicated JATS-internal program to perform
#       the operations. This is much better than the previous implementation
#       which was shell-based. Its problems included:
#               1) Very slow under Windows
#               2) Special handling on $
#               3) Windows Path length limitation of < ~260 characters
#
#       Implementation note:
#               1) Do not get the shell involved in invoking the command
#                  Quote args in '' not "" as "" will trigger shell usage
#                  This is good as we don't need/want shell expansion either
#                  Shell startup is slow under windows.
#               2) Paths use '/'. This is passed though to the utility
#
#       Macros
#       NiceName - convert a '\ ' pathname into an string with plain spaces
#                  Convert nasty characters into %nn to get past the shell
#                  Characters to convert are:
#                       Percent(%)              - Its our escape lead-in
#                                                 Not sure make handles such file
#                       singlequote(')          - It quotes our arguments
#                       Ampersand(&)            - If found make uses shell
#
NiceName = $(subst \$(space), ,$(subst ',%27,$(subst &,%26,$(subst %,%25,$1))))

define CopyFile
        $(AA_PRE)JatsFileUtil 'c0' '$1' '$(call NiceName,$2)' '$(call NiceName,$3)' '$4'
endef

define UncopyFile
        $(AA_PRE)JatsFileUtil 'd0' '$1' '$(call NiceName,$2)'
endef

###############################################################################
#   Unit Test Post Processing support
#       Allows user control by adding UTF_POSTPROCESS=1/0 the command line
#
UTF_POSTPROCESS := 1

# Set to defined or undefined
ifneq "$(findstring 1,$(UTF_POSTPROCESS))" ""
override UTF_POSTPROCESS := 1
else
override UTF_POSTPROCESS :=
endif

##