update Logging file documentation to reference new default vtk-m logging behavior
This commit is contained in:
parent
23b73103e0
commit
f505f2ae75
@ -50,9 +50,11 @@
|
|||||||
/// functions to help format common types of log data such as byte counts and
|
/// functions to help format common types of log data such as byte counts and
|
||||||
/// type names.
|
/// type names.
|
||||||
///
|
///
|
||||||
/// Logging is enabled by setting the CMake variable VTKm_ENABLE_LOGGING. When
|
/// Logging is enabled via the CMake option VTKm_ENABLE_LOGGING by default.
|
||||||
/// this flag is enabled, any messages logged to the Info, Warn, Error, and
|
/// The default log level is set to only log Warn and Error messages; Fatal
|
||||||
/// Fatal levels are printed to stderr by default.
|
/// levels are printed to stderr by default. The logging system will need
|
||||||
|
/// to be initialized through a call to either vtkm::cont::Initialize or
|
||||||
|
/// vtkm::cont::InitLogging.
|
||||||
///
|
///
|
||||||
/// Additional logging features are enabled by calling vtkm::cont::InitLogging
|
/// Additional logging features are enabled by calling vtkm::cont::InitLogging
|
||||||
/// (or preferably, vtkm::cont::Initialize) in an executable. This will:
|
/// (or preferably, vtkm::cont::Initialize) in an executable. This will:
|
||||||
@ -81,7 +83,7 @@
|
|||||||
/// vtkm::cont::SetThreadName. This will appear in the log output so that
|
/// vtkm::cont::SetThreadName. This will appear in the log output so that
|
||||||
/// per-thread messages can be easily tracked.
|
/// per-thread messages can be easily tracked.
|
||||||
///
|
///
|
||||||
/// By default, only Info, Warn, Error, and Fatal messages are printed to
|
/// By default, only Warn, Error, and Fatal messages are printed to
|
||||||
/// stderr. This can be changed at runtime by passing the '-v' flag to an
|
/// stderr. This can be changed at runtime by passing the '-v' flag to an
|
||||||
/// executable that calls vtkm::cont::InitLogging. Alternatively, the
|
/// executable that calls vtkm::cont::InitLogging. Alternatively, the
|
||||||
/// application can explicitly call vtkm::cont::SetStderrLogLevel to change the
|
/// application can explicitly call vtkm::cont::SetStderrLogLevel to change the
|
||||||
@ -351,7 +353,8 @@ enum class LogLevel
|
|||||||
*
|
*
|
||||||
* Initializes logging. Sets up custom log level and thread names. Parses any
|
* Initializes logging. Sets up custom log level and thread names. Parses any
|
||||||
* "-v [LogLevel]" arguments to set the stderr log level. This argument may
|
* "-v [LogLevel]" arguments to set the stderr log level. This argument may
|
||||||
* be either numeric, or the 4-character string printed in the output.
|
* be either numeric, or the 4-character string printed in the output. Note that
|
||||||
|
* loguru will consume the "-v [LogLevel]" argument and shrink the arg list.
|
||||||
*
|
*
|
||||||
* If the parameterless overload is used, the `-v` parsing is not used, but
|
* If the parameterless overload is used, the `-v` parsing is not used, but
|
||||||
* other functionality should still work.
|
* other functionality should still work.
|
||||||
|
Loading…
Reference in New Issue
Block a user