basic/macro: add comment explaining DEFINE_TRIVIAL_DESTRUCTOR()

diff --git a/src/basic/macro.h b/src/basic/macro.h
index 0c99d68db2633c5644db6b4d8ab260be24de0e8c..7f650d0719e77cf2ec4a1959b5c33a2011f3e250 100644 (file)
--- a/src/basic/macro.h
+++ b/src/basic/macro.h
@@ -310,6 +310,8 @@ static inline int __coverity_check_and_return__(int condition) {
 #define FOREACH_ARRAY(i, array, num)                                    \
         _FOREACH_ARRAY(i, array, num, UNIQ_T(m, UNIQ), UNIQ_T(end, UNIQ))
 
+/* A wrapper for 'func' to return void.
+ * Only useful when a void-returning function is required by some API. */
 #define DEFINE_TRIVIAL_DESTRUCTOR(name, type, func)             \
         static inline void name(type *p) {                      \
                 func(p);                                        \