Manpages - intltool-update.8
Table of Contents
NAME
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@bentspoon.com>
Kenneth Christiansen <kenneth@gnu.org>
Maciej Stachowiak <mjs@eazel.com>
SEE ALSO
*intltoolize*(8), *intltool-prepare*(8), *intltool-extract*(8), *intltool-merge*(8), *xgettext*(1)