- * all subsequent values to one position left in the dynar. Note that the free
- * function is called only if object == NULL.
+ * all subsequent values to one position left in the dynar.
+ *
+ * If the object argument of this function is a non-null pointer, the removed
+ * element is copied to this address. If not, the element is freed using the
+ * free_f function passed at dynar creation.