diff src/editors.h @ 140:e57b0207e180

editors.c was almost completely rewritten: - centralized template parsing - better control of executed editors - possibility to get editor exit status via callback

--- a/src/editors.h	Wed Sep 12 21:17:31 2007 +0000
+++ b/src/editors.h	Sun Sep 30 21:10:54 2007 +0000
@@ -13,13 +13,62 @@
 #ifndef EDITORS_H
 #define EDITORS_H
 
+enum {
+	EDITOR_KEEP_FS            = 0x00000001,
+	EDITOR_VERBOSE            = 0x00000002,
+	EDITOR_VERBOSE_MULTI      = 0x00000004,
+	
+	EDITOR_DEST               = 0x00000100,
+	EDITOR_FOR_EACH           = 0x00000200,
+	EDITOR_SINGLE_COMMAND     = 0x00000400,
+	
+	EDITOR_ERROR_EMPTY        = 0x00020000,
+	EDITOR_ERROR_SYNTAX       = 0x00040000,
+	EDITOR_ERROR_INCOMPATIBLE = 0x00080000,
+	EDITOR_ERROR_NO_FILE      = 0x00100000,
+	EDITOR_ERROR_CANT_EXEC    = 0x00200000,
+	EDITOR_ERROR_STATUS       = 0x00400000,
+	EDITOR_ERROR_SKIPPED      = 0x00800000,
+
+	EDITOR_ERROR_MASK         = 0xffff0000
+	
+};
+
+/* return values from callback function */
+enum {
+	EDITOR_CB_CONTINUE = 0, /* continue multiple editor execution on remaining files*/
+	EDITOR_CB_SKIP,         /* skip the remaining files */
+	EDITOR_CB_SUSPEND       /* suspend execution, one of editor_resume or editor_skip
+	                           must be called later */
+};
+
+
+/*
+Callback is called even on skipped files, with the EDITOR_ERROR_SKIPPED flag set. 
+It is a good place to call file_data_change_info_free().
+
+ed - pointer that can be used for editor_resume/editor_skip or NULL if all files were already processed
+flags - flags above
+list - list of procesed FileData structures, typically single file or whole list passed to start_editor_*
+data - generic pointer
+*/
+typedef gint (*EditorCallback) (gpointer ed, gint flags, GList *list, gpointer data);
+
+
+
+void editor_resume(gpointer ed);
+void editor_skip(gpointer ed);
+
+
+gint editor_command_parse(const gchar *template, GList *list, gchar **output);
 
 void editor_reset_defaults(void);
 gint start_editor_from_file(gint n, FileData *fd);
 gint start_editor_from_file_list(gint n, GList *list);
-
+gint start_editor_from_file_full(gint n, FileData *fd, EditorCallback cb, gpointer data);
+gint start_editor_from_file_list_full(gint n, GList *list, EditorCallback cb, gpointer data);
 gint editor_window_flag_set(gint n);
-
+const gchar *editor_get_error_str(gint flags);
 
 #endif