.\" dpkg manual page - deb822(5)
.\"
.\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk>
.\" Copyright © 2015 Guillem Jover <guillem@debian.org>
.\"
.\" This is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
.
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH deb822 5 2022-05-25 1.19.7 "suite dpkg"
.nh
.SH NOM
deb822 \- Format des donn\('ees de contr\(^ole RFC822 Debian
.
.SH DESCRIPTION
Le syst\(`eme de gestion de paquets manipule des donn\('ees repr\('esent\('ees dans un
format commun, connues comme \fIdonn\('ees de contr\(^ole\fP, stock\('ees dans les
\fIfichiers de contr\(^ole\fP. Les fichiers de contr\(^ole sont utilis\('es pour les
paquets source, les paquets binaires et les fichiers \fB.changes\fP qui
contr\(^olent l'installation des fichiers t\('el\('evers\('es (les bases de donn\('ees
internes de \fBdpkg\fP sont dans un format similaire).
.
.SH SYNTAXE
Un fichier de contr\(^ole consiste en un ou plusieurs paragraphes de champs
(les paragraphes sont aussi parfois appel\('es strophes, \(Fo\ stanzas\ \(Fc). Les
paragraphes sont s\('epar\('es par des lignes vides. Les analyseurs peuvent
accepter des lignes qui ne contiennent que des caract\(`eres U+0020 \fBESPACE\fP
et U+0009 \fBTABULATION\fP comme s\('eparateurs de paragraphes, mais les fichiers
de contr\(^ole utiliseront des lignes vides. Certains fichiers de contr\(^ole
acceptent seulement un paragraphe unique, d'autres plusieurs, dans ce cas,
chaque paragraphe fait r\('ef\('erence habituellement \(`a un paquet diff\('erent. (Par
exemple, dans les paquets source, le premier paragraphe fait r\('ef\('erence au
paquet source, et les paragraphes suivants font r\('ef\('erences aux paquets
binaires cr\('e\('es \(`a partir du source.) L'ordre des paragraphes dans les
fichiers de contr\(^oles est important.

Chaque paragraphe consiste en une s\('erie de champs de donn\('ees. Chaque champ
est constitu\('e d'un nom de champ suivi de deux\-points (U+003A \(Fo\ \fB:\fP\ \(Fc), puis
les donn\('ees ou valeur associ\('ees \(`a ce champ. Le nom du champ est compos\('e de
caract\(`eres US\-ASCII \(`a l'exception des caract\(`eres de contr\(^ole, de l'espace et
des deux\-points (c'est\-\(`a dire des caract\(`eres entre U+0021 \(Fo\ \fB!\fP\ \(Fc et U+0039
\(Fo\ \fB9\fP\ \(Fc, et entre U+003B \(Fo\ \fB;\fP\ \(Fc et U+007E \(Fo\ \fB~\fP\ \(Fc compris). Les noms de
champ ne doivent pas commencer par le caract\(`ere de commentaire \(Fo\ (U+0023
\fB#\fP\ \(Fc, ni par le caract\(`ere trait d'union (U+002D \(Fo\ \fB\-\fP\ \(Fc.

Les champs se terminent \(`a la fin de la ligne ou \(`a la fin de la derni\(`ere
ligne de continuation (voir ci\-dessous). Une espace horizontale (U+0020
\fBESPACE\fP et U+0009 \fBTABULATION\fP) peut appara\(^itre imm\('ediatement avant ou
apr\(`es la valeur et est ignor\('ee dans ce cas\ ; par convention, il y une espace
unique apr\(`es les deux\-points. Par exemple, un champ pourrait \(^etre\ :
.RS
.nf
Package: dpkg
.fi
.RE
le nom du champ est \fBPackage\fP et la valeur du champ \fBdpkg\fP.

Des valeurs de champ vides ne sont permises que dans les fichiers de
contr\(^ole des paquets source (\fIdebian/control\fP). Ces champs sont ignor\('es.

Un paragraphe ne doit pas contenir plus d'une instance d'un nom de champ
particulier.

Il y a trois types de champ\ :

.RS 0
.TP 
\fBsimple\fP
Ce champ, y compris sa valeur, doit \(^etre une ligne unique. La coupure du
champ est interdite. Il s'agit du type de champ par d\('efaut lorsque la
d\('efinition du champ ne pr\('ecise pas un type diff\('erent.
.TP 
\fBcoup\('e\fP
La valeur d'un champ coup\('e (\(Fo\ folded\ \(Fc) est une ligne logique qui peut
s'\('etendre sur plusieurs lignes. Les lignes qui suivent la premi\(`ere sont
appel\('ees ligne de continuation et doivent commencer par un caract\(`ere U+0020
\fBESPACE\fP ou U+0009 \fBTABULATION\fP. Une espace, y compris les caract\(`eres saut
de ligne, n'est pas importante dans les valeurs de champ des champs coup\('es.

La m\('ethode de coupure est similaire \(`a RFC5322, permettant des fichiers de
contr\(^ole, qui contiennent seulement un paragraphe et pas des champs \(`a
plusieurs lignes, d'\(^etre lus par les analyseurs \('ecrits pour RFC5322.
.TP 
\fB\(`a lignes multiples\fP
La valeur d'un champ \(`a lignes multiples peut comprendre de multiples lignes
de continuation. La premi\(`ere ligne de la valeur, la partie sur la m\(^eme ligne
que le nom du champ, a souvent une signification particuli\(`ere ou peut devoir
\(^etre vide. Les autres lignes sont ajout\('ees avec la m\(^eme syntaxe que les
lignes de continuation des champs coup\('es. Une espace, y compris les
caract\(`eres saut de ligne, est importante dans les valeurs des champs \(`a
lignes multiples.
.RE

Aucune espace ne doit appara\(^itre dans les noms (de paquet, d'architecture,
de fichier ou n'importe quoi d'autre) ou les num\('eros de version, ou entre
les caract\(`eres des relations des versions multi\-caract\(`eres.

La pr\('esence et le but d'un champ, ainsi que la syntaxe de sa valeur peuvent
diff\('erer selon les types de fichiers de contr\(^ole.

Les noms de champ ne sont pas sensibles \(`a la casse, mais il est habituel de
mettre en capitale l'initiale des noms de champ utilisant une casse mixte
comme indiqu\('e plus bas. Les valeurs de champ sont sensibles \(`a la casse \(`a
moins que la description du champ ne dise le contraire.

Les s\('eparateurs de paragraphes (lignes vides) et les lignes constitu\('ees
uniquement de U+0020 \fBESPACE\fP et U+0009 \fBTABULATION\fP, ne sont pas permis
dans les valeurs de champ ou entre les champs. Les lignes vides dans les
valeurs de champ sont habituellement prot\('eg\('ees par une U+0020 \fBESPACE\fP
suivie par un point (U+002E \(Fo\ \fB.\fP\ \(Fc).

Les lignes d\('ebutant par un U+0023 \(Fo\ \fB#\fP\ \(Fc, sans \(^etre pr\('ec\('ed\('ee d'une espace
sont des lignes de commentaires qui ne sont permises que dans les fichiers
de contr\(^ole de paquet source et dans les fichiers \fBdeb\-origin\fP(5). Ces
lignes de commentaires sont ignor\('ees, m\(^eme entre deux lignes de
continuation. Elles ne peuvent terminer les lignes logiques.

Tous les fichiers de contr\(^ole doivent \(^etre encod\('es en UTF\-8.
.
.\" .SH EXAMPLE
.\" .RS
.\" .nf
.\" .fi
.\" .RE
.
.SH "VOIR AUSSI"
\fBRFC822\fP, \fBRFC5322\fP.
.SH TRADUCTION
Ariel VARDI <ariel.vardi@freesbee.fr>, 2002.
Philippe Batailler, 2006.
Nicolas Fran\(,cois, 2006.
Veuillez signaler toute erreur \(`a <debian\-l10n\-french@lists.debian.org>.
