* functions for working with a TnyFolder. tinymail does not seem to offer any
* easy way to cause derived TnyFolders to be instantiated.
*/
-
-/* TODO: These "const TnyFolder*" arguments will eventually need to
- * be "TnyFolder*". C cannot support constness for complex objects like C++
- * can, because it lacks the mutable keyword and doesn't allow both const
- * and non-const get function overloads.
- */
-
+
/**
* modest_tny_folder_guess_type:
* @folder: a valid tnymail folder
*
* Returns: the folder type, or TNY_FOLDER_TYPE_UNKNOWN
*/
-TnyFolderType modest_tny_folder_guess_folder_type (const TnyFolder *folder);
+TnyFolderType modest_tny_folder_guess_folder_type (TnyFolder *folder);
*
* Returns: get the help_id for this folder, or NULL in case of error
*/
-const gchar* modest_tny_folder_get_help_id (const TnyFolder *folder);
+const gchar* modest_tny_folder_get_help_id (TnyFolder *folder);
/**
gboolean modest_tny_folder_is_ancestor (TnyFolder *folder,
TnyFolderStore *ancestor);
+/**
+ * modest_tny_folder_store_find_folder_from_uri:
+ * @folder_store: a #TnyFolderStore
+ * @uri: a string
+ *
+ * This method tries to find a folder in @folder_store. The idea is
+ * being as fast as possible being synchronous. This is accomplished
+ * avoiding network access.
+ *
+ * Returns: %NULL if folder is not found, or a #TnyFolder.
+ */
+TnyFolder *modest_tny_folder_store_find_folder_from_uri (TnyFolderStore *folder_store, const gchar *uri);
+
+/**
+ * modest_tny_folder_get_display_name:
+ * @folder: a #TnyFolder
+ *
+ * obtain the display name for @folder
+ *
+ * Returns: a newly allocated string
+ */
+gchar * modest_tny_folder_get_display_name (TnyFolder *folder);
+
G_END_DECLS
#endif /* __MODEST_TNY_FOLDER_H__*/