NOME

Locale::Po4a::Pod - converte documenti POD da/a file PO

SINTASSI

use Locale::Po4a::Pod;
my $parser = Locale::Po4a::Pod->new();
# Legge il file POD da STDIN e scrive su STDOUT.
$parser->parse_from_filehandle;
# Legge il file POD da file.pod e scrive su file.txt.
$parser->parse_from_file ('file.pod', 'file.txt');

DESCRIZIONE

Locale::Po4a::Pod è un modulo che aiuta la traduzione in altre lingue della documentazione in formato POD (il linguaggio preferito per la documentazione di Perl).

STATO DI QUESTO MODULO

Questo modulo è ritenuto perfettamente stabile ed è noto solo un bug:Ho un altro problema con /usr/lib/perl5/Tk/MainWindow.pod (e qualche altra pagina, vedere più avanti) che contiene:

C<" #n">

La sfortuna ha voluto che, nella versione di po4a, questo è stato mandato a capo dove c'è lo spazio. Come risultato, la versione originale, la pagina man contiene:

" #n"

e la mia contiene:

"" #n""

che è logico, dato che C<blabla> viene riscritto come "blabla".

Elenco completo delle pagine che presentano questo problema sulla mia casella (da 564 pagine; nota che dipende dalla colonna di a capo scelta):

/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

FUNZIONAMENTO INTERNO

Come classe derivata da Pod::Parser, Locale::Po4a::Pod supporta gli stessi metodi e la stessa interfaccia. Vedere anche Pod::Parser per maggiori dettagli; in breve, si crea un nuovo parser con "Locale::Po4a::Pod->new()", dopodiché si effettua una chiamata a parse_from_filehandle() o parse_from_file().

VEDERE ANCHE

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

AUTORI

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

TRADUZIONE

Danilo Piazzalunga <danilopiazza@libero.it>
Marco Ciampa <ciampix@posteo.net>

COPYRIGHT E LICENZA

Copyright © 2002 SPI, inc.

Questo programma è software libero; è lecito ridistribuirlo o modificarlo secondo i termini della licenza GPL v2.0 o successive (vedere il file COPYING).