-/* do not use this structure internals directly, but use the public interface
- * This was made public to allow:
- * - the inlining of the foreach elements
- * - sending such beasts over the network
+/*
+ * \warning DO NOT USE THIS STRUCTURE DIRECTLY! Instead, use the public interface:
+ * This was made public to allow:
+ * - the inlining of the foreach elements
+ * - sending such beasts over the network
+ *
+ * \see xbt_dynar_length()