summaryrefslogtreecommitdiffstats
path: root/man/de/deb-changes.pod
blob: daaaea1ee2e631d303812d4283ca25c874bbe23c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
        *****************************************************
        *           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 BEZEICHNUNG

dpkg-genchanges - Format der Upload-Changes-Datei von Debian

=head1 ÜBERSICHT

I<Dateiname>B<.changes>

=head1 BESCHREIBUNG

Jeder Debian-Upload besteht aus einer .changes-Steuerdatei, die eine Reihe von Feldern im L<deb822(5)>-Format enthält.

Jedes Feld beginnt mit einer Markierung wie B<Source> oder B<Binary> (Groß-/Kleinschreibung ist egal), gefolgt von einem Doppelpunkt und dem Inhalt des Feldes (Groß-/Kleinschreibung ist relevant, außer anders angegeben). Felder werden nur durch Feldmarkierungen abgegrenzt. Mit anderen Worten: Der Feldtext kann sich über mehrere Zeilen erstrecken, wobei die Installationswerkzeuge die Zeilen bei der Verarbeitung des Feldinhaltes zusammenfügen werden (Ausnahmen sind die mehrzeiligen Felder B<Description>, B<Changes>, B<Files>, B<Checksums-Sha1> und B<Checksums-Sha256>, siehe unten).

Die Steuerdaten können in eine Signatur mit einer wie in RFC4880 spezifizierten OpenPGP-ASCII-Hülle eingeschlossen sein.

=head1 FELDER

=over 

=item B<Format:> I<Formatversion> (verpflichtend)

Der Wert dieses Feldes gibt die Formatversion der Datei an. Die Syntax des Feldwertes ist eine Versionsnummer mit einer Haupt- und einer Nebenkomponente. Rückwärtsinkompatible Änderungen im Format führen zu einer Erhöhung der Hauptversion und rückwärtskompatible Änderungen (wie die Aufnahme neuer Felder) führen zu einer Erhöhung der Nebenversion. Die aktuelle Formatversion ist B<1.8>.

=item B<Date:> I<Veröffentlichungsdatum> (verpflichtend)

Das Datum, an dem das Paket letztmalig gebaut oder bearbeitet wurde. Es muss im gleichen Format wie in einem Eintrag bei L<deb-changelog(5)> sein.

Der Wert dieses Feldes wird normalerweise aus der Datei I<debian/changelog> entnommen.

=item B<Source:> I<Quellname> [B<(>I<Quellversion>B<)>] (verpflichtend)

Der Name des Quellpakets. Falls sich die Quellversion von der Binärversion unterscheidet, folgt dem I<Quellname>n in Klammern eine I<Quellversion>. Dies kann passieren, falls dies ein rein-binärer nicht-Betreuer-Upload ist.

=item B<Binary:> I<Binärpaketliste> (verpflichtend im Kontext)

Dieses gefaltete Feld ist eine durch Leerzeichen getrennte Liste von hochzuladenden binären Paketen. Falls es sich um einen reinen Quell-Upload handelt, wird dieses Feld ausgelassen (seit Dpkg 1.19.3).

=item B<Architecture:> I<Architekturliste>

Listet die Architekturen der derzeit hochgeladenen Dateien auf. Geläufige Architekturen sind B<amd64>, B<armel>, B<i386>, usw. Beachten Sie, dass der Wert B<all> für Pakete gedacht ist, die Architektur-unabhängig sind. Falls die Quellen für das Paket auch hochgeladen werden, ist der besondere Eintrag B<source> auch vorhanden. Architektur-Platzhalter dürfen in der Liste niemals auftauchen.

=item B<Version:> I<Versionszeichenkette> (verpflichtend)

Typischerweise ist das die Original-Paketversionsnummer, in der Form, die der Programmautor verwendet. Es kann auch eine Debian-Revisionsnummer enthalten (für nicht aus Debian stammende Pakete). Das genaue Format und der Sortieralgorithmus sind in L<deb-version(7)> beschrieben.

=item B<Distribution:> I<Distribution>en (verpflichtend)

Listet eine oder mehrere durch Leerzeichen getrennte Distributionen auf, bei denen diese Version installiert werden sollte, wenn es in das Archiv hochgeladen wird.

=item B<Urgency:> I<Dringlichkeit> (empfohlen)

Die Dringlichkeit des Uploads. Die derzeit bekannten Werte, in aufsteigender Reihenfolge der Dringlichkeit, sind: B<low>, B<medium>, B<high>, B<critical> und B<emergency>.

=item B<Maintainer:> I<Vollständiger-Name-und-E-Mail> (verpflichtend)

Sollte in dem Format „Joe Bloggs E<lt>jbloggs@example.orgE<gt>“ sein und ist typischerweise die Person, die das Paket erstellt hat, im Gegensatz zum Autor der Software, die paketiert wurde.

=item B<Changed-By:> I<Vollständiger-Name-und-E-Mail>

Sollte in dem Format „Joe Bloggs E<lt>jbloggs@example.orgE<gt>“ sein und ist typischerweise die Person, die die Änderungen für die Veröffentlichung am Paket vorgenommen hat.

=item B<Description:> (empfohlen)

=item S< >I<Binärpaketname> B<-> I<Binärpaketzusammenfassung>

Dieses mehrzeilige Feld enthält eine Liste von Binärpaketnamen, gefolgt von einem Leerzeichen, einem Bindestrich (‚B<->’) und ihren, möglicherweise abgeschnittenen, Kurzbeschreibungen. Falls es sich um einen reinen Quell-Upload handelt, wird dieses Feld ausgelassen (seit Dpkg 1.19.3).

=item B<Closes:> I<Fehlernummernliste>

Eine durch Leerzeichen getrennte Liste von Fehlerberichtsnummern von Fehlerberichten, die mit diesem Upload behoben wurden. Die Software des Distributionsarchivs könnte dieses Feld benutzen, um automatisch die Nummern der referenzierten Fehler in der Fehlerdatenbank der Distribution zu schließen.

=item B<Binary-Only: yes>

Das Feld kennzeichnet, dass der Upload ein rein binärer, nicht-Betreuer-Upload ist. Er stammt aus dem Schlüssel/Werte-Paar B<binary-only=yes> aus dem Metadateneintrag des Changelogs.

=item B<Built-For-Profiles:> I<Profilliste>

Das Feld gibt eine durch Leerraum getrennte Liste von Bauprofilen an, unter denen dieser Upload gebaut wurde.

=item B<Changes:> (verpflichtend)

=item S< >I<Changelog-Einträge>

Das mehrzeilige Feld enthält den aneinandergehängten Text aller Changelog-Einträge, die Teil dieses Uploads sind. Um ein gültiges mehrzeiliges Feld zu erhalten, werden leere Zeilen durch einen einzelnen Satzpunkt (‚.’) ersetzt und alle Zeilen mit einem Leerzeichen eingerückt. Der genaue Inhalt hängt vom Changelog-Format ab.

=item B<Files:> (verpflichtend)

=item S< >I<Md5sum> I<Größe> I<Sektion> I<Priorität> I<Dateiname>

Das mehrzeilige Feld enthält eine Liste der Dateien mit Md5sum, Größe, Sektion und Priorität für jede.

Die erste Zeile des Feldwertes (dem Teil auf der gleichen Zeile wie der von einem Doppelpunkt gefolgte Feldname) ist immer leer. Der Inhalt des Feldes wird durch Fortsetzungszeilen ausgedrückt, eine Zeile pro Datei. Jede Zeile besteht aus durch Leerzeichen getrennten Einträgen, die die Datei beschreiben: die Md5sum, die Dateigröße, die Datei-Sektion, die Datei-Priorität und der Dateiname.

Dieses Feld führt alle Dateien, die den Upload bilden, auf. Die Liste der Dateien in diesem Feld muss auf die Liste der Dateien in den anderen zugehörigen B<Checksums>-Feldern passen.

=item B<Checksums-Sha1:> (verpflichtend)

=item B<Checksums-Sha256:> (verpflichtend)

=item S< >I<Prüfsumme> I<Größe> I<Dateiname>

Diese mehrzeiligen Felder enthalten eine Liste von Dateien mit einer Prüfsumme und Größe für jede. Diese Felder haben die gleiche Syntax und unterscheiden sich nur im verwandten Prüfsummenalgorithmus: SHA-1 für B<Checksums-Sha1> und SHA-256 für B<Checksums-Sha256>.

Die erste Zeile des Feldwertes (der Teil auf der gleichen Zeile wie der durch einen Doppelpunkt gefolgte Feldname) ist immer leer. Der Inhalt des Feldes wird durch Fortsetzungszeilen ausgedrückt, eine Zeile pro Datei. Jede Zeile besteht aus durch Leerzeichen getrennten Einträgen, die die Datei beschreiben: der Prüfsumme, der Dateigröße und dem Dateinamen.

Diese Felder führen alle Dateien auf, aus denen der Upload besteht. Die Liste der Dateien in diesen Feldern muss zu der Liste in dem Feld B<Files> und den anderen zugehörigen B<Checksums>-Feldern passen.

=back

=head1 FEHLER

Das Feld B<Files> ist inkonsistent gegenüber den anderen B<Checksums>-Feldern. Die Felder B<Changed-By> und B<Maintainer> haben verwirrende Namen. Das Feld B<Distribution> enthält Informationen darüber, was normalerweise als Suite bezeichnet wird.

=head1 SIEHE AUCH

L<deb822(5)>, L<deb-src-control(5)>, L<deb-version(7)>.


=head1 ÜBERSETZUNG

Die deutsche Übersetzung wurde 2004, 2006-2023 von Helge Kreutzmann
<debian@helgefjell.de>, 2007 von Florian Rehnisch <eixman@gmx.de> und
2008 von Sven Joachim <svenjoac@gmx.de>
angefertigt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die
GNU General Public License Version 2 oder neuer für die Kopierbedingungen.
Es gibt KEINE HAFTUNG.