diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 335889371..3ab002b8b 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2008-02-09  Matthias Clasen  <mclasen@redhat.com>
+
+	* glib/tmpl/i18n.sgml: Improve the documentation for the
+	N_() macro.  (#514053, Tommi Vainikainen)
+
 2008-01-28  Matthias Clasen  <mclasen@redhat.com>
 
 	* === Released 2.15.4 ===
diff --git a/docs/reference/glib/tmpl/i18n.sgml b/docs/reference/glib/tmpl/i18n.sgml
index 7c2226c84..8ebc4541c 100644
--- a/docs/reference/glib/tmpl/i18n.sgml
+++ b/docs/reference/glib/tmpl/i18n.sgml
@@ -90,9 +90,10 @@ messages. Note that this only works with GNU gettext >= 0.15.
 
 <!-- ##### MACRO N_ ##### -->
 <para>
-Marks a string for translation, gets replaced with the untranslated string
-at runtime. This is useful in situations where the translated strings can't
+Only marks a string for translation.
+This is useful in situations where the translated strings can't
 be directly used, e.g. in string array initializers. 
+To get the translated string, call gettext() at runtime.
 </para>
 <informalexample><programlisting>
      {