From 14bc2a17dd03ccd89f65a302328763ff22c710c2 Mon Sep 17 00:00:00 2001
From: Pierre Rochard <pierre@rochard.org>
Date: Fri, 14 Sep 2018 14:13:16 -0400
Subject: [PATCH] Trivial: add doxygen-compatible comments relating to
 BerkeleyEnvironment

---
 src/wallet/db.cpp | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/wallet/db.cpp b/src/wallet/db.cpp
index e75430dbec..f2e7b13df1 100644
--- a/src/wallet/db.cpp
+++ b/src/wallet/db.cpp
@@ -84,6 +84,13 @@ bool IsWalletLoaded(const fs::path& wallet_path)
     return database && database->IsDatabaseLoaded(database_filename);
 }
 
+/**
+ * @param[in] wallet_path Path to wallet directory. Or (for backwards compatibility only) a path to a berkeley btree data file inside a wallet directory.
+ * @param[out] database_filename Filename of berkeley btree data file inside the wallet directory.
+ * @return A shared pointer to the BerkeleyEnvironment object for the wallet directory, never empty because ~BerkeleyEnvironment
+ * erases the weak pointer from the g_dbenvs map.
+ * @post A new BerkeleyEnvironment weak pointer is inserted into g_dbenvs if the directory path key was not already in the map.
+ */
 std::shared_ptr<BerkeleyEnvironment> GetWalletEnv(const fs::path& wallet_path, std::string& database_filename)
 {
     fs::path env_directory;
@@ -218,6 +225,7 @@ bool BerkeleyEnvironment::Open(bool retry)
     return true;
 }
 
+//! Construct an in-memory mock Berkeley environment for testing and as a place-holder for g_dbenvs emplace
 BerkeleyEnvironment::BerkeleyEnvironment()
 {
     Reset();