diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c
index 1b54c1e465..d509920c68 100644
--- a/gtk/gtkwindow.c
+++ b/gtk/gtkwindow.c
@@ -4871,6 +4871,10 @@ gtk_window_get_position (GtkWindow *window,
  * Hides @window, then reshows it, resetting the
  * default size and position of the window. Used
  * by GUI builders only.
+ * 
+ * Deprecated: 3.10: GUI builders can call gtk_widget_hide(),
+ *   gtk_widget_unrealize() and then gtk_widget_show() on @window
+ *   themselves, if they still need this functionality.
  **/
 void
 gtk_window_reshow_with_initial_size (GtkWindow *window)
diff --git a/gtk/gtkwindow.h b/gtk/gtkwindow.h
index 6472a7eacd..5de3dfeb70 100644
--- a/gtk/gtkwindow.h
+++ b/gtk/gtkwindow.h
@@ -315,6 +315,7 @@ GtkWindowGroup *gtk_window_get_group (GtkWindow   *window);
 gboolean gtk_window_has_group        (GtkWindow   *window);
 
 /* Ignore this unless you are writing a GUI builder */
+GDK_DEPRECATED_IN_3_10
 void     gtk_window_reshow_with_initial_size (GtkWindow *window);
 
 GtkWindowType gtk_window_get_window_type     (GtkWindow     *window);