[PATCH] docs: maple_tree: Replace removed bulk insertion API
Karl Mehltretter
kmehltretter at gmail.com
Fri Sep 4 18:55:09 PDT 2026
Commit e3852a1213ff ("maple_tree: Drop bulk insert support") removed
mas_expected_entries() but left the documentation describing it.
Document the current preallocation interface instead.
Fixes: e3852a1213ff ("maple_tree: Drop bulk insert support")
Assisted-by: LLM
Signed-off-by: Karl Mehltretter <kmehltretter at gmail.com>
---
Documentation/core-api/maple_tree.rst | 9 ++++-----
1 file changed, 4 insertions(+), 5 deletions(-)
diff --git a/Documentation/core-api/maple_tree.rst b/Documentation/core-api/maple_tree.rst
index 12bccfb6aac1..836342fb1eec 100644
--- a/Documentation/core-api/maple_tree.rst
+++ b/Documentation/core-api/maple_tree.rst
@@ -214,11 +214,10 @@ Advanced Allocating Nodes
-------------------------
Allocations are usually handled internally to the tree, however if allocations
-need to occur before a write occurs then calling mas_expected_entries() will
-allocate the worst-case number of needed nodes to insert the provided number of
-ranges. This also causes the tree to enter mass insertion mode. Once
-insertions are complete calling mas_destroy() on the maple state will free the
-unused allocations.
+need to occur before a write occurs then calling mas_preallocate() will
+allocate the nodes needed to store the provided entry. The entry is then
+stored with mas_store_prealloc(). If the store is abandoned, calling
+mas_destroy() on the maple state will free the unused allocations.
.. _maple-tree-advanced-locks:
--
2.53.0
More information about the maple-tree
mailing list