Mention some caveats.

diff --git a/gettext-tools/doc/ChangeLog b/gettext-tools/doc/ChangeLog
index 9f6ebf0255ce71b34da7c7b29d7d8044dff0d355..b03a23b07b3bf7f48b0b39d553dd7fb6d1181f7a 100644 (file)
--- a/gettext-tools/doc/ChangeLog
+++ b/gettext-tools/doc/ChangeLog
@@ -1,3 +1,8 @@
+2007-06-07  Bruno Haible  <bruno@clisp.org>
+
+       * xgettext.texi: Mention some caveats.
+       Reported by Ariel <asgettext@dsgml.com>.
+
 2007-06-03  Bruno Haible  <bruno@clisp.org>
 
        * gettext.texi (Users): Chapter completely rewritten.

diff --git a/gettext-tools/doc/xgettext.texi b/gettext-tools/doc/xgettext.texi
index 4be8c4b87ab0a2b72b60b364930b0ee3bee4581e..b7ce003406b53846dbcb08252674fac110569d18 100644 (file)
--- a/gettext-tools/doc/xgettext.texi
+++ b/gettext-tools/doc/xgettext.texi
@@ -353,7 +353,9 @@ Write the .po file using indented style.
 
 @item --no-location
 @opindex --no-location@r{, @code{xgettext} option}
-Do not write @samp{#: @var{filename}:@var{line}} lines.
+Do not write @samp{#: @var{filename}:@var{line}} lines.  Note that using
+this option makes it harder for technically skilled translators to understand
+each message's context.
 
 @item -n
 @itemx --add-location
@@ -408,7 +410,8 @@ Sort output by file location.
 
 @item --omit-header
 @opindex --omit-header@r{, @code{xgettext} option}
-Don't write header with @samp{msgid ""} entry.
+Don't write header with @samp{msgid ""} entry.  Note that using this option
+will lead to an error if the resulting file would not entirely be in ASCII.
 
 @cindex testing @file{.po} files for equivalence
 This is useful for testing purposes because it eliminates a source