-/*####[ Cache cursor functions ]#############################################*/
-/* To traverse (simple) caches */
-/* Don't add or remove entries to the cache while traversing !!! */
-/*###########################################################################*/
-typedef struct gras_set_cursor_ gras_set_cursor_t;
-/* creator/destructor */
-void gras_set_cursor_first (gras_set_t *set,
- gras_set_cursor_t **cursor);
-void gras_set_cursor_step (gras_set_cursor_t *cursor);
-int gras_set_cursor_get_or_free (gras_set_cursor_t **cursor,
- gras_set_elm_t **elm);
-
-#define gras_set_foreach(set,cursor,elm) \
- for (cursor=NULL, gras_set_cursor_first((set),&(cursor)) ; \
- gras_set_cursor_get_or_free(&(cursor),(gras_set_elm_t**)&(elm)); \
- gras_set_cursor_step(cursor) )
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* _GRAS_SET_H */
+/** @} */
+/** @name 3. Cursors
+ *
+ * \warning Don't add or remove entries to the cache while traversing
+ *
+ * @{
+ */
+
+/** @brief Cursor type */
+typedef struct xbt_set_cursor_ *xbt_set_cursor_t;
+
+void xbt_set_cursor_first (xbt_set_t set,
+ xbt_set_cursor_t *cursor);
+void xbt_set_cursor_step (xbt_set_cursor_t cursor);
+int xbt_set_cursor_get_or_free (xbt_set_cursor_t *cursor,
+ xbt_set_elm_t *elm);
+
+/** @brief Iterates over the whole set
+ * @hideinitializer
+ */
+#define xbt_set_foreach(set,cursor,elm) \
+ for ((cursor) = NULL, xbt_set_cursor_first((set),&(cursor)) ; \
+ xbt_set_cursor_get_or_free(&(cursor),(xbt_set_elm_t*)&(elm)); \
+ xbt_set_cursor_step(cursor) )
+
+/* @} */
+/* @} */
+SG_END_DECL()
+
+#endif /* _XBT_SET_H */