1
/* intl-compat.c - Stub functions to call gettext functions from GNU gettext
3
Copyright (C) 1995, 2000, 2001 Software Foundation, Inc.
5
This program is free software; you can redistribute it and/or modify it
6
under the terms of the GNU Library General Public License as published
7
by the Free Software Foundation; either version 2, or (at your option)
10
This program is distributed in the hope that it will be useful,
11
but WITHOUT ANY WARRANTY; without even the implied warranty of
12
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13
Library General Public License for more details.
15
You should have received a copy of the GNU Library General Public
16
License along with this program; if not, write to the Free Software
17
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
24
#include "libgnuintl.h"
27
/* @@ end of prolog @@ */
29
/* This file redirects the gettext functions (without prefix or suffix) to
30
those defined in the included GNU gettext library (with "__" suffix).
31
It is compiled into libintl when the included GNU gettext library is
32
configured --with-included-gettext.
34
This redirection works also in the case that the system C library or
35
the system libintl library contain gettext/textdomain/... functions.
36
If it didn't, we would need to add preprocessor level redirections to
37
libgnuintl.h of the following form:
39
# define gettext gettext__
40
# define dgettext dgettext__
41
# define dcgettext dcgettext__
42
# define ngettext ngettext__
43
# define dngettext dngettext__
44
# define dcngettext dcngettext__
45
# define textdomain textdomain__
46
# define bindtextdomain bindtextdomain__
47
# define bind_textdomain_codeset bind_textdomain_codeset__
49
How does this redirection work? There are two cases.
50
A. When libintl.a is linked into an executable, it works because
51
functions defined in the executable always override functions in
53
B. When libintl.so is used, it works because
54
1. those systems defining gettext/textdomain/... in the C library
55
(namely, Solaris 2.4 and newer, and GNU libc 2.0 and newer) are
56
ELF systems and define these symbols as weak, thus explicitly
57
letting other shared libraries override it.
58
2. those systems defining gettext/textdomain/... in a standalone
59
libintl.so library (namely, Solaris 2.3 and newer) have this
60
shared library in /usr/lib, and the linker will search /usr/lib
61
*after* the directory where the GNU gettext library is installed.
63
A third case, namely when libintl.a is linked into a shared library
64
whose name is not libintl.so, is not supported. In this case, on
65
Solaris, when -lintl precedes the linker option for the shared library
66
containing GNU gettext, the system's gettext would indeed override
67
the GNU gettext. Anyone doing this kind of stuff must be clever enough
68
to 1. compile libintl.a with -fPIC, 2. remove -lintl from his linker
80
#undef bind_textdomain_codeset
87
return gettext__ (msgid);
92
dgettext (domainname, msgid)
93
const char *domainname;
96
return dgettext__ (domainname, msgid);
101
dcgettext (domainname, msgid, category)
102
const char *domainname;
106
return dcgettext__ (domainname, msgid, category);
111
ngettext (msgid1, msgid2, n)
116
return ngettext__ (msgid1, msgid2, n);
121
dngettext (domainname, msgid1, msgid2, n)
122
const char *domainname;
127
return dngettext__ (domainname, msgid1, msgid2, n);
132
dcngettext (domainname, msgid1, msgid2, n, category)
133
const char *domainname;
139
return dcngettext__ (domainname, msgid1, msgid2, n, category);
144
textdomain (domainname)
145
const char *domainname;
147
return textdomain__ (domainname);
152
bindtextdomain (domainname, dirname)
153
const char *domainname;
156
return bindtextdomain__ (domainname, dirname);
161
bind_textdomain_codeset (domainname, codeset)
162
const char *domainname;
165
return bind_textdomain_codeset__ (domainname, codeset);