diff --git a/docs/reference/gtk/getting_started.xml b/docs/reference/gtk/getting_started.xml
index 63d79cdc95..892425b329 100644
--- a/docs/reference/gtk/getting_started.xml
+++ b/docs/reference/gtk/getting_started.xml
@@ -75,6 +75,21 @@
by the windowing system: it will have a frame, a title bar and window
controls, depending on the platform.
+ A window title is set using gtk_window_set_title(). This function
+ takes a GtkWindow* pointer and a string as input. As our
+ window pointer is a GtkWidget pointer, we need to cast it
+ to GtkWindow*.
+ But instead of casting window via
+ (GtkWindow*),
+ window can be cast using the macro
+ GTK_WINDOW().
+ GTK_WINDOW() will check if the
+ pointer is an instance of the GtkWindow class, before casting, and emit a
+ warning if the check fails. More information about this convention
+ can be found
+
+ here.
+
In order to terminate the application when the #GtkWindow is
destroyed, we connect the #GtkWidget::destroy signal to the gtk_main_quit()
function. This function will terminate the GTK+ main loop started by calling