gimp r26629 - in branches/soc-2008-tagging: . app/widgets

[aurisj svn gnome org]

Author: aurisj
Date: Sun Aug 17 20:06:04 2008
New Revision: 26629
URL: http://svn.gnome.org/viewvc/gimp?rev=26629&view=rev

Log:
2008-08-17  Aurimas JuÅka  <aurisj svn gnome org>

	* app/widgets/gimptagentry.h: described the meaning of gimp tag entry
	text mask.



Modified:
   branches/soc-2008-tagging/ChangeLog
   branches/soc-2008-tagging/app/widgets/gimptagentry.h

Modified: branches/soc-2008-tagging/app/widgets/gimptagentry.h
==============================================================================
--- branches/soc-2008-tagging/app/widgets/gimptagentry.h	(original)
+++ branches/soc-2008-tagging/app/widgets/gimptagentry.h	Sun Aug 17 20:06:04 2008
@@ -47,6 +47,17 @@
   GtkEntry                      parent_instance;
 
   GimpFilteredContainer        *filtered_container;
+  /* mask describes the meaning of each char in GimpTagEntry.
+   * It is maintained automatically on insert-text and delete-text
+   * events. If manual mask modification is desired, then
+   * suppress_mask_update must be increased before calling any
+   * function changing entry contents.
+   * Meaning of mask chars:
+   * u - undefined / unknown (just typed unparsed text)
+   * t - tag
+   * s - separator
+   * w - whitespace.
+   */
   GString                      *mask;
   GList                        *selected_items;
   GList                        *recent_list;