From 26b4fc65b92a462beb8020097d2e87d0936ce804 Mon Sep 17 00:00:00 2001 From: David Schleef Date: Sat, 10 Dec 2011 14:29:16 -0800 Subject: [PATCH] window: add note about window references https://bugzilla.gnome.org/show_bug.cgi?id=665928 --- gtk/gtkwindow.c | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c index 3d9e858a96..303d319724 100644 --- a/gtk/gtkwindow.c +++ b/gtk/gtkwindow.c @@ -1837,6 +1837,14 @@ gtk_window_buildable_custom_finished (GtkBuildable *buildable, * * If you simply want an undecorated window (no window borders), use * gtk_window_set_decorated(), don't use #GTK_WINDOW_POPUP. + * + * All top-level windows created by gtk_window_new() are stored in + * an internal top-level window list. This list can be obtained from + * gtk_window_list_toplevels(). Due to Gtk+ keeping a reference to + * the window internally, gtk_window_new() does not return a reference + * to the caller. + * + * To delete a #GtkWindow, call gtk_window_destroy(). * * Return value: a new #GtkWindow. **/