NAME

maketext - translate and make messages

SYNOPSIS

maketext [OPTION] [--domain=TEXTDOMAIN] MSGKEY [PARAM...]
maketext [OPTION] -s MSGID [PARAM...]

DESCRIPTION

The maketext script translates a natural language message into the user's language, by looking up the translation in a message MO file, and process the plural transformation with Maketext.

The maketext script is a command-line interface to Locale::Maketext::Gettext(3) (and Locale::Maketext(3)). It can be used in shell scripts, etc, to translate, maketext and return the result. By this way, it enables Maketext to be integrated into other programming languages/systems, like bash/csh, python, PHP, C, etc. It works like the command-line program gettext.

For example:

% maketext -s "[*,_1,virus was,viruses were] found in [*,_2,file,files]." 0 1
0 viruses were found in 1 file.
% maketext -s "[*,_1,virus was,viruses were] found in [*,_2,file,files]." 1 3
1 virus was found in 3 files.
%

OPTIONS

-d,--domain=TEXTDOMAIN

Retrieve translated messages from TEXTDOMAIN.

-s

Adds a new line to the end of the output so that it behaves like the `echo' or the `gettext' command.

-h,--help

Display the help messages.

-V,--version

Display version information and exit.

MSGKEY

The original text used to look up translated text.

PARAM...

Parameters to Maketext for the plural and other text functions.

ENVIRONMENT

TEXTDOMAIN

TEXTDOMAIN is used to determine the text domain when the -d parameter is not given.

TEXTDOMAINDIR

TEXTDOMAINDIR is used to search the message catelog/MO file if it does not reside in the system locale directories.

NOTES

Maketext language function override, like quant or numerate, is not available here. Suggestions are welcome.

The current system locale directory search order is: /usr/share/locale, /usr/lib/locale, /usr/local/share/locale, /usr/local/lib/locale. Suggestions are welcome.

BUGS

Report bugs to imacat <imacat@mail.imacat.idv.tw>

SEE ALSO

Locale::Maketext(3), Locale::Maketext::TPJ13(3), Locale::Maketext::Gettext(3), Locale::Maketext::Gettext::Functions(3), bindtextdomain(3), textdomain(3). Also, please refer to the official GNU gettext manual at http://www.gnu.org/software/gettext/manual/.

AUTHOR

imacat <imacat@mail.imacat.idv.tw>

COPYRIGHT

Copyright (c) 2003-2007 imacat. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.