1PO2DEBCONF(1) po-debconf PO2DEBCONF(1)
2
3
4
6 po2debconf - merge master templates file and PO files
7
9 po2debconf [-v] [-h] [--podir=DIR] [-o FILE] [-e STRING] master
10
12 This program reads all PO files and a single templates file, and
13 produces a Debconf templates file containing all translations, similar
14 to the one produced by debconf-mergetemplate(1) (from the
15 "debconf-utils" package). PO files are by default searched in the po
16 subdirectory below the location of the master file.
17
18 To help the language code transition for Norwegian Bokmål, the no and
19 nb language codes are handled specially. If no.po exists, it should be
20 renamed to nb.po. Using nb.po will make both "-no" and "-nb"
21 translations available in the templates file.
22
23 Lines beginning with a number sign ("#") are comments in templates
24 files. They are useful to give hints to translators, and are discarded
25 by po2debconf. Special comments have been introduced in "po-debconf"
26 1.0. They are in the form "#flag:directive". The "#flag:partial" is
27 the only directive interpreted by po2debconf. Normally when a field is
28 composed of several paragraphs (like "__Choices" and "_Description"),
29 it is translated if all paragraphs are translated. When a field
30 contains "#flag:partial", translated strings may be mixed with
31 untranslated strings.
32
34 -h, --help
35 Display a usage summary and exit.
36
37 -v, --verbose
38 Process in verbose mode.
39
40 --podir=DIR
41 Set directory for PO files. Default is to search PO files in the
42 po subdirectory below the location of the master file.
43
44 -o, --output=FILE
45 Set output filename (default is standard output).
46
47 -e, --encoding=STRING
48 Convert encoding. Argument can take 3 values: "utf8" (convert to
49 UTF-8), "po" (do not change encoding) and "popular" (convert
50 encoding of input files depending on their language; the
51 "PODEBCONF_ENCODINGS" environment variable must point to a name of
52 a file containing the encoding map).
53
54 Such a filename looks like:
55
56 #
57 # Number is comment sign
58 #
59 cs ISO-8859-2
60 da ISO-8859-1
61 de ISO-8859-1
62 el ISO-8859-7
63
64 etc.
65
66 Default encoding used to be "popular", and has been switched to
67 "utf8" since po-debconf 0.9.0.
68
70 Since debconf 1.2.0, templates format has changed, encoding is part of
71 field names, i.e. they are "foo-lang.encoding". When older debconf
72 encounter such fields, they are silently ignored, which means that
73 original text is displayed.
74
75 If present, a po/output file can override defaults for encoding and
76 output format. It contains a single line with two fields. The first
77 field is the output format (currently valid values are 1 for fields in
78 the form "foo-lang", and 2 for "foo-lang.encoding") and the second
79 field is the encoding, e.g.
80
81 echo '2 utf8' > po/output
82
83 let po2debconf convert text to UTF-8.
84
85 When encoding is set to "po" or "utf8", output format is always set to
86 2, so that older debconf do not try to display text with wrong
87 encodings.
88
90 debconf-gettextize(1), debconf-updatepo(1), po-debconf(7).
91
93 Denis Barbier <barbier@linuxfr.org>
94
95
96
97 2022-07-22 PO2DEBCONF(1)