Po generation tool - Revision history

Ted at 06:12, 5 November 2010

2010-11-05T06:12:21Z

← Older revision		Revision as of 06:12, 5 November 2010
Line 7:		Line 7:
	* All under feature clauses named `Internationalization'.		* 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>
	<br>		<br>

Ted: /* Usage */

2010-11-05T03:57:34Z

Usage

← Older revision		Revision as of 03:57, 5 November 2010
Line 14:		Line 14:
	== Usage ==		== Usage ==
	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:		Example:

Ted: /* Usage */

2010-11-05T03:57:02Z

Usage

← Older revision		Revision as of 03:57, 5 November 2010
Line 14:		Line 14:
	== Usage ==		== Usage ==
	Usage:		Usage:
	po_generation_tool [~~OPTION~~] [~~INPUTFILE~~]...		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).		Extract translatable strings from given input Eiffel class files (*.e).

	INPUTFILE ... input files		INPUTFILE ... input files or directories
	-f add list of input files		-f add list of input files
	-D add list of directories to list for input files search		-D add list of directories to list for input files search

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.

← Older revision		Revision as of 04:10, 24 December 2008
Line 2:		Line 2:
	[[Category:Internationalization]]		[[Category:Internationalization]]
	== Overview ==		== 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.
			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 [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]].
			<br>
			<br>
			The source code of the tool can be accessed [https://svn.origo.ethz.ch/eiffelstudio/trunk/Src/tools/po_generation_tool here].

	== Usage ==		== Usage ==
Line 19:		Line 27:

	== Limitations ==		== 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.

Ted at 15:56, 25 January 2007

2007-01-25T15:56:43Z

← Older revision		Revision as of 15:56, 25 January 2007
Line 1:		Line 1:
	[[Category:Tools]]		[[Category:Tools]]
			[[Category:Internationalization]]
	== Overview ==		== 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. 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]]

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.