
        *****************************************************
        *           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 ficheiros PO, com
Pod::Simple

=head1 RESUMO

  [po4a_paths] /path/to/pot $lang:/path/to/po
  [type:SimplePod] /path/to/source.pod $lang:/path/to/localized.pod

ou

  [po4a_paths] /path/to/pot $lang:/path/to/po
  [po4a_alias:pod] SimplePod
  [type:pod] /path/to/source.pod $lang:/path/to/localized.pod

=head1 DESCRIÇÃO

Isto é um módulo para ajudar a tradução da documentação em formato POD (o
idioma preferido para documentar Perl) em outras línguas humanas.

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

=over

=item *

O formato SimplePod nunca inclui novas linhas adicionais nas mensagens a
traduzir.  O formato Pod atual, no entanto, pode conter novas linhas extra,
em particular em entradas de mensagens literais.

=item *

Parágrafos podem ser renderizados com dobragem de linha.  O módulo
L<Pod::Parser> pode aplicar manuseamento especial para dobragem de linha,
tornando isso difícil de replicar com o L<Pod::Simple>.  No entanto, o
L<Pod::Simple> parece produzir resultados mais naturais .

=item *

No SimplePod, a mensagem C<=for> (ex. C<=for comment text>) não inclui um
nome de formato (tal como C<comment>), assim a mensagem consiste apenas de
texto.  Em contraste, o formato Pod atual retêm o nome de formato,
resultando numa mensagem tipo C<comment text>.  O comportamento anterior é
considerado mais confortável para tradutores.

=item *

Entradas como a de baixo, que denotam C<=end comment>, já não estão
presentes como se via no módulo Pod atual.  Como estas não são mensagens
traduzíveis, a sua ausência é uma melhoria.

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

=item *

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

=item *

A secção parâmetro C<=begin> não é mais sujeita a tradução.  No módulo Pod
atual, é incluída.  Se existir uma obrigação de a incluir na tradução, por
favor reporte isso.

=back

=head1 ESTADO DESTE MÓDULO

Este módulo é ainda um novo desenvolvimento, assim menos estável que o
L<Locale::Po4a::Pod>.  Ele continua a evoluir, e há espaço para mais
melhoramentos.  O seu comportamento pode mudar com o tempo, e podem ser
introduzidas opções adicionais para melhor optimizar a experiência de
tradução para os utilizadores.  O feedback e casos de uso de aplicações do
mundo real irão ter um papel chave em guiar o seu futuro desenvolvimento.

O código é totalmente coberto pela nossa suite de teste, e não conhecemos
nenhuns bugs existentes.  No entanto, até 2025, não foi testado na batalha
de fluxos de trabalho de traduções no mundo real por projetos externos.
Dito isto, acreditamentos que o módulo está pronto para uso produtivo, mesmo
que alguns bugs sejam inevitavelmente descobertos ao ganhar uma adoção mais
ampla.

Este módulo destina-se a substituir o atual módulo L<Locale::Po4a::Pod>.  A
razão é que L<Pod::Parser>, o qual é usado pelo actual L<Locale::Po4a::Pod>,
está agora descontinuado, e é recomendado usar L<Pod::Simple> em vez deste.
Veja também 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 DIREITOS DE AUTOR E LICENÇA

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

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