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.