Merge bitcoin/bitcoin#24360: doc: improve -netinfo help based on feedback from users and devs

a4da16fbd43ea1fff344f1602f7a5ace3d4a8a95 Improve -netinfo help based on feedback from users and devs (Jon Atack)

Pull request description:

  Clarify which networks are displayed by the peer counts table (*reachable* networks; follow-up to #23324) in response to questions received over the past months, and a few other improvements.

ACKs for top commit:
  laanwj:
    Code review ACK a4da16fbd43ea1fff344f1602f7a5ace3d4a8a95
  w0xlt:
    ACK a4da16f
  kristapsk:
    utACK a4da16fbd43ea1fff344f1602f7a5ace3d4a8a95

Tree-SHA512: e6522c08421aa7f10d50723156d0a8fc5ec82cad2f0bd931bbec603077fcd4921c6505ef743d57386fba81c95dcfc77df75abf3378319886368e4ae33f9a6d73
This commit is contained in:
MarcoFalke 2022-02-18 07:32:03 +01:00 committed by Vijay
parent 9d05cb5e9e
commit 19e3ee894e
No known key found for this signature in database
GPG Key ID: E38DD2EE8F0967B1

View File

@ -640,8 +640,9 @@ public:
"Suggestion: use with the Linux watch(1) command for a live dashboard; see example below.\n\n" "Suggestion: use with the Linux watch(1) command for a live dashboard; see example below.\n\n"
"Arguments:\n" "Arguments:\n"
+ strprintf("1. level (integer 0-%d, optional) Specify the info level of the peers dashboard (default 0):\n", MAX_DETAIL_LEVEL) + + strprintf("1. level (integer 0-%d, optional) Specify the info level of the peers dashboard (default 0):\n", MAX_DETAIL_LEVEL) +
" 0 - Connection counts and local addresses\n" " 0 - Peer counts for each reachable network as well as for block relay peers\n"
" 1 - Like 0 but with a peers listing (without address or version columns)\n" " and manual peers, and the list of local addresses and ports\n"
" 1 - Like 0 but preceded by a peers listing (without address and version columns)\n"
" 2 - Like 1 but with an address column\n" " 2 - Like 1 but with an address column\n"
" 3 - Like 1 but with a version column\n" " 3 - Like 1 but with a version column\n"
" 4 - Like 1 but with both address and version columns\n" " 4 - Like 1 but with both address and version columns\n"
@ -680,13 +681,13 @@ public:
" id Peer index, in increasing order of peer connections since node startup\n" " id Peer index, in increasing order of peer connections since node startup\n"
" address IP address and port of the peer\n" " address IP address and port of the peer\n"
" version Peer version and subversion concatenated, e.g. \"70016/Satoshi:21.0.0/\"\n\n" " version Peer version and subversion concatenated, e.g. \"70016/Satoshi:21.0.0/\"\n\n"
"* The connection counts table displays the number of peers by direction, network, and the totals\n" "* The peer counts table displays the number of peers for each reachable network as well as\n"
" for each, as well as two special outbound columns for block relay peers and manual peers.\n\n" " the number of block relay peers and manual peers.\n\n"
"* The local addresses table lists each local address broadcast by the node, the port, and the score.\n\n" "* The local addresses table lists each local address broadcast by the node, the port, and the score.\n\n"
"Examples:\n\n" "Examples:\n\n"
"Connection counts and local addresses only\n" "Peer counts table of reachable networks and list of local addresses\n"
"> dash-cli -netinfo\n\n" "> dash-cli -netinfo\n\n"
"Compact peers listing\n" "The same, preceded by a peers listing without address and version columns\n"
"> dash-cli -netinfo 1\n\n" "> dash-cli -netinfo 1\n\n"
"Full dashboard\n" "Full dashboard\n"
+ strprintf("> dash-cli -netinfo %d\n\n", MAX_DETAIL_LEVEL) + + strprintf("> dash-cli -netinfo %d\n\n", MAX_DETAIL_LEVEL) +