
        *****************************************************
        *           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

1;

__END__

=head1 NOME

Locale::Po4a::SimplePod - converte dados POD de/para arquivos PO, com
Pod::Simple

=head1 SINOPSE

  [po4a_paths] /caminho/para/pot $lang:/caminho/para/po
  [type:SimplePod] /caminho/para/fonte.pod $lang:/caminho/para/localizado.pod

ou

  [po4a_paths] /caminho/para/pot $lang:/caminho/para/po
  [po4a_alias:pod] SimplePod
  [type:pod] /caminho/para/fonte.pod $lang:/caminho/para/localizado.pod

=head1 DESCRIÇÃO

Este é um módulo para ajudar a tradução de documentação no formato POD (a
linguagem preferido para documentar Perl) para outros idiomas.

As principais diferenças entre o formato Pod atual e o formato SimplePod são
as seguintes:

=over

=item *

O formato SimplePod nunca inclui quebras de linha adicionais em mensagens a
serem traduzidas. O formato Pod atual, no entanto, pode conter quebras de
linha extras, principalmente em entradas de mensagens literais.

=item *

Parágrafos podem ser renderizados com quebra de linha. O módulo
L<Pod::Parser> pode aplicar um tratamento especial para quebra de linha,
dificultando a replicação com L<Pod::Simple>. No entanto, L<Pod::Simple>
parece produzir uma saída mais natural.

=item *

No SimplePod, a mensagem C<=for> (por exemplo, C<=for comment text>) não
inclui um nome de formato (como C<comment>), portanto, a mensagem consiste
apenas em texto. Em contraste, o formato Pod atual mantém o nome do formato,
resultando em uma mensagem como C<comment text>. O comportamento anterior é
considerado mais confortável para tradutores.

=item *

Entradas como a abaixo, que denotam C<=end comment>, não estão mais
presentes como visto no módulo Pod atual. Como essas mensagens não são
traduzíveis, sua ausência é uma melhoria.

  #. type: =end
  #: sample.pod:10
  msgid "comment"
  msgstr ""

=item *

Blocos de texto cuja validade do formato POD é incerta agora são tratados
como C<no-wrap>. Isso se aplica, por exemplo, ao conteúdo dentro de um bloco
C<=begin html>. No módulo Pod, eles não eram tratados como C<no-wrap>, o que
às vezes resultava em quebra de linha.

=item *

A seção de parâmetros C<=begin> não está mais sujeita à tradução. No módulo
Pod atual, ela está incluída. Se houver demanda para incluí-la na tradução,
por favor, informe.

=back

=head1 ESTADO DESTE MÓDULO

Este módulo ainda é um módulo recém-desenvolvido, portanto, é menos estável
que o L<Locale::Po4a::Pod>. Ele continua a evoluir e há espaço para mais
refinamentos. Seu comportamento pode mudar com o tempo, e opções adicionais
podem ser introduzidas para otimizar melhor a experiência de tradução para
os usuários. Feedbacks e casos de uso de aplicações reais desempenharão um
papel fundamental na orientação de seu desenvolvimento futuro.

O código é totalmente coberto pelo nosso conjunto de testes e não temos
conhecimento de nenhum bug existente. No entanto, até 2025, ele não havia
sido testado em fluxos de trabalho de tradução reais por projetos
externos. Dito isso, acreditamos que o módulo está pronto para uso em
produção, mesmo que alguns bugs possam ser inevitavelmente descobertos à
medida que for sendo adotado mais amplamente.

This module is intended to replace the current L<Locale::Po4a::Pod> module.
The reason is that L<Pod::Parser>, which is used by the current
L<Locale::Po4a::Pod>, is now deprecated, and it is recommended to use
L<Pod::Simple> instead.  See also L<GitHub issue #256 "Consider migrating
away from deprecated
C<Pod::Parser>"|https://github.com/mquinson/po4a/issues/256>.

=head1 VEJA TAMBÉM

L<Pod::Simple>, L<Locale::Po4a::Pod>, L<Locale::Po4a::TransTractor>,
L<po4a(7)|po4a.7>, L<Locale::Po4a::SimplePod::Parser>.

=head1 AUTORES

  gemmaro <gemmaro.dev@gmail.com>


=head1 TRADUÇÃO

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

=head1 COPYRIGHT E LICENÇA

  Copyright (C) 2025 gemmaro <gemmaro.dev@gmail.com>.

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