table of contents
LOCALE::PO4A::POD.3PM(1) | User Contributed Perl Documentation | LOCALE::PO4A::POD.3PM(1) |
NOME¶
Locale::Po4a::Pod - converte dados POD de/para ficheiros PO
RESUMO¶
use Locale::Po4a::Pod; my $parser = Locale::Po4a::Pod->new(); # Read POD from STDIN and write to STDOUT. $parser->parse_from_filehandle; # Read POD from file.pod and write to file.txt. $parser->parse_from_file ('file.pod', 'file.txt');
DESCRIÇÃO¶
Locale::Po4a:: Pod é um módulo para ajudar a tradução da documentação em formato POD (o idioma preferido para documentar Perl) em outras línguas [humanas].
Um novo analisador SimplePod está agora disponível. Por favor considere usa-lo em vez do módulo Pod atual. Se encontrar quaisquer bugs, os seus relatórios serão muito apreciados.
A mensagem de aviso em cima será mostrada por um período de transição. Para a desativar, defina a opção "no-warn-simple".
ESTADO DESTE MÓDULO¶
Acho que este módulo é estável que nem rocha, e há apenas um erro conhecido com /usr/lib/perl5/Tk/MainWindow.pod (e algumas outras páginas, veja abaixo) que contém:
C<" #n">
Por falta de sorte, na versão do po4a, isto 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 que é lógico desde que C<foobar> está a rescrever "foobar".
Lista completa de páginas com este 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
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 "Locale::Po4a::Pod->new()" e depois invoca também 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)
DIREITOS DE AUTOR E LICENÇA¶
Copyright © 2002 SPI, Inc.
Este programa é um software livre; pode redistribuí-lo e/ou modificá-lo sob os termos da GPL v2.0 ou posterior (veja o ficheiro COPYING).
2025-09-14 | perl v5.40.1 |