This directory contains make rules for printing help information when using make, such as the project make usage text, rules, and more.

This directory also contains make rules for helping debug the make environment and project rules (e.g., printing the values of environment variables, etc.).

Usage: make <command> [<ENV_VAR>=<value> <ENV_VAR>=<value> ...]

Prints a Makefile help message, which includes a list of common commands.

$ make help

Prints a sorted list of Makefile rules.

$ make list-rules

The list of rules is not exhaustive, as the list does not include rules which have not been explicitly declared PHONY targets and does not include rules declared via variables.

Prints a sorted list of Makefile rules for computing project statistics.

$ make list-stats-rules

The list of rules is not exhaustive, as the list does not include rules which have not been explicitly declared PHONY targets and does not include rules declared via variables.

Prints a sorted list of Makefile variable names.

$ make list-variables

To remove duplicates, pipe to uniq. Note that the list of variables is not exhaustive, as the list does not include built-in variables.

Prints the runtime value of a Makefile variable.

$ make inspect.CC

$ make inspect.ROOT_DIR

Asserts that a Makefile variable is set.

$ make assert.CXX

If a variable is not set, the command exits with a non-zero exit code.