* src/modest-tny-account-store.[ch]:

[modest] / src / modest-tny-account-store.h

diff --git a/src/modest-tny-account-store.h b/src/modest-tny-account-store.h
index df87c3c..1ed6d50 100644 (file)
--- a/src/modest-tny-account-store.h
+++ b/src/modest-tny-account-store.h
@@ -41,6 +41,7 @@
 #include <tny-folder.h>
 #include <modest-account-mgr.h>
 #include <modest-tny-local-folders-account.h>
+#include <gtk/gtkwidget.h>
 
 /* other include files */
 
@@ -125,7 +126,7 @@ TnyAccount* modest_tny_account_store_get_tny_account_by  (ModestTnyAccountStore
  * modest_tny_account_store_get_server_account
  * @self: a ModestTnyAccountStore instance
  * @account_name: a modest account name
- * @type: the tny account type (store or transport)
+ * @type: the tny account type (#TNY_ACCOUNT_TYPE_STORE or #TNY_ACCOUNT_TYPE_STORE)
  * 
  * Get the tny account corresponding to one of the server_accounts for account with @account_name
  * 
@@ -151,6 +152,9 @@ TnyAccount* modest_tny_account_store_get_server_account (ModestTnyAccountStore *
 TnyAccount* modest_tny_account_store_get_transport_account_for_open_connection (ModestTnyAccountStore *self,
                                                                                const gchar *account_name);
 
+TnyAccount* modest_tny_account_store_get_smtp_specific_transport_account_for_open_connection (ModestTnyAccountStore *self,
+                                                                                             const gchar *account_name);
+
 /**
  * tny_account_store_get_session
  * @self: a TnyAccountStore instance
@@ -165,7 +169,8 @@ TnySessionCamel*    modest_tny_account_store_get_session    (TnyAccountStore *se
 /** modest_tny_account_store_get_local_folders_account:
  * @self: a TnyAccountStore instance
  * 
- * Get the user-visible local folders account.
+ * Get the user-visible local folders account. It returns a new
+ * reference so the caller must unref it when no longer needed
  **/
 TnyAccount * modest_tny_account_store_get_local_folders_account (ModestTnyAccountStore *self);
 
@@ -175,7 +180,9 @@ TnyAccount * modest_tny_account_store_get_local_folders_account (ModestTnyAccoun
  * 
  * Get the mmc folders account.
  *
- * Returns: a #TnyAccount, or %NULL if no mmc account is available now.
+ * Returns: a #TnyAccount, or %NULL if no mmc account is available
+ * now. It returns a new reference so the caller must unref it when no
+ * longer needed
  */
 TnyAccount * modest_tny_account_store_get_mmc_folders_account (ModestTnyAccountStore *self);
 
@@ -209,11 +216,36 @@ TnyMsg *modest_tny_account_store_find_msg_in_outboxes (ModestTnyAccountStore *se
  *
  * Gets the transport account from a header that is in the outbox
  *
- * Returns: %NULL or a %TnyTransportAccount
+ * Returns: %NULL or a %TnyTransportAccount. Returns a new reference
+ * so the caller must unref it when no longer needed
+ */
+TnyTransportAccount * modest_tny_account_store_get_transport_account_from_outbox_header(ModestTnyAccountStore *self,
+                                                                                      TnyHeader *header);
+
+/**
+ * modest_tny_account_store_new_connection_specific_transport_account:
+ * @self: a #ModestTnyAccountStore
+ * @name: the name of the connection specific smtp transport account
+ *
+ * Creates a connection specific transport account and put it in the merged outbox
+ *
+ * Returns: the new #TnyTransportAccount
+ */
+TnyTransportAccount * modest_tny_account_store_new_connection_specific_transport_account (ModestTnyAccountStore *self,
+                                                                                         const gchar *name);
+
+/**
+ * modest_tny_account_store_show_account_settings_dialog:
+ * @self: a #ModestTnyAccountStore
+ * @account_name: a string
+ *
+ * obtains (if already created) or creates (and shows) the settings dialog for
+ * @account_name
+ *
+ * Returns: a #ModesAccountSettingsDialog
  */
-TnyTransportAccount *
-modest_tny_account_store_get_transport_account_from_outbox_header(ModestTnyAccountStore *self,
-                                                                 TnyHeader *header);
+GtkWidget *modest_tny_account_store_show_account_settings_dialog (ModestTnyAccountStore *self,
+                                                                 const gchar *account_name);
 
 G_END_DECLS