INTLTOOL-UPDATE
Section: Maintenance Commands (8)
Updated: 2003-08-02
Page Index
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)