[gtk+/gtk-2-24] Entry: Warn about corner case hiding icon tooltips

[Daniel Boles <dboles src gnome org>]

commit 8302b7138192cf10fdf8c09748ed952a08a4ae59
Author: Daniel Boles <dboles src gnome org>
Date:   Tue Aug 1 13:35:39 2017 +0100

    Entry: Warn about corner case hiding icon tooltips
    
    https://bugzilla.gnome.org/show_bug.cgi?id=785672#c4

 gtk/gtkentry.c |    6 ++++++
 1 files changed, 6 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index 7b99f6e..98a8cd3 100644
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -8440,6 +8440,12 @@ gtk_entry_get_icon_tooltip_text (GtkEntry             *entry,
  * See also gtk_widget_set_tooltip_text() and 
  * gtk_entry_set_icon_tooltip_markup().
  *
+ * If you unset the widget tooltip via gtk_widget_set_tooltip_text() or
+ * gtk_widget_set_tooltip_markup(), this sets GtkWidget:has-tooltip to %FALSE,
+ * which suppresses icon tooltips too. You can resolve this by then calling
+ * gtk_widget_set_has_tooltip() to set GtkWidget:has-tooltip back to %TRUE, or
+ * setting at least one non-empty tooltip on any icon achieves the same result.
+ *
  * Since: 2.16
  */
 void