X-Git-Url: http://git.linex4red.de/pub/lufa.git/blobdiff_plain/56e792c95b1a29e61d9204a8f7f305d7f33261f1..fc0ff2f97657a893db336dded648c8bd60582bc1:/LUFA/Build/lufa.doxygen.in diff --git a/LUFA/Build/lufa.doxygen.in b/LUFA/Build/lufa.doxygen.in index 9efbbcbcc..7d4f8ae31 100644 --- a/LUFA/Build/lufa.doxygen.in +++ b/LUFA/Build/lufa.doxygen.in @@ -6,8 +6,10 @@ # www.lufa-lib.org # -LUFA_BUILD_MODULES += DOXYGEN -LUFA_BUILD_TARGETS += doxygen +LUFA_BUILD_MODULES += DOXYGEN +LUFA_BUILD_TARGETS += doxygen +LUFA_BUILD_MANDATORY_VARS += LUFA_PATH +LUFA_BUILD_OPTIONAL_VARS += DOXYGEN_CONF DOXYGEN_FAIL_ON_WARNING DOXYGEN_OVERRIDE_PARAMS # ----------------------------------------------------------------------------- # LUFA Doxygen Buildsystem Makefile Module. @@ -22,7 +24,7 @@ LUFA_BUILD_TARGETS += doxygen # # MANDATORY PARAMETERS: # -# (None) +# LUFA_PATH - Path to the LUFA library core # # OPTIONAL PARAMETERS: # @@ -33,18 +35,23 @@ LUFA_BUILD_TARGETS += doxygen # configuration file # ----------------------------------------------------------------------------- -# Output Messages -MSG_DOXYGEN_CMD = ' [DOXYGEN] :' +# Sanity-check values of mandatory user-supplied variables +LUFA_PATH ?= $(error Makefile LUFA_PATH value not set.) -# Default values of user-supplied variables +# 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] :' # 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 + DOXYGEN_CMD = $(BASE_DOXYGEN_CMD) endif doxygen: