aboutsummaryrefslogtreecommitdiff
path: root/gcc
diff options
context:
space:
mode:
authorPhilipp Thomas <pthomas@suse.de>2002-02-17 14:55:10 +0000
committerPhilipp Thomas <pthomas@gcc.gnu.org>2002-02-17 14:55:10 +0000
commit404ae494a6ba548ea63588cd3ceac4a54be791d3 (patch)
tree689f3b8eb04879216029d9ab9b249d8ad5998479 /gcc
parenta52453cc4295af6f62d1e59faac80056c426a400 (diff)
downloadgcc-404ae494a6ba548ea63588cd3ceac4a54be791d3.zip
gcc-404ae494a6ba548ea63588cd3ceac4a54be791d3.tar.gz
gcc-404ae494a6ba548ea63588cd3ceac4a54be791d3.tar.bz2
Explain why empty strings should not be marked for translation.
From-SVN: r49821
Diffstat (limited to 'gcc')
-rw-r--r--gcc/ChangeLog5
-rw-r--r--gcc/doc/tm.texi14
2 files changed, 16 insertions, 3 deletions
diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index cd30880..4530ebf 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,5 +1,10 @@
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
printf style arguments. Change calls where necessary.
* output.h (output_operand_lossage): Change declaration
diff --git a/gcc/doc/tm.texi b/gcc/doc/tm.texi
index 663393e..891559a 100644
--- 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