diff -r 4ac889e14211 -r 5942859fd76c src/cx/buffer.h
--- a/src/cx/buffer.h	Sun Apr 13 13:02:54 2025 +0200
+++ b/src/cx/buffer.h	Sun Apr 13 14:30:51 2025 +0200
@@ -474,6 +474,9 @@
  *
  * If the current capacity is not sufficient, the buffer will be extended.
  *
+ * The new 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.
+ *
  * @param buffer the buffer
  * @param capacity the minimum required capacity for this buffer
  * @retval zero the capacity was already sufficient or successfully increased