diff options
| -rw-r--r-- | gtk/gtkwindowgroup.c | 12 |
1 files changed, 10 insertions, 2 deletions
diff --git a/gtk/gtkwindowgroup.c b/gtk/gtkwindowgroup.c index 2a9cd1e92a..bed78cf286 100644 --- a/gtk/gtkwindowgroup.c +++ b/gtk/gtkwindowgroup.c @@ -34,8 +34,16 @@ * @Short_description: Limit the effect of grabs * @Title: GtkWindowGroup * - * #GtkWindowGroup objects are referenced by each window in the group, - * so once you have added all windows to a #GtkWindowGroup, you can drop + * A #GtkWindowGroup restricts the effect of grabs to windows + * in the same group, thereby making window groups almost behave + * like separate applications. + * + * A window can be a member in at most one window group at a time. + * Windows that have not been explicitly assigned to a group are + * implicitly treated like windows of the default window group. + * + * GtkWindowGroup objects are referenced by each window in the group, + * so once you have added all windows to a GtkWindowGroup, you can drop * the initial reference to the window group with g_object_unref(). If the * windows in the window group are subsequently destroyed, then they will * be removed from the window group and drop their references on the window |