From 6650afb264b2247a0e7786cc3a2fef8a115d285d Mon Sep 17 00:00:00 2001 From: Christian Thaeter Date: Mon, 12 Jan 2009 21:07:40 +0100 Subject: [PATCH] document LOG_BASELIMIT's --- src/nobug.h | 39 +++++++++++++++++++++++++++++---------- 1 file changed, 29 insertions(+), 10 deletions(-) diff --git a/src/nobug.h b/src/nobug.h index 9ab0663..9a67d2e 100644 --- a/src/nobug.h +++ b/src/nobug.h @@ -640,16 +640,6 @@ NOBUG_IF_NOT_RELEASE( NOBUG_LVL(lvl), ## __VA_ARGS__) \ ) -#define NOBUG_LVL(lvl) NOBUG_LVL_##lvl -#define NOBUG_LVL_0 "EMERG" -#define NOBUG_LVL_1 "ALERT" -#define NOBUG_LVL_2 "CRIT" -#define NOBUG_LVL_3 "ERR" -#define NOBUG_LVL_4 "WARNING" -#define NOBUG_LVL_5 "NOTICE" -#define NOBUG_LVL_6 "INFO" -#define NOBUG_LVL_7 "TRACE" - /* low level logging handler @@ -664,7 +654,36 @@ NOBUG_IF_NOT_RELEASE( NOBUG_LOCATION_FUNC location NOBUG_TAIL(__VA_ARGS__)) \ ) +#define NOBUG_LVL(lvl) NOBUG_LVL_##lvl +#define NOBUG_LVL_0 "EMERG" +#define NOBUG_LVL_1 "ALERT" +#define NOBUG_LVL_2 "CRIT" +#define NOBUG_LVL_3 "ERR" +#define NOBUG_LVL_4 "WARNING" +#define NOBUG_LVL_5 "NOTICE" +#define NOBUG_LVL_6 "INFO" +#define NOBUG_LVL_7 "TRACE" +/* +//index.log_baselimit xref:LOG_BASELIMIT[LOG_BASELIMIT] +//logmacros [[LOG_BASELIMIT]] +//logmacros .LOG_BASELIMIT +//logmacros NOBUG_LOG_BASELIMIT_ALPHA +//logmacros NOBUG_LOG_BASELIMIT_BETA +//logmacros NOBUG_LOG_BASELIMIT_RELEASE +//logmacros NOBUG_LOG_BASELIMIT +//logmacros +//logmacros NoBug defines some logging base limits, anything more detailed +//logmacros than this base limits will be optimized out. This is used to +//logmacros reduce the logging overhead for *RELEASE* builds. +//logmacros By default the limit is set to `LOG_DEBUG` for *ALPHA* and *BETA* +//logmacros builds, so all logging is retained and `LOG_NOTICE` in *RELEASE* +//logmacros builds to log the application progress only coarsely then. +//logmacros +//logmacros This macros can be defined before including 'nobug.h' to some other +//logmacros log level (as defined in 'syslog.h'). +//logmacros +*/ #ifndef NOBUG_LOG_BASELIMIT_ALPHA #define NOBUG_LOG_BASELIMIT_ALPHA LOG_DEBUG #endif -- 2.11.4.GIT