diff -r 4ac889e14211 -r 5942859fd76c docs/Writerside/topics/buffer.h.md
--- a/docs/Writerside/topics/buffer.h.md	Sun Apr 13 13:02:54 2025 +0200
+++ b/docs/Writerside/topics/buffer.h.md	Sun Apr 13 14:30:51 2025 +0200
@@ -128,7 +128,8 @@
 ```
 
 The function `cxBufferMinimumCapacity()` guarantees a buffer capacity of _at least_ `capacity`.
-It may allocate more space, depending on the allocation strategy.
+The actual capacity will be a power of two until the system's page size is reached.
+Then, the new capacity will be a multiple of the page size.
 The function returns non-zero if increasing the capacity was attempted unsuccessfully.
 
 The function `cxBufferShrink()` can be used to shrink the capacity of the buffer to its current size