diff -r 946895d19dde -r 185dc2a4b45c docs/Writerside/topics/list.h.md --- a/docs/Writerside/topics/list.h.md Tue Nov 11 18:43:08 2025 +0100 +++ b/docs/Writerside/topics/list.h.md Tue Nov 11 18:47:48 2025 +0100 @@ -401,7 +401,7 @@ With `cxListClone()` you can create deep copies of the elements in a list and insert them into another list. The destination list does not need to be empty, in which case the elements will be appended. -Depending on the concrete list implementation, `cxListClone()` tries to allocate enough memory up-front, before trying +Depending on the concrete list implementation, `cxListClone()` tries to allocate enough memory up-front before trying to insert anything. The function `cxListDifference()` clones elements from the `minuend` that are _not_ contained in the `subtrahend`, @@ -414,7 +414,7 @@ so that the result of the union is still sorted. However, when the `dst` list already contains elements, all functions will only append the result of the operation to that list. -That means, the `dst` list is only guaranteed to be sorted, when it was empty and the input lists are all sorted. +That means the `dst` list is only guaranteed to be sorted when it was empty and the input lists are all sorted. Refer to the documentation of the [clone-function callback](allocator.h.md#clone-function) to learn how to implement it. @@ -444,7 +444,7 @@ If a list implementation allows overallocation, the function `cxListReserve()` can be used to reserve memory for a total of `count` elements. On the other hand, you can use `cxListShrink()` to dispose of any overallocated memory and reduce the capacity to the actual number of currently stored elements. -Calling `cxListReserve()` with a `count` argument that is less than the current size of the list has no effect and the function returns zero. +Calling `cxListReserve()` with a `count` argument that is less than the current size of the list has no effect, and the function returns zero. If allocating memory fails, `cxListReserve()` returns a non-zero value. Since shrinking should never fail, `cxListShrink()` will usually always return zero,