.\" 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 "2018-12-09" "Ferramentas do Po4a" "Ferramentas do 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 arquivos \s-1PO\s0
.SH "SINOPSE"
.IX Header "SINOPSE"
.Vb 2
\&    use Locale::Po4a::Pod;
\&    my $parser = Locale::Po4a::Pod\->new (sentence => 0, width => 78);
\&
\&    # Lê um POD da STDIN e escreve para a STDOUT.
\&    $parser\->parse_from_filehandle;
\&
\&    # Lê um POD do arquivo.pod e escreve para arquivo.txt.
\&    $parser\->parse_from_file (\*(Aqarquivo.pod\*(Aq, \*(Aqarquivo.txt\*(Aq);
.Ve
.SH "DESCRIÇÃO"
.IX Header "DESCRIÇÃO"
Locale::Po4a::Pod é um módulo para ajudar a tradução de documentação no
formato \s-1POD\s0 (a linguagem preferido para documentar Perl) para outros
idiomas.
.SH "ESTADO DESTE MÓDULO"
.IX Header "ESTADO DESTE MÓDULO"
Eu penso que este módulos está bem consolidado, e há apenas um erro
conhecido com \fI/usr/lib/perl5/Tk/MainWindow.pod\fR (e alguns outras páginas,
veja abaixo), o qual contém:
.PP
.Vb 1
\&  C<" #n">
.Ve
.PP
Por falta de sorte, na versão do po4a, isso foi divido no espaço pelo
dimensionamento. Como resultado, na versão original, a página de manual
contém
.PP
.Vb 1
\& " #n"
.Ve
.PP
e o meu contém
.PP
.Vb 1
\& "" #n""
.Ve
.PP
o qual faz sentido, já que C<foobar> é reescrito como \*(L"foobar\*(R".
.PP
Uma lista completa de páginas tendo este problema no meu computador (das 564
páginas; note que depende da coluna escolhida para dimensionamento):
/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 "INTERNO"
.IX Header "INTERNO"
Como uma classe derivada de Pod::Parser, Locale::Po4a::Pod tem suporte aos
mesmos métodos e interfaces. Veja Pod::Parser para todos os detalhes. De
forma resumida, cria-se um novo analisador com \f(CW\*(C`Locale::Po4a::Pod\->new()\*(C'\fR e, então, chama-se \fBparse_from_filehandle()\fR ou \fBparse_from_file()\fR.
.PP
\&\fBnew()\fR pode receber opções, na forma de pares chave/valor, que controla o
comportamento do analisador. As opções reconhecidas a todos os filhos de
Pod::Parser:
.IP "\fBalt\fR" 4
.IX Item "alt"
Se definido com um valor verdadeiro, seleciona um formato de saída
alternativo que, dentre outras coisas, usa um estilo de cabeçalho diferente
e marca entradas \fB=item\fR com um caractere de dois-pontos (:) na margem
esquerda. O padrão é falso.
.IP "\fBcode\fR" 4
.IX Item "code"
Se definido com um valor verdadeiro, as partes não\-POD do arquivo de saída
serão incluídas na saída. Útil para visualizar o código documentado com
blocos \s-1POD\s0 com o \s-1POD\s0 renderizado e o código intacto.
.IP "\fBindent\fR" 4
.IX Item "indent"
O número de espaços para recuar (\*(L"indentar\*(R") o texto comum e o recuo padrão
para os blocos \fB=over\fR. O padrão é 4.
.IP "\fBloose\fR" 4
.IX Item "loose"
Se definido com um valor verdadeiro, uma linha em branco é mostrada após um
cabeçalho \fB=head1\fR. Se definido com falso (o padrão), nenhuma linha em
branco é exibida após \fB=head1\fR, porém uma ainda é mostrada após
\&\fB=head2\fR. Esse é o padrão porque é a formatação esperada para as páginas de
manual; Se você estiver formatando documentos de texto arbitrário, definir
isso para verdadeiro pode resultar em um resultado mais agradável.
.IP "\fBquotes\fR" 4
.IX Item "quotes"
Define os sinais de aspas para envolver textos C<>. Se o valor for um
único caractere, ele for usado em ambas aspas da esquerda e da direita; se
ele for dois caracteres, o primeiro caractere é usado como aspas da esquerda
e o segundo como a aspas da direita; e se ele for quarto caracteres, os
primeiros dois são usados como as aspas da esquerda e os dois últimos são
usados como as aspas da direita.
.Sp
Esse valor também pode ser definido com o valor especial \fBnone\fR, caso em
que aspas não são adicionadas em volta de textos C<>.
.IP "\fBsentence\fR" 4
.IX Item "sentence"
Se definido com um valor verdadeiro, Locale::Po4a::Pod vai presumir que cada
sentença termina com dois espaços e vai tentar preservar aquele
espaçamento. Se definido com falso, todos os espaços em branco consecutivos
em parágrafos não\-verbatim são comprimidos em um único espaço. O padrão é
verdadeiro.
.IP "\fBwidth\fR" 4
.IX Item "width"
A coluna na qual se deve realizar dimensionamento no lado direito. O padrão
é 76.
.SH "VEJA TAMBÉM"
.IX Header "VEJA TAMBÉM"
Pod::Parser, \fBLocale::Po4a::Man\fR\|(3pm),
\&\fBLocale::Po4a::TransTractor\fR\|(3pm), \fBpo4a\fR\|(7)
.SH "AUTORES"
.IX Header "AUTORES"
.Vb 2
\& Denis Barbier <barbier@linuxfr.org>
\& Martin Quinson (mquinson#debian.org)
.Ve
.SH "COPYRIGHT E LICENÇA"
.IX Header "COPYRIGHT E LICENÇA"
Copyright © 2002 \s-1SPI,\s0 Inc.
.PP
Esse programa é um software livre; você pode redistribuí\-lo e/ou modificá\-lo
sob os termos da \s-1GPL\s0 (veja o arquivo \s-1COPYING\s0).