From: Bruno Haible <bruno@clisp.org>
Date: Tue, 10 Sep 2024 09:28:28 +0000 (+0200)
Subject: doc: Discourage --omit-header.
X-Git-Url: http://git.ipfire.org/gitweb/gitweb.cgi?a=commitdiff_plain;h=607eee071b782d2124819f5c876aee771c6b69b3;p=thirdparty%2Fgettext.git

doc: Discourage --omit-header.

* gettext-tools/doc/msgcomm.texi: Document the effects of --omit-header.
* gettext-tools/doc/xgettext.texi: Likewise.
---

diff --git a/gettext-tools/doc/msgcomm.texi b/gettext-tools/doc/msgcomm.texi
index df77b3ac7..f99e21ce0 100644
--- a/gettext-tools/doc/msgcomm.texi
+++ b/gettext-tools/doc/msgcomm.texi
@@ -1,5 +1,5 @@
 @c This file is part of the GNU gettext manual.
-@c Copyright (C) 1995-2019 Free Software Foundation, Inc.
+@c Copyright (C) 1995-2024 Free Software Foundation, Inc.
 @c See the file gettext.texi for copying conditions.
 
 @pindex msgcomm
@@ -192,6 +192,8 @@ Sort output by file location.
 @item --omit-header
 @opindex --omit-header@r{, @code{msgcomm} option}
 Don't write header with @samp{msgid ""} entry.
+Note: Using this option may lead to an error in subsequent operations
+if the output contains non-ASCII characters.
 
 @end table
 
diff --git a/gettext-tools/doc/xgettext.texi b/gettext-tools/doc/xgettext.texi
index 5cb6c114e..cb3d3dff9 100644
--- a/gettext-tools/doc/xgettext.texi
+++ b/gettext-tools/doc/xgettext.texi
@@ -559,6 +559,8 @@ Sort output by file location.
 @item --omit-header
 @opindex --omit-header@r{, @code{xgettext} option}
 Don't write header with @samp{msgid ""} entry.
+Note: Using this option may lead to an error in subsequent operations
+if the output contains non-ASCII characters.
 
 @cindex testing @file{.po} files for equivalence
 This is useful for testing purposes because it eliminates a source