intltool-merge(8) [debian man page]

INTLTOOL-MERGE(8)					      System Manager's Manual						 INTLTOOL-MERGE(8)

NAME

       intltool-merge - merge translated strings into various types of file

SYNOPSIS

       intltool-merge [option]... PO_DIRECTORY FILENAME OUTPUT_FILE

DESCRIPTION

       Merge  translated strings in po files in PO_DIRECTORY with the original application file FILENAME, and output the file OUTPUT_FILE contain-
       ing both original and localized strings.

       If FILENAME is an XML file, OUTPUT_FILE will contain repeated xml nodes, where each  node  contains  one  of  the  localized  strings  with
       "xml:lang" attribute.

OPTIONS

   Mode of operation
       -b
       --ba-style
	   Merge files in bonobo-activation style, which is used for bonobo servers.

       -d
       --desktop-style
	   Merge files in desktop style, which is similar to the Windows .ini file format.

       -k
       --keys-style
	   Merge files in keys style, which is used for metadata.

       -o
       --oaf-style
	   (OBSOLETE) Same as -b/--ba-style.

       -r
       --rfc822deb-style
	   Merge files in RFC 822 style, which is usually used in Debian configuration files.

       --quoted-style
	   Merge files in quoted string style, which just translates any strings within "".

       -x
       --xml-style
	   Merge files in standard XML style, both as attributes and as raw pcdata.

   Other options
       -u
       --utf8
	   Convert all strings to UTF-8 before merging.

       -p
       --pass-through
	   Use strings as is in .po files without conversion (STRONGLY unrecommended with -x).

       -c
       --cache
	   (TBD)

       -q
       --quiet
	   Be quiet while running.

       -v
       --version
	   Show version information.

       -h
       --help
	   Show usage and basic help information.

FILES

       po/.intltool-merge-cache
	      Cache file generated by intltool-merge, that contains all strings in all po files separated by 1.

REPORTING BUGS

       Report bugs to http://bugs.launchpad.net/intltool

AUTHOR

       Darin Adler <darin@bentspoon.com>
       Kenneth Christiansen <kenneth@gnu.org>
       Maciej Stachowiak <mjs@eazel.com>

SEE ALSO

       iconv(1), intltoolize(8), intltool-prepare(8), intltool-extract(8), intltool-update(8)

intltool							    2003-08-02							 INTLTOOL-MERGE(8)

INTLTOOL-PREPARE(8)					      System Manager's Manual					       INTLTOOL-PREPARE(8)

NAME

       intltool-prepare - Prepare software to make use of intltool

SYNOPSIS

       intltool-prepare [option] [KEYWORD]...

DESCRIPTION

       For  software  packages	that  include  some specific type of translatable files (such as .desktop and .soundlist), before they make use of
       intltool, translators have to dig through them one by one, and add their localization into each file. This process is  error  prone,  since
       translators  may  include  typing  errors, or add their localization in wrong encoding. Besides, translators may not alwas know other files
       (beside .po files) are translatable.

       intltool avoids all the problems above by extracting strings inside those translatable files into po template (.pot) file. All  translators
       need to care about is just translating po files. Afterwards, intltool-merge(8) will merge localized strings into those files.

       Before  your  software  becomes intltool-aware, a few issues have to be sorted out, and intltool-prepare tries to take care of all of them.
       intltool-prepare will:

       o Extract all localized strings in .desktop style files (including ".desktop", ".soundlist", ".keys" and ".directory")  into  corresponding
	 po files.

       o Convert the translatable files into templates that don't contain any localization.

       o Add the list of template files above into POTFILES.in.

       o Add the list of old translatable files into .cvsignore (since they will be generated by intltool later).

       o Add the rules for generating these files into Makefile.am.

       NOTE: You must change working directory to the top level source directory before running intltool-prepare.

OPTIONS

       KEYWORD is a list of additional keywords beside "Name", "Comment" and "description". intltool-prepare will recognize any line starting with
       those KEYWORD and extract localized strings after equal sign ("=").

       -x
       --verbose
	   Be verbose to give user additional feedback.

       -v
       --version
	   Show version information.
       -h
       --help
	   Show usage and basic help information.

REPORTING BUGS

       Report bugs to http://bugs.launchpad.net/intltool

AUTHOR

       Darin Adler <darin@bentspoon.com>
       Kenneth Christiansen <kenneth@gnu.org>
       Maciej Stachowiak <mjs@eazel.com>

SEE ALSO

       intltoolize(8), intltool-update(8), intltool-extract(8), intltool-merge(8)

intltool							    2003-08-02						       INTLTOOL-PREPARE(8)