X-Git-Url: http://git.ozlabs.org/?a=blobdiff_plain;f=ccan%2Ftlist%2Ftlist.h;h=a99191a2e0ebd75e9b13145550ac90d0a859f72e;hb=5c1767485d0879cdacdfeed218f5e91cc2e9f716;hp=28978514678d99a7df24ca66872465cf0cea3586;hpb=d81e79b8dfdfb0da8766c022e767a5b040e5d07b;p=ccan

diff --git a/ccan/tlist/tlist.h b/ccan/tlist/tlist.h
index 28978514..a99191a2 100644
--- a/ccan/tlist/tlist.h
+++ b/ccan/tlist/tlist.h
@@ -11,15 +11,16 @@
  *
  * This declares a structure "struct tlist_@suffix" to use for
  * lists containing this type.  The actual list can be accessed using
- * ".raw" or tlist_raw().
+ * ".raw" or tlist_raw().  For maximum portability, place tlists
+ * embedded in structures as the last member.
  *
  * Example:
  *	// Defines struct tlist_children
  *	TLIST_TYPE(children, struct child);
  *	struct parent {
  *		const char *name;
- *		struct tlist_children children;
  *		unsigned int num_children;
+ *		struct tlist_children children;
  *	};
  *
  *	struct child {