* uncommented valid strings

[modest] / src / modest-account-mgr.h

diff --git a/src/modest-account-mgr.h b/src/modest-account-mgr.h
index a7385ac..1e2e27b 100644 (file)
--- a/src/modest-account-mgr.h
+++ b/src/modest-account-mgr.h
@@ -110,6 +110,8 @@ gboolean        modest_account_mgr_add_account    (ModestAccountMgr *self,
  * @username: the username
  * @password: the password
  * @proto:    the protocol (imap, smtp, ...) used for this account
+ * @security: the security options, (SSL, TLS ...) used to access the server
+ * @auth: the authentication method (password, none ...) used to access the server
  * 
  * add a server account to the configuration.
  * the server account with @name should not already exist
@@ -121,7 +123,9 @@ gboolean modest_account_mgr_add_server_account    (ModestAccountMgr *self,
                                                   const gchar *hostname,
                                                   const gchar *username,
                                                   const gchar *password,
-                                                  ModestProtocol proto);  
+                                                  ModestProtocol proto,
+                                                  ModestProtocol security,
+                                                  ModestProtocol auth);
 
 
 /**
@@ -164,20 +168,23 @@ gboolean        modest_account_mgr_remove_account         (ModestAccountMgr *sel
  * list all account names
  *
  * Returns: a newly allocated list of account names, or NULL in case of error or
- * if there are no accounts. The caller must free the returned GSList
+ * if there are no accounts. The caller must free the returned GSList.
+ *
+ * TODO: I believe that the caller must free the strings in the GSList items too, 
+ * because this is implemented via gconf_client_all_dirs() which also requires a deep free, 
+ * though that's not documented. murrayc.
  */
 GSList*                modest_account_mgr_account_names    (ModestAccountMgr *self);
 
 
 /**
- * modest_account_mgr_server_account_names:
+ * modest_account_mgr_search_server_account:
  * @self: a ModestAccountMgr instance
  * @account_name: get only server accounts for @account_name, or NULL for any
- * @type: get only server accounts from protocol type @type, or MODEST_PROTO_TYPE_ANY
- * @proto: get only server account with protocol @proto, or NULL for any
- * @only_enabled: get only enabled server accounts if TRUE
+ * @type: get only server accounts from protocol type @type, or MODEST_PROTOCOL_TYPE_UNKNOWN
+ * @proto: get only server account with protocol @proto, or MODEST_PROTOCOL_UNKNOWN for any
  * 
- * list all the server account names
+ * List all the server account names, optionally narrowing the result down to one account.
  *
  * Returns: a newly allocated list of server account names, or NULL in case of
  * error or if there are no server accounts. The caller must free the returned GSList