Doc improvement

svn path=/trunk/; revision=6486

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 3358893..3ab002b 100644 (file)
--- 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 7c2226c..8ebc454 100644 (file)
--- 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>
      {