docs: Clean up many dangling links

In many cases, these were references to no longer
existing api, so some rewording was necessary.

1 files changed, 1 insertions, 14 deletions

diff --git a/gtk/gtktooltip.c b/gtk/gtktooltip.c
index 284e96d912..e3011b4d6a 100644
--- a/gtk/gtktooltip.c
+++ b/gtk/gtktooltip.c
@@ -62,19 +62,6 @@
  *
  *   Return %TRUE from your query-tooltip handler. This causes the tooltip to be
  *   show. If you return %FALSE, it will not be shown.
- *
- * In the probably rare case where you want to have even more control over the
- * tooltip that is about to be shown, you can set your own #GtkWindow which
- * will be used as tooltip window.  This works as follows:
- * 
- * - Set #GtkWidget:has-tooltip and connect to #GtkWidget::query-tooltip as before.
- *   Use gtk_widget_set_tooltip_window() to set a #GtkWindow created by you as
- *   tooltip window.
- *
- * - In the #GtkWidget::query-tooltip callback you can access your window using
- *   gtk_widget_get_tooltip_window() and manipulate as you wish. The semantics of
- *   the return value are exactly as before, return %TRUE to show the window,
- *   %FALSE to not show it.
  */
 
 
@@ -357,7 +344,7 @@ gtk_tooltip_set_tip_area (GtkTooltip         *tooltip,
     }
 }
 
-/**
+/*
  * gtk_tooltip_trigger_tooltip_query:
  * @display: a #GdkDisplay
  *