From ea0c3a3c2cfd308488f1eb8de87663cebf286574 Mon Sep 17 00:00:00 2001
From: Dieter Verfaillie <dieterv@optionexplicit.be>
Date: Wed, 9 Mar 2011 07:56:10 +0100
Subject: reference: pygtk-gtktooltip.xml: add missing set_icon_from_gicon
 method and add parameter markup

---
 docs/reference/pygtk-gtktooltip.xml | 48 ++++++++++++++++++++++++++++++++-----
 1 file changed, 42 insertions(+), 6 deletions(-)

diff --git a/docs/reference/pygtk-gtktooltip.xml b/docs/reference/pygtk-gtktooltip.xml
index 1b2f47cb..5a41e268 100644
--- a/docs/reference/pygtk-gtktooltip.xml
+++ b/docs/reference/pygtk-gtktooltip.xml
@@ -33,6 +33,11 @@
         <methodparam><parameter role="keyword">stock_id</parameter></methodparam>
         <methodparam><parameter role="keyword">size</parameter></methodparam>
     </methodsynopsis>
+    <methodsynopsis language="python">
+      <methodname><link linkend="method-gtktooltip--set-icon-from-gicon">set_icon_from_gicon</link></methodname>
+      <methodparam><parameter role="keyword">gicon</parameter></methodparam>
+      <methodparam><parameter role="keyword">size</parameter></methodparam>
+    </methodsynopsis>
     <methodsynopsis language="python">
         <methodname><link linkend="method-gtktooltip--set-markup">set_markup</link></methodname>
         <methodparam><parameter role="keyword">markup</parameter></methodparam>
@@ -230,10 +235,10 @@
             </note>
 
             <para>
-                The <methodname>set_icon_from_icon_name</methodname>() method sets
-                the icon of the tooltip (which is in front of the text) to be the
-                icon indicated by icon_name with the size indicated by size. If icon_name
-                is <literal>None</literal>, the image will be hidden.
+                The <methodname>set_icon_from_icon_name</methodname>() method sets the icon of the tooltip
+                (which is in front of the text) to be the icon indicated by <parameter>icon_name</parameter>
+                with the size indicated by <parameter>size</parameter>. If icon_name is <literal>None</literal>,
+                the image will be hidden.
             </para>
         </refsect2>
 
@@ -263,11 +268,42 @@
 
             <para>
                 The <methodname>set_icon_from_stock</methodname>() method sets the icon of the tooltip
-                (which is in front of the text) to be the stock item indicated by stock_id with the size
-                indicated by size. If stock_id is <literal>None</literal>, the image will be hidden.
+                (which is in front of the text) to be the stock item indicated by <parameter>stock_id</parameter>
+                with the size indicated by <parameter>size</parameter>. If stock_id is <literal>None</literal>,
+                the image will be hidden.
             </para>
         </refsect2>
 
+        <refsect2 id="method-gtktooltip--set-icon-from-gicon">
+          <title>gtk.Tooltip.set_icon_from_gicon</title>
+
+          <programlisting><methodsynopsis language="python">
+            <methodname>set_icon_from_gicon</methodname>
+            <methodparam><parameter role="keyword">gicon</parameter></methodparam>
+            <methodparam><parameter role="keyword">size</parameter></methodparam>
+          </methodsynopsis></programlisting>
+          <variablelist>
+            <varlistentry>
+              <term><parameter role="keyword">gicon</parameter>&nbsp;:</term>
+              <listitem><simpara>the icon to set, or <literal>None</literal>..</simpara></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><parameter role="keyword">size</parameter>&nbsp;:</term>
+              <listitem><simpara>a stock icon size.</simpara></listitem>
+            </varlistentry>
+          </variablelist>
+
+          <note>
+            <para>This method is available in PyGTK 2.20 and above.</para>
+          </note>
+
+          <para>The <methodname>set_icon_from_gicon</methodname>() method sets the icon of the
+          tooltip (which is in front of the text) to be the icon indicated by <parameter>gicon</parameter>
+          with the size indicated by <parameter>size</parameter>. If gicon is <literal>None</literal>,
+          the image will be hidden.</para>
+
+        </refsect2>
+
         <refsect2 id="method-gtktooltip--set-markup">
             <title>gtk.Tooltip.set_markup</title>
 
-- 
cgit v1.2.1