diff options
author | Chandan Singh <chandan@chandansingh.net> | 2020-08-03 21:49:14 +0000 |
---|---|---|
committer | bst-marge-bot <marge-bot@buildstream.build> | 2020-08-04 10:35:49 +0000 |
commit | c7f9214c8e097f27fffa38b4b7c0b0042c9d9034 (patch) | |
tree | 604b1e94fec52032436ef9c7883c61cd63ea9b4c | |
parent | 713736231f7f80c7c1a723e44f248684e7cdb6b2 (diff) | |
download | buildstream-c7f9214c8e097f27fffa38b4b7c0b0042c9d9034.tar.gz |
data/userconfig.yaml: Document valid symbols for format stringschandan/fix-utils-495
Document the valid symbols that can be used as part of the
`message-format`. And, in case of `element-format`, redirect to
`bst show --help` to avoid duplicating the help text in two places.
Fixes #510.
-rw-r--r-- | src/buildstream/data/userconfig.yaml | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/src/buildstream/data/userconfig.yaml b/src/buildstream/data/userconfig.yaml index 5b568167b..d6f91ef66 100644 --- a/src/buildstream/data/userconfig.yaml +++ b/src/buildstream/data/userconfig.yaml @@ -125,11 +125,26 @@ logging: # Format string for printing the pipeline at startup, this # also determines the default display format for `bst show` + # + # See `bst show --help` for details on which symbols can be + # used in the format string. element-format: | %{state: >12} %{full-key} %{name} %{workspace-dirs} # Format string for all log messages. + # + # Following symbols can be used in the format string: + # + # elapsed - Time spent on this operation + # elapsed-us - Time spent on this operation (with microsecond precision) + # wallclock - Current wallclock time + # wallclock-us - Current wallclock time (with microsecond precision) + # key - The abbreviated cache key (if all sources are consistent) + # element - Name of the element + # action - Type of the message + # message - The main message text + # message-format: | [%{elapsed}][%{key}][%{element}] %{action} %{message} |