From 201edf3668630ca4919b08537ab9909ce231868d Mon Sep 17 00:00:00 2001
From: Jussi Saurio <jussi.saurio@gmail.com>
Date: Thu, 10 Jul 2025 13:05:54 +0300
Subject: [PATCH] btree/balance: add comment

---
 core/storage/btree.rs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/core/storage/btree.rs b/core/storage/btree.rs
index 0a5d9bdd7..0e64d7c6e 100644
--- a/core/storage/btree.rs
+++ b/core/storage/btree.rs
@@ -2464,6 +2464,7 @@ impl BTreeCursor {
                 (WriteState::BalanceNonRootDoBalancing, Ok(CursorResult::IO))
             }
             WriteState::BalanceNonRootDoBalancing => {
+                // Ensure all involved pages are in memory.
                 let write_info = self.state.write_info().unwrap();
                 let mut balance_info = write_info.balance_info.borrow_mut();
                 let balance_info = balance_info.as_mut().unwrap();
@@ -2475,7 +2476,7 @@ impl BTreeCursor {
                     let page = page.as_ref().unwrap();
                     return_if_locked_maybe_load!(self.pager, page);
                 }
-                // Now do real balancing
+                // Start balancing.
                 let parent_page_btree = self.stack.top();
                 let parent_page = parent_page_btree.get();