From 82e27aede9aa866d147fc087d618314c50243825 Mon Sep 17 00:00:00 2001
From: Christian Dywan <christian@twotoasts.de>
Date: Fri, 21 May 2010 17:10:25 +0200
Subject: [PATCH] Explain that unmap-event may never be emitted

Fixes: https://bugzilla.gnome.org/show_bug.cgi?id=613302
---
 gtk/gtkwidget.c | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index d20a5c9b31..6cd6ba6250 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -1576,9 +1576,13 @@ gtk_widget_class_init (GtkWidgetClass *klass)
    * @widget: the object which received the signal
    * @event: the #GdkEventAny which triggered this signal
    *
-   * The ::unmap-event signal will be emitted when the @widget's window is
+   * The ::unmap-event signal may be emitted when the @widget's window is
    * unmapped. A window is unmapped when it becomes invisible on the screen.
    *
+   * For performance reasons GTK+ may not emit ::unmap-event, so one
+   * should always also implement ::unrealize in order to release
+   * resources and disconnect signal handlers.
+   *
    * To receive this signal, the #GdkWindow associated to the widget needs
    * to enable the #GDK_STRUCTURE_MASK mask. GDK will enable this mask
    * automatically for all new windows.