# HG changeset patch
# User Mike Becker <universe@uap-core.de>
# Date 1687278527 -7200
# Node ID cff828e156a9604c40208f147de8584332689165
# Parent  71b2f3f6318220543f74f8688aa20ded86e5742a
add missing docs for cx_invoke_destructor()

diff -r 71b2f3f63182 -r cff828e156a9 src/cx/collection.h
--- a/src/cx/collection.h	Tue Jun 20 18:26:35 2023 +0200
+++ b/src/cx/collection.h	Tue Jun 20 18:28:47 2023 +0200
@@ -127,6 +127,15 @@
     (c)->store_pointer ? (*((void **) (e))) : (e))
 
 
+/**
+ * Invokes all available destructor functions for a specific element.
+ *
+ * Usually only used by collection implementations. There should be no need
+ * to invoke this macro manually.
+ *
+ * @param c the collection
+ * @param e the element
+ */
 #define cx_invoke_destructor(c, e) \
     if ((c)->simple_destructor) cx_invoke_simple_destructor(c,e); \
     if ((c)->advanced_destructor) cx_invoke_advanced_destructor(c,e)