diff options
Diffstat (limited to 'doc/mailfromd.texi')
-rw-r--r-- | doc/mailfromd.texi | 72 |
1 files changed, 72 insertions, 0 deletions
diff --git a/doc/mailfromd.texi b/doc/mailfromd.texi index 30f542c3..bc76dbe9 100644 --- a/doc/mailfromd.texi +++ b/doc/mailfromd.texi @@ -7249,6 +7249,78 @@ the decision based on the cached data, or to @samp{0} otherwise. @subsubsection National Language Support Functions @UNREVISED{} +@deftypefn {Built-in Function} string bindtextdomain (string @var{domain}, @ + string @var{dirname}) +This function sets the base directory of the hierarchy containing +message catalogs for a given message domain. + +@var{domain} is a string identifying the textual domain. If +it is not empty, the base directory for message catalogs belonging to +domain @var{domain} is set to @var{dirname}. It is important that +@var{dirname} be an absolute pathname; otherwise it cannot be +guaranteed that the message catalogs will be found. + +If @var{domain} is @samp{""}, @code{bindtextdomain} returns the +previously set base directory for domain @var{domain}. +@end deftypefn + +@deftypefn {Built-in Function} string dgettext (string @var{domain}, @ + string @var{msgid}) +@code{dgettext} attempts to translate the string @var{msgid} into the +currently active locale, according to the settings of the textual +domain @var{domain}. If there is no translation available, +@code{dgettext} returns @var{msgid} unchanged. +@end deftypefn + +@deftypefn {Built-in Function} string dngettext @ + (string @var{domain}, string @var{msgid}, string @var{msgid_plural}, @ + number @var{n}) +The @code{dngettext} functions attempts to translate a text string +into the language specified by the current locale, by looking up the +appropriate singular or plural form of the translation in a message +catalog, set for the textual domain @var{domain}. + +@xref{Plural forms, Additional functions for plural forms, +Additional functions for plural forms, gettext, GNU gettext +utilities}, for the detailed discussion of the plural form handling in +different languages. +@end deftypefn + +@deftypefn {Library Function} string textdomain (string @var{domain}) +The @code{textdomain} function sets the current message domain to +@var{domain}, if it is not empty. In any case the function returns +the current message domain. The current domain is @samp{mailfromd} +initially. For example, the following sequence of @code{textdomain} +invocations will yield: + +@smallexample +textdomain("") @result{} "mailfromd" +textdomain("myfilter") @result{} "myfilter" +textdomain("") @result{} "myfilter" +@end smallexample + +@end deftypefn + +@deftypefn {Library Function} string gettext (string @var{msgid}) +@code{gettext} attempts to translate the string @var{msgid} into the +currently active locale, according to the settings of the current textual +domain (set using @code{textdomain} function). If there is no +translation available, @code{gettext} returns @var{msgid} unchanged. +@end deftypefn + +@deftypefn {Library Function} string ngettext @ + (string @var{msgid}, string @var{msgid_plural}, number @var{n}) +The @code{ngettext} functions attempts to translate a text string +into the language specified by the current locale, by looking up the +appropriate singular or plural form of the translation in a message +catalog, set for the current textual domain. + +@xref{Plural forms, Additional functions for plural forms, +Additional functions for plural forms, gettext, GNU gettext +utilities}, for the detailed discussion of the plural form handling in +different languages. +@end deftypefn + @node Debugging Functions @subsubsection Debugging Functions |