
        *****************************************************
        *           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

po4a-updatepo - aktualisiert die Übersetzung (im PO-Format) einer Dokumentation

=head1 ÜBERSICHT

B<po4a-updatepo> B<-f> I<fmt> (B<-m> I<Master.dok>)+ (B<-p> I<XX.po>)+

(I<XX.po> sind die Ausgaben, alles andere sind Eingaben)

=head1 BESCHREIBUNG

Das Projektziel von Po4a (PO für alles) ist es, die Übersetzung (und interessanter, die Wartung der Übersetzung) zu vereinfachen, indem die Gettext-Werkzeuge auch für Gebiete verwendet werden, wo diese nicht erwartet werden, wie Dokumentation.

Das Skript B<po4a-updatepo> ist dafür verantwortlich, die PO-Dateien zu aktualisieren, um die Änderungen an der Originaldatei wiederzugeben. Dafür konvertiert es die Dokumentationsdatei in eine POT-Datei und ruft L<msgmerge(1)> mit dieser neuen POT-Datei und den bereitgestellten PO-Dateien auf.

Es ist möglich, mehr als eine PO-Datei (falls Sie mehrere Sprachen gleichzeitig aktualisieren möchten) und mehrere Dokumentationsdateien anzugeben (falls Sie die Übersetzung mehrere Dokumente in der gleichen PO-Datei speichern möchten).

Falls im Master-Dokument nicht ASCII-Zeichen vorkommen, wird dieses Skript die PO-Dateien nach UTF-8 konvertieren (falls sie dies nicht bereits waren), um Zeichen außerhalb des Standards transparent zu handhaben.

=head1 OPTIONEN

=over 4

=item B<-f>, B<--format>

Format der Dokumentation, mit der Sie arbeiten möchten. Verwenden Sie die Option B<--help-format>, um eine Liste der verfügbaren Formate zu erhalten.

=item B<-m>, B<--master>

Datei(en), die das zu übersetzende Master-Dokumente enthalten.

=item B<-M>, B<--master-charset>

Zeichensatz der Dateien, die das zu übersetzende Dokument enthalten. Beachten Sie, dass alle Dateien im gleichen Zeichensatz vorliegen müssen.

=item B<-p>, B<--po>

Zu aktualisierende PO-Datei(en). Falls diese Dateien noch nicht existieren werden sie mit B<po4a-updatepo> erstellt.

=item B<-o>, B<--option>

Extraoption(en), die an die Formaterweiterung übergeben werden soll. Lesen Sie die Dokumentation jeder Erweiterung für weitere Informationen über die gültigen Optionen und ihre Bedeutungen. Beispielsweise könnten Sie dem AsciiDoc-Auswerter »-o tablecells« übergeben, während der Text-Auswerter »-o tabs=split« akzeptierte.

=item B<--no-previous>

This option removes B<--previous> from the options passed to B<msgmerge>. This helps supporting old versions of B<gettext> (before v0.16).

=item B<--previous>

Diese Option fügt B<--previous> zu den an B<msgmerge> übergebenen Optionen hinzu. Dies benötigt B<gettext> 0.16 oder neuer und ist standardmäßig aktiviert.

=item B<--msgmerge-opt> I<Optionen>

Extraoptionen für B<msgmerge>(1).

=item B<-h>, B<--help>

zeigt eine kurze Hilfemeldung an

=item B<--help-format>

die von Po4a verstandenen Dokumentationsformate auflisten

=item B<-V>, B<--version>

zeigt die Version des Skripts und beendet sich

=item B<-v>, B<--verbose>

Erhöhen der Ausführlichkeit des Programms

=item B<-d>, B<--debug>

Fehlersuch- (Debug-)Informationen ausgeben

=item B<--porefs> I<Typ>[,B<wrap>|B<nowrap>]

Gibt das Referenzformat an. Das Argument I<Typ> kann entweder B<never> (keine Referenz erzeugen), B<file> (nur die Datei ohne Zeilenzahlen festlegen), B<counter> (alle Zeilennummern durch einen ansteigenden Zähler ersetzen) oder B<full> (komplette Referenzen einbinden) sein. Die Vorgabe ist »full«.

Das Argument kann von einem Komma und entweder dem Schlüsselwort B<wrap> oder B<nowrap> gefolgt werden. Referenzen werden standardmäßig auf eine einzelne Zeile geschrieben. Die Option B<wrap> bricht Referenzen über mehre Zeilen um, um die B<gettext> (B<xgettext> und B<msgmerge>) nachzuahmen. Diese Option wird in zukünftigen Veröffentlichungen die Vorgabe werden, da sie vernünftiger ist. Die Option B<nowrap> ist für Benutzer, die das alte Verhalten beibehalten möchten, verfügbar.

=item B<--wrap-po> B<no>|B<newlines>|I<Zahl> (Vorgabe: 76)

Legt fest, wie die PO-Datei umgebrochen werden soll. Dies ermöglicht die Auswahl zwischen Dateien, die schön umgebrochen sind aber zu GIT-Konflikten führen können oder Dateien, die leichter automatisch handzuhaben, aber schwerer für Menschen zu lesen sind.

Aus kosmetischen Gründen hat die Gettext-Programmsammlung in der Vergangenheit PO-Dateien in der 77.Spalte umgebrochen. Diese Option legt das Verhalten von Po4a fest. Falls auf einen numerischen Wert gesetzt, wird Po4a die PO-Datei nach dieser Spalte und nach Zeilenumbrüchen im Inhalt umbrechen. Falls auf B<newlines> gesetzt, wird Po4a die msgid und msgstr nur nach Zeilenumbrüchen im Inhalt auftrennen. Falls auf B<no> gesetzt, wird Po4a die PO-Datei überhaupt nicht umbrechen. Der Umbruch der Referenzkommentare wird mit der Option B<--porefs> gesteuert.

Beachten Sie, dass diese Option keine Auswirkung darauf hat, wie msgid und msgstr umgebrochen werden, d.h. wie Zeilenumbrüche zu dem Inhalt dieser Zeilen hinzugefügt werden.

=item B<--msgid-bugs-address> I<e-mail@adresse>

Setzt die E-Mail-Adresse, an die Fehler in den Meldungen (msgid) berichtet werden sollen. Standardmäßig haben die erstellten POT-Dateien keine »Report-Msgid-Bugs-To«-Felder.

=item B<--copyright-holder> I<Zeichenkette>

Setzt den Namen des Urhebers in den Kopfzeilen der POT-Datei. Standardmäßig ist dies »Free Software Foundation, Inc.«.

=item B<--package-name> I<Zeichenkette>

Setzt den Paketnamen für die POT-Kopfzeilen. Standardmäßig »PACKAGE«.

=item B<--package-version> I<Zeichenkette>

Setzt die Paketversion für die POT-Kopfzeilen. Standardmäßig »VERSION«.

=back

=head1 SIEHE AUCH

L<po4a-gettextize(1)>, L<po4a-normalize(1)>, L<po4a-translate(1)>, L<po4a(7)>

=head1 AUTOREN

 Denis Barbier <barbier@linuxfr.org>
 Nicolas François <nicolas.francois@centraliens.net>
 Martin Quinson (mquinson#debian.org)

=head1 URHEBERRECHT UND LIZENZ

Copyright 2002-2020 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.

