intltool-update

NAME

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

SYNOPSIS

I intltool-update [option]...
I 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 R 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
"--dist
Merge R LANGCODE .po with existing PO template.

Other options

.
"-g
"--gettext-package=NAME"
Manually specify PO template file name, instead of determining the name automatically from source. Useful with R -p / --pot option. This option has an additional effect: the name of current working directory is no more limited to "po" or "po-*".
"-o
"--output-file=FILENAME"
Manually specify output FILENAME after merging old translation with PO template. Useful either with R -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
Contains list of source files which should be ignored when searching for translatable strings.

REPORTING BUGS

Report bugs to http://bugzilla.gnome.org (product name "intltool") or send email to <xml-i18n-tools@gnome.org>.

AUTHOR

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

SEE ALSO