-xbt_error_t xbt_cfg_empty(xbt_cfg_t cfg, const char *name);
-
-/*----[ Getting ]---------------------------------------------------------*/
-/* Returns a pointer to the values actually stored in the cache. Do not */
-/* modify them unless you really know what you're doing. */
-xbt_error_t xbt_cfg_get_int (xbt_cfg_t cfg,
- const char *name,
- int *val);
-xbt_error_t xbt_cfg_get_double(xbt_cfg_t cfg,
- const char *name,
- double *val);
-xbt_error_t xbt_cfg_get_string(xbt_cfg_t cfg,
- const char *name,
- char **val);
-xbt_error_t xbt_cfg_get_host (xbt_cfg_t cfg,
- const char *name,
- char **host,
- int *port);
-xbt_error_t xbt_cfg_get_dynar (xbt_cfg_t cfg,
- const char *name,
- /* OUT */ xbt_dynar_t *dynar);
-
-END_DECL
+XBT_PUBLIC(void) xbt_cfg_empty(xbt_cfg_t cfg, const char *name);
+
+/* @} */
+
+/** @defgroup XBT_cfg_decl Configuration type declaration and memory management
+ * @ingroup XBT_config
+ *
+ * @{
+ */
+
+ /** @brief possible content of each configuration cell */
+ typedef enum {
+ xbt_cfgelm_int=0, /**< int */
+ xbt_cfgelm_double, /**< double */
+ xbt_cfgelm_string, /**< char* */
+ xbt_cfgelm_peer, /**< both a char* (representing the peername) and an integer (representing the port) */
+
+ xbt_cfgelm_any, /* not shown to users to prevent errors */
+ xbt_cfgelm_type_count
+ } e_xbt_cfgelm_type_t;
+
+ /** \brief Callback types. They get the name of the modified entry, and the position of the changed value */
+ typedef void (*xbt_cfg_cb_t)(const char*, int);
+
+ XBT_PUBLIC(xbt_cfg_t) xbt_cfg_new (void);
+ XBT_PUBLIC(void) xbt_cfg_cpy(xbt_cfg_t tocopy, /* OUT */ xbt_cfg_t *whereto);
+ XBT_PUBLIC(void) xbt_cfg_free(xbt_cfg_t *cfg);
+ XBT_PUBLIC(void) xbt_cfg_dump(const char *name,const char*indent,xbt_cfg_t cfg);
+
+ /** @} */
+
+/** @defgroup XBT_cfg_register Registering stuff
+ * @ingroup XBT_config
+ *
+ * This how to add new variables to an existing configuration set. Use it to make your code
+ * configurable.
+ *
+ * @{
+ */
+ XBT_PUBLIC(void) xbt_cfg_register(xbt_cfg_t cfg,
+ const char *name, e_xbt_cfgelm_type_t type,
+ int min, int max,
+ xbt_cfg_cb_t cb_set, xbt_cfg_cb_t cb_rm);
+ XBT_PUBLIC(void) xbt_cfg_unregister(xbt_cfg_t cfg, const char *name);
+ XBT_PUBLIC(void) xbt_cfg_register_str(xbt_cfg_t cfg, const char *entry);
+ XBT_PUBLIC(void) xbt_cfg_check(xbt_cfg_t cfg);
+ XBT_PUBLIC(e_xbt_cfgelm_type_t) xbt_cfg_get_type(xbt_cfg_t cfg, const char *name);
+/* @} */
+/** @defgroup XBT_cfg_get Getting the stored values
+ * @ingroup XBT_config
+ *
+ * This is how to retrieve the values stored in the configuration set. This is only
+ * intended to configurable code, naturally.
+ *
+ * Note that those function return a pointer to the values actually stored
+ * in the set. Do not modify them unless you really know what you're doing.
+ * Likewise, do not free the strings after use, they are not copy of the data,
+ * but the data themselves.
+ *
+ * @{
+ */
+
+ XBT_PUBLIC(int) xbt_cfg_get_int (xbt_cfg_t cfg, const char *name);
+ XBT_PUBLIC(double) xbt_cfg_get_double(xbt_cfg_t cfg, const char *name);
+ XBT_PUBLIC(char*) xbt_cfg_get_string(xbt_cfg_t cfg, const char *name);
+ XBT_PUBLIC(void) xbt_cfg_get_peer (xbt_cfg_t cfg, const char *name, char **peer, int *port);
+ XBT_PUBLIC(xbt_dynar_t) xbt_cfg_get_dynar (xbt_cfg_t cfg, const char *name);
+
+ XBT_PUBLIC(int) xbt_cfg_get_int_at (xbt_cfg_t cfg, const char *name, int pos);
+ XBT_PUBLIC(double) xbt_cfg_get_double_at(xbt_cfg_t cfg, const char *name, int pos);
+ XBT_PUBLIC(char*) xbt_cfg_get_string_at(xbt_cfg_t cfg, const char *name, int pos);
+ XBT_PUBLIC(void) xbt_cfg_get_peer_at (xbt_cfg_t cfg, const char *name, int pos, char **peer, int *port);
+
+/** @} */
+
+SG_END_DECL()