Update manpages, bash completion, and example bitcoin.conf

Author: luke-jr

contrib/completions/bash/bitcoin-cli.bash

@@ -1,5 +1,10 @@
-# bash programmable completion for bitcoin-cli(1)
-# Copyright (c) 2012-2022 The Bitcoin Core developers
+# Dynamic bash programmable completion for bitcoin-cli(1)
+#     DO NOT EDIT THIS FILE BY HAND -- THIS WILL FAIL THE FUNCTIONAL TEST tool_cli_completion
+# This file is auto-generated by the functional test tool_cli_completion.
+# If you want to modify this file, modify test/functional/tool_cli_completion.py and re-autogenerate
+# this file via the --overwrite test flag.
+
+# Copyright (c) 2012-2024 The Bitcoin Core developers
 # Distributed under the MIT software license, see the accompanying
 # file COPYING or http://www.opensource.org/licenses/mit-license.php.
 
@@ -30,65 +35,63 @@ _bitcoin_cli() {
 
     if ((cword > 5)); then
         case ${words[cword-5]} in
-            sendtoaddress)
-                COMPREPLY=( $( compgen -W "true false" -- "$cur" ) )
+            descriptorprocesspsbt)
+                COMPREPLY=( $( compgen -W "false true" -- "$cur" ) )
                 return 0
                 ;;
         esac
     fi
 
     if ((cword > 4)); then
         case ${words[cword-4]} in
-            importaddress|listtransactions|setban)
-                COMPREPLY=( $( compgen -W "true false" -- "$cur" ) )
+            createpsbt|createrawtransaction|descriptorprocesspsbt|setban)
+                COMPREPLY=( $( compgen -W "false true" -- "$cur" ) )
                 return 0
                 ;;
-            signrawtransactionwithkey|signrawtransactionwithwallet)
-                COMPREPLY=( $( compgen -W "ALL NONE SINGLE ALL|ANYONECANPAY NONE|ANYONECANPAY SINGLE|ANYONECANPAY" -- "$cur" ) )
+            signrawtransactionwithkey)
+                COMPREPLY=( $( compgen -W "ALL ALL|ANYONECANPAY NONE NONE|ANYONECANPAY SINGLE SINGLE|ANYONECANPAY" -- "$cur" ) )
                 return 0
                 ;;
         esac
     fi
 
     if ((cword > 3)); then
         case ${words[cword-3]} in
-            addmultisigaddress)
-                return 0
-                ;;
-            getbalance|gettxout|importaddress|importpubkey|importprivkey|listreceivedbyaddress|listsinceblock)
-                COMPREPLY=( $( compgen -W "true false" -- "$cur" ) )
+            addnode|converttopsbt|dumptxoutset|getdescriptoractivity|gettxout|gettxoutsetinfo)
+                COMPREPLY=( $( compgen -W "false true" -- "$cur" ) )
                 return 0
                 ;;
         esac
     fi
 
     if ((cword > 2)); then
         case ${words[cword-2]} in
+            converttopsbt|decoderawtransaction|finalizepsbt|getblockheader|getmempoolancestors|getmempooldescendants|getrawmempool|listmempooltransactions)
+                COMPREPLY=( $( compgen -W "false true" -- "$cur" ) )
+                return 0
+                ;;
             addnode)
-                COMPREPLY=( $( compgen -W "add remove onetry" -- "$cur" ) )
+                COMPREPLY=( $( compgen -W "add onetry remove" -- "$cur" ) )
                 return 0
                 ;;
             setban)
                 COMPREPLY=( $( compgen -W "add remove" -- "$cur" ) )
                 return 0
                 ;;
-            fundrawtransaction|getblock|getblockheader|getmempoolancestors|getmempooldescendants|getrawtransaction|gettransaction|listreceivedbyaddress|sendrawtransaction)
-                COMPREPLY=( $( compgen -W "true false" -- "$cur" ) )
+            estimatesmartfee)
+                COMPREPLY=( $( compgen -W "CONSERVATIVE ECONOMICAL UNSET" -- "$cur" ) )
                 return 0
                 ;;
         esac
     fi
 
     case "$prev" in
-        backupwallet|dumpwallet|importwallet)
+        dumptxoutset|importmempool|loadtxoutset)
             _filedir
             return 0
             ;;
-        getaddednodeinfo|getrawmempool|lockunspent)
-            COMPREPLY=( $( compgen -W "true false" -- "$cur" ) )
-            return 0
-            ;;
-        getbalance|getnewaddress|listtransactions|sendmany)
+        getrawmempool|setnetworkactive|setscriptthreadsenabled)
+            COMPREPLY=( $( compgen -W "false true" -- "$cur" ) )
             return 0
             ;;
     esac

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" "December 2024" "bitcoin-cli v28.1.0" "User Commands"
+.TH BITCOIN-CLI "1" "March 2025" "bitcoin-cli v28.1.0" "User Commands"
 .SH NAME
 bitcoin-cli \- manual page for bitcoin-cli v28.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 v28.1.0
+Bitcoin Knots RPC client version v28.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
 \-?
@@ -32,13 +39,20 @@ addresses known to the node may be higher.
 .IP
 Color setting for CLI output (default: auto). Valid values: always, auto
 (add color codes when standard output is connected to a terminal
-and OS is not WIN32), never.
+and OS is not WIN32), never. Only applies to the output of
+\fB\-getinfo\fR.
 .HP
 \fB\-conf=\fR<file>
 .IP
 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 +68,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
@@ -67,8 +82,10 @@ Pass named instead of positional arguments (default: false)
 \fB\-netinfo\fR
 .IP
 Get network peer connection information from the remote server. An
-optional integer argument from 0 to 4 can be passed for different
-peers listings (default: 0). Pass "help" for detailed help
+optional argument from 0 to 4 can be passed for different peers
+listings (default: 0). If a non\-zero value is passed, an
+additional "outonly" (or "o") argument can be passed to see
+outbound peers only. Pass "help" (or "h") for detailed help
 documentation.
 .HP
 \fB\-rpcclienttimeout=\fR<n>
@@ -153,6 +170,12 @@ testnet4, 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
@@ -176,14 +199,15 @@ Consider moving to testnet4 now by using \fB\-testnet4\fR.
 .IP
 Use the testnet4 chain. Equivalent to \fB\-chain\fR=\fI\,testnet4\/\fR.
 .SH COPYRIGHT
-Copyright (C) 2009-2024 The Bitcoin Core developers
+Copyright (C) 2009-2025 The Bitcoin Knots developers
+Copyright (C) 2009-2025 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>
 .SH "SEE ALSO"
-bitcoind(1), bitcoin-cli(1), bitcoin-tx(1), bitcoin-wallet(1), bitcoin-util(1), bitcoin-qt(1)
+bitcoind(1), bitcoin-tx(1), bitcoin-wallet(1), bitcoin-util(1), bitcoin-qt(1)