NAME

TDcal::nls —

TDcal Perl programming library

SYNOPSIS

use TDcal::nls;

$lang =
tdnlsinit();

$l =
__($s);

DESCRIPTION

TDcal::nls provides functions for NLS support within TDcal applications.

The function tdnlsinit() should be invoked early on in a program in order to parse the user's locale setting environment variables and load the appropriate TDcal language support files.

Within the Perl code, any strings which are to be displayed to the user can be wrapped in a call to the function __() which takes a string as an argument and returns the language-specific version of the string.

Note: there are two variants of the NLS support. One, nls-on.pm, provides the above functions, that operate as described above. The other, nls-off.pm, provides the same functions, but they do nothing. It is intended that just one of these files is installed as nls.pm based on the user's or system's choice of NLS support.

RETURN VALUES

tdnlsinit() returns the two-letter code corresponding to the language selected. This can be used for later selection of help file language.

__() returns the locale-specific translation of the input string or the original input string if a translation is not available.

ENVIRONMENT

The following environment variables affect the operation of TDcal::nls:

LANG: NLS general language specifier. Its value is used if either of the LC_ variables are not set.
LC_MESSAGES: NLS language support for messages.
LC_TIME: NLS language support for month/day names and time formats.

STANDARDS

See TDcal(7).

HISTORY

See TDcal(7).