NAME
po2debconf - merge master templates file and PO files
SYNOPSIS
po2debconf
[-v] [-h]
[--podir=BI\s-1DIR\s0]
[-o BI\s-1FILE\s0]
[-e BI\s-1STRING\s0]
master
DESCRIPTION
This program reads all \s-1PO\s0 files and a single templates file, and
produces a Debconf templates file containing all translations, similar
to the one produced by debconf-mergetemplate(1) (from the
CWdebconf-utils package). \s-1PO\s0 files are by default searched in the
po subdirectory below the location of the master file.
To help the language code transition for Norwegian Bokma\*ol, the
no and nb language codes are handled specially. If no.po exists,
it should be renamed to nb.po. Using nb.po will make both CW-no
and CW-nb translations available in the templates file.
Lines beginning with a number sign (CW#) are comments in templates files,
they are useful to give hints to translators, and are discarded by po2debconf.
Special comments have been introduced in CWpo-debconf 1.0, they are in the
form CW#flag:CIdirectiveCW. The CW#flag:partial is the only directive
interpreted by po2debconf. Normally when a field is composed of several
paragraphs (like CW__Choices and CW_Description), it is translated if all
paragraphs are translated. When a field succeeds CW#flag:partial, translated
strings may be mixed with untranslated strings.
OPTIONS
"-h,
Display a usage summary and exit.
"-v,
Process in verbose mode.
"--podir=BI\s-1DIR\s0"
Set directory for \s-1PO\s0 files. Default is to search \s-1PO\s0 files in the po
subdirectory below the location of the master file.
"-o,
Set output filename (default is standard output).
"-e,
Convert encoding. Argument can take 3 values: CWutf8 (convert to
\s-1UTF-8\s0), CWpo (do not change encoding) and CWpopular (convert
encoding of input files depending on their language; the
CWPODEBCONF_ENCODINGS environment variable must point to a filename
containing the encoding map),
Such a filename looks like:
#
# Sharp is comment sign
#
cs ISO-8859-2
da ISO-8859-1
de ISO-8859-1
el ISO-8859-7
etc.
Default encoding used to be CWpopular, and has been switched to CWutf8
since po-debconf 0.9.0.
OUTPUT FORMAT
Since debconf 1.2.0, templates format has changed, encoding is part of
field names, i.e. they are CWfoo-CIlangCW.CIencodingCW. When older
debconf encounter such fields, they are silently ignored, which means
that original text is displayed.
If present, a po/output file can override defaults for encoding and
output format. It contains a single line, first field is output format
(currently valid values are 1 for fields in the form CWfoo-CIlangCW,
and 2 for CWfoo-CIlangCW.CIencodingCW) and second field is encoding, e.g.
echo '2 utf8' > po/output
let po2debconf convert text to \s-1UTF-8\s0.
When encoding is set to CWpo or CWutf8, output format is always set to
2, so that older debconf do not try to display text with wrong
encodings.
SEE ALSO
debconf-gettextize(1),
debconf-updatepo(1),
po-debconf(7).
AUTHOR
Denis Barbier <barbier@linuxfr.org>
