[gtk/window-destroy: 3/16] window: Add gtk_window_destroy

[Matthias Clasen <matthiasc src gnome org>]

commit 6f6ffa553b1b171a67b25a5ec2b3f94ee73f2cb1
Author: Matthias Clasen <mclasen redhat com>
Date:   Sat May 9 09:30:29 2020 -0400

    window: Add gtk_window_destroy
    
    This is a replacement for gtk_widget_destroy for toplevels.
    For now, it is just a wrapper.

 docs/reference/gtk/gtk4-sections.txt |  1 +
 gtk/gtkwindow.c                      | 14 ++++++++++++++
 gtk/gtkwindow.h                      |  3 +++
 3 files changed, 18 insertions(+)
---
diff --git a/docs/reference/gtk/gtk4-sections.txt b/docs/reference/gtk/gtk4-sections.txt
index ab0f2dafb7..16c790391f 100644
--- a/docs/reference/gtk/gtk4-sections.txt
+++ b/docs/reference/gtk/gtk4-sections.txt
@@ -4188,6 +4188,7 @@ gtk_requisition_get_type
 GtkWindow
 GtkWindowClass
 gtk_window_new
+gtk_window_destroy
 gtk_window_get_child
 gtk_window_set_child
 gtk_window_set_title
diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c
index e37707428b..c5b39b4b80 100644
--- a/gtk/gtkwindow.c
+++ b/gtk/gtkwindow.c
@@ -8021,3 +8021,17 @@ gtk_window_get_child (GtkWindow *window)
 
   return priv->child;
 }
+
+/**
+ * gtk_window_destroy:
+ * @window: The window to destroy
+ *
+ * Drop the internal reference GTK holds on toplevel windows.
+ */
+void
+gtk_window_destroy (GtkWindow *window)
+{
+  g_return_if_fail (GTK_IS_WINDOW (window));
+
+  gtk_widget_destroy (GTK_WIDGET (window));
+}
diff --git a/gtk/gtkwindow.h b/gtk/gtkwindow.h
index 488a37c792..8a94876c95 100644
--- a/gtk/gtkwindow.h
+++ b/gtk/gtkwindow.h
@@ -254,6 +254,9 @@ GtkWidget *gtk_window_get_titlebar         (GtkWindow    *window);
 GDK_AVAILABLE_IN_ALL
 gboolean gtk_window_is_maximized           (GtkWindow    *window);
 
+GDK_AVAILABLE_IN_ALL
+void     gtk_window_destroy                (GtkWindow    *window);
+
 GDK_AVAILABLE_IN_ALL
 void     gtk_window_set_interactive_debugging (gboolean enable);