LOCALE::PO4A::POD.3PM

Section: User Contributed Perl Documentation (1)
Updated: 2025-04-18
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].

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: 09:22:08 GMT, April 18, 2025

po4av0.73