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.