roll: pigweed pw_status, pw_log: Log status messages as CODE (message)

A status with a message was logged as "CODE: message". Logs usually
describe what failed and then give the status, so a typical log read
"Read failed: NOT_FOUND: No such key".

Log the message in parentheses after the code instead, so that the same
log reads "Read failed: NOT_FOUND (No such key)". The parentheses also
show where the message ends when more text follows the status.

Add "Logging statuses" sections to the pw_status and pw_log docs that
show how to log a status and what is logged.

Update the bit field token examples in pw_tokenizer, which are modeled
on status messages, to match.

Original-Reviewed-on: https://pigweed-review.googlesource.com/c/pigweed/pigweed/+/535562
Original-Revision: 4fc3b9da7aa481f6a6f79cb24dc6ab867b6a7bdb

Rolled-Repo: https://pigweed.googlesource.com/pigweed/pigweed
Rolled-Commits: d7878d4ed9f1ea..4fc3b9da7aa481
Roll-Count: 1
Roller-URL: https://cr-buildbucket.appspot.com/build/8664504854019483281
GitWatcher: ignore
CQ-Do-Not-Cancel-Tryjobs: true
Change-Id: If686e36981bafe01d3dff1ea1a45ca06ba969ef9
Reviewed-on: https://pigweed-review.googlesource.com/c/third_party/github/zephyrproject-rtos/zephyr/+/537000
1 file changed