| 1 | #ifndef _LIBINTL_H |
|---|
| 2 | #include <intl/libintl.h> |
|---|
| 3 | |
|---|
| 4 | # ifndef _ISOMAC |
|---|
| 5 | |
|---|
| 6 | #include <locale.h> |
|---|
| 7 | |
|---|
| 8 | /* Now define the internal interfaces. */ |
|---|
| 9 | extern char *__gettext (const char *__msgid) |
|---|
| 10 | __attribute_format_arg__ (1); |
|---|
| 11 | extern char *__dgettext (const char *__domainname, |
|---|
| 12 | const char *__msgid) |
|---|
| 13 | __attribute_format_arg__ (2); |
|---|
| 14 | extern char *__dcgettext (const char *__domainname, |
|---|
| 15 | const char *__msgid, int __category) |
|---|
| 16 | __attribute_format_arg__ (2); |
|---|
| 17 | libc_hidden_proto (__dcgettext) |
|---|
| 18 | |
|---|
| 19 | extern char *__ngettext (const char *__msgid1, const char *__msgid2, |
|---|
| 20 | unsigned long int __n) |
|---|
| 21 | __attribute_format_arg__ (1) __attribute_format_arg__ (2); |
|---|
| 22 | extern char *__dngettext (const char *__domainname, |
|---|
| 23 | const char *__msgid1, const char *__msgid2, |
|---|
| 24 | unsigned long int __n) |
|---|
| 25 | __attribute_format_arg__ (2) __attribute_format_arg__ (3); |
|---|
| 26 | extern char *__dcngettext (const char *__domainname, |
|---|
| 27 | const char *__msgid1, const char *__msgid2, |
|---|
| 28 | unsigned long int __n, int __category) |
|---|
| 29 | __attribute_format_arg__ (2) __attribute_format_arg__ (3); |
|---|
| 30 | |
|---|
| 31 | extern char *__textdomain (const char *__domainname); |
|---|
| 32 | extern char *__bindtextdomain (const char *__domainname, |
|---|
| 33 | const char *__dirname); |
|---|
| 34 | extern char *__bind_textdomain_codeset (const char *__domainname, |
|---|
| 35 | const char *__codeset); |
|---|
| 36 | |
|---|
| 37 | extern const char _libc_intl_domainname[]; |
|---|
| 38 | libc_hidden_proto (_libc_intl_domainname) |
|---|
| 39 | |
|---|
| 40 | /* _ marks its argument, a string literal, for translation, and |
|---|
| 41 | performs translation at run time if the LC_MESSAGES locale category |
|---|
| 42 | has been set. The MSGID argument is extracted, added to the |
|---|
| 43 | translation database, and eventually submitted to the translation |
|---|
| 44 | team for processing. New translations are periodically |
|---|
| 45 | incorporated into the glibc source tree as part of translation |
|---|
| 46 | updates. */ |
|---|
| 47 | # undef _ |
|---|
| 48 | # define _(msgid) __dcgettext (_libc_intl_domainname, msgid, LC_MESSAGES) |
|---|
| 49 | |
|---|
| 50 | /* N_ marks its argument, a string literal, for translation, so that |
|---|
| 51 | it is extracted and added to the translation database (similar to |
|---|
| 52 | the _ macro above). It does not translate the string at run time. |
|---|
| 53 | The first, primary use case for N_ is a context in which a string |
|---|
| 54 | literal is required, such as an initializer. Translation will |
|---|
| 55 | happen later, for example using the __gettext function. |
|---|
| 56 | |
|---|
| 57 | The second, historic, use case involves strings which may be |
|---|
| 58 | translated in a future version of the library, but cannot be |
|---|
| 59 | translated in current releases due to some technical limitation |
|---|
| 60 | (e.g., gettext not being available in the dynamic loader). No |
|---|
| 61 | translation at run time happens in such cases. In the future, this |
|---|
| 62 | historic usage of N_ may become deprecated. Strings which are not |
|---|
| 63 | translated create unnecessary work for the translation team. We |
|---|
| 64 | continue to use N_ because it helps mark translatable strings. */ |
|---|
| 65 | # undef N_ |
|---|
| 66 | # define N_(msgid) msgid |
|---|
| 67 | |
|---|
| 68 | # endif /* !_ISOMAC */ |
|---|
| 69 | #endif |
|---|
| 70 | |
|---|
