[gimp] app: fix up obsolete comments in GimpImageMap, and reorder members

[Michael Natterer <mitch src gnome org>]

commit c0fbbcdac4f64a234d2e090e2bc616e609c732a0
Author: Michael Natterer <mitch gimp org>
Date:   Wed Jun 25 18:53:44 2014 +0200

    app: fix up obsolete comments in GimpImageMap, and reorder members

 app/core/gimpimagemap.c |   18 ++++++------------
 app/core/gimpimagemap.h |    4 ++--
 2 files changed, 8 insertions(+), 14 deletions(-)
---
diff --git a/app/core/gimpimagemap.c b/app/core/gimpimagemap.c
index d6f72fe..490ccfd 100644
--- a/app/core/gimpimagemap.c
+++ b/app/core/gimpimagemap.c
@@ -16,19 +16,13 @@
  */
 
 /* This file contains the code necessary for generating on canvas
- * previews, either by connecting a function to process the pixels or
- * by connecting a specified GEGL operation to do the processing. It
- * keeps an undo buffer to allow direct modification of the pixel data
- * (so that it will show up in the projection) and it will restore the
- * source in case the mapping procedure was cancelled.
+ * previews, by connecting a specified GEGL operation to do the
+ * processing. It uses drawable filters that allow for non-destructive
+ * manupulation of drawable data, with live preview on screen.
  *
  * To create a tool that uses this, see /tools/gimpimagemaptool.c for
  * the interface and /tools/gimpcolorbalancetool.c for an example of
  * using that interface.
- *
- * Note that when talking about on canvas preview, we are speaking
- * about non destructive image editing where the operation is previewd
- * before being applied.
  */
 
 #include "config.h"
@@ -66,14 +60,14 @@ struct _GimpImageMap
   gchar                *undo_desc;
   GeglNode             *operation;
   gchar                *icon_name;
+
   GimpImageMapRegion    region;
+  gdouble               opacity;
+  GimpLayerModeEffects  paint_mode;
   gboolean              gamma_hack;
 
   GeglRectangle         filter_area;
 
-  gdouble               opacity;
-  GimpLayerModeEffects  paint_mode;
-
   GimpFilter           *filter;
   GeglNode             *translate;
   GeglNode             *crop;
diff --git a/app/core/gimpimagemap.h b/app/core/gimpimagemap.h
index ed69d08..1b17403 100644
--- a/app/core/gimpimagemap.h
+++ b/app/core/gimpimagemap.h
@@ -43,8 +43,8 @@ struct _GimpImageMapClass
 /*  Image Map functions  */
 
 /*  Successive image_map_apply functions can be called, but eventually
- *  MUST be followed with an image_map_commit or an image_map_abort call
- *  The image map is no longer valid after a call to commit or abort.
+ *  MUST be followed with an image_map_commit or an image_map_abort call,
+ *  both of which will remove the live filter from the drawable.
  */
 
 GType          gimp_image_map_get_type   (void) G_GNUC_CONST;