diff --git a/gtk/gtkapplicationwindow.c b/gtk/gtkapplicationwindow.c
index adf221c9114d3a923d3a9dbf92c6d6af0a02791d..b3354cfe869129481a0f20e3c196047c45f091a0 100644
--- a/gtk/gtkapplicationwindow.c
+++ b/gtk/gtkapplicationwindow.c
@@ -74,7 +74,14 @@
  * ## A GtkApplicationWindow with a menubar
  *
  * The code sample below shows how to set up a `GtkApplicationWindow`
- * with a menu bar defined on the [class@Gtk.Application]:
+ * with a menu bar defined on the [class@Gtk.Application].
+ *
+ * Localization note: Translated strings will be used at
+ * runtime if a translation exists. However, gettext does not have support
+ * for extracting strings from an XML string like this. See
+ * [gettext bug 64481](https://savannah.gnu.org/bugs/?64481) and consider using
+ * `gtk_builder_new_from_resource` to read XML from a separate file instead
+ * if gettext extraction is needed.
  *
  * ```c
  * GtkApplication *app = gtk_application_new ("org.gtk.test", 0);