1PO2DEBCONF(1)                     po-debconf                     PO2DEBCONF(1)
2
3
4

NAME

6       po2debconf - merge master templates file and PO files
7

SYNOPSIS

9       po2debconf [-v] [-h] [--podir=DIR] [-o FILE] [-e STRING] master
10

DESCRIPTION

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

OPTIONS

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

OUTPUT FORMAT

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

SEE ALSO

90       debconf-gettextize(1), debconf-updatepo(1), po-debconf(7).
91

AUTHOR

93         Denis Barbier <barbier@linuxfr.org>
94
95
96
97                                  2023-01-20                     PO2DEBCONF(1)