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