From: Bruno Haible <bruno@clisp.org>
Date: Thu, 7 Jun 2007 13:54:56 +0000 (+0000)
Subject: Mention some caveats.
X-Git-Tag: v0.17~350
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ea164b6cbc526e594971a97d284d96db91f24b08;p=thirdparty%2Fgettext.git

Mention some caveats.
---

diff --git a/gettext-tools/doc/ChangeLog b/gettext-tools/doc/ChangeLog
index 9f6ebf025..b03a23b07 100644
--- 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 4be8c4b87..b7ce00340 100644
--- 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