Synched docstrings from libguile/
[bpt/guile.git] / doc / ref / api-i18n.texi
1 @c -*-texinfo-*-
2 @c This is part of the GNU Guile Reference Manual.
3 @c Copyright (C) 1996, 1997, 2000, 2001, 2002, 2003, 2004
4 @c Free Software Foundation, Inc.
5 @c See the file guile.texi for copying conditions.
6
7 @page
8 @node Internationalization
9 @section Support for Internationalization
10
11 @deffn {Scheme Procedure} gettext msgid [domain [category]]
12 @deffnx {C Function} scm_gettext (msgid, domain, category)
13 Return the translation of @var{msgid} in the message domain @var{domain}. @var{domain} is optional and defaults to the domain set through (textdomain). @var{category} is optional and defaults to LC_MESSAGES.
14 @end deffn
15
16 @deffn {Scheme Procedure} ngettext msgid msgid_plural n [domain [category]]
17 @deffnx {C Function} scm_ngettext (msgid, msgid_plural, n, domain, category)
18 Return the translation of @var{msgid}/@var{msgid_plural} in the message domain @var{domain}, with the plural form being chosen appropriately for the number @var{n}. @var{domain} is optional and defaults to the domain set through (textdomain). @var{category} is optional and defaults to LC_MESSAGES.
19 @end deffn
20
21 @deffn {Scheme Procedure} textdomain [domainname]
22 @deffnx {C Function} scm_textdomain (domainname)
23 If optional parameter @var{domainname} is supplied, set the textdomain. Return the textdomain.
24 @end deffn
25
26 @deffn {Scheme Procedure} bindtextdomain domainname [directory]
27 @deffnx {C Function} scm_bindtextdomain (domainname, directory)
28 If optional parameter @var{directory} is supplied, set message
29 catalogs to directory @var{directory}. Return the directory bound to
30 @var{domainname}.
31 @end deffn
32
33 @deffn {Scheme Procedure} bind-textdomain-codeset domainname [encoding]
34 @deffnx {C Function} scm_bind_textdomain_codeset (domainname, encoding)
35 If optional parameter @var{encoding} is supplied, set encoding for
36 message catalogs of @var{domainname}. Return the encoding of
37 @var{domainname}.
38 @end deffn
39
40 @c Local Variables:
41 @c TeX-master: "guile.texi"
42 @c End: