annotate lib/gettext.h @ 3947:765d3b9a6126

update gettext.h from gettext.h
author Karl Berry <karl@freefriends.org>
date Wed, 25 Sep 2002 15:26:39 +0000
parents 758df4efd0f5
children e58a1c05a6ba
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3815
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
1 /* Convenience header for conditional use of GNU <libintl.h>.
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
2 Copyright (C) 1995-1998, 2000-2002 Free Software Foundation, Inc.
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
3
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
4 This program is free software; you can redistribute it and/or modify it
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
5 under the terms of the GNU Library General Public License as published
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
6 by the Free Software Foundation; either version 2, or (at your option)
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
7 any later version.
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
8
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
9 This program is distributed in the hope that it will be useful,
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
12 Library General Public License for more details.
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
13
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
14 You should have received a copy of the GNU Library General Public
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
15 License along with this program; if not, write to the Free Software
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
16 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
17 USA. */
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
18
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
19 #ifndef _LIBGETTEXT_H
3947
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
20 #define _LIBGETTEXT_H 1
3815
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
21
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
22 /* NLS can be disabled through the configure --disable-nls option. */
3947
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
23 #if ENABLE_NLS
3815
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
24
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
25 /* Get declarations of GNU message catalog functions. */
3947
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
26 # include <libintl.h>
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
27
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
28 #else
3815
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
29
3947
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
30 /* Solaris /usr/include/locale.h includes /usr/include/libintl.h, which
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
31 chokes if dcgettext is defined as a macro. So include it now, to make
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
32 later inclusions of <locale.h> a NOP. We don't include <libintl.h>
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
33 as well because people using "gettext.h" will not include <libintl.h>,
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
34 and also including <libintl.h> would fail on SunOS 4, whereas <locale.h>
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
35 is OK. */
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
36 #if defined(__sun)
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
37 # include <locale.h>
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
38 #endif
3815
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
39
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
40 /* Disabled NLS.
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
41 The casts to 'const char *' serve the purpose of producing warnings
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
42 for invalid uses of the value returned from these functions.
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
43 On pre-ANSI systems without 'const', the config.h file is supposed to
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
44 contain "#define const". */
3947
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
45 # define gettext(Msgid) ((const char *) (Msgid))
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
46 # define dgettext(Domainname, Msgid) ((const char *) (Msgid))
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
47 # define dcgettext(Domainname, Msgid, Category) ((const char *) (Msgid))
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
48 # define ngettext(Msgid1, Msgid2, N) \
3815
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
49 ((N) == 1 ? (const char *) (Msgid1) : (const char *) (Msgid2))
3947
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
50 # define dngettext(Domainname, Msgid1, Msgid2, N) \
3815
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
51 ((N) == 1 ? (const char *) (Msgid1) : (const char *) (Msgid2))
3947
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
52 # define dcngettext(Domainname, Msgid1, Msgid2, N, Category) \
3815
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
53 ((N) == 1 ? (const char *) (Msgid1) : (const char *) (Msgid2))
3947
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
54 # define textdomain(Domainname) ((const char *) (Domainname))
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
55 # define bindtextdomain(Domainname, Dirname) ((const char *) (Dirname))
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
56 # define bind_textdomain_codeset(Domainname, Codeset) ((const char *) (Codeset))
3815
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
57
3947
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
58 #endif
3815
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
59
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
60 /* A pseudo function call that serves as a marker for the automated
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
61 extraction of messages, but does not call gettext(). The run-time
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
62 translation is done at a different place in the code.
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
63 The argument, String, should be a literal string. Concatenated strings
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
64 and other string expressions won't work.
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
65 The macro's expansion is not parenthesized, so that it is suitable as
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
66 initializer for static 'char[]' or 'const char[]' variables. */
3947
765d3b9a6126 update gettext.h from gettext.h
Karl Berry <karl@freefriends.org>
parents: 3815
diff changeset
67 #define gettext_noop(String) String
3815
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
68
758df4efd0f5 filtered through cppi
Jim Meyering <jim@meyering.net>
parents:
diff changeset
69 #endif /* _LIBGETTEXT_H */