MAKETEXT(1)

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.