/**
- * modest_conf_get_list:
+ * modest_conf_set_list:
* @self: a ModestConf instance
* @key: the key of the value to retrieve
+ * @val: the list with the values to set
* @list_type: the type of the elements of the list
* @err: a GError ptr, or NULL to ignore.
*
- * get a list of values from the configuration system
- *
- * Returns: a list with the values for the key, or NULL in case of error or
- * if the list is empty; @err gives details in case of error
+ * set a list of values in the configuration system
+ * @err gives details in case of error
*/
-GSList * modest_conf_get_list (ModestConf* self, const gchar* key,
- ModestConfValueType list_type, GError **err);
+void modest_conf_set_list (ModestConf* self, const gchar* key,
+ GSList *val, ModestConfValueType list_type,
+ GError **err);
/**
gboolean modest_conf_key_exists (ModestConf* self, const gchar* key, GError **err);
+
+/**
+ * modest_conf_key_valid:
+ * @str: some key
+ *
+ * check whether @str is a valid key in the config system
+ * This is a *class* function, and therefore does not require a ModestConf
+ * instance
+ *
+ * Returns: TRUE if it is valid, FALSE otherwise
+ */
+gboolean modest_conf_key_is_valid (const gchar* str);
+
+
/**
* modest_conf_key_escape:
* @str: a string to escape
*
* returns an escaped version of @str, ie. something suitable as a key
* This is a *class* function, and therefore does not require a ModestConf
- * instance
+ * instance. Note: this for is invidual elements in a key
*
* Returns: a newly allocated string with the escaped version
*/
*
* returns an unescaped version of @str. This is a *class* function, and
* therefore does not require a ModestConf instance
+ * Note: this for is invidual elements in a key
*
* Returns: a newly allocated string with the unescaped version
*/