[pygtk] Bug 590948 - Adding information about Reference gtk.Widget.set_tooltip_window

[Gian Mario Tagliaretti <gianmt src gnome org>]

commit a95ef503f77d6812528049e837d12f6cee7e9ef8
Author: Gian Mario Tagliaretti <gianmt gnome org>
Date:   Sat Aug 22 22:23:37 2009 +0200

    Bug 590948 - Adding information about Reference gtk.Widget.set_tooltip_window
    
    Add a clarification on the usage

 docs/reference/pygtk-gtkwidget.xml |    9 +++++++++
 1 files changed, 9 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/pygtk-gtkwidget.xml b/docs/reference/pygtk-gtkwidget.xml
index f8f3ab7..4d0d173 100644
--- a/docs/reference/pygtk-gtkwidget.xml
+++ b/docs/reference/pygtk-gtkwidget.xml
@@ -6943,6 +6943,15 @@ method.</para>
             the default tooltip window. If custom_window is <literal>None</literal>,
             the default tooltip window will be used.            
         </para>
+	
+	<note>
+	  You have to connect to the <link linkend="signal-gtkwidget--query-tooltip">"query-tooltip"</link>
+	  signal a callback to decide if the custom_window should be shown or not, return <literal>True</literal>
+	  if you want to show the custom_window, False otherwise.
+	  You have also to set the property "has-tooltip" to <literal>True</literal> or the "query-tooltip"
+	  signal will not be emitted.
+	</note>
+	
 
     </refsect2>