.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "PO2DEBCONF 1"
.TH PO2DEBCONF 1 "2020-12-30" "" "po-debconf"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NOME"
.IX Header "NOME"
po2debconf \- combinar o ficheiro mestre templates e os ficheiros \s-1PO\s0
.SH "SINOPSE"
.IX Header "SINOPSE"
\&\fBpo2debconf\fR [\fB\-v\fR] [\fB\-h\fR] [\fB\-\-podir=\f(BI\s-1DIR\s0\fB\fR] [\fB\-o \f(BI\s-1FILE\s0\fB\fR] [\fB\-e
\&\f(BI\s-1STRING\s0\fB\fR] \fImaster\fR
.SH "DESCRIÇÃO"
.IX Header "DESCRIÇÃO"
Este programa lê todos os ficheiros \s-1PO\s0 e um único ficheiro \fItemplates\fR, e
produz um ficheiro templates de Debconf contendo todas as traduções, similar
ao produzido por \fBdebconf\-mergetemplate\fR\|(1) (do pacote
\&\f(CW\*(C`debconf\-utils\*(C'\fR). Os ficheiros \s-1PO,\s0 por omissão, são procurados no
sub\-directório abaixo da localização do ficheiro mestre.
.PP
Para ajudar na transição do código do idioma para o Norueguês Bokmål,
os códigos de idioma \fBno\fR e \fBnb\fR são lidados de forma especial.  Se o
\&\fIno.po\fR existir, deve ser renomeado para \fInb.po\fR. Utilizar o \fInb.po\fR
tornará ambas as traduções \f(CW\*(C`\-no\*(C'\fR e \f(CW\*(C`\-nb\*(C'\fR disponíveis no ficheiro
templates.
.PP
As linhas que começam por um símbolo cardinal (\f(CW\*(C`#\*(C'\fR) são comentários nos
ficheiros templates. Estes são úteis para darem dicas aos tradutores, e são
descartados pelo \fBpo2debconf\fR.  No \f(CW\*(C`po\-debconf\*(C'\fR 1.0. foram introduzidos
comentários especiais sob a forma \f(CW\*(C`#flag:\f(CIdirective\f(CW\*(C'\fR.  A \f(CW\*(C`#flag:partial\*(C'\fR
é a única directiva interpretada pelo \fBpo2debconf\fR.  Normalmente quando um
campo é composto por vários parágrafos (como \f(CW\*(C`_\|_Choices\*(C'\fR e
\&\f(CW\*(C`_Description\*(C'\fR), é traduzido se todos os parágrafos estiverem
traduzidos. Quando um campo contiver \f(CW\*(C`#flag:partial\*(C'\fR, as mensagens
traduzidas podem ser misturadas com mensagens não traduzidas.
.SH "OPÇÕES"
.IX Header "OPÇÕES"
.IP "\fB\-h\fR, \fB\-\-help\fR" 4
.IX Item "-h, --help"
Mostrar um resumo de utilização e sair.
.IP "\fB\-v\fR, \fB\-\-verbose\fR" 4
.IX Item "-v, --verbose"
Processar em modo detalhado.
.IP "\fB\-\-podir=\f(BI\s-1DIR\s0\fB\fR" 4
.IX Item "--podir=DIR"
Definir o directório para os ficheiros \s-1PO.\s0 É pré\-definido procurar ficheiros
\&\s-1PO\s0 no sub\-directório \fIpo\fR abaixo da localização do ficheiro mestre.
.IP "\fB\-o\fR, \fB\-\-output=\f(BI\s-1FILE\s0\fB\fR" 4
.IX Item "-o, --output=FILE"
Definir o nome do ficheiro da saída (o predefinido é a saída standard).
.IP "\fB\-e\fR, \fB\-\-encoding=\f(BI\s-1STRING\s0\fB\fR" 4
.IX Item "-e, --encoding=STRING"
Converter a codificação. O argumento pode tomar 3 valores: \f(CW\*(C`utf8\*(C'\fR
(converter para \s-1UTF\-8\s0), \f(CW\*(C`po\*(C'\fR (não alterar a codificação) e \f(CW\*(C`popular\*(C'\fR
(converter a codificação dos ficheiros de entrada de acordo com o seu
idioma; a variável de ambiente \f(CW\*(C`PODEBCONF_ENCODINGS\*(C'\fR tem de apontar para um
nome dum ficheiro que contenha o mapa de codificação),
.Sp
Tal nome de ficheiro parece-se com:
.Sp
.Vb 7
\&  #
\&  #   O cardinal é o símbolo dos comentários
\&  #
\&  cs       ISO\-8859\-2
\&  da       ISO\-8859\-1
\&  de       ISO\-8859\-1
\&  el       ISO\-8859\-7
.Ve
.Sp
etc.
.Sp
A codificação pré\-definida costumava ser \f(CW\*(C`popular\*(C'\fR, mas desde o po-debconf
0.9.0 foi mudada para \f(CW\*(C`utf8\*(C'\fR.
.SH "FORMATO DE SAÍDA"
.IX Header "FORMATO DE SAÍDA"
Desde o debconf 1.2.0, o formato dos templates foi alterado, a codificação é
parte dos nomes de campos, i.e. estes são \f(CW\*(C`foo\-\f(CIlang\f(CW.\f(CIencoding\f(CW\*(C'\fR.
Quando versões mais antigas do debconf encontram esses campos, estes são
simplesmente ignorados, o que significa que o texto é mostrado.
.PP
Se estiver presente, o ficheiro \fIpo/output\fR pode ultrapassar as
pré\-definições para a codificação e para o formato de saída.  Contém uma
única linha com dois campos. O primeiro campo é o formato de saída
(actualmente os valores válidos são 1 para campos no formato \f(CW\*(C`foo\-\f(CIlang\f(CW\*(C'\fR,
e 2 para \f(CW\*(C`foo\-\f(CIlang\f(CW.\f(CIencoding\f(CW\*(C'\fR) e o segundo campo é a codificação, e.g.
.PP
.Vb 1
\&   echo \*(Aq2 utf8\*(Aq > po/output
.Ve
.PP
deixar <po2debconf> converter texto para \s-1UTF\-8.\s0
.PP
Quando a codificação está definida para \f(CW\*(C`po\*(C'\fR ou \f(CW\*(C`utf8\*(C'\fR, o formato de saída
é sempre definido como 2, para que a versão antiga do debconf não tente
mostrar texto com codificações erradas.
.SH "VEJA TAMBÉM"
.IX Header "VEJA TAMBÉM"
\&\fBdebconf\-gettextize\fR\|(1), \fBdebconf\-updatepo\fR\|(1), \fBpo\-debconf\fR\|(7).
.SH "AUTOR"
.IX Header "AUTOR"
.Vb 1
\&  Denis Barbier <barbier@linuxfr.org>
.Ve