Shuenhoy/vtk-m2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update Logging file documentation to reference new default vtk-m logging behavior

Browse Source
This commit is contained in:
nadavi 2019-09-13 09:47:21 -06:00
parent 23b73103e0
commit f505f2ae75
1 changed files with 8 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
vtkm/cont/Logging.h
View File

@ -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.