intltool-update(8)

intltool-update8

Updates po template file and merge translations with it

Usage

intltool-update [option] ...

intltool-update LANGCODE

Overview

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.

Releases

13 releases since Debian 3.0 (Woody); the text changed 3 times.

  1. 3.0
  2. 3.1–5.0
  3. 6.0–8
  4. 9–Arch

--dist since Debian 3.1 (Sarge); --gettext-package since Debian 3.1 (Sarge); --headers since Debian 3.1 (Sarge); --output-file since Debian 3.1 (Sarge); -d since Debian 3.1 (Sarge); -g since Debian 3.1 (Sarge); -o since Debian 3.1 (Sarge); -s since Debian 3.1 (Sarge).

--header until Debian 3.0 (Woody); -h until Debian 3.0 (Woody); -v until Debian 3.0 (Woody).

Reporting bugs

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

Author

Darin Adler <[email protected]>
Kenneth Christiansen <[email protected]>
Maciej Stachowiak <[email protected]>

From intltool 0.51.0-6 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.