.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" 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 "Locale::Po4a::Pod 3pm"
.TH Locale::Po4a::Pod 3pm "2020-08-19" "Ferramentas Po4a" "Ferramentas Po4a"
.\" 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"
Locale::Po4a::Pod \- converte dados \s-1POD\s0 de/para ficheiros \s-1PO\s0
.SH "SINOPSE"
.IX Header "SINOPSE"
.Vb 2
\&    use Locale::Po4a::Pod;
\&    my $parser = Locale::Po4a::Pod\->new (sentence => 0, width => 78);
\&
\&    # Ler POD de STDIN e escrever em STDOUT.
\&    $parser\->parse_from_filehandle;
\&
\&    # Ler POD de file.pod e escrever para file.txt.
\&    $parser\->parse_from_file (\*(Aqfile.pod\*(Aq, \*(Aqfile.txt\*(Aq);
.Ve
.SH "DESCRIÇÃO"
.IX Header "DESCRIÇÃO"
Locale::Po4a:: Pod é um módulo para ajudar a tradução da documentação em
formato \s-1POD\s0 (o idioma preferido para documentar Perl) em outralíngua
[humana].
.SH "STATUS DESTE MÓDULO"
.IX Header "STATUS DESTE MÓDULO"
Eu acho que este módulo é rocha estável, e há apenas um erro conhecido com
\&\fI/usr/lib/perl5/Tk/MainWindow.pod\fR (e algumas outras páginas, veja abaixo)
que contém:
.PP
.Vb 1
\&  C<" #n">
.Ve
.PP
Falta de sorte, na versão po4a, este foi dividido no espaço por o
envolvimento. Como resultado, na versão original, a página do manual contém
.PP
.Vb 1
\& " #n"
.Ve
.PP
e a minha contém
.PP
.Vb 1
\& "" #n""
.Ve
.PP
O que é lógico desde que C<foobar> é rescrito \*(L"foobar\*(R".
.PP
Lista completa de páginas com este problema na minha caixa (de 564 páginas,
note que depende da coluna envolvida
escolhida):/usr/lib/perl5/Tk/MainWindow.pod
/usr/share/perl/5.8.0/overload.pod /usr/share/perl/5.8.0/pod/perlapi.pod
/usr/share/perl/5.8.0/pod/perldelta.pod
/usr/share/perl/5.8.0/pod/perlfaq5.pod /usr/share/perl/5.8.0/pod/perlpod.pod
/usr/share/perl/5.8.0/pod/perlre.pod /usr/share/perl/5.8.0/pod/perlretut.pod
.SH "INTERNAS"
.IX Header "INTERNAS"
Como uma classe derivada de Pod::Parser, Locale::Po4a::Pod suporta o mesmo
métodos e interfaces. Ver Pod::Parser para todos os detalhes, com
brevidade, cria um novo analisador com \f(CW\*(C`Locale::Po4a::Pod\->new()\*(C'\fR e
depois invoca também \fBparse_from_filehandle()\fR ou \fBparse_from_file()\fR.
.PP
\&\fBnovo()\fR pode tomar opções, na forma de pares chave/valor, que controlam a o
comportamento do analisador. As opções comuns reconhecidas para todos
Pod::Parser as crianças são:
.IP "\fBalt\fR" 4
.IX Item "alt"
Se for definido para um valor verdadeiro, seleciona um formato de saída
alternativo que, entre outras as coisas, usa um título de estilo diferente e
marca as entradas b<=item> com uma coluna na margem esquerda. Padrão é
falso.
.IP "\fBcode\fR" 4
.IX Item "code"
Se for definido para um valor de verdade, as partes não\-POD do ficheiro de
entrada será incluída na saída. Útil para visualização de código documentado
com blocos \s-1POD\s0 com o \s-1POD\s0 prestado e o código deixado intacto.
.IP "\fBindent\fR" 4
.IX Item "indent"
O número de espaços para texto normal recuado, e o recuo padrão para
\&\fB=over\fR blocos. Padrão é 4.
.IP "\fBloose\fR" 4
.IX Item "loose"
Se for definido para um valor de verdade, uma linha em branco é impressa
depois de um título \fB=head1\fR. Se definido como falso (o padrão), nenhuma
linha em branco é impressa após \fB=head1\fR embora um ainda é impresso após
\&\fB=head2\fR. Este é o padrão porque é a formatação esperada para as páginas de
manual, se você está a formatar documentos de texto arbitrários,
definindo-os como verdadeiro pode resultar numa saída mais agradável.
.IP "\fBquotes\fR" 4
.IX Item "quotes"
Define a citação marcada usada para cercar o texto C<>. Se o valor é um
caractere único, é utilizado como citação à esquerda e à direita, se for
dois carateres, o primeiro caratere é utilizado como a citação esquerda e a
segunda como a citação direita, e se é de quatro carateres, os dois
primeiros são usados ​​como citação esquerda e os dois últimos como a
citação direita.
.Sp
Isso também pode ser definido como o valor especial \fBnone\fR, caso em que
nenhuma citação marcada seja adicionada ao redor do texto C<>.
.IP "\fBsentence\fR" 4
.IX Item "sentence"
Se for definido para um valor verdadeiro, Locale::Po4a::Pod assumirá que
cada sentença termina em dois espaços, e vai tentar preservar esse
espaçamento. Se for definido como falso, todos os espaços consecutivos em
parágrafos não literais são comprimidos num único espaço. Padrão é
verdadeiro.
.IP "\fBwidth\fR" 4
.IX Item "width"
A coluna na qual se deseja envolver o texto no lado direito. O padrão é 76.
.SH "VER TAMBÉM"
.IX Header "VER TAMBÉM"
Pod::Parser, \fBLocale::Po4a::Man\fR\|(3pm),
\&\fBLocale::Po4a::TransTractor\fR\|(3pm), \fBpo4a\fR\|(7)
.SH "AUTORES"
.IX Header "AUTORES"
.Vb 3
\& Denis Barbier <barbier@linuxfr.org>
\& Martin Quinson (mquinson#debian.org)
\&=head1 DIREITOS DE AUTOR E LICENÇA
.Ve
.PP
Copyright © 2002 \s-1SPI,\s0 Inc.
.PP
Este programa é software livre, você pode redistribuí\-lo e/ou modificá\-lo
sob os termos da \s-1GPL\s0 (consulte o ficheiro CÓPIA).