Difference between revisions of "Po generation tool"

Revision as of 18:57, 4 November 2010

Overview

The Po Generation Tool is an auxiliary tool of i18n library used extracting manifest strings from compilable Eiffel classes. The following manifest strings are extracted:

• Direct arguments of calls of `translation' and `plural_translation' are extracted.
• All under feature clauses named `Internationalization'.

The output is an .po file with void translations. The tool is being used for internationalization of EiffelStudio. The output file is the initial estudio.pot which is completed by appending other useful entries later. See EiffelStudio Internationalization.

The source code of the tool can be accessed here.

Usage

 Usage:
         po_generation_tool (-f|-D) INPUTFILE [(-f|-D) INPUTFILE] ... [-o OUTPUT]|[-]

 Example:
         po_generation_tool -f class1.e class2.e
         po_generation_tool -D dir1 dir2 -o out.pot
 
 Extract translatable strings from given input Eiffel class files (*.e).

 INPUTFILE ...   input files or directories
 -f              add list of input files
 -D              add list of directories to list for input files search
 -o              write output to specified file
                 If output file is -, output is written to standard output.
                 If output file is not specified, 'po_file.pot' will be generated as default name.
 -h              display this help and exit

Limitations

• The tool now is not smart enough to identify a call of `translation' or `plural_translation' that is from an identifier of type I18N_LOCALE or others. This means that any call with the same name as `translation' and that takes one manifest string argument or with the same name as `plural_translation' and that takes two manifest string arguments is extracted.
• Suggestion: Do not use a feature with signature like "translation(a_string: STRING_GENERAL)" or "plural_translation (a_string1: STRING_GENERAL; a_string2: STRING_GENERAL)" in your system, if i18n library and the tool are used.