diff --git a/gtk/gtkheaderbar.c b/gtk/gtkheaderbar.c
index 86dfbcc57f..b87947167f 100644
--- a/gtk/gtkheaderbar.c
+++ b/gtk/gtkheaderbar.c
@@ -2021,8 +2021,11 @@ gtk_header_bar_set_has_subtitle (GtkHeaderBar *bar,
  * gtk_header_bar_get_has_subtitle:
  * @bar: a #GtkHeaderBar
  *
+ * Retrieves whether the header bar reserves space for
+ * a subtitle, regardless if one is currently set or not.
+ *
  * Returns: %TRUE if the header bar reserves space
- * for a subtitle.
+ *     for a subtitle
  *
  * Since: 3.12
  */