Newly added logging section from #28318 is missing a single backtick. Also fixes some minor punctuation errors in that section.
doc: Add missing backtick in developer notes logging section #29241
pull fjahr wants to merge 1 commits into bitcoin:master from fjahr:202401-backtick changing 1 files +6 −6-
fjahr commented at 2:54 PM on January 12, 2024: contributor
-
DrahtBot commented at 2:54 PM on January 12, 2024: contributor
<!--e57a25ab6845829454e8d69fc972939a-->
The following sections might be updated with supplementary metadata relevant to reviewers and maintainers.
<!--006a51241073e994b41acfe9ec718e94-->
Code Coverage
For detailed information about the code coverage, see the test coverage report.
<!--021abf342d371248e50ceaed478a90ca-->
Reviews
See the guideline for information on the review process.
Type Reviewers ACK jonatack, alfonsoromanz Stale ACK ismaelsadeeq If your review is incorrectly listed, please react with 👎 to this comment and the bot will ignore it on the next update.
- DrahtBot added the label Docs on Jan 12, 2024
-
ismaelsadeeq commented at 2:58 PM on January 12, 2024: member
utACK a29d5c9f5100a5e15b243960ebc505305a70901e 👍🏾
Thanks was just reading this
-
in doc/developer-notes.md:758 in a29d5c9f51 outdated
754 | @@ -755,7 +755,7 @@ logging messages. They should be used as follows: 755 | severe enough to warrant shutting down the node (eg, system time 756 | appears to be wrong, unknown soft fork appears to have activated). 757 | 758 | -- `LogTrace(BCLog::CATEGORY, fmt, params...) should be used in place of 759 | +- `LogTrace(BCLog::CATEGORY, fmt, params...)` should be used in place of
jonatack commented at 3:07 PM on January 12, 2024:While touching these, suggest also this
@@ -742,7 +742,7 @@ logging messages. They should be used as follows: - `LogInfo(fmt, params...)` should only be used rarely, eg for startup messages or for infrequent and important events such as a new block tip being found or a new outbound connection being made. These log messages - are unconditional so care must be taken that they can't be used by an + are unconditional, so care must be taken that they can't be used by an attacker to fill up storage. Note that `LogPrintf(fmt, params...)` is a deprecated alias for `LogInfo`.and
s/eg/e.g./throughout this section.
fjahr commented at 3:27 PM on January 12, 2024:Done, thanks!
jonatack commented at 3:07 PM on January 12, 2024: memberACK a29d5c9f5100a5e15b243960ebc505305a70901e, couple suggestions
c003562120doc: Add missing backtick in developer notes logging section
Also fix some minor punctuation error in the section.
fjahr force-pushed on Jan 12, 2024jonatack commented at 4:10 PM on January 12, 2024: memberACK c003562120c193c296ac754b4bb8cff02bbbe4dc
Tangential, I don't understand the macro ordering in this line:
The macros `LogInfo`, `LogDebug`, `LogTrace`, `LogWarning` and `LogError` are available forDrahtBot requested review from ismaelsadeeq on Jan 12, 2024alfonsoromanz commented at 6:07 PM on January 12, 2024: contributorACK c003562120c193c296ac754b4bb8cff02bbbe4dc
fanquake merged this on Jan 15, 2024fanquake closed this on Jan 15, 2024bitcoin locked this on Jan 14, 2025
This is a metadata mirror of the GitHub repository bitcoin/bitcoin. This site is not affiliated with GitHub. Content is generated from a GitHub metadata backup.
generated: 2026-04-22 03:13 UTC
More mirrored repositories can be found on mirror.b10c.me