diff --git a/ChangeLog b/ChangeLog
index ae48f609b6..5456f43ebb 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2008-03-28  Sven Neumann  <sven@gimp.org>
+
+	* libgimpwidgets/gimphelpui.c: updated documentation.
+
 2008-03-28  Sven Neumann  <sven@gimp.org>
 
 	* app/dialogs/tips-parser.[ch]
diff --git a/libgimpwidgets/gimphelpui.c b/libgimpwidgets/gimphelpui.c
index 407a4a8b66..f396d9d62e 100644
--- a/libgimpwidgets/gimphelpui.c
+++ b/libgimpwidgets/gimphelpui.c
@@ -178,9 +178,9 @@ gimp_help_connect (GtkWidget    *widget,
  * @tooltip: The text for this widget's tooltip (or %NULL).
  * @help_id: The @help_id for the #GtkTipsQuery tooltips inspector.
  *
- * The reason why we don't use gtk_tooltips_set_tip() is that it's
- * impossible to set a @private_tip (aka @help_id) without a visible
- * @tooltip.
+ * The reason why we don't use gtk_widget_set_tooltip_text() is that
+ * elements in the GIMP user interface should, if possible, also have
+ * a @help_id set for context-sensitive help.
  *
  * This function can be called with #NULL for @tooltip. Use this feature
  * if you want to set a help link for a widget which shouldn't have