Skip to content

Commit a7b47dd

Browse files
committed
doc: global level control
1 parent 846751a commit a7b47dd

File tree

1 file changed

+10
-5
lines changed

1 file changed

+10
-5
lines changed

docs/dev_notes.md

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,19 +8,24 @@ To control the log level of a class with a `Logger`, make a logging `.properties
88
org.jlab.detector.helicity.HelicityGenerator.level = FINEST
99
org.jlab.detector.calib.utils.RCDBProvider.level = FINER
1010
```
11-
Then run as
12-
```bash
13-
java -Djava.util.logging.config.file=my_levels.properties ...
11+
You can also control the _global_ log level for all classes with `.level`, for example, to set
12+
it to `FINE`:
13+
```
14+
.level = FINE
15+
```
16+
To use this `.properties` file, run with the `java` option
17+
```
18+
-Djava.util.logging.config.file=my_levels.properties
1419
```
15-
or using `run-coatjava`,
20+
For example, if using `run-coatjava`,
1621
```bash
1722
run-coatjava [CLASS_NAME] [CLASS_ARGS] -- -Djava.util.logging.config.file=my_levels.properties
1823
```
1924
From high to low, the levels are `SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST` (see `java.util.logging.Level` documentation).
2025
You may also use levels `ALL` or `OFF`, for everything or nothing, respectively.
2126

2227
> [!NOTE]
23-
> These properties may compete with the log level set by `OptionParser`'s option `-l`, potentially overriding that level.
28+
> These properties may compete with the log level set by `OptionParser`'s option `-l`, potentially overriding that level. For example, `postprocess` and `decoder` use `OptionParser`.
2429
2530
## Bumping Version Number and Deploying
2631

0 commit comments

Comments
 (0)