LUFA/Build/DMBS/DMBS/doxygen.mk

   1 #
   2 #            DMBS Build System
   3 #     Released into the public domain.
   4 #
   5 #  dean [at] fourwalledcubicle [dot] com
   6 #        www.fourwalledcubicle.com
   7 #
   8
   9 DMBS_BUILD_MODULES         += DOXYGEN
  10 DMBS_BUILD_TARGETS         += doxygen doxygen-upgrade doxygen-create
  11 DMBS_BUILD_MANDATORY_VARS  +=
  12 DMBS_BUILD_OPTIONAL_VARS   += DOXYGEN_CONF DOXYGEN_FAIL_ON_WARNING DOXYGEN_OVERRIDE_PARAMS
  13 DMBS_BUILD_PROVIDED_VARS   +=
  14 DMBS_BUILD_PROVIDED_MACROS +=
  15
  16 SHELL = /bin/sh
  17
  18 ERROR_IF_UNSET   ?= $(if $(filter undefined, $(origin $(strip $(1)))), $(error Makefile $(strip $(1)) value not set))
  19 ERROR_IF_EMPTY   ?= $(if $(strip $($(strip $(1)))), , $(error Makefile $(strip $(1)) option cannot be blank))
  20 ERROR_IF_NONBOOL ?= $(if $(filter Y N, $($(strip $(1)))), , $(error Makefile $(strip $(1)) option must be Y or N))
  21
  22 # Default values of optionally user-supplied variables
  23 DOXYGEN_CONF            ?= doxyfile
  24 DOXYGEN_FAIL_ON_WARNING ?= Y
  25 DOXYGEN_OVERRIDE_PARAMS ?= QUIET=YES
  26
  27 # Sanity check user supplied values
  28 $(foreach MANDATORY_VAR, $(DMBS_BUILD_MANDATORY_VARS), $(call ERROR_IF_UNSET, $(MANDATORY_VAR)))
  29 $(call ERROR_IF_EMPTY, DOXYGEN_CONF)
  30 $(call ERROR_IF_NONBOOL, DOXYGEN_FAIL_ON_WARNING)
  31
  32 # Output Messages
  33 MSG_DOXYGEN_CMD         := ' [DOXYGEN] :'
  34
  35 # Determine Doxygen invocation command
  36 BASE_DOXYGEN_CMD := ( cat $(DOXYGEN_CONF) $(DOXYGEN_OVERRIDE_PARAMS:%=; echo "%") ) | doxygen -
  37 ifeq ($(DOXYGEN_FAIL_ON_WARNING), Y)
  38    DOXYGEN_CMD := if ( $(BASE_DOXYGEN_CMD) 2>&1 | grep -v "warning: ignoring unsupported tag" ;); then exit 1; fi;
  39 else
  40    DOXYGEN_CMD := $(BASE_DOXYGEN_CMD)
  41 endif
  42
  43 # Error if the specified Doxygen configuration file does not exist
  44 $(DOXYGEN_CONF):
  45         $(error Doxygen configuration file $@ does not exist)
  46
  47 # Builds the project documentation using the specified configuration file and the DOXYGEN tool
  48 doxygen: $(DOXYGEN_CONF) $(MAKEFILE_LIST)
  49         @echo $(MSG_DOXYGEN_CMD) Configuration file \"$(DOXYGEN_CONF)\" with parameters \"$(DOXYGEN_OVERRIDE_PARAMS)\"
  50         $(DOXYGEN_CMD)
  51
  52 # Upgrades an existing Doxygen configuration file to the latest Doxygen template, preserving settings
  53 doxygen-upgrade: $(DOXYGEN_CONF) $(MAKEFILE_LIST)
  54         @echo $(MSG_DOXYGEN_CMD) Upgrading configuration file \"$(DOXYGEN_CONF)\" with latest template
  55         doxygen -u $(DOXYGEN_CONF) > /dev/null
  56
  57 # Creates a new Doxygen configuration file with the set file name
  58 doxygen-create: $(MAKEFILE_LIST)
  59         @echo $(MSG_DOXYGEN_CMD) Creating new configuration file \"$(DOXYGEN_CONF)\" with latest template
  60         doxygen -g $(DOXYGEN_CONF) > /dev/null
  61
  62 # Phony build targets for this module
  63 .PHONY: $(DMBS_BUILD_TARGETS)