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