Intltool-update (8) Linux Manual Page

intltool-update – updates PO template file and merge translations with it

Synopsis

intltool-update [option]…
intltool-update LANGCODE

Description

intltool-update generates new po file templates from source code, and merges existing translations with these new po templates. You must change working directory to the subdirectory containing translations (usually "po/") before running intltool-update.

Options

When executing intltool-update , only one mode of operation is allowed each time.

Mode of operation

-p
–pot: Generate po template (.pot) only.
-s
–headers: Executes intltool-extract(8) to extract strings inside XML/INI style files listed in POTFILES.in, and writes the extracted strings into header files, so that the strings can be recognised by xgettext(1).
-m
–maintain: Search for left out files, which should have been listed in POTFILES.in or POTFILES.skip. A list of all these files are written into another file called "missing".
-r
–report: Display a status report for all translations in the software.
-d LANGCODE
–dist LANGCODE: Merge LANGCODE.po with existing PO template.

Other options

-g NAME
–gettext-package=NAME: Manually specify PO template file name, instead of determining the name automatically from source. Useful with -p/–pot option. This option has an additional effect: the name of current working directory is no more limited to "po" or "po-*".
-o FILENAME
–output-file=FILENAME: Manually specify output FILENAME after merging old translation with PO template. Useful either with -d/–dist option or without any option.
-x
–verbose: Display lots of feedback.
–version: Show version information.
–help: Show usage and basic help information.

Examples

Creates a new PO template from source code, and name it foo.pot:

intltool-update --pot --gettext-package=foo

Updates translation file xy.po using existing po template called "bar.pot", and writes output into "xy1.po":

intltool-update --dist --gettext-package=bar --output-file=xy1.po xy

Creates new PO template and updates translation file xy.po (xy.po is overwritten with new content):

intltool-update xy

(same as intltool-update –pot && intltool-update –dist xy)

Files

po/POTFILES.in: Contains list of source files which contain translatable strings, one file per line.
po/POTFILES.skip
po/POTFILES.ignore (obsolete): Contains list of source files which should be ignored when searching for translatable strings.

Reporting Bugs

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

Author

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

intltool-update (8) Linux Manual Page