Update: Add clarifying documentation to some memory allocation functions.

diff --git a/level_0/f_memory/c/memory/array.h b/level_0/f_memory/c/memory/array.h
index 2f5cc4ee0f3f1e80620a74cf2ba4361be1f8bfc5..078fde9b53501748e0a334c50337a18611e16450 100644 (file)
--- a/level_0/f_memory/c/memory/array.h
+++ b/level_0/f_memory/c/memory/array.h
@@ -279,6 +279,9 @@ extern "C" {
  * This function is only useful for simple structures of the form "{ array, used, size }" where the array is a simple type.
  * If the simple type that is "array" requires additional memory manipulation on allocation, then do not use this function.
  *
+ * This does not guarantee the size increased to be increased by the given step.
+ * There may be some practices that result in the step being increased by a smaller amount.
+ *
  * @param step
  *   The allocation step to use.
  *
@@ -326,6 +329,8 @@ extern "C" {
  * This function is only useful for simple structures of the form "{ array, used, size }" where the array is a simple type.
  * If the simple type that is "array" requires additional memory manipulation on allocation, then do not use this function.
  *
+ * This does guarantee the size to be increased by the given amount, but only when (used + amount > size).
+ *
  * @param amount
  *   A positive number representing how much to increase the size by.
  * @param width