Merge pull request #8029 from smlng/enh/make/develhelp

make: cleanup and centralise DEVELHELP setting

Makefile.include

@@ -111,6 +111,14 @@ endif
 
 QQ=
 
+# Set this to 1 to enable code in RIOT that does safety checking
+# which is not needed in a production environment but helps in the
+# development process:
+DEVELHELP ?= 0
+ifeq ($(DEVELHELP),1)
+  CFLAGS += -DDEVELHELP
+endif
+
 # Fail on warnings. Can be overridden by `make WERROR=0`.
 WERROR ?= 1
 export WERROR

doc.txt

@@ -9,8 +9,11 @@
 
 /**
  * @def DEVELHELP
- * @brief   This global macro activates some behavior that helps you while
- *          developing but is otherwise optimized out.
+ * @brief   This global macro activates functionality to help developers.
+ *
+ *          Additional code parts such as (extensive) debug output and sanity
+ *          checks using assertions. To activate it set environment variable
+ *          `DEVELHELP=1`, or disable explicitly with `DEVELHELP=0`.
  */
 #if DOXYGEN
 #   define DEVELHELP