diff -r d7129285ac32 -r dce9b8450656 src/cx/array_list.h
--- a/src/cx/array_list.h	Tue Mar 21 17:21:20 2023 +0100
+++ b/src/cx/array_list.h	Tue Mar 28 19:13:33 2023 +0200
@@ -152,6 +152,9 @@
 /**
  * Allocates an array list for storing elements with \p item_size bytes each.
  *
+ * If \p item_size is CX_STORE_POINTERS, the created list will be created as if
+ * cxListStorePointers() was called immediately after creation.
+ *
  * @param allocator the allocator for allocating the list memory
  * @param comparator the comparator for the elements
  * @param item_size the size of each element in bytes
@@ -172,6 +175,9 @@
  * If you want to call functions that need a compare function, you have to
  * set it immediately after creation or use cxArrayListCreate().
  *
+ * If \p item_size is CX_STORE_POINTERS, the created list will be created as if
+ * cxListStorePointers() was called immediately after creation.
+ *
  * @param item_size the size of each element in bytes
  * @param initial_capacity the initial number of elements the array can store
  * @return the created list