NAMN¶

Locale::Po4a::Pod - konvertera POD-data från/till PO-filer

SYNOPSIS¶

    use Locale::Po4a::Pod;
    my $parser = Locale::Po4a::Pod->new();
    # Read POD from STDIN and write to STDOUT.
    $parser->parse_from_filehandle;
    # Read POD from file.pod and write to file.txt.
    $parser->parse_from_file ('file.pod', 'file.txt');

BESKRIVNING¶

Locale::Po4a::Pod är ett modul som hjälper till att översätta dokumentation i POD-format (det föredragna språket för att dokumentera Perl) till andra [mänskliga] språk.

En ny SimplePod-parser är nu tillgänglig. Överväg att använda den istället för det nuvarande Pod-modulet. Om du stöter på några buggar skulle vi uppskatta om du rapporterar dem.

Ovanstående varningsmeddelande kommer att visas under en övergångsperiod. För att inaktivera det, ställ in flaggan C-<no-warn-simple>.

STATUS FÖR DENNA MODUL¶

Jag tycker att den här modulen är mycket stabil, och det finns bara en känd bugg med /usr/lib/perl5/Tk/MainWindow.pod (och några andra sidor, se nedan) som innehåller:

  C<" #n">

Oturen ville att detta i po4a-versionen delades upp på två rader på grund av radbrytningen. Som ett resultat innehåller man-sidan i originalversionen:

 " #n"

och min innehåller:

 "" #n""

vilket är logiskt eftersom C<foobar> omskrivs till "foobar".

Komplett lista över sidor som har detta problem på min dator (av 564 sidor; observera att det beror på den valda radbrytningskolumnen):

 /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

INTERNA DELAR¶

Som en härledd klass från Pod::Parser stöder Locale::Po4a::Pod samma metoder och gränssnitt. Se Pod::Parser för alla detaljer; kortfattat skapar man en ny parser med "Locale::Po4a::Pod->new()" och anropar sedan antingen parse_from_filehandle() eller parse_from_file().

SE ÄVEN¶

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

UPPHOVSPERSONER¶

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

UPPHOVSRÄTT OCH LICENS¶

Copyright © 2002 SPI, Inc.

Detta program är fri programvara; du får distribuera och/eller modifiera det enligt villkoren i GPL v2.0 eller senare (se filen COPYING).