gtk+ r21943 - in trunk/docs/reference: . gtk gtk/tmpl

[matthiasc svn gnome org]

Author: matthiasc
Date: Sat Dec 27 05:30:58 2008
New Revision: 21943
URL: http://svn.gnome.org/viewvc/gtk+?rev=21943&view=rev

Log:
More additions


Modified:
   trunk/docs/reference/ChangeLog
   trunk/docs/reference/gtk/gtk-sections.txt
   trunk/docs/reference/gtk/tmpl/gtkentry.sgml

Modified: trunk/docs/reference/gtk/gtk-sections.txt
==============================================================================
--- trunk/docs/reference/gtk/gtk-sections.txt	(original)
+++ trunk/docs/reference/gtk/gtk-sections.txt	Sat Dec 27 05:30:58 2008
@@ -1260,6 +1260,7 @@
 gtk_entry_set_progress_pulse_step
 gtk_entry_get_progress_pulse_step
 gtk_entry_progress_pulse
+GtkEntryIconPosition
 gtk_entry_set_icon_from_pixbuf
 gtk_entry_set_icon_from_stock
 gtk_entry_set_icon_from_icon_name

Modified: trunk/docs/reference/gtk/tmpl/gtkentry.sgml
==============================================================================
--- trunk/docs/reference/gtk/tmpl/gtkentry.sgml	(original)
+++ trunk/docs/reference/gtk/tmpl/gtkentry.sgml	Sat Dec 27 05:30:58 2008
@@ -25,16 +25,26 @@
 </para>
 <para>
 Since 2.16, GtkEntry has the ability to display progress or activity 
-information behind the text. To make an entry display progress or activity
-information, use gtk_entry_set_progress_fraction() or
-gtk_entry_set_progress_pulse_step().
+information behind the text. To make an entry display such information, 
+use gtk_entry_set_progress_fraction() or gtk_entry_set_progress_pulse_step().
 </para>
 <para>
 Additionally, GtkEntry can show icons at either side of the entry. These
 icons can be activatable by clicking, can be set up as drag source and
 can have tooltips. To add an icon, use gtk_entry_set_icon_from_gicon() or
 one of the various other functions that set an icon from a stock id, an
-icon name or a pixbuf.
+icon name or a pixbuf. To trigger an action when the user clicks an icon,
+connect to the #GtkEntry::icon-pressed signal. To allow DND operations
+from an icon, use gtk_entry_icon_set_drag_source(). To set a tooltip on 
+an icon, use gtk_entry_set_icon_tooltip_text() or the corresponding function
+for markup.
+</para>
+<para>
+Note that functionality or information that is only available by clicking 
+on an icon in an entry may not be accessible at all to users which are not 
+able to use a mouse or other pointing device. It is therefore recommended 
+that any such functionality should also be available by other means, e.g. 
+via the context menu of the entry.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->