
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NAME

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

=head1 ÜBERSICHT

    use Locale::Po4a::Pod;
    my $parser = Locale::Po4a::Pod->new (sentence => 0, width => 78);

    # POD von STDIN lesen und nach STDOUT schreiben
    $parser->parse_from_filehandle;

    # POD aus Datei.pod lesen und nach Datei.txt schreiben
    $parser->parse_from_file ('Datei.pod', 'Datei.txt');

=head1 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.

=head1 STATUS DIESES MODULS

Ich denke, dieses Modul ist stabil wie ein Felsen und es gibt nur einen bekannten Fehler mit F</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 enthielt die Ursprungsversion des Handbuchs 

 " #n"

und meine enthielt

 "" #n""

was logisch ist, da CE<lt>foobarE<gt> 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





=head1 INTERNA

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

new() akzeptiert Optionen in der Form von Schlüssel/Wert-Paaren, die das Verhalten des Parsers steuern. Die von allen Pod::Parser-Kindern erkannten Optionen sind:

=over 4

=item B<alt>

Falls dies auf einen wahren Wert gesetzt wird, wird unter anderem ein alternatives Ausgabeformat ausgewählt, ein anderer Stil für Überschriften gewählt und B<=item>-Einträge mit einem Doppelpunkt in der linken Spalte markiert. Standardmäßig »false«.

=item B<code>

Falls dies auf einen wahren Wert gesetzt wird, wird der nicht POD-Teil der Eingabedatei in der Ausgabe eingeschlossen. Nützlich, um Code, der mit POD-Blöcken dokumentiert ist, mit dem dargestellten POD und dem inktakt verbliebenen Code anzuschauen.

=item B<indent>

Die Anzahl der Leerzeichen, um regulären Text einzurücken sowie die Vorgabe für die Einrückung für B<=over>-Blöcke. Standardmäßig 4.

=item B<loose>

Falls dies auf einen wahren Wert gesetzt wird, wird eine Leerzeile nach einer B<=head>-Zeile ausgegeben. Falls auf den Standardwert »false« gesetzt, wird keine Leerzeile nach B<=head1> ausgegeben, obwohl nach B<=head2> weiterhin eine ausgegeben wird. Dies ist die Vorgabe, da dies der bei Handbuchseiten erwarteten Formatierung entspricht; falls Sie beliebige Texte formatieren, könnte das Setzen auf »true« zu einer schöneren Ausgabe führen.

=item B<quotes>

Setzt die Anführungszeichen, die CE<lt>>-Text umfassen sollen. Falls der Wert ein einzelnes Zeichen ist, wird dieses sowohl als linkes als auch als rechtes Anführungszeichen verwandt. Falls es sich um zwei Zeichen handelt, wird das erste als öffnendes Anführungszeichen (links) und das zweite als schließendes Anführungszeichen (rechts) verwandt. Falls es sich um vier Zeichen handelt, werden die ersten zwei als öffnende und die anderen zwei als schließende Anführungszeichen verwandt.

Dies kann auch auf den speziellen Wert B<none> gesetzt werden. In diesem Fall werden um CE<lt>>-Text keine Anführungszeichen gesetzt.

=item B<sentence>

Falls dies auf einen wahren Wert gesetzt wird, wird Locale::Po4a::Pod annehmen, dass jeder Satz mit zwei Leerzeichen endet und versuchen, diese Leerzeichen zu erhalten. Falls auf »false« gesetzt, werden alle direkt aufeinander folgenden Leerzeichen in Absätzen, die nicht direkt ausgegeben werden, in ein einzelnes Leerzeichen zusammengefasst. Standardmäßig »true«.

=item B<width>

Die Spalte, an der Text auf der rechten Seite umgebrochen werden soll. Standardmäßig 76.

=back

=head1 SIEHE AUCH

L<Pod::Parser>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::TransTractor(3pm)>, L<po4a(7)|po4a.7>

=head1 AUTOREN

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

=head1 URHEBERRECHT UND LIZENZ

Copyright © 2002 SPI, Inc.

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

