diff --git a/docs/logging.md b/docs/logging.md index 48eb3a7..5e3a9dc 100644 --- a/docs/logging.md +++ b/docs/logging.md @@ -247,9 +247,11 @@ The wildcarding functionality 3. supports both `*` (matches 0 or more characters) and `?` (matches any single character) wildcards. Please also refer to [command line flags](flags.md) for more information. +You can dynamically control the level of a module using the `#!cpp SetVLOGLevel` function. + There's also `#!cpp VLOG_IS_ON(n)` "verbose level" condition macro. This macro -returns `#!cpp true` when the `--v` is equal to or greater than `n`. The macro can be -used as follows: +returns `#!cpp true` when the matching `--vmodule`, else `--v` is equal to or greater than `n`. +The macro can be used as follows: ``` cpp if (VLOG_IS_ON(2)) { diff --git a/src/glog/vlog_is_on.h b/src/glog/vlog_is_on.h index eb1c233..a90a409 100644 --- a/src/glog/vlog_is_on.h +++ b/src/glog/vlog_is_on.h @@ -103,11 +103,9 @@ namespace google { // Set VLOG(_IS_ON) level for module_pattern to log_level. // This lets us dynamically control what is normally set by the --vmodule flag. // Returns the level that previously applied to module_pattern. -// NOTE: To change the log level for VLOG(_IS_ON) sites -// that have already executed after/during InitGoogleLogging, -// one needs to supply the exact --vmodule pattern that applied to them. -// (If no --vmodule pattern applied to them -// the value of FLAGS_v will continue to control them.) +// NOTE: All VLOG(_IS_ON) sites that have not matched any prior module_patterns +// will be re-evaluated with the provided module_pattern. Sites that have +// already matched a different module_pattern will not be affected. extern GLOG_EXPORT int SetVLOGLevel(const char* module_pattern, int log_level); // Various declarations needed for VLOG_IS_ON above: =========================