NOME

Locale::Po4a::Pod - converte dados POD de/para arquivos PO

SINOPSE

use Locale::Po4a::Pod;
my $parser = Locale::Po4a::Pod->new();
# Lê o POD a partir da STDIN e escreve para STDOUT.
$parser->parse_from_filehandle;
# Lê POD do arquivo.pod e escreve para arquivo.txt.
$parser->parse_from_file ('arquivo.pod', 'arquivo.txt');

DESCRIÇÃO

Locale::Po4a::Pod é um módulo para ajudar a tradução de documentação no formato POD (a linguagem preferido para documentar Perl) para outros idiomas.

Um novo analisador SimplePod já está disponível. Considere usá-lo em vez do módulo Pod atual. Se encontrar algum bug, seus relatórios serão muito apreciados.

A mensagem de aviso acima será exibida por um período transitório. Para desativá-la, defina a opção "no-warn-simple".

ESTADO DESTE MÓDULO

Eu penso que este módulos está bem consolidado, e há apenas um erro conhecido com /usr/lib/perl5/Tk/MainWindow.pod (e alguns outras páginas, veja abaixo), o qual contém:

C<" #n">

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 man contém:

" #n"

e o meu contém:

"" #n""

o qual faz sentido, já que C<foobar> é reescrito como "foobar".

Lista completa de páginas com esse problema na minha caixa (de 564 páginas; observe que depende da coluna escolhida para quebra de texto):

/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

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 "Locale::Po4a::Pod->new()" e, então, chama-se parse_from_filehandle() ou parse_from_file().

VEJA TAMBÉM

Pod::Parser, Locale::Po4a::Man(3pm), Locale::Po4a::TransTractor(3pm), po4a(7)

AUTORES

Denis Barbier <barbier@linuxfr.org>
Martin Quinson (mquinson#debian.org)

TRADUÇÃO

Luiz Fernando Ranghetti <elchevive@opensuse.org>
Rafael Fontenelle <rafaelff@gnome.org>

COPYRIGHT E LICENÇA

Copyright © 2002 SPI, Inc.

Esse programa é um software livre; você pode redistribuí-lo e/ou modificá-lo sob os termos da GPL v2.0 ou posterior (veja o arquivo COPYING).