NAME¶

Locale::Po4a::Pod - konvertiert POD-Daten von/in PO-Dateien

ÜBERSICHT¶

    use Locale::Po4a::Pod;
    my $parser = Locale::Po4a::Pod->new();
    # POD von STDIN lesen und nach STDOUT schreiben.
    $parser->parse_from_filehandle;
    # POD von Datei.pod lesen und nach Datei.txt schreiben.
    $parser->parse_from_file ('Datei.pod', 'Datei.txt');

BESCHREIBUNG¶

Locale::Po4a::Pod ist ein Modul, um bei der Übersetzung von Dokumentation in dem POD-Format (dem für Perl-Dokumentierung bevorzugten Format) in andere [natürliche] Sprachen zu helfen.

Ein neues Auswertprogramm SimplePod ist jetzt verfügbar. Bitte ziehen Sie dessen Verwendung anstelle des aktuellen Pod-Moduls in Betracht. Falls Sie Fehler bemerken, wären wir für Ihre Fehlerberichte (auf Englisch) sehr dankbar.

Die obige Warnmeldung wird für eine Übergangszeit angezeigt. Um sie zu deaktivieren, setzen Sie die Option "no-warn-simple".

STATUS DIESES MODULS¶

Ich denke, dieses Modul ist stabil wie ein Felsen und es gibt nur einen bekannten Fehler mit /usr/lib/perl5/Tk/MainWindow.pod (und einigen anderen Seiten, siehe unten), in der Folgendes steht:

  C<" #n">

Durch fehlendes Glück wurde in der Po4a-Version dies beim Leerzeichen umgebrochen. Dadurch enthält die Ursprungsversion des Handbuchs:

 " #n"

Und meine enthält:

 "" #n""

was logisch ist, da C<foobar> in "foobar" umgeschrieben wird.

Vollständige Liste von Seiten, die auf meiner Maschine dieses Problem haben (von 564 Seiten, beachten Sie, dass dies von der gewählten Umbruchspalte abhängt):

 /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¶

Als abgeleitete Klasse von Pod::Parser unterstützt Locale::Po4a::Pod die gleichen Methoden und Schnittstellen. Lesen Sie Pod::Parser für alle Details; in Kürze, ein neuer Parser wird mit "Locale::Po4a::Pod->new()" erstellt und dann wird entweder parse_from_filehandle() oder parse_from_file() aufgerufen.

SIEHE AUCH¶

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

AUTOREN¶

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

URHEBERRECHT UND LIZENZ¶

Copyright © 2002 SPI, Inc.

Dieses Programm ist freie Software; Sie können es unter den Bedingungen der GPL v2.0 oder neuer (siehe die Datei COPYING) vertreiben und/oder verändern.