comments about struct list

diff --git a/lib/linklist.h b/lib/linklist.h
index ace6dee3997934d2af0da8578edf21f39d42f0b4..331135fe14d7894579b2835b1cf2387c1a71011c 100644 (file)
--- a/lib/linklist.h
+++ b/lib/linklist.h
@@ -36,7 +36,12 @@ struct list
 {
   struct listnode *head;
   struct listnode *tail;
+  /* invariant: count is the number of listnodes in the list */
   unsigned int count;
+  /*
+   * Returns -1 if val1 < val2, 0 if equal?, 1 if val1 > val2.
+   * Used as definition of sorted for listnode_add_sort
+   */
   int (*cmp) (void *val1, void *val2);
   void (*del) (void *val);
 };