@@ -118,10 +118,13 @@
 		     itemSize: (size_t)itemSize;
 
 /**
  * @brief Creates a new OFData with the specified `count` items of size 1 by
  *	  taking over ownership of the specified items pointer.
+ *
+ * If initialization fails for whatever reason, the passed memory is *not*
+ * free'd if `freeWhenDone` is true.
  *
  * @param items The items to store in the OFData
  * @param count The number of items
  * @param freeWhenDone Whether to free the pointer when it is no longer needed
  *		       by the OFData
@@ -132,10 +135,13 @@
 		       freeWhenDone: (bool)freeWhenDone;
 
 /**
  * @brief Creates a new OFData with the specified `count` items of the
  *	  specified size by taking ownership of the specified items pointer.
+ *
+ * If initialization fails for whatever reason, the passed memory is *not*
+ * free'd if `freeWhenDone` is true.
  *
  * @param items The items to store in the OFData
  * @param count The number of items
  * @param itemSize The item size of a single item in bytes
  * @param freeWhenDone Whether to free the pointer when it is no longer needed
@@ -210,10 +216,13 @@
 
 /**
  * @brief Initializes an already allocated OFData with the specified `count`
  *	  items of size 1 by taking over ownership of the specified items
  *	  pointer.
+ *
+ * If initialization fails for whatever reason, the passed memory is *not*
+ * free'd if `freeWhenDone` is true.
  *
  * @param items The items to store in the OFData
  * @param count The number of items
  * @param freeWhenDone Whether to free the pointer when it is no longer needed
  *		       by the OFData
@@ -225,10 +234,13 @@
 
 /**
  * @brief Initializes an already allocated OFData with the specified `count`
  *	  items of the specified size by taking ownership of the specified
  *	  items pointer.
+ *
+ * If initialization fails for whatever reason, the passed memory is *not*
+ * free'd if `freeWhenDone` is true.
  *
  * @param items The items to store in the OFData
  * @param count The number of items
  * @param itemSize The item size of a single item in bytes
  * @param freeWhenDone Whether to free the pointer when it is no longer needed