list: Clarify description of list_moved().
authorBen Pfaff <blp@nicira.com>
Tue, 7 Jun 2011 20:16:37 +0000 (13:16 -0700)
committerBen Pfaff <blp@nicira.com>
Tue, 7 Jun 2011 20:21:26 +0000 (13:21 -0700)
This function doesn't have any users, but an upcoming commit will add one.

lib/list.c

index b5fa3893aa4c1df1c76a0030f1d8907f8b1bf063..a236f8c73bfaf4232c9331dd46ab216f3f6f23ca 100644 (file)
@@ -90,7 +90,11 @@ list_replace(struct list *element, const struct list *position)
 }
 
 /* Adjusts pointers around 'list' to compensate for 'list' having been moved
- * around in memory (e.g. as a consequence of realloc()). */
+ * around in memory (e.g. as a consequence of realloc()).
+ *
+ * This always works if 'list' is a member of a list, or if 'list' is the head
+ * of a non-empty list.  It fails badly, however, if 'list' is the head of an
+ * empty list; just use list_init() in that case. */
 void
 list_moved(struct list *list)
 {