MetzNet
/
dfhack
3
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge remote-tracking branch 'suokko/runtime_debug_prints' into develop 

Missing update to Plugins.rst from web editor
develop
lethosor 2018-12-27 16:30:19 -05:00
parent a2f8742128 0ccfc8be35
commit 5554b0d89f
1 changed files with 10 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
docs/Plugins.rst
Unescape Escape View File

@ -396,28 +396,24 @@ Otherwise somewhat similar to `gui/quickcmd`.
debug debug
===== =====
Manager DFHack runtime debug prints. Debug prints are grouped by plugin name, Manager for DFHack runtime debug prints. Debug prints are grouped by plugin name,
category name and print level. Levels are ``trace``, ``debug``, ``info``, category name and print level. Levels are ``trace``, ``debug``, ``info``,
``warning`` and ``error``. ``warning`` and ``error``.
The runtime message printing is controlled using filters. Filters set minimum The runtime message printing is controlled using filters. Filters set the
visible message to all matching categories. Matching uses regular expression visible messages of all matching categories. Matching uses regular expression syntax,
that allows listing multiple alternative matches or partial name matches. which allows listing multiple alternative matches or partial name matches.
Persistent filters are stored in ``dfhack-config/runtime-debug.json``. This syntax is a C++ version of the ECMA-262 grammar (Javascript regular expressions).
Details of differences can be found at
https://en.cppreference.com/w/cpp/regex/ecmascript
Persistent filters are stored in ``dfhack-config/runtime-debug.json``.
Oldest filters are applied first. That means a newer filter can override the Oldest filters are applied first. That means a newer filter can override the
older printing level selection. older printing level selection.
Usage: ``debugfilter [subcommand] [parameters...]`` Usage: ``debugfilter [subcommand] [parameters...]``
Following subcommands are supported. The following subcommands are supported:
Regular expression syntax
-------------------------
Syntax is C++ version of ECMA-262 grammar (Javascript regular expression).
Deails of differences can be found from
https://en.cppreference.com/w/cpp/regex/ecmascript
help help
---- ----
@ -466,7 +462,7 @@ Level is the minimum debug printing level to show in log.
* ``info``: Important state changes that happen rarely during normal execution * ``info``: Important state changes that happen rarely during normal execution
* ``warining``: Enabled by default. Shows warnings about unexpected events which code managed to handle correctly. * ``warning``: Enabled by default. Shows warnings about unexpected events which code managed to handle correctly.
* ``error``: Enabled by default. Shows errors which code can't handle without user intervention. * ``error``: Enabled by default. Shows errors which code can't handle without user intervention.