diff options
author | Dan Albert <danalbert@google.com> | 2016-02-24 13:48:45 -0800 |
---|---|---|
committer | Dan Albert <danalbert@google.com> | 2016-02-24 13:51:18 -0800 |
commit | b9de1157289455b0ca26daff519d4a0ddcd1fa13 (patch) | |
tree | 4c56cc0a34b91f17033a40a455f26652304f7b8d /gcc-4.8.3/gcc/ABOUT-GCC-NLS | |
parent | 098157a754787181cfa10e71325832448ddcea98 (diff) | |
download | toolchain_gcc-b9de1157289455b0ca26daff519d4a0ddcd1fa13.tar.gz toolchain_gcc-b9de1157289455b0ca26daff519d4a0ddcd1fa13.tar.bz2 toolchain_gcc-b9de1157289455b0ca26daff519d4a0ddcd1fa13.zip |
Update 4.8.1 to 4.8.3.
My previous drop was the wrong version. The platform mingw is
currently using 4.8.3, not 4.8.1 (not sure how I got that wrong).
From ftp://ftp.gnu.org/gnu/gcc/gcc-4.8.3/gcc-4.8.3.tar.bz2.
Bug: http://b/26523949
Change-Id: Id85f1bdcbbaf78c7d0b5a69e74c798a08f341c35
Diffstat (limited to 'gcc-4.8.3/gcc/ABOUT-GCC-NLS')
-rw-r--r-- | gcc-4.8.3/gcc/ABOUT-GCC-NLS | 56 |
1 files changed, 56 insertions, 0 deletions
diff --git a/gcc-4.8.3/gcc/ABOUT-GCC-NLS b/gcc-4.8.3/gcc/ABOUT-GCC-NLS new file mode 100644 index 000000000..c46aa85fb --- /dev/null +++ b/gcc-4.8.3/gcc/ABOUT-GCC-NLS @@ -0,0 +1,56 @@ +Notes on GCC's Native Language Support + +By and large, only diagnostic messages have been internationalized. +Some work remains in other areas; for example, GCC does not yet allow +non-ASCII letters in identifiers. + +Not all of GCC's diagnostic messages have been internationalized. Programs +like `genattr' (in fact all gen* programs) are not internationalized, as +their users are GCC maintainers who typically need to be able to read +English anyway; internationalizing them would thus entail needless work for +the human translators. Messages used for debugging, such as used in dumped +tables, should also not be translated. + +The GCC library should not contain any messages that need +internationalization, because it operates below the internationalization +library. + +Unlike some other GNU programs, the GCC sources contain few instances +of explicit translation calls like _("string"). Instead, the +diagnostic printing routines automatically translate their arguments. +For example, GCC source code should not contain calls like `error +(_("unterminated comment"))'; it should contain calls like `error +("unterminated comment")' instead, as it is the `error' function's +responsibility to translate the message before the user sees it. + +By convention, any function parameter in the GCC sources whose name +ends in `msgid' is expected to be a message requiring translation. +If the parameter name ends with `gmsgid', it is assumed to be a GCC +diagnostics format string requiring translation, if it ends with +`cmsgid', it is assumed to be a format string for `printf' family +of functions, requiring a translation. +For example, the `error' function's first parameter is named `gmsgid'. +GCC's exgettext script uses this convention to determine which +function parameter strings need to be translated. The exgettext +script also assumes that any occurrence of `%eMSGID}' on a source +line, where MSGID does not contain `%' or `}', corresponds to a +message MSGID that requires translation; this is needed to identify +diagnostics in GCC spec strings. +The `G_(GMSGID)' macro defined in intl.h can be used to mark GCC diagnostics +format strings as requiring translation, but other than that it is a +no-op at runtime. + +If you modify source files, you'll need at least version 0.14.15 of the +GNU gettext package to propagate the modifications to the translation +tables. + +After having built and installed these gettext tools, you have to +configure GCC with --enable-maintainer-mode to get the master catalog +rebuilt. + + +Copyright (C) 1998-2013 Free Software Foundation, Inc. + +Copying and distribution of this file, with or without modification, +are permitted in any medium without royalty provided the copyright +notice and this notice are preserved. |