From ca6aa0b9bee3fdf355b7154a9a686a80977f2a02 Mon Sep 17 00:00:00 2001 From: am-sq Date: Tue, 18 Jun 2024 10:19:43 -0700 Subject: [PATCH] doc: loadwallet loads from relative walletdir Improves the documentation of help output for loadwallet to clarify that filename is relative to the default wallet directory. Adds examples that get a wallet from sub-directories. --- src/wallet/rpc/wallet.cpp | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/src/wallet/rpc/wallet.cpp b/src/wallet/rpc/wallet.cpp index 5140ac8c059..89b174d0f7a 100644 --- a/src/wallet/rpc/wallet.cpp +++ b/src/wallet/rpc/wallet.cpp @@ -220,7 +220,7 @@ static RPCHelpMan loadwallet() "\nNote that all wallet command-line options used when starting bitcoind will be" "\napplied to the new wallet.\n", { - {"filename", RPCArg::Type::STR, RPCArg::Optional::NO, "The wallet directory or .dat file."}, + {"filename", RPCArg::Type::STR, RPCArg::Optional::NO, "The path to the directory of the wallet to be loaded, either absolute or relative to the \"wallets\" directory. The \"wallets\" directory is set by the -walletdir option and defaults to the \"wallets\" folder within the data directory."}, {"load_on_startup", RPCArg::Type::BOOL, RPCArg::Optional::OMITTED, "Save wallet name to persistent settings and load on startup. True to add wallet to startup list, false to remove, null to leave unchanged."}, }, RPCResult{ @@ -234,8 +234,15 @@ static RPCHelpMan loadwallet() } }, RPCExamples{ - HelpExampleCli("loadwallet", "\"test.dat\"") - + HelpExampleRpc("loadwallet", "\"test.dat\"") + "\nLoad wallet from the wallet dir:\n" + + HelpExampleCli("loadwallet", "\"walletname\"") + + HelpExampleRpc("loadwallet", "\"walletname\"") + + "\nLoad wallet using absolute path (Unix):\n" + + HelpExampleCli("loadwallet", "\"/path/to/walletname/\"") + + HelpExampleRpc("loadwallet", "\"/path/to/walletname/\"") + + "\nLoad wallet using absolute path (Windows):\n" + + HelpExampleCli("loadwallet", "\"DriveLetter:\\path\\to\\walletname\\\"") + + HelpExampleRpc("loadwallet", "\"DriveLetter:\\path\\to\\walletname\\\"") }, [&](const RPCHelpMan& self, const JSONRPCRequest& request) -> UniValue {