diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c
index 0064a0a4e18738334c4bc8426390fa2a4028ddff..bc3fff7db87f6ecc564411f08d6def2a79791711 100644
--- a/gtk/gtkwindow.c
+++ b/gtk/gtkwindow.c
@@ -864,7 +864,8 @@ gtk_window_class_init (GtkWindowClass *klass)
   /**
    * GtkWindow:hide-on-close:
    *
-   * If this window should be hidden when the users clicks the close button.
+   * If this window should be hidden instead of destroyed when the user clicks
+   * the close button.
    */
   window_props[PROP_HIDE_ON_CLOSE] =
       g_param_spec_boolean ("hide-on-close", NULL, NULL,
@@ -2952,7 +2953,7 @@ gtk_window_set_hide_on_close (GtkWindow *window,
  * gtk_window_get_hide_on_close:
  * @window: a window
  *
- * Returns whether the window will be hidden when the close
+ * Returns whether the window will be hidden instead of destroyed when the close
  * button is clicked.
  *
  * Returns: true if the window will be hidden