3 # Copyright (C) Dean Camera, 2012.
5 # dean [at] fourwalledcubicle [dot] com
9 LUFA_BUILD_MODULES += DOXYGEN
10 LUFA_BUILD_TARGETS += doxygen
12 # -----------------------------------------------------------------------------
13 # LUFA Doxygen Buildsystem Makefile Module.
14 # -----------------------------------------------------------------------------
16 # Provides a set of targets to automatically build Doxygen documentation for
17 # a project (see www.doxygen.org).
18 # -----------------------------------------------------------------------------
21 # doxygen - Build Doxygen Documentation
23 # MANDATORY PARAMETERS:
27 # OPTIONAL PARAMETERS:
29 # DOXYGEN_CONF - Doxygen configuration filename
30 # DOXYGEN_FAIL_ON_WARNING - Set to Y to fail the build on Doxygen warnings,
31 # N to continue even if warnings occur
32 # DOXYGEN_OVERRIDE_PARAMS - Parameters to override in the doxygen
34 # -----------------------------------------------------------------------------
37 MSG_DOXYGEN_CMD = ' [DOXYGEN] :'
39 # Default values of user-supplied variables
40 DOXYGEN_CONF ?= Doxygen.conf
41 DOXYGEN_FAIL_ON_WARNING ?= Y
42 DOXYGEN_OVERRIDE_PARAMS ?= QUIET=YES
44 # Determine Doxygen invocation command
45 DOXYGEN_CMD = ( cat Doxygen.conf ; $(DOXYGEN_OVERRIDE_PARAMS:%=echo "%";)) | doxygen -
46 ifeq ($(DOXYGEN_FAIL_ON_WARNING), Y)
47 DOXYGEN_CMD = if ( ( cat Doxygen.conf $(DOXYGEN_OVERRIDE_PARAMS:%=; echo "%") ) | doxygen - 2>&1 | grep -v "warning: ignoring unsupported tag" ;); then exit 1; fi;
51 @echo $(MSG_DOXYGEN_CMD) Configuration file \"$(DOXYGEN_CONF)\" with parameters \"$(DOXYGEN_OVERRIDE_PARAMS)\"