1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
RIOT/doc.txt
Jim O'Brien bd149e7db9 thread: Add THREAD_NAMES make flag
Separate thread names from DEVELHELP so thread names can be
enabled in non-development/debug builds when required/desired.
THREAD_NAMES will be enabled by default then DEVELHELP is set to 1.
2020-09-10 10:08:27 +02:00

62 lines
1.7 KiB
Plaintext

/**
* @defgroup config Compile time configurations
* @brief List of compile-time configurations
*
* This group contains all compile-time configurations macros that are
* intended to be modified by the user.
*
* These configuration macros are defined within modules like this:
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [.c]
* #ifndef SOME_CONFIGURATION_PARAM
* #define SOME_CONFIGURATION_PARAM DEFAULT_VALUE
* #endif
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Because of that, configurations can be altered e.g via CFLAGS (e.g
* `CFLAGS += -DSOME_CONFIGURATION_PARAM=SOME_VALUE`)
*/
/**
* @defgroup utils Utilities
* @brief Utilities and helper functionality
*
* Additional scripts and configuration options to ease RIOT
* development.
* @{
*/
/**
* @def DEVELHELP
* @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
#endif
/**
* @def CONFIG_THREAD_NAMES
* @brief This global macro enable storage of thread names to help developers.
*
* To activate it set environment variable `THREAD_NAMES=1`, or use Kconfig.
* It is automatically enabled if `DEVELHELP` is.
*/
#if DOXYGEN
# define CONFIG_THREAD_NAMES
#endif
/**
* @def TEST_SUITES
* @brief This global macro activates functionality that is needed for
* automated testing but not needed otherwise.
*/
#if DOXYGEN
# define TEST_SUITES
#endif
/**
* @}
*/