[gtkmm-documentation] Recommend non-deprecated Tooltip API in Tooltips chapter

[David King <davidk src gnome org>]

commit c379c810888b1038a3724d284943dd0776d215ff
Author: David King <davidk openismus com>
Date:   Fri May 7 10:25:00 2010 +0200

    Recommend non-deprecated Tooltip API in Tooltips chapter
    
    * docs/tutorial/C/gtkmm-tutorial-in.xml: Remove text that recommended
    use of the deprecated Tooltips API, and suggest the Tooltip API
    instead.

 ChangeLog                             |    8 ++++++++
 docs/tutorial/C/gtkmm-tutorial-in.xml |   21 +++++++++------------
 2 files changed, 17 insertions(+), 12 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 543b1e9..19ab7a2 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,13 @@
 2010-05-07  David King  <davidk openismus com>
 
+	Recommend non-deprecated Tooltip API in Tooltips chapter
+
+	* docs/tutorial/C/gtkmm-tutorial-in.xml: Remove text that recommended
+	use of the deprecated Tooltips API, and suggest the Tooltip API
+	instead.
+
+2010-05-07  David King  <davidk openismus com>
+
 	Update copyright years for tutorial
 
 	* docs/tutorial/C/gtkmm-tutorial-in.xml: Update copyright years to
diff --git a/docs/tutorial/C/gtkmm-tutorial-in.xml b/docs/tutorial/C/gtkmm-tutorial-in.xml
index 49f0330..bdb83c0 100644
--- a/docs/tutorial/C/gtkmm-tutorial-in.xml
+++ b/docs/tutorial/C/gtkmm-tutorial-in.xml
@@ -1542,20 +1542,17 @@ An <classname>InfoBar</classname> may show small items of information or to ask
 <title>Tooltips</title>
 
 <para>
-<classname>Tooltips</classname> are the little text strings that pop up when
-you leave your pointer over a widget for a few seconds and the
-<classname>Gtk::Tooltips</classname> object is a group of these tooltips. After
-creating a <classname>Gtk::Tooltips</classname> instance, you can use the
-<methodname>set_tip()</methodname> method to associate some descriptive text with a
-<classname>Widget</classname>.
+Tooltips are the little information windows that pop up when you leave your
+pointer over a widget for a few seconds. Use
+<methodname>set_tooltip_text()</methodname> to set a text string as a tooltip
+on any <classname>Widget</classname>. <classname>Gtk::ToolItem</classname>s are
+not <classname>Widget</classname>s, but have the same method for convenience.
+<classname>Gtk::Tooltip</classname> is used for more advanced tooltip usage,
+such as showing an image as well as text.
 </para>
 
-<para>
-The <methodname>enable()</methodname> and <methodname>disable()</methodname> methods
-allow you to turn a whole group of tooltips on and off.
-</para>
-
-<para><ulink url="&url_refdocs_base_gtk;Tooltips.html">Reference</ulink></para>
+<para><ulink url="&url_refdocs_base_gtk;Widget.html">Widget Reference</ulink></para>
+<para><ulink url="&url_refdocs_base_gtk;Tooltip.html">Tooltip Reference</ulink></para>
 
 </sect1>