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.
This commit is contained in:
am-sq 2024-06-18 10:19:43 -07:00
parent 43e287b3ff
commit ca6aa0b9be

View file

@ -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
{