include: list.h: document things that must not be done

Add some warnings that list entries must not be added twice.

Signed-off-by: Enrico Weigelt, metux IT consult <info@metux.net>
This commit is contained in:
Enrico Weigelt, metux IT consult 2025-05-28 12:32:28 +02:00
parent fc428a78a2
commit 74766ee6bd

View File

@ -95,6 +95,11 @@
* xorg_list_del(&iterator->entry);
* }
*
* WARNING: entries MUST NOT be added to the list twice, otherwise iterating
* will end up in infinite loop.
* WARNING: entries MUST NOT be added to multiple lists - use separate entry
* nodes within the container struct, if it needs to be added to
* several lists at the same time.
*/
/**