LOCALE::PO4A::POD.3PM(1)                   User Contributed Perl Documentation


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

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

           # Le o POD a partir da STDIN e escreve para STDOUT.
           $parser->parse_from_filehandle;

           # Le POD do arquivo.pod e escreve para arquivo.txt.
           $parser->parse_from_file ('arquivo.pod', 'arquivo.txt');

DESCRICAO
       Locale::Po4a::Pod e um modulo para ajudar a traducao de documentacao no
       formato POD (a linguagem preferido para documentar Perl) para outros
       idiomas.

       Um novo analisador SimplePod ja esta disponivel. Considere usa-lo em
       vez do modulo Pod atual. Se encontrar algum bug, seus relatorios serao
       muito apreciados.

       A mensagem de aviso acima sera exibida por um periodo transitorio. Para
       desativa-la, defina a opcao "no-warn-simple".

ESTADO DESTE MODULO
       Eu penso que este modulos esta bem consolidado, e ha apenas um erro
       conhecido com /usr/lib/perl5/Tk/MainWindow.pod (e alguns outras
       paginas, veja abaixo), o qual contem:

         C<" #n">

       Por falta de sorte, na versao do po4a, isso foi divido no espaco pelo
       dimensionamento. Como resultado, na versao original, a pagina man
       contem:

        " #n"

       e o meu contem:

        "" #n""

       o qual faz sentido, ja que C<foobar> e reescrito como "foobar".

       Lista completa de paginas com esse problema na minha caixa (de 564
       paginas; 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 metodos e interfaces. Veja Pod::Parser para todos os
       detalhes. De forma resumida, cria-se um novo analisador com
       "Locale::Po4a::Pod->new()" e, entao, chama-se parse_from_filehandle()
       ou parse_from_file().

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

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

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

COPYRIGHT E LICENCA
       Copyright (C) 2002 SPI, Inc.

       Esse programa e um software livre; voce pode redistribui-lo e/ou
       modifica-lo sob os termos da GPL v2.0 ou posterior (veja o arquivo
       COPYING).

perl v5.42.0                      2025-11-22          LOCALE::PO4A::POD.3PM(1)