window: add note about window references

https://bugzilla.gnome.org/show_bug.cgi?id=665928
This commit is contained in:
David Schleef 2011-12-10 14:29:16 -08:00 committed by Matthias Clasen
parent 65ce9a523a
commit 26b4fc65b9

View File

@ -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.
**/