- It's not safe to treat ELEM as an element in a list after
- removing it. In particular, using list_next() or list_prev()
- on ELEM after removal yields undefined behavior. This means
- that a naive loop to remove the elements in a list will fail:
+ A list element must be treated very carefully after removing
+ it from its list. Calling list_next() or list_prev() on ELEM
+ will return the item that was previously before or after ELEM,
+ but, e.g., list_prev(list_next(ELEM)) is no longer ELEM!