/**
* modest_maemo_utils_create_temp_stream:
- * @extension: a string with the extension the file should get, or %NULL
+ * @orig_name: a string with the original name of the extension, or %NULL
* @path: a string with the created file path
*
- * Creates a temporary fs stream
+ * Creates a temporary fs stream, in a random subdir of /tmp or /var/tmp.
*
* Returns: a #TnyFsStream, or %NULL if operation failed.
*/
-TnyFsStream *modest_maemo_utils_create_temp_stream (const gchar *extension, gchar **path);
+TnyFsStream *modest_maemo_utils_create_temp_stream (const gchar *orig_name, gchar **path);
/**
* modest_maemo_utils_get_supported_secure_authentication_methods:
*/
void modest_maemo_utils_setup_images_filechooser (GtkFileChooser *chooser);
-/** modest_maemo_show_information_note_and_forget:
+/** modest_maemo_show_information_note_in_main_context_and_forget:
* @parent_window: The window for which the note should be transient.
* @message: The text to show.
*
- * Show the information note and destroy it when it is closed, without
- * blocking. Use this when you don't want to use gtk_dialog_run(), which might lead
- * to hangs.
+ * This calls modest_maemo_show_information_note_and_forget() in an idle handler.
+ * This should be used when you are not sure that you are in the main context,
+ * because you should try to use GTK+ UI code only in the main context.
*/
-void modest_maemo_show_information_note_and_forget (GtkWindow *parent_window, const gchar* message);
+void modest_maemo_show_information_note_in_main_context_and_forget (GtkWindow *parent_window, const gchar* message);
/** modest_maemo_show_dialog_and_forget:
* @parent_window: The window for which the note should be transient.