
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NOME

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

=head1 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');

=head1 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 L<SimplePod|Locale::Po4a::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 C<no-warn-simple>.

=head1 ESTADO DESTE MÓDULO

Eu penso que este módulos está bem consolidado, e há apenas um erro
conhecido com F</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 CE<lt>foobarE<gt> é 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

=head1 INTERNO

Como uma classe derivada de Pod::Parser, Locale::Po4a::Pod tem suporte aos
mesmos métodos e interfaces. Veja L<Pod::Parser> para todos os detalhes. De
forma resumida, cria-se um novo analisador com C<< Locale::Po4a::Pod->new()
>> e, então, chama-se parse_from_filehandle() ou parse_from_file().

=head1 VEJA TAMBÉM

L<Pod::Parser>, L<Locale::Po4a::Man(3pm)>,
L<Locale::Po4a::TransTractor(3pm)>, L<po4a(7)|po4a.7>

=head1 AUTORES

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


=head1 TRADUÇÃO

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

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