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

# [NAME](#NAME)

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

# [SYNOPSIS](#SYNOPSIS)

**intltool-update \[option]...**  
**intltool-update LANGCODE**

# [DESCRIPTION](#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](#OPTIONS)

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

## [Mode of operation](#Mode_of_operation)

[**-p**](#p)

[**--pot**](#pot)

Generate po template (.pot) only.

[**-s**](#s)

[**--headers**](#headers)

Executes [**intltool-extract**(8)](/man/os/intltool/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)](/man/os/intltool/xgettext.1).

[**-m**](#m)

[**--maintain**](#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**](#r)

[**--report**](#report)

Display a status report for all translations in the software.

[**-d LANGCODE**](#d)

[**--dist LANGCODE**](#dist)

Merge **LANGCODE**.po with existing PO template.

## [Other options](#Other_options)

[**-g NAME**](#g)

[**--gettext-package**=*NAME*](#gettext-package)

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**](#o)

[**--output-file**=*FILENAME*](#output-file)

Manually specify output *FILENAME* after merging old translation with PO template. Useful either with **-d**/**--dist** option or without any option.

[**-x**](#x)

[**--verbose**](#verbose)

Display lots of feedback.

[**--version**](#version)

Show version information.

[**--help**](#help)

Show usage and basic help information.

# [EXAMPLES](#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](#FILES)

[**po/POTFILES.in**](#po/POTFILES.in)

Contains list of source files which contain translatable strings, one file per line.

[**po/POTFILES.skip**](#po/POTFILES.skip)

[**po/POTFILES.ignore** (obsolete)](#po/POTFILES.ignore)

Contains list of source files which should be ignored when searching for translatable strings.

# [REPORTING BUGS](#REPORTING_BUGS)

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

# [AUTHOR](#AUTHOR)

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

# [SEE ALSO](#SEE_ALSO)

[**intltoolize**(8)](/man/os/intltool/intltoolize.8), [**intltool-prepare**(8)](/man/os/intltool/intltool-prepare.8), [**intltool-extract**(8)](/man/os/intltool/intltool-extract.8), [**intltool-merge**(8)](/man/os/intltool/intltool-merge.8), [**xgettext**(1)](/man/os/intltool/xgettext.1)

2003-08-02 intltool

---

Document: intltool-update(8) from intltool 0.51.0-r8 (Chainguard OS)
Source: https://launchpad.net/intltool/trunk/0.51.0/+download/intltool-0.51.0.tar.gz