intltool-update(8)
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
--potGenerate po template (.pot) only. - -s
--headersExecutes 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
--maintainSearch 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
--reportDisplay a status report for all translations in the software. - -d LANGCODE
--dist LANGCODEMerge LANGCODE.po with existing PO template. - Other options
- -g NAME
--gettext-package=NAMEManually 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=FILENAMEManually specify output FILENAME after merging old translation with PO template. Useful either with -d/--dist option or without any option. - -x
--verboseDisplay 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://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>