Update manpages & example bitcoin.conf

doc/man/bitcoin-cli.1

@@ -1,21 +1,28 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
-.TH BITCOIN-CLI "1" "June 2024" "bitcoin-cli v27.1.0" "User Commands"
+.TH BITCOIN-CLI "1" "August 2024" "bitcoin-cli v27.1.0" "User Commands"
 .SH NAME
 bitcoin-cli \- manual page for bitcoin-cli v27.1.0
 .SH SYNOPSIS
 .B bitcoin-cli
-[\fI\,options\/\fR] \fI\,<command> \/\fR[\fI\,params\/\fR]  \fI\,Send command to Bitcoin Core\/\fR
+[\fI\,options\/\fR] \fI\,<command> \/\fR[\fI\,params\/\fR]
 .br
 .B bitcoin-cli
-[\fI\,options\/\fR] \fI\,-named <command> \/\fR[\fI\,name=value\/\fR]...  \fI\,Send command to Bitcoin Core (with named arguments)\/\fR
+[\fI\,options\/\fR] \fI\,-named <command> \/\fR[\fI\,name=value\/\fR]...
 .br
 .B bitcoin-cli
-[\fI\,options\/\fR] \fI\,help                List commands\/\fR
+[\fI\,options\/\fR] \fI\,help\/\fR
 .br
 .B bitcoin-cli
-[\fI\,options\/\fR] \fI\,help <command>      Get help for a command\/\fR
+[\fI\,options\/\fR] \fI\,help <command>\/\fR
 .SH DESCRIPTION
-Bitcoin Core RPC client version v27.1.0
+Bitcoin Knots RPC client version v27.1.0
+.PP
+The bitcoin\-cli utility provides a command line interface to interact with a bitcoind/bitcoin\-qt RPC server.
+.PP
+It can be used to query network information, manage wallets, create or broadcast transactions, and control the bitcoind server.
+.PP
+Use the "help" command to list all commands. Use "help <command>" to show help for that command.
+The \fB\-named\fR option allows you to specify parameters using the key=value format, eliminating the need to pass unused positional parameters.
 .SH OPTIONS
 .HP
 \-?
@@ -39,6 +46,12 @@ and OS is not WIN32), never.
 Specify configuration file. Relative paths will be prefixed by datadir
 location. (default: bitcoin.conf)
 .HP
+\fB\-confrw=\fR<file>
+.IP
+Specify read/write configuration file. Relative paths will be prefixed
+by the network\-specific datadir location. (default:
+bitcoin_rw.conf)
+.HP
 \fB\-datadir=\fR<dir>
 .IP
 Specify data directory
@@ -54,11 +67,12 @@ nblocks and maxtries arguments. Example: bitcoin\-cli \fB\-generate\fR 4
 .HP
 \fB\-getinfo\fR
 .IP
-Get general information from the remote server. Note that unlike
-server\-side RPC calls, the output of \fB\-getinfo\fR is the result of
-multiple non\-atomic requests. Some entries in the output may
-represent results from different states (e.g. wallet balance may
-be as of a different block from the chain state reported)
+Get general information from the remote server, including the total
+balance and the balances of each loaded wallet when in
+multiwallet mode. Note that \fB\-getinfo\fR is the combined result of
+several RPCs (getnetworkinfo, getblockchaininfo, getwalletinfo,
+getbalances, and in multiwallet mode, listwallets), each with
+potentially different state.
 .HP
 \fB\-named\fR
 .IP
@@ -153,6 +167,12 @@ signet, regtest
 Use the signet chain. Equivalent to \fB\-chain\fR=\fI\,signet\/\fR. Note that the network
 is defined by the \fB\-signetchallenge\fR parameter
 .HP
+\fB\-signetblocktime\fR
+.IP
+Difficulty adjustment will target a block time of the given amount in
+seconds (only for custom signet networks, must have
+\fB\-signetchallenge\fR set; defaults to 10 minutes)
+.HP
 \fB\-signetchallenge\fR
 .IP
 Blocks must satisfy the given script to be considered valid (only for
@@ -172,10 +192,12 @@ Use the test chain. Equivalent to \fB\-chain\fR=\fI\,test\/\fR.
 .SH COPYRIGHT
 Copyright (C) 2009-2024 The Bitcoin Core developers
 
-Please contribute if you find Bitcoin Core useful. Visit
-<https://bitcoincore.org/> for further information about the software.
-The source code is available from <https://github.com/bitcoin/bitcoin>.
+Please contribute if you find Bitcoin Knots useful. Visit
+<https://bitcoinknots.org/> for further information about the software.
+The source code is available from <https://github.com/bitcoinknots/bitcoin>.
 
 This is experimental software.
 Distributed under the MIT software license, see the accompanying file COPYING
-or <https://opensource.org/licenses/MIT>
+or <https://opensource.org/licenses/MIT>
+.SH "SEE ALSO"
+bitcoind(1), bitcoin-tx(1), bitcoin-wallet(1), bitcoin-util(1), bitcoin-qt(1)