make/include/base.rules

   1 .PHONY: report.main report.gcc report.modules report.var report.true report.help
   2 .PHONY: shell.run
   3
   4 report.modules::
   5
   6 report.main:
   7         @$(MAKE) report.true REPORT=main
   8
   9 report.gcc:
  10         @$(MAKE) report.true REPORT=gcc
  11
  12 report.var:
  13         @$(MAKE) report.true REPORT=var
  14
  15 ## needed for nested make (which drives each report)
  16 report.true:
  17         @true
  18
  19 ## linefeed is important
  20 define REPORT.help.item.global
  21         @echo 'report.$(1)' | awk '{ printf("  %-21s  $(REPORT.help.$(1))\n", $$0) }'
  22
  23 endef
  24 define REPORT.help.item.module
  25         @echo '$($(1).name).report' | awk '{ printf("  %-21s  $(1)-scoped vars\n", $$0) }'
  26
  27 endef
  28
  29 REPORT.help.main = global general vars
  30 REPORT.help.gcc  = global gcc vars (inherited by module GCC)
  31 REPORT.help.var  = usage: make report.var name=VARNAME
  32
  33 report.help:
  34         @echo "  AVAILABLE MAKEFILE VARS REPORTS"
  35         @echo "  ----------------------------------------------------------------"
  36         $(foreach n,main gcc var,$(call REPORT.help.item.global,$n))
  37         $(foreach n,$(MODULES.NAMES),$(call REPORT.help.item.module,$n))
  38
  39 ## diagnostic aid when troubleshooting build issues
  40 shell.run:
  41         $(command)