};
typedef struct _ModestPresets ModestPresets;
-enum _ModestPresetsInfo {
+typedef enum _ModestPresetsInfo {
/* two bits for the server type */
MODEST_PRESETS_INFO_NONE = 0x0000,
MODEST_PRESETS_INFO_IMAP = 0x0001,
MODEST_PRESETS_INFO_APOP = 0x0004,
MODEST_PRESETS_INFO_SECURE_SMTP = 0x0008,
MODEST_PRESETS_INFO_SECURE_INCOMING = 0x000f
-};
+} ModestPresetsInfo;
-typedef enum _ModestPresetsInfo ModestPresetsInfo;
+/* typedef enum _ModestPresetsInfo ModestPresetsInfo; */
/**
* modest_presets_get_providers:
* @self: a valid ModestPresets instance
* @mcc: limit the search to providers with this mcc (Mobile Country Code),
- * or <0 to get all
- * @include_globals: include providers without MCC (such as GMail, Yahoo) if @mcc != 0?
+ * or 0 to get all
+ * @include_globals: include (global) providers without MCC (such as GMail, Yahoo)
*
- * get a list of providers
+ * get a list of providers matching certian criteria
*
* Returns: a newly allocated array of strings, or NULL in case of error
* should be freed with g_strvfree
*
**/
-gchar ** modest_presets_get_providers (ModestPresets *self, gint mcc,
- gboolean include_globals);
+gchar ** modest_presets_get_providers (ModestPresets *self, guint mcc,
+ gboolean include_globals);
/**
* modest_presets_get_server:
* @self: a valid ModestPresets instance
* @provider: name of the provider
- * @incoming: get the incoming mailserver if TRUE, get the outgoing server otherwise
+ * @incoming_server: get the incoming mailserver if TRUE, get the
+ * outgoing server otherwise
*
* get the name of a incoming or outgoing mailserver
*
* modest_presets_get_info:
* @self: a valid ModestPresets instance
* @provider: name of the provider
- * @incoming: get the incoming mailserver if TRUE, get the outgoing server otherwise
+ * @incoming_server: get the incoming mailserver if TRUE, get the
+ * outgoing server otherwise
*
* get information about some incoming or outgoing mailserver
*
/**
* modest_presets_destroy:
- * @self: a valid ModestPresets instance
+ * @self: a valid ModestPresets instance (ie. must not be NULL)
*
* destroy ModestPresets instance; this is required after you're done with it.
- *
*/
void modest_presets_destroy (ModestPresets *self);