X-Git-Url: http://g0dil.de/git?a=blobdiff_plain;f=senf%2FUtils%2FLogger%2FConfig.hh;h=a7eaa897c891c82fe3624590f5711a755b5d4166;hb=93d9568d448749dc187e7622b733a4a3caa319df;hp=9f0f73541b202cc46897aad2b559ff02446f098c;hpb=601d1f509f5bb24df167a4dd5a20da67a0af9af8;p=senf.git diff --git a/senf/Utils/Logger/Config.hh b/senf/Utils/Logger/Config.hh index 9f0f735..a7eaa89 100644 --- a/senf/Utils/Logger/Config.hh +++ b/senf/Utils/Logger/Config.hh @@ -31,7 +31,7 @@ //#include "Config.mpp" #include "Config.ih" -///////////////////////////////hh.p//////////////////////////////////////// +//-///////////////////////////////////////////////////////////////////////////////////////////////// /** \defgroup config Configuration @@ -77,7 +77,7 @@ All the entries specified via \c SENF_LOG_CONF are applied in a fixed order: - + \li First the entries which have both a stream and an area specified are checked \li next all entries with area but no stream given are checked \li followed by all entries with a given stream but no area @@ -105,7 +105,7 @@ consoleLog.route(); fileLog.route(); - \endcode + \endcode Here we see an already relatively complex setup: All debug messages (that is, those, which are not disabled at compile time) are routed to the console. We also route important transactions to the console \e except transactions from the \c foo::SomeClass area. The \c fileLog simply @@ -119,13 +119,13 @@ enabled \e explicitly by setting \c SENF_LOG_CONF so they can be routed. \section config_fallback Fallback routing - + There are two cases, where this setup may lead to inadvertently lost log messages: \li When using a library which does internally use the Logger but not initializing the logger in your application. \li When log messages are created during initialization of static objects. Since no route is set up in these cases, the messages will be dropped. - + To counter this problem, the logger is initially in fallback routing state. If any log message arrives in this state, the message will be logged to the console if it is above the default runtime limit of it's stream. The first routing statement on any target will take the @@ -152,7 +152,7 @@ namespace senf { namespace log { ///\ingroup config - ///\{ + //\{ # ifdef DOXYGEN @@ -175,7 +175,7 @@ namespace log { name ::= arbitrary C++ identifier - \ref SENF_LOG_CONF is a Boost.Preprocessor style sequence of 3-tuples. + \ref SENF_LOG_CONF is a Boost.Preprocessor style sequence of 3-tuples. The first tuple element \e optional_stream specifies the stream to match. If this is (_), the entry will match any stream. @@ -195,13 +195,13 @@ namespace log { # endif /** \brief Check, if logging is enabled for stream/area/level tuple - + This is a template meta-function which will check, whether logging to the given combination of parameters \a Stream, \a Area and \a Level is compile-time enabled. The logging might still be disabled at runtime. \code - if (senf::log::Enabled::value) { // ... } @@ -218,11 +218,11 @@ namespace log { >= detail::Config::compileLimit::value ); }; - ///\} + //\} }} -///////////////////////////////hh.e//////////////////////////////////////// +//-///////////////////////////////////////////////////////////////////////////////////////////////// //#include "Config.cci" //#include "Config.ct" //#include "Config.cti"