summaryrefslogtreecommitdiff
path: root/docs/reference
diff options
context:
space:
mode:
authorMatthias Clasen <matthiasc@src.gnome.org>2008-12-27 05:30:58 +0000
committerMatthias Clasen <matthiasc@src.gnome.org>2008-12-27 05:30:58 +0000
commit8a4a531540d4cb7ca9b0a7f40935cfe996e91fff (patch)
treeb69762e00115a6c1bb315fd17492f9f3b970f9ab /docs/reference
parent53f475a67a02733c08d0ce58dd1f457fc88a1e2b (diff)
downloadgtk+-8a4a531540d4cb7ca9b0a7f40935cfe996e91fff.tar.gz
More additions
svn path=/trunk/; revision=21943
Diffstat (limited to 'docs/reference')
-rw-r--r--docs/reference/ChangeLog6
-rw-r--r--docs/reference/gtk/gtk-sections.txt1
-rw-r--r--docs/reference/gtk/tmpl/gtkentry.sgml18
3 files changed, 21 insertions, 4 deletions
diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index b35d734206..52b48979d8 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,9 @@
+2008-12-27 Matthias Clasen <mclasen@redhat.com>
+
+ * gtk/gtk-sections.txt: Add GtkEntryIconPosition
+
+ * gtk/tmpl/gtkentry.sgml: Add note about a11y concerns.
+
2008-12-26 Matthias Clasen <mclasen@redhat.com>
* gtk/tmpl/gtkentry.sgml: Mention new functionality
diff --git a/docs/reference/gtk/gtk-sections.txt b/docs/reference/gtk/gtk-sections.txt
index b7497a2a05..326fea9e63 100644
--- a/docs/reference/gtk/gtk-sections.txt
+++ b/docs/reference/gtk/gtk-sections.txt
@@ -1260,6 +1260,7 @@ gtk_entry_get_progress_fraction
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
diff --git a/docs/reference/gtk/tmpl/gtkentry.sgml b/docs/reference/gtk/tmpl/gtkentry.sgml
index d09ee4af54..323fa1f260 100644
--- a/docs/reference/gtk/tmpl/gtkentry.sgml
+++ b/docs/reference/gtk/tmpl/gtkentry.sgml
@@ -25,16 +25,26 @@ a password entry. The warning can be turned of with the
</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 ##### -->