Skip to content

Commit 7e6ab33

Browse files
committed
level_logger: changes as proposed by @ivan-pi
1 parent 8a3f31d commit 7e6ab33

File tree

1 file changed

+14
-13
lines changed

1 file changed

+14
-13
lines changed

doc/specs/stdlib_logger.md

+14-13
Original file line numberDiff line numberDiff line change
@@ -8,20 +8,20 @@ title: logger
88
## Introduction
99

1010
This module defines a derived type, its methods, a variable, and
11-
constants to be used for the reporting of errors, for filtering the
12-
log messages, and other information. The derived type, `logger_type`,
13-
is to be used to define both global and local logger variables. The
14-
`logger_type` methods serve to configure the loggers and use the logger
15-
variables to report messages to a variable specific list of I/O units
16-
termed `log_units`. The variable, `global_logger`, of type `logger_type`,
17-
is intended to serve as the default global logger. The constants serve as
18-
error flags returned by the optional integer `stat` argument.
11+
constants to be used for the reporting of errors, displaying messages,
12+
and other information. The derived type, `logger_type`, is to be used
13+
to define both global and local logger variables. The `logger_type`
14+
methods serve to configure the loggers and use the logger variables to
15+
report messages to a variable specific list of I/O units termed
16+
`log_units`. The variable, `global_logger`, of type `logger_type`,
17+
is intended to serve as the default global logger. The constants serve
18+
as error flags returned by the optional integer `stat` argument.
1919

2020
The logger variables have the option to:
2121

2222
* change which units receive the log messages;
2323
* report which units receive the log messages;
24-
* change the level for filtering the log messages;
24+
* select which types of messages are logged;
2525
* precede messages by a blank line;
2626
* precede messages by a time stamp of the form
2727
`yyyy-mm-dd hh:mm:ss.sss`;
@@ -66,10 +66,11 @@ Error Code | Description
6666
`write_fault` | one of the writes to `log_units` failed
6767

6868
The module also defines eight distinct public integer constants for
69-
filtering the log messages. These constants, termed severity levels, are
70-
(sorted following their increasing order of severity): `all_level`,
71-
`debug_level`, `information_level`, `warning_level`, `error_level`,
72-
`io_error_level`, `text_error_level`, and `none_level`.
69+
selecting the messages that are logged. These constants, termed
70+
severity levels, are (sorted following their increasing order of
71+
severity): `all_level`, `debug_level`, `information_level`,
72+
`warning_level`, `error_level`, `io_error_level`, `text_error_level`,
73+
and `none_level`.
7374
All log messages with a level (e.g., `debug_level`) lower than a
7475
specified severity level (e.g., `information_level`) will be ignored.
7576
The levels `error_level` and `io_error_level` have the same severity.

0 commit comments

Comments
 (0)