* 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 a7f7c5d..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 */
 
@@ -168,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);
 
@@ -178,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);
 
@@ -212,11 +216,11 @@ 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);
+TnyTransportAccount * modest_tny_account_store_get_transport_account_from_outbox_header(ModestTnyAccountStore *self,
+                                                                                      TnyHeader *header);
 
 /**
  * modest_tny_account_store_new_connection_specific_transport_account:
@@ -227,9 +231,21 @@ modest_tny_account_store_get_transport_account_from_outbox_header(ModestTnyAccou
  *
  * Returns: the new #TnyTransportAccount
  */
-TnyTransportAccount *
-modest_tny_account_store_new_connection_specific_transport_account (ModestTnyAccountStore *self,
-                                                                   const gchar *name);
+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
+ */
+GtkWidget *modest_tny_account_store_show_account_settings_dialog (ModestTnyAccountStore *self,
+                                                                 const gchar *account_name);
 
 G_END_DECLS