X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=list.h;h=ba6211ba191395e40fd63d526ab9ddacc2b7f697;hp=4b946c7c24e037925c924b76df76c23c0a109196;hb=c79899fe6a1e8eb3086749f46c599d9790d99921;hpb=101e1fd3252d838458a6ad4015f497818c54c897

diff --git a/list.h b/list.h
index 4b946c7c..ba6211ba 100644
--- a/list.h
+++ b/list.h
@@ -13,12 +13,15 @@
 	const typeof( ((type *)0)->member ) *__mptr = (ptr);    \
 	(type *)( (char *)__mptr - offsetof(type,member) );})
 
-/*
- * These are non-NULL pointers that will result in page faults
- * under normal circumstances, used to verify that nobody uses
- * non-initialized list entries.
+/**
+ * Non-NULL pointers that will result in page faults under normal
+ * circumstances, used to verify that nobody uses non-initialized list entries.
+ * Used for poisoning the \a next pointer of struct list_head.
  */
 #define LIST_POISON1  ((void *) 0x00100100)
+/** Non-null pointer, used for poisoning the \a prev pointer of struct
+ * list_head
+ */
 #define LIST_POISON2  ((void *) 0x00200200)
 
 /**