Po generation tool - Revision history

Ted at 06:12, 5 November 2010

2010-11-05T06:12:21Z

Ted: /* Usage */

2010-11-05T03:57:34Z

‎Usage

Ted: /* Usage */

2010-11-05T03:57:02Z

‎Usage

Ted: Updated since i18n APIs have been changed. Added more info.

2008-12-24T04:10:38Z

Updated since i18n APIs have been changed. Added more info.

Ted at 15:56, 25 January 2007

2007-01-25T15:56:43Z

Ted at 04:37, 25 January 2007

2007-01-25T04:37:10Z

New page

[[Category:Tools]]
== Overview ==
The Po Generation Tool is an auxiliary tool of [[Internationalization|i18n library]] used extracting manifest strings from compilable Eiffel classes. Only those manifest strings which are parsed as arguments into features of `translate' and `translate_plural' are extracted. The output is an [http://www.gnu.org/software/gettext/manual/html_node/gettext_9.html#SEC9 .po file] with void translations. The tool is being used for internationalization of EiffelStudio. The output file is the initial [https://origo.ethz.ch/eiffelsoftware/es/trunk/Delivery/studio/lang/po_files/estudio.pot estudio.pot] which is completed by appending other useful entries. See [[EiffelStudio_Internationalization|EiffelStudio Internationalization]]

== Usage ==
Usage:
po_generation_tool [OPTION] [INPUTFILE]...

Extract translatable strings from given input Eiffel class files (*.e).

INPUTFILE ... input files
-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 `translate' or `translate_plural' is from an indentifier of type I18N_LOCALE. This means that any call of the same name with `translate' and that takes one manifest string argument or of the same name with `translate_plural' and that takes two manifest string arguments is extracted.
* Suggestion: Do not use a feature with signature like "translate (a_string: STRING_GENERAL)" or "translate_plural (a_string1: STRING_GENERAL; a_string2: STRING_GENERAL)", if i18n library is used.

@@ Line 7: / Line 7: @@
 * All under feature clauses named `Internationalization'.
-The output is an [http://www.gnu.org/software/gettext/manual/html_node/gettext_9.html#SEC9 .po file] with void translations. The tool is being used for internationalization of EiffelStudio. The output file is the initial [https://origo.ethz.ch/eiffelsoftware/es/trunk/Delivery/studio/lang/po_files/estudio.pot estudio.pot] which is completed by appending other useful entries later. See [[EiffelStudio_Internationalization|EiffelStudio Internationalization]].
+The output is an [http://www.gnu.org/software/gettext/manual/html_node/gettext_9.html#SEC9 .po file] with void translations. The tool is being used for internationalization of EiffelStudio. The output file is the initial [https://svn.origo.ethz.ch/eiffelstudio/trunk/Delivery/studio/lang/po_files/estudio.pot estudio.pot] which is completed by appending other useful entries later. See [[EiffelStudio_Internationalization|EiffelStudio Internationalization]].
 <br>
 <br>

@@ Line 14: / Line 14: @@
 == Usage ==
    Usage:
-           po_generation_tool (-f|-D) INPUTFILE [(-f|-D) INPUTFILE] ... [-o OUTPUT]
+           po_generation_tool (-f|-D) INPUTFILE [(-f|-D) INPUTFILE] ... [-o OUTPUT]|[-]
    Example:

@@ Line 14: / Line 14: @@
 == Usage ==
    Usage:
-           po_generation_tool [OPTION] [INPUTFILE]...
+           po_generation_tool (-f|-D) INPUTFILE [(-f|-D) INPUTFILE] ... [-o OUTPUT]
    Extract translatable strings from given input Eiffel class files (*.e).
-   INPUTFILE ...   input files
+   INPUTFILE ...   input files or directories
    -f              add list of input files
    -D              add list of directories to list for input files search

@@ Line 2: / Line 2: @@
 [[Category:Internationalization]]
 == Overview ==
-The Po Generation Tool is an auxiliary tool of [[Internationalization|i18n library]] used extracting manifest strings from compilable Eiffel classes. Only those manifest strings which are parsed as arguments into features of `translate' and `translate_plural' are extracted. The output is an [http://www.gnu.org/software/gettext/manual/html_node/gettext_9.html#SEC9 .po file] with void translations. The tool is being used for internationalization of EiffelStudio. The output file is the initial [https://origo.ethz.ch/eiffelsoftware/es/trunk/Delivery/studio/lang/po_files/estudio.pot estudio.pot] which is completed by appending other useful entries. See [[EiffelStudio_Internationalization|EiffelStudio Internationalization]]
+The Po Generation Tool is an auxiliary tool of [[Internationalization|i18n library]] used extracting manifest strings from compilable Eiffel classes.
 == Usage ==
@@ Line 19: / Line 27: @@
 == Limitations ==
-* The tool now is not smart enough to identify a call of `translate' or `translate_plural' is from an indentifier of type I18N_LOCALE. This means that any call of the same name with `translate' and that takes one manifest string argument or of the same name with `translate_plural' and that takes two manifest string arguments is extracted.
+* 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 "translate (a_string: STRING_GENERAL)" or "translate_plural (a_string1: STRING_GENERAL; a_string2: STRING_GENERAL)", if i18n library is used.
+* 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.