Explain why empty strings should not be marked for translation.

From-SVN: r49821

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index cd30880e35f2d3b400465b1893b7e6166e4e6e94..4530ebf425549f42059eca0babecba72704f9a66 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,8 @@
+2002-02-17  Philipp Thomas  <pthomas@suse.de>
+
+       * doc/tm.texi: Explain why empty strings should not be
+       marked for translation.
+
 2002-02-17  Philipp Thomas  <pthomas@suse.de>
 
        * final.c (output_operand_lossage): Changed to accept

diff --git a/gcc/doc/tm.texi b/gcc/doc/tm.texi
index 663393e74592d6977ccb2bdb479928e4bef400a1..891559afa70638ea0526eafa5dafa4a7b9a1191f 100644 (file)
--- a/gcc/doc/tm.texi
+++ b/gcc/doc/tm.texi
@@ -687,7 +687,11 @@ string is present but empty, then no help information will be displayed
 for that option, but it will not count as an undocumented option.  The
 actual option name is made by appending @samp{-m} to the specified name.
 Non-empty description strings should be marked with @code{N_(@dots{})} for
-@command{xgettext}.  In addition to the description for @option{--help},
+@command{xgettext}.  Please do not mark empty strings because the empty
+string is reserved by GNU gettext. @code{gettext("")} returns the header entry
+of the message catalog with meta information, not the empty string.
+
+In addition to the description for @option{--help},
 more detailed documentation for each option should be added to
 @file{invoke.texi}.
 
@@ -713,8 +717,12 @@ options that have values.  Its definition is an initializer with a
 subgrouping for each command option.
 
 Each subgrouping contains a string constant, that defines the fixed part
-of the option name, the address of a variable, and a description string
-(which should again be marked with @code{N_(@dots{})}).
+of the option name, the address of a variable, and a description string.
+Non-empty description strings should be marked with @code{N_(@dots{})} for
+@command{xgettext}.  Please do not mark empty strings because the empty
+string is reserved by GNU gettext. @code{gettext("")} returns the header entry
+of the message catalog with meta information, not the empty string.
+
 The variable, type @code{char *}, is set to the variable part of the
 given option if the fixed part matches.  The actual option name is made
 by appending @samp{-m} to the specified name.  Again, each option should