X-Git-Url: http://git.linex4red.de/pub/USBasp.git/blobdiff_plain/fc3768733ee6204967234e2f0dabde6d6d80882e..c7344c22ac700dacf55a8dc729111dd7781c5fed:/LUFA/Build/lufa.doxygen.in?ds=inline diff --git a/LUFA/Build/lufa.doxygen.in b/LUFA/Build/lufa.doxygen.in index 532bde5bd..1a5ede8e9 100644 --- a/LUFA/Build/lufa.doxygen.in +++ b/LUFA/Build/lufa.doxygen.in @@ -8,7 +8,7 @@ LUFA_BUILD_MODULES += DOXYGEN LUFA_BUILD_TARGETS += doxygen -LUFA_BUILD_MANDATORY_VARS += +LUFA_BUILD_MANDATORY_VARS += LUFA_PATH LUFA_BUILD_OPTIONAL_VARS += DOXYGEN_CONF DOXYGEN_FAIL_ON_WARNING DOXYGEN_OVERRIDE_PARAMS # ----------------------------------------------------------------------------- @@ -24,7 +24,7 @@ LUFA_BUILD_OPTIONAL_VARS += DOXYGEN_CONF DOXYGEN_FAIL_ON_WARNING DOXYGEN_OVERRI # # MANDATORY PARAMETERS: # -# (None) +# LUFA_PATH - Path to the LUFA library core # # OPTIONAL PARAMETERS: # @@ -35,20 +35,30 @@ LUFA_BUILD_OPTIONAL_VARS += DOXYGEN_CONF DOXYGEN_FAIL_ON_WARNING DOXYGEN_OVERRI # configuration file # ----------------------------------------------------------------------------- +# Sanity-check values of mandatory user-supplied variables +LUFA_PATH ?= $(error Makefile LUFA_PATH value not set) + # Default values of optionally user-supplied variables DOXYGEN_CONF ?= Doxygen.conf DOXYGEN_FAIL_ON_WARNING ?= Y -DOXYGEN_OVERRIDE_PARAMS ?= QUIET=YES +DOXYGEN_OVERRIDE_PARAMS ?= QUIET=YES HTML_STYLESHEET=$(patsubst %/,%,$(LUFA_PATH))/DoxygenPages/Style/Style.css # Output Messages -MSG_DOXYGEN_CMD = ' [DOXYGEN] :' +MSG_DOXYGEN_CMD := ' [DOXYGEN] :' # Determine Doxygen invocation command -DOXYGEN_CMD = ( cat Doxygen.conf ; $(DOXYGEN_OVERRIDE_PARAMS:%=echo "%";)) | doxygen - +BASE_DOXYGEN_CMD = ( cat Doxygen.conf $(DOXYGEN_OVERRIDE_PARAMS:%=; echo "%") ) | doxygen - ifeq ($(DOXYGEN_FAIL_ON_WARNING), Y) - DOXYGEN_CMD = if ( ( cat Doxygen.conf $(DOXYGEN_OVERRIDE_PARAMS:%=; echo "%") ) | doxygen - 2>&1 | grep -v "warning: ignoring unsupported tag" ;); then exit 1; fi; + DOXYGEN_CMD = if ( $(BASE_DOXYGEN_CMD) 2>&1 | grep -v "warning: ignoring unsupported tag" ;); then exit 1; fi; +else ifeq ($(DOXYGEN_FAIL_ON_WARNING), N) + DOXYGEN_CMD = $(BASE_DOXYGEN_CMD) +else + $(error DOXYGEN_FAIL_ON_WARNING must be Y or N.) endif doxygen: @echo $(MSG_DOXYGEN_CMD) Configuration file \"$(DOXYGEN_CONF)\" with parameters \"$(DOXYGEN_OVERRIDE_PARAMS)\" $(DOXYGEN_CMD) + +# Phony build targets for this module +.PHONY: doxygen \ No newline at end of file