intltool-update(8)

1INTLTOOL-UPDATE(8)          System Manager's Manual         INTLTOOL-UPDATE(8)
2
3
4

NAME

6       intltool-update  - updates PO template file and merge translations with
7       it
8
9

SYNOPSIS

11       intltool-update [option]...
12       intltool-update LANGCODE
13
14

DESCRIPTION

16       intltool-update generates new po file templates from source  code,  and
17       merges existing translations with these new po templates.
18
19       You must change working directory to the subdirectory containing trans‐
20       lations (usually "po/") before running intltool-update.
21
22

OPTIONS

24       When executing intltool-update , only one mode of operation is  allowed
25       each time.
26
27   Mode of operation
28       -p
29       --pot
30           Generate po template (.pot) only.
31
32       -s
33       --headers
34           Executes  intltool-extract(8)  to  extract  strings  inside XML/INI
35           style files listed in POTFILES.in, and writes the extracted strings
36           into  header  files, so that the strings can be recognised by xget‐
37           text(1).
38
39       -m
40       --maintain
41           Search for left out files, which should have been  listed  in  POT‐
42           FILES.in  or  POTFILES.skip.  A list of all these files are written
43           into another file called "missing".
44
45       -r
46       --report
47           Display a status report for all translations in the software.
48
49       -d LANGCODE
50       --dist LANGCODE
51           Merge LANGCODE.po with existing PO template.
52
53   Other options
54       -g NAME
55       --gettext-package=NAME
56           Manually specify PO template file name, instead of determining  the
57           name  automatically  from source. Useful with -p/--pot option. This
58           option has an additional effect: the name of current working direc‐
59           tory is no more limited to "po" or "po-*".
60
61       -o FILENAME
62       --output-file=FILENAME
63           Manually specify output FILENAME after merging old translation with
64           PO template. Useful either with -d/--dist  option  or  without  any
65           option.
66
67       -x
68       --verbose
69           Display lots of feedback.
70
71       --version
72           Show version information.
73
74       --help
75           Show usage and basic help information.
76
77

EXAMPLES

79       Creates a new PO template from source code, and name it foo.pot:
80
81         intltool-update --pot --gettext-package=foo
82
83       Updates  translation  file  xy.po  using  existing  po  template called
84       "bar.pot", and writes output into "xy1.po":
85
86         intltool-update --dist --gettext-package=bar --output-file=xy1.po xy
87
88       Creates new PO template and updates translation file  xy.po  (xy.po  is
89       overwritten with new content):
90
91         intltool-update xy
92         (same as intltool-update --pot && intltool-update --dist xy)
93
94

FILES

96       po/POTFILES.in
97              Contains   list  of  source  files  which  contain  translatable
98              strings, one file per line.
99
100       po/POTFILES.skip
101       po/POTFILES.ignore (obsolete)
102              Contains list of source  files  which  should  be  ignored  when
103              searching for translatable strings.
104
105

REPORTING BUGS

107       Report bugs to http://bugs.launchpad.net/intltool
108
109

AUTHOR

111       Darin Adler <darin@bentspoon.com>
112       Kenneth Christiansen <kenneth@gnu.org>
113       Maciej Stachowiak <mjs@eazel.com>
114
115