deb822

BEZEICHNUNG

BESCHREIBUNG

SYNTAX

Jeder Absatz besteht aus einer Reihe von Datenfeldern. Jedes Feld besteht aus dem Feldnamen, gefolgt von einem Doppelpunkt (U+003A bq:') und den Daten/Werten, die dem Feld zugeordnet sind. Der Feldname besteht aus US-ASCII-Zeichen, außer den Steuerzeichen, dem Leerzeichen und dem Doppelpunkt (d.h. Zeichen in den Bereichen U+0021 bq!' bis U+0039 bq9' und U+003B bq;' bis U+007E bq~' einschließlich). Feldnamen dürfen nicht mit dem Kommentarzeichen (U+0023 bq#') oder dem Gedankenstrich (U+002D bq-') beginnen.

Das Feld endet am Zeilenende oder am Ende der letzten Fortsetzungszeile (siehe unten). Horizontaler Leerraum (U+0020 LEERZEICHEN und U+0009 TABULATOR) können sofort nach oder vor dem Wert vorkommen und werden dort ignoriert; als Konvention wird ein einzelnes Leerzeichen nach dem Doppelpunkt gesetzt. Ein Feld könnte beispielsweise sein:

Package: dpkg

Leere Feldwerte sind nur in Quellpaket-Steuerdateien (debian/control) erlaubt. Solche Felder werden ignoriert.

Ein Absatz darf nicht mehr als ein Vorkommen eines bestimmten Feldnamens enthalten.

Es gibt drei Arten von Feldern:

simple

Ein Feld, einschließlich des Wertes, muss eine einzelne Zeile sein. Falten (Umbrechen) des Feldes ist nicht erlaubt. Dies ist der Standardtyp, falls die Definition des Feldes nicht einen anderen Typ spezifiziert.

folded

Der Wert des gefalteten Feldes ist eine logische Zeile, die sich über mehrere Zeilen erstrecken kann. Die Zeilen nach der ersten werden Fortsetzungszeilen genannt und müssen mit einem U+0020 LEERZEICHEN oder U+0009 TABULATOR beginnen. Leerraum, darunter Zeilenumbrüche, ist für die Feldwerte gefalteter Zeilen nicht signifikant.

Diese Faltmethode ist ähnlich RFC5322 und erlaubt Steuerdateien, die nur einen Absatz und keine mehrzeiligen Absätze, die von für RFC5322 geschriebenen Auswertprogrammen eingelesen werden müssen, enthalten.

multiline

Der Wert eines mehrzeiligen Feldes darf mehrere Fortsetzungszeilen enthalten. Die erstes des Wertes, der Teil der auf der gleichen Zeile wie der Feldname ist, hat oft eine spezielle Bedeutung oder könnte leer sein müssen. Weitere Zeilen werden hinzugefügt und folgen der gleichen Syntax wie die Fortsetzungszeilen von anderen gefalteten Feldern. Leerraum, inklusive Zeilenumbrüchen, ist im Wert von mehrzeiligen Feldern signifikant.

Leerraum darf nicht innerhalb von Namen (von Paketen, Architekturen, Dateien oder sonstigem) oder Versionsnummern oder zwischen den Zeichen einer Mehrzeichenversionsbeziehung auftauchen.

Die Existenz und der Zweck eines Feldes und die Syntax seines Wertes können zwischen den Arten der Steuerdateien variieren.

Die Groß-/Kleinschreibung ist bei Feldnamen nicht relevant, aber normalerweise wird die Großschreibung eines Feldes in der unten gezeigten gemischten Weise vorgenommen. Bei den Feldwerten ist die Groß-/Kleinschreibung relevant, außer die Beschreibung sagt etwas anderes.

Absatztrenner (leere Zeilen) und Zeilen, die nur aus U+0020 LEERZEICHEN und U+0009 TABULAOREN bestehen sind in Feldwerten oder zwischen Feldern nicht erlaubt. Leere Zeilen und Feldwerte werden normalerweise maskiert, indem sie durch ein U+0020 LEERZEICHEN gefolgt von einem Satzpunkt (U+002E bq.') dargestellt werden.

Zeilen, die mit U+0023 bq#' ohne ein vorangestellten Leerraum beginnen, sind Kommentarzeilen, die nur in Quellpaketsteuerdateien (debian/control) und in deb-origin(5)-Dateien erlaubt sind. Diese Kommentarzeilen werden ignoriert, selbst zwischen zwei Fortsetzungszeilen. Sie beenden keine logischen Zeilen.

Alle Steuerdateien müssen in UTF-8 kodiert sein.  

SIEHE AUCH

ÜBERSETZUNG

Index

BEZEICHNUNG

BESCHREIBUNG

SYNTAX

SIEHE AUCH

ÜBERSETZUNG