LOCALE::PO4A::POD.3PM(1)

NAAM
Locale::Po4a::Pod - POD-data van/naar PO-bestanden converteren

OVERZICHT
    use Locale::Po4a::Pod;
    my $parser = Locale::Po4a::Pod->new();

    # POD lezen uit STDIN en schrijven naar STDOUT.
    $parser->parse_from_filehandle;

    # POD lezen uit bestand.pod en schrijven naar bestand.txt.
    $parser->parse_from_file ('bestand.pod', 'bestand.txt');

BESCHRIJVING
Locale::Po4a::Pod is een module ter ondersteuning van de vertaling van documentatie in de POD-indeling (de voorkeurtaal bij het documenteren van Perl) naar andere [menselijke] talen.

STATUS VAN DEZE MODULE
Ik denk dat deze module extreem stabiel is, en er is enkel één bekende bug met /usr/lib/perl5/Tk/MainWindow.pod (en enkele andere pagina's, zie hieronder), welke het volgende bevat:

  C<" #n">

Bij gebrek aan geluk werd dit in de po4a-versie gesplitst op de spatie. Als gevolg daarvan bevat de man-pagna in de originele versie:

 " #n"

en bevat mijn versie:

 "" #n""

hetgeen logisch is, want C<foobar> wordt geconverteerd als "foobar".

Volledige lijst van pagina's die dit probleem hebben op mijn computer (van 564 pagina's; merk op dat het afhangt van de gekozen kolom waarop de regel afgebroken wordt):

 /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

BINNENWERK
Als een afgeleide klasse van Pod::Parser, ondersteunt Locale::Po4a::Pod dezelfde methodes en interfaces. Zie Pod::Parser voor alle details; in het kort: men creëert een nieuwe ontleder met "Locale::Po4a::Pod->new()" en aanroept daarna ofwel parse_from_filehandle() of parse_from_file().

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

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

COPYRIGHT EN LICENTIE
Copyright © 2002 SPI, Inc.

Dit programma is vrije software; u kunt het verder verspreiden en/of aanpassen onder de bepalingen van de GPL v2.0 of recenter (zie het bestand COPYING).