[gimp] app: Clarify corner case uses of gimp_object_name_changed()

[Martin Nordholts <martinn src gnome org>]

commit cb94993f40980128158cb8ca517659201521085b
Author: Martin Nordholts <martinn src gnome org>
Date:   Sat Aug 29 12:11:28 2009 +0200

    app: Clarify corner case uses of gimp_object_name_changed()

 app/core/gimpdata.c               |    1 +
 app/core/gimpfloatingselundo.c    |    4 ++++
 app/core/gimplayer-floating-sel.c |    4 ++++
 3 files changed, 9 insertions(+), 0 deletions(-)
---
diff --git a/app/core/gimpdata.c b/app/core/gimpdata.c
index 183c850..5335d68 100644
--- a/app/core/gimpdata.c
+++ b/app/core/gimpdata.c
@@ -355,6 +355,7 @@ gimp_data_real_dirty (GimpData *data)
 
   gimp_viewable_invalidate_preview (GIMP_VIEWABLE (data));
 
+  /* Emit the "name-changed" to signal general dirtiness */
   gimp_object_name_changed (GIMP_OBJECT (data));
 }
 
diff --git a/app/core/gimpfloatingselundo.c b/app/core/gimpfloatingselundo.c
index be08bc2..86f1de9 100644
--- a/app/core/gimpfloatingselundo.c
+++ b/app/core/gimpfloatingselundo.c
@@ -122,6 +122,10 @@ gimp_floating_sel_undo_pop (GimpUndo            *undo,
           gimp_layer_set_floating_sel_drawable (floating_layer, NULL);
         }
 
+      /* When the floating selection is converted to/from a normal
+       * layer it does something resembling a name, so emit the
+       * "name-changed" signal
+       */
       gimp_object_name_changed (GIMP_OBJECT (floating_layer));
 
       gimp_drawable_update (GIMP_DRAWABLE (floating_layer),
diff --git a/app/core/gimplayer-floating-sel.c b/app/core/gimplayer-floating-sel.c
index 7b3e169..bc710e6 100644
--- a/app/core/gimplayer-floating-sel.c
+++ b/app/core/gimplayer-floating-sel.c
@@ -149,6 +149,10 @@ floating_sel_to_layer (GimpLayer  *layer,
 
   gimp_image_undo_group_end (image);
 
+  /* When the floating selection is converted to/from a normal layer
+   * it does something resembling a name, so emit the "name-changed"
+   * signal
+   */
   gimp_object_name_changed (GIMP_OBJECT (layer));
 
   gimp_drawable_update (GIMP_DRAWABLE (layer),