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
6
it under the terms of the GNU General Public License as published by
7
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
13
GNU General Public License for more details.
15
You should have received a copy of the GNU General Public License
16
along with this program; if not, write to the Free Software
17
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
23
#include "libgnuintl.h"
26
/* @@ end of prolog @@ */
28
/* This file redirects the gettext functions (without prefix or suffix) to
29
those defined in the included GNU gettext library (with "__" suffix).
30
It is compiled into libintl when the included GNU gettext library is
31
configured --with-included-gettext.
33
This redirection works also in the case that the system C library or
34
the system libintl library contain gettext/textdomain/... functions.
35
If it didn't, we would need to add preprocessor level redirections to
36
libgnuintl.h of the following form:
38
# define gettext gettext__
39
# define dgettext dgettext__
40
# define dcgettext dcgettext__
41
# define ngettext ngettext__
42
# define dngettext dngettext__
43
# define dcngettext dcngettext__
44
# define textdomain textdomain__
45
# define bindtextdomain bindtextdomain__
46
# define bind_textdomain_codeset bind_textdomain_codeset__
48
How does this redirection work? There are two cases.
49
A. When libintl.a is linked into an executable, it works because
50
functions defined in the executable always override functions in
52
B. When libintl.so is used, it works because
53
1. those systems defining gettext/textdomain/... in the C library
54
(namely, Solaris 2.4 and newer, and GNU libc 2.0 and newer) are
55
ELF systems and define these symbols as weak, thus explicitly
56
letting other shared libraries override it.
57
2. those systems defining gettext/textdomain/... in a standalone
58
libintl.so library (namely, Solaris 2.3 and newer) have this
59
shared library in /usr/lib, and the linker will search /usr/lib
60
*after* the directory where the GNU gettext library is installed.
62
A third case, namely when libintl.a is linked into a shared library
63
whose name is not libintl.so, is not supported. In this case, on
64
Solaris, when -lintl precedes the linker option for the shared library
65
containing GNU gettext, the system's gettext would indeed override
66
the GNU gettext. Anyone doing this kind of stuff must be clever enough
67
to 1. compile libintl.a with -fPIC, 2. remove -lintl from his linker
79
#undef bind_textdomain_codeset
86
return gettext__ (msgid);
91
dgettext (domainname, msgid)
92
const char *domainname;
95
return dgettext__ (domainname, msgid);
100
dcgettext (domainname, msgid, category)
101
const char *domainname;
105
return dcgettext__ (domainname, msgid, category);
110
ngettext (msgid1, msgid2, n)
115
return ngettext__ (msgid1, msgid2, n);
120
dngettext (domainname, msgid1, msgid2, n)
121
const char *domainname;
126
return dngettext__ (domainname, msgid1, msgid2, n);
131
dcngettext (domainname, msgid1, msgid2, n, category)
132
const char *domainname;
138
return dcngettext__ (domainname, msgid1, msgid2, n, category);
143
textdomain (domainname)
144
const char *domainname;
146
return textdomain__ (domainname);
151
bindtextdomain (domainname, dirname)
152
const char *domainname;
155
return bindtextdomain__ (domainname, dirname);
160
bind_textdomain_codeset (domainname, codeset)
161
const char *domainname;
164
return bind_textdomain_codeset__ (domainname, codeset);