LOCALE::PO4A::POD.3PM

Section: User Contributed Perl Documentation (1)
Updated: 2025-06-27
Index Return to Main Contents

NOME

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

SINOPSE

    use Locale::Po4a::Pod;
    my $parser = Locale::Po4a::Pod->new();

    # 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 ('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 outralíngua [humana].

A new SimplePod parser is now available. Please consider using it instead of the current Pod module. If you encounter any bugs, your reports would be greatly appreciated.

The above warning message will be displayed for a transitional period. To disable it, set the "no-warn-simple" option.

ESTADO DESTE MÓDULO

Acho que este módulo é rocha estável 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> é rescrito "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().

VER 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

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).

This document was created by using the manual pages.
Time: 05:03:50 GMT, June 27, 2025