2007-07-23 Murray Cumming <murrayc@murrayc.com>
[modest] / src / modest-tny-account.h
index d4a2e3f..867f19a 100644 (file)
@@ -95,13 +95,14 @@ TnyAccount* modest_tny_account_new_for_per_account_local_outbox_folder (
 /**
  * modest_tny_account_new_from_server_account_name:
  * @account_mgr: a valid account mgr instance
+ * @session: a valid TnySessionCamel instance.
  * @server_account_name: the name of a server account in the configuration system.
  *
  * Returns: a new TnyAccount or NULL in case of error.
  */
 TnyAccount*
 modest_tny_account_new_from_server_account_name (ModestAccountMgr *account_mgr, 
-       const gchar* server_account_name);
+       TnySessionCamel *session, const gchar* server_account_name);
        
 /**
  * modest_tny_account_get_special_folder:
@@ -114,7 +115,8 @@ modest_tny_account_new_from_server_account_name (ModestAccountMgr *account_mgr,
  * such as (for example) server-side Sent/Junk mail for IMAP accounts 
  * 
  * Returns: the tny folder corresponding to this special folder, or NULL in case
- * of error, or if the special folder does not exist for this account
+ * of error, or if the special folder does not exist for this account. 
+ * This must be unrefed with g_object_unref().
  */
 TnyFolder*    modest_tny_account_get_special_folder   (TnyAccount *self,
                                                       TnyFolderType special_type);