Re: [RFR] man://dpkg/dpkg-source.1
Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr> écrivait :
« Quelques corrections, principalement typographiques.
« D'une manière générale, je mettrais plutôt « paramètre » à la place
« d'« argument » (pas dans le diff).
C'est quoi l'argument pour préférer « paramètre ?
Je joins le fichier man , qui comprend les corrections de V.Perrin,
pour pouvoir le lire avec man ./dpkg-source.1
a+
--
Philippe Batailler
.\" original version: 22
.\" This file was generated with po4a. Translate the source file.
.\"
.\" Authors: Ian Jackson
.TH DPKG\-SOURCE 1 "janvier 2000" "Projet Debian" "Utilitaires de Dpkg"
.SH NOM
dpkg\-source, dpkg\-gencontrol, dpkg\-shlibdeps, dpkg\-genchanges,
dpkg\-buildpackage, dpkg\-distaddfile, dpkg\-parsechangelog \- Les outils de
Debian pour les paquets source.
.SH SYNOPSIS
.B dpkg\-source\fR \fB-x \fR\fIfichier.dsc\fR [\fIrépertoire-de-sortie\fR]
.br
\fBdpkg\-source \-b\fR [\fIoptions\fR] \fIrépertoire\fR [\fIrépertoire-d'-origine\fR | targz-d'-origine |'']
.br
\fBdpkg\-gencontrol\fR [\fIoptions\fR]
.br
.B dpkg\-shlibdeps\fR \fIoptions
.br
\fBdpkg\-genchanges\fR [\fIoptions\fR]
.br
\fBdpkg\-buildpackage\fR [\fIoptions\fR]
.br
.B dpkg\-distaddfile\fR [\fIoptions\fR]\fI fichier section priorité
.br
\fBdpkg\-parsechangelog\fR [\fIoptions\fR]
.SH DESCRIPTION
\fBdpkg\-source\fR empaquette ou dépaquette une archive source Debian.
\fBdpkg\-gencontrol\fR lit les informations contenues dans une arborescence
Debian dépaquetée et crée le fichier «\ control\ » d'un paquet binaire (par
défaut, c'est le fichier debian/tmp/DEBIAN/control)\ ; il ajoute aussi une
entrée pour ce paquet binaire dans \fBdebian/files\fR.
\fBdpkg\-shlibdeps\fR calcule, pour les exécutables nommés dans ses arguments,
les dépendances envers les bibliothèques partagées. Ces dépendances sont
ajoutées au fichier \fBdebian/substvars\fR sous la forme
\fBshlibs:\fR \fIdependance\fR où \fIdépendance\fR est le nom du champ indiquant
le type de dépendance. Toute autre variable commençant par \fIshlibs:\fR est supprimée du
fichier. \fBdpkg\-shlibdeps\fR lit les informations concernant les dépendances
envers les bibliothèques partagées dans les fichiers suivants\ :
\fBdebian/shlibs.local\fR, \fB/etc/dpkg/shlibs.override\fR, le fichier \fBshlibs\fR,
(fichier du paquet contenant un fichier qui, selon \fBobjdump\fR, satisfait au
système de dépendance envers les bibliothèques) ou bien
\fB/etc/dpkg/shlibs.default\fR. Le premier trouvé est utilisé. Voyez
.BR dpkg-shlibdeps 1
pour des précisions sur le format des fichiers qui traitent des dépendances envers
les bibliothèques partagées.
\fBdpkg\-genchanges\fR lit les informations à la fois dans une arborescence
debian dépaquetée et déjà construite et sur les fichiers qui ont été créés\ ;
puis il crée un fichier de contrôle pour la mise en place dans l'archive Debian
(c'est le fichier \fB.changes\fR).
\fBdpkg\-buildpackage\fR est un script de contrôle qui peut faciliter la
construction automatique d'un paquet.
.B dpkg\-distaddfile\fR ajoute une entrée pour un fichier dans \fBdebian/files\fR.
\fBdpkg\-parsechangelog\fR lit et fait l'analyse du fichier «\ changelog\ »
d'une arborescence source dépaquetée et affiche les informations qu'il
contient sur la sortie standard et sous une forme lisible par la machine.
Aucune de ces commandes ne permet la combinaison de plusieurs options en une
seule et elles ne permettent pas d'indiquer la valeur d'une option dans un
argument séparé.
.SH "LES OPTIONS COMMUNES"
Beaucoup de ces programmes partagent les options qui sont décrites ici\ ; on
décrit en même temps les programmes qui les acceptent.
.TP
.BI \-h
Affiche la version du programme et un message d'aide qui comprend un résumé
des options acceptées. Tous les outils pour les paquets source comprennent
cette option.
.TP
.BI \-v version
Avec \fBdpkg-buildpackage\fR, \fBdpkg-genchanges\fR et \fBdpkg-parsechangelog\fR
cette option force l'utilisation des informations contenues dans le fichier
«\ changelog\ » et qui concernent toutes les versions strictement plus
récentes que \fIversion\fR.
Avec \fBdpkg\-gencontrol\fR, cette option donne le numéro de version du paquet
binaire qui sera créé.
.TP
.BI \-C description-des-changements
Lit la description des changements dans le fichier
\fIdescription-des-changements\fR plutôt que dans le fichier «\ changelog\ » de
l'arborescence source. \fBdpkg\-buildpackage\fR et \fBdpkg\-genchanges\fR
acceptent cette option.
.TP
.BI \-m adresse-du-responsable
Utilise \fIadresse-du-responsable\fR comme nom et adresse électronique du
responsable de paquet pour cette mise en place, plutôt que d'utiliser les
informations contenues dans le fichier «\ control\ » de l'arborescence
source. \fBdpkg\-buildpackage\fR et \fBdpkg\-genchanges\fR acceptent cette option.
.TP
.BI \-e adresse-du-responsable
Utilise \fIadresse-du-responsable\fR comme nom et adresse électronique du
responsable de paquet pour cette mise en place, plutôt que d'utiliser les
informations contenues dans le fichier «\ changelog\ » de l'arborescence
source. \fBdpkg\-buildpackage\fR et \fBdpkg\-genchanges\fR acceptent cette option.
.TP
.BR \-si ", " \-sa ", " \-sd
Ces options contrôlent si l'archive source originale est incluse dans
l'installation produite par \fBdpkg\-buildpackage\fR et \fBdpkg\-genchanges\fR
quand on construit un paquet source (les options \fB\-b\fR ou \fB\-B\fR n'ont pas
été utilisées).
Par défaut, ou quand l'option \fB\-si\fR est indiquée, les sources originales
sont incluses si le numéro de version se termine par \fB\-0\fR ou \fB\-1\fR,
c'est-à-dire si la partie «\ révision Debian\ » du numéro de version est égal à \fB0\fR
ou à \fB1\fR.
L'option \fB\-sa\fR force l'inclusion des sources originales\ ; l'option
\fB\-sd\fR force leur exclusion et inclut seulement le «\ diff\ ».
.TP
.BI \-V nom = valeur
Fixe la valeur d'une variable de substitution. \fBdpkg\-source\fR,
\fBdpkg\-gencontrol\fR et \fBdpkg\-genchanges\fR acceptent cette option. Voyez
ci-dessous pour une discussion sur la valeur de substitution.
.TP
.BI \-T fichier/substvars
Lit, (ou écrit pour \fBdpkg\-shlibdeps\fR), les variables de substitution dans
le fichier \fIfichier/substvars\fR\ ; par défaut c'est le fichier
\fBdebian/substvars\fR. \fBdpkg\-source\fR, \fBdpkg\-gencontrol\fR,
\fBdpkg\-shlibdeps\fR et \fBdpkg-genchanges\fR acceptent cette option.
.TP
.BI \-D champ = valeur
Remplace ou ajoute en sortie un champ dans le fichier de
contrôle. \fBdpkg\-source\fR, \fBdpkg\-gencontrol\fR et \fBdpkg\-genchanges\fR
acceptent cette option.
.TP
.BI \-U champ
Supprime en sortie un champ dans le fichier de contrôle. \fBdpkg\-source\fR,
\fBdpkg\-gencontrol\fR et \fBdpkg\-genchanges\fR acceptent cette option.
.TP
.BR \-b | \-B | \-S
Avec \fBdpkg\-genchanges\fR et \fBdpkg\-buildpackage\fR, les options \fB\-b\fR et
\fB\-B\fR indiquent qu'on veut seulement construire un paquet binaire. L'option
\fB\-b\fR indique qu'aucun fichier source n'est à construire ou à distribuer,
et l'option \fB\-B\fR indique en plus qu'aucun fichier, appartenant à un paquet
binaire ne dépendant pas d'une architecture, n'est à distribuer. L'option
\fB\-S\fR indique que seul le paquet source doit être installé et qu'on a pas besoin
de construire un paquet binaire. Seul \fBdpkg\-buildpackage\fR se sert des
options \fB\-b\fR et \fB\-B\fR. \fBdpkg-genchanges\fR crée seulement un fichier
\fB.changes\fR pour tous les fichiers produits par la ou les cible(s) \fBbinary\-*\fR du
paquet.
L'option \fB\-b\fR indique à \fBdpkg\-source\fR de construire un paquet source
(plutôt que d'en extraire un), voyez ci-dessous.
.TP
.BI \-c fichier/control
Indique le principal fichier de contrôle des sources où trouver les informations
de construction. Par défaut, c'est le fichier
\fBdebian/control\fR. \fBdpkg\-source\fR, \fBdpkg\-gencontrol\fR et
\fBdpkg\-genchanges\fR acceptent cette option.
.TP
.BI \-l fichier/changelog
Indique le fichier d'enregistrement des changements. Par défaut, c'est le fichier
\fBdebian/changelog\fR.
\fBdpkg\-source\fR, \fBdpkg\-gencontrol\fR et \fBdpkg\-genchanges\fR acceptent cette
option.
.TP
.BI \-f fichier/liste-des-fichiers
Lit ou écrit la liste des fichiers qui doivent être mis en place dans le
fichier \fIfichier/liste-des-fichiers\fR plutôt que dans le fichier
\fBdebian/files\fR. \fBdpkg\-gencontrol\fR, \fBdpkg\-genchanges\fR et
\fBdpkg\-distaddfile\fR acceptent cette option.
.TP
.BI \-F format-du-changelog
Donne le format du fichier changelog. Par défaut, c'est une ligne spéciale,
près de la fin du fichier, qui l'indique\ ; sinon, on utilise le format
classique \fBdebian\fR.
\fBdpkg\-source\fR, \fBdpkg\-gencontrol\fR et \fBdpkg\-genchanges\fR acceptent cette option.
.TP
.BI \-W
Cette option transforme certaines erreurs en avertissements. Seul
\fBdpkg\-source\fR l'utilise, mais \fBdpkg\-buildpackage\fR la reconnaît et la
transmet à \fBdpkg\-source\fR.
.TP
.BI \-E
Cette option annule une précédente option \fB\-W\fR. Elle n'est actuellement
comprise que par \fBdpkg\-buildpackage\fR et \fBdpkg\-source\fR.
.SH "LES OPTIONS DE DPKG\-SOURCE"
Quand on fournit les options communes \fB\-c\fR et \fB\-l\fR avec des chemins
relatifs, on considère qu'ils sont relatifs au répertoire le plus élevé de
l'arborescence source.
.TP
.B \-x
Cette option sert à extraire un paquet source. On doit donner un seul
argument sans option\ : le nom du fichier de contrôle des sources Debian
(\fB.dsc\fR).
Un deuxième argument sans option peut être donné pour indiquer le répertoire où
extraire le paquet source, il ne doit pas déjà exister. Quand aucun répertoire n'est indiqué,
le paquet source est extrait dans le répertoire \fIsource\fR-\fIversion-\fR du répertoire
courant.
Aucune option n'est utile avec \fBdpkg\-source\-x\fR.
\fBdpkg\-source\fR lit, dans le fichier de contrôle, les noms des
fichiers qui composent le paquet source\ ; il suppose qu'ils sont dans le
même répertoire que le fichier \fB.dsc\fR.
Les fichiers extraits du paquet auront le même système de propriété et de
permission que s'ils avaient été simplement créés. Les répertoires et les
fichiers exécutables auront un système de permission égal à 0777 et les
simples fichiers, 0666\ ; ces deux systèmes étant modifiés par le masque de
celui qui fait l'extraction\ ; Si le répertoire parent est «\ setgid\ », les
répertoires extraits le seront aussi et tous les fichiers et répertoires
hériteront du système de propriété de ce groupe.
.TP
.B \-b
Construire\ : empaqueter une arborescence. Un ou deux arguments, sans
option, seront fournis. Le premier représente le nom du répertoire qui
contient l'arborescence non empaquetée. Si l'on donne un second argument, ce
sera le nom du répertoire contenant les sources amont ou bien le nom du fichier «\ tar\ »
ou bien une chaîne vide si le paquet est «\ debian pure souche\ » et n'a
donc pas de fichiers «\ diffs\ » concernant sa «\ debianisation\ ». S'il n'y
a pas de second argument, et selon les autres arguments donnés,
\fBdpkg\-source\fR cherche le fichier « tar » des sources amont
\fIpaquet\fR\fB_\fR\fIversion-amont\fR\fB.orig.tar.gz\fR ou bien le répertoire
source amont \fIrépertoire\fR\fB.orig\fR ou bien une chaîne vide (pas de source
amont, et donc pas de «\ diffs\ »).
.TP
.B \-i[<regexp>]
On peut donner une expression rationnelle Perl correspondant à la liste des fichiers
qui doivent être éliminés du «\ diff\ ». Cette liste est créée par une commande «\ find\ ».
L'option \fB-i\fR toute seule, élimine les fichiers de contrôle et les répertoires
des systèmes les plus connus de contrôle de version, les fichiers d'échange et de sauvegarde et
les répertoires utilisés par Libtool.
C'est très utile pour supprimer les fichiers superflus qui sont inclus dans
le .diff.gz (p. ex. «\ debian/BUGS_TODO/*\ » ou «\ debian/RCS/*,v\ »). Quand
on suit avec un CVS distant un paquet que l'on maintient, et qu'on a pas la
possibilité d'enregistrer les fichiers debian de contrôle ou d'étiqueter
\fIcvs\-buildpackage(1)\fR, il faut faire un «\ checkout/update\ »
supplémentaire dans un répertoire tenu vierge pour créer le fichier
orig.tar.gz. Les fichiers «\ CVS/Entries\ » de ce répertoire contiennent des
dates qui diffèrent de celles du répertoire de travail\ ; cela provoque
indûment leur inclusion dans chaque .diff.gz créé, à moins d'utiliser
l'option \fB\-i\fR.
.TP
.B \-I<fichier>
Avec cette option, le fichier est fourni comme paramètre à l'option \-\-exclude de tar quand
on veut créer un fichier .orig.tar.gz ou .tar.gz. Par exemple, \-ICVS fera
que tar sautera les répertoires du CVS quand il doit créer un fichier .tar.gz.
On peut répéter cette option pour exclure plusieurs fichiers.
.TP
.BR \-sa , \-sp , \-su , \-sk , \-sA , \-sP , \-sU , \-sK , \-ss " avec " \-b
Quand on spécifie \fB\-sk\fR ou \fB\-sp\fR, \fBdpkg\-source\fR s'attend à ce que les
sources amont soientt un fichier «\ tar\ »\ ; par défaut, c'est le fichier
\fIpaquet\fR\fB_\fR\fIversion-amont\fR\fB.orig.tar.gz\fR. Il le laisse en place
en tant que fichier «\ tar\ » ou le copie dans le répertoire en cours s'il
n'y est pas déjà. Quand on utilise \fB\-sp\fR au lieu de \fB\-sk\fR, il le
supprime ensuite.
Quand on spécifie \fB\-su\fR ou \fB\-sr\fR, les sources amont sont supposées dans
un répertoire\ ; par défaut, c'est le répertoire
\fIpaquet\fR\fB-\fR\fIversion-amont\fR\fB.orig\fR et \fBdpkg\-source\fR crée une
nouvelle archive des sources amont. Quand on utilise \fB\-sr\fR,
\fBdpkg\-source\fR supprime ce répertoire après usage.
Quand on utilise \fB\-ss\fR, \fBdpkg\-source\fR s'attend à ce que les sources
amont soient disponibles à la fois comme un répertoire et comme un fichier
«\ tar\ ». Il se sert du répertoire pour créer le «\ diff\ », mais se sert
du fichier «\ tar\ » pour créer le fichier \fB.dsc\fR. On doit faire attention
avec cette option. Si le répertoire et le fichier «\ tar\ » ne correspondent
pas, une mauvaise archive source en résulte.
Quand on utilise \fB\-sn\fR, \fBdpkg\-source\fR ne cherche pas les sources amont,
et ne crée pas de «\ diff\ ». Le second argument, s'il existe, doit être une
chaîne vide. Cela sert pour les paquets Debian pure souche qui n'ont pas de
sources amont distinctes et donc, pas de fichier «\ diff\ » de debianisation.
Quand on utilise \fB\-sa\fR ou \fB\-sA\fR, \fBdpkg\-source\fR cherche des sources
amont soit sous forme de fichier «\ tar\ », soit sous forme de répertoire
-- le deuxième argument, s'il existe, ou bien une chaîne vide (cela revient
à utiliser l'option \fB\-sn)\fR. Quand un fichier «\ tar\ » existe, il est
dépaqueté et \fBdpkg\-source\fR crée un fichier «\ diff\ »\ ; ensuite il
supprime le fichier «\ tar\ » (cela revient à utiliser l'option \fB\-sp)\fR\ ;
quand un répertoire est trouvé, il est compacté et \fBdpkg\-source\fR crée le
source originel\ ; puis ce répertoire est supprimé (cela revient à utiliser
l'option \fB\-sr)\fR\ ; quand ni l'un ni l'autre n'est trouvé, \fBdpkg\-source\fR
suppose que le paquet ne possède pas de fichier «\ diff\ » de debianisation,
mais seulement une simple archive source (cela revient à utiliser l'option
\fB\-sn\fR). Quand les deux sont trouvés, \fBdpkg\-source\fR ignore le répertoire
et le remplace si l'option \fB\-sA\fR a été spécifiée (cela revient à utiliser
l'option \fB\-sP)\fR\ ; ou bien il provoque une erreur si l'option \fB\-sa\fR a
été spécifiée. L'option par défaut est \fB\-sA\fR.
Les options \fB\-sa\fR, \fB\-sp\fR, \fB\-sk\fR, \fB\-su\fR et \fB\-sr\fR ne remplacent pas
les fichiers «\ tar\ » ou les répertoires existants. Pour cela, il faut
utiliser les options \fB\-sA\fR, \fB\-sP\fR, \fB\-sK\fR, \fB\-sU\fR et \fB\-sR\fR.
.TP
.BR \-sp , \-su , \-sn " avec " \-x
Dans tous ces cas, l'arborescence existante des sources amont est supprimée.
Quand on utilise l'option \fB\-sp\fR lors d'une extraction, les sources amont
(si elles existent) sont gardées en tant que fichier «\ tar\ ». S'il n'est pas déjà
dans le répertoire en cours ou si ce répertoire contient un fichier
différent, le fichier «\ tar\ » est copié dans ce répertoire. C'est le
comportement par défaut.
L'option \fB\-su\fR déplie l'arborescence des sources amont.
L'option \fB\-sn\fR assure que les sources amont ne seront ni copiées dans le
répertoire en cours, ni dépliées. Une arborescence des sources amont
présente dans le répertoire en cours est toujours supprimée.
.SH "LES OPTIONS POUR DPKG\-GENCONTROL"
\fBdpkg\-gencontrol\fR ne prend pas d'argument sans option.
.TP
.BI \-p paquet
cette option produit les informations concernant le paquet binaire
\fIpaquet.\fR Si le fichier de contrôle des sources liste un seul paquet
binaire, on peut omettre cette option\ ; sinon c'est indispensable
d'indiquer le paquet pour lequel on veut produire les informations.
.TP
.BI \-n nom-de-fichier
Le nom du paquet est \fInom-de-fichier\fR au lieu de l'habituel\ : paquet_version_arch.deb.
.TP
.BR \-is ", " \-ip ", " \-isp
Ces options incluent, dans le fichier de contrôle du paquet binaire, les
champs \fBSection\fR et \fBPriority\fR qui concernent ce paquet et qui se trouvent
dans le fichier principal de contrôle des sources. Habituellement on ne met
pas ces informations là, mais dans le fichier \fB.changes\fR. L'option \fB\-isp\fR
inclut les deux champs, \fB\-is\fR seulement le champ \fBSection\fR et \fB\-ip\fR
seulement le champ \fBPriority\fR.
.TP
.BI \-P rep-de-construction-du-paquet
Cette option indique à \fBdpkg\-source\fR que le répertoire de construction du
paquet est \fIrep-de-construction-du-paquet\fR au lieu de \fBdebian/tmp\fR. Cette
valeur sert à trouver la valeur par défaut de la variable de substitution
\fBInstalled\-Size\fR et celle du champ correspondant dans le fichier de
contrôle (on utilise la commande \fBdu\fR)\ ; elle donne aussi l'emplacement
par défaut pour le fichier de sortie.
.TP
.B \-O
Cette option provoque l'affichage du fichier de contrôle sur la sortie
standard au lieu de \fBdebian/tmp/DEBIAN/control\fR (ou
\fIrep-de-construction-du-paquet\fR\fB/DEBIAN/control\fR si l'option \fB\-P\fR a été
utilisée).
.SH "LES OPTIONS POUR DPKG\-SHLIBDEPS"
\fBdpkg-shlibdeps\fR interprète des arguments sans option comme des commandes
exécutables, comme si on avait simplement donné \fB\-e\fR\fIexécutable\fR\fP.
.TP
.BI \-e exécutable
Cette option inclut les bonnes dépendances envers les bibliothèques
partagées que demande \fIexécutable\fR.
.TP
.BI \-d champ-dépendance
Cette option ajoute les dépendances destinées au champ «\ dépendance\ » du
fichier de contrôle \fIchamp-dépendance\fR. Les dépendances pour ce champ sont
dans la variable \fBshlibs:\fR\fIchamp-dépendance\fR.
L'option \fB\-d\fR\fIchamp-dépendance\fR concerne tous les exécutables qui suivent
l'option, jusqu'à la prochaine option \fB\-d\fR\fIchamp-dépendance\fR.\fP Par
défaut, \fIchamp-dépendance\fR vaut \fBDepends\fR.
Quand, dans plusieurs champs reconnus ayant trait aux dépendances comme les
champs \fBPre\-Depends\fR, \fBDepends\fR, \fBRecommends\fR, \fBEnhances\fR ou
\fBSuggests\fR, apparaît la même entrée (ou bien un ensemble d'alternatives)
\fBdpkg\-shlibdeps\fR supprime automatiquement les dépendances dans tous les
champs sauf celui qui représente la dépendance la plus importante.
.TP
.BI \-p préfixe-pour-le-nom-des-variables
Les variables de substitution commenceront par
\fIpréfixe-pour-le-nom-des-variables\fR\fB:\fR au lieu de \fBshlibs:\fR. De même,
toute variable de substitution commençant par
\fIpréfixe-pour-le-nom-des-variables\fR\fB:\fR (au lieu de \fBshlib:\fR) est enlevée
du fichier de substitution des variables.
.TP
.BI \-L fichier-local-shlibs
\fBdpkg-shlibdeps\fR lira les informations de remplacement concernant les
dépendances envers les bibliothèques partagées dans \fIfichier-local-shlibs\fR
au lieu de \fBdebian/shlibs.local\fR.
.TP
.B \-O
Les définitions des variables de substitution seront affichées sur la sortie
standard, plutôt qu'ajoutées dans le fichier de substitution des variables
qui est par défaut debian/substvars.
.TP
.BI \-t type
\fBdpkg\-shlibdeps\fR préfèrera les informations sur les dépendances
des bibliothèques partagées qui sont étiquetées pour un type de paquet donné.
Si aucune information de type n'est donnée, il n'utilisera pas d'information.
Par défaut, le type de paquet est "deb". On peut créer une étiquette pour ces
informations en les préfixant par le nom du type, un deux-points et une espace.
.SH "LES OPTIONS DE DPKG\-GENCHANGES"
\fBdpkg-genchanges\fR ne prend pas d'argument sans option.
.TP
.BI \-u répertoire-des-fichiers-à-installer
Cherche les fichiers à installer dans \fIrépertoire-des-fichiers-à-installer\fR
plutôt que dans \fB..\fR (\fBdpkg-genchanges\fR doit trouver ces fichiers de
manière à mettre leurs tailles et leurs sommes de contrôle dans le fichier
.B .changes.)
.TP
.B \-q
\fBdpkg\-genchanges\fR affiche habituellement des messages d'information sur la
sortie d'erreur standard\ ; par exemple, combien de fichiers source du
paquet sont en cours d'installation. \fB\-q\fR supprime ces messages.
.SH "LES OPTIONS DE DPKG\-BUILDPACKAGE"
\fBdpkg\-buildpackage\fR ne prend pas d'arguments sans option.
.TP
.BI \-k key-id
Précise une clé pour la signature des paquets.
.TP
.BI \-r commande-pour-obtenir-privilèges-de-root
Quand \fBdpkg\-buildpackage\fR doit exécuter une partie du processus de
construction en tant que root, il préfixe la commande exécutée par
\fIcommande-pour-obtenir-privilèges-de-root\fR, si elle
existe. \fIcommande-pour-obtenir-privilèges-de-root\fR sera le nom d'un
programme présent dans le \fBPATH\fR et ce programme prend comme argument le
nom de la commande réelle à exécuter et les arguments qu'elle doit
prendre. \fIcommande-pour-obtenir-privilèges-de-root\fR ne contiendra pas
d'espace ni aucun « métacaractère » de l'interpréteur de commandes.
.\" what happens, if it contains spaces? (hs)
\fIcommande-pour-obtenir-privilèges-de-root\fR est classiquement \fBfakeroot\fR,
\fBsudo\fR, \fBsuper\fR ou \fBreally\fR. \fBsu\fR ne va pas, puisque ce programme
demande une option \fB\-c\fR pour exécuter une commande\ ; et même alors il ne
peut qu'appeler l'interpréteur de commandes de l'utilisateur au lieu de
passer directement les arguments à la commande qui doit être exécutée.
.TP
.BI \-p commande-de-signature
Quand \fBdpkg-buildpackage\fR doit exécuter GPG ou PGP pour signer un fichier
source de contrôle (\fB.dsc\fR) ou un fichier \fB.changes\fR, il exécute
\fIcommande-de-signature\fR (en examinant le \fBPATH\fR si nécessaire) au lieu de
\fBpgp\fR. \fIcommande-de-signature\fR obtient tous les arguments qu'aurait obtenu
\fBpgp\fR. Si \fIcommande-de-signature\fR veut recevoir ses arguments à la manière
GPG plutôt qu'à la manière PGP, on choisira l'option \fB\-sgpg.\fR
\fIcommande-de-signature\fR ne contiendra pas d'espace ni aucun «\ métacaractère\ »
de l'interpréteur de commandes.
.TP
.B \-tc
Nettoyage de l'arborescence (en utilisant
\fIcommande-pour-obtenir-privilèges-de-root\fR \fBdebian/rules clean\fR) après la
construction du paquet.
.TP
.BR \-us ", " \-uc
Ne pas signer, respectivement, soit le paquet source, soit le fichier «\ .changes\ ».
.TP
.BI \-a architecture
Précise l'architecture Debian pour laquelle on construit. L'architecture de
la machine sur laquelle on construit est automatiquement déterminée\ ; c'est
aussi l'architecture par défaut de la machine hôte.
.TP
.B \-i[<regexp>]
Chaîne passée telle quelle à \fBdpkg\-source\fR.
.TP
.B \-I<fichier>
Fichier passé tel quel à \fBdpkg\-source\fR. Peut être plusieurs fois répétée.
.TP
.B \-D
Vérifie les dépendances de construction et les conflits\ ; se termine en
cas de problèmes.
.TP
.B \-d
Ne pas vérifier les dépendances de constructions et les conflits.
.TP
.B \-nc
Ne pas nettoyer l'arborescence source (implique l'option \-b)
.SH "LES ARGUMENTS DE DPKG\-DISTADDFILE"
\fBdpkg\-distaddfile\fR ne prend pas d'option particulière. Il prend trois
arguments sans option, à savoir le nom du fichier, la section et la
priorité, pour le fichier \fB.changes\fR.
Le nom du fichier sera indiqué relativement au répertoire dans lequel
\fBdpkg\-genchanges\fR s'attend à trouver les fichiers, habituellement \fB..n\fR,
plutôt que relativement au répertoire dans lequel est exécuté
.B dpkg\-distaddfile.
.SH "LES ARGUMENTS DE DPKG\-PARSECHANGELOG"
\fBdpkg\-parsechangelog\fR ne prend ni d'option particulière ni d'argument sans option.
.SH "LA SUBSTITUTION DE VARIABLE"
Avant que \fBdpkg\-source\fR, \fBdpkg\-gencontrol\fR et \fBdpkg\-genchanges\fR
n'écrivent leurs informations de contrôle (dans le fichier source de
contrôle \fB.dsc\fR pour \fBdpkg\-source\fR et sur la sortie standard pour
\fBdpkg\-gencontrol\fR et \fBdpkg\-genchanges),\fR ils accomplissent quelques
substitutions de variable dans le fichier de sortie.
Une substitution de variable est de la forme : \fB${\fR\fIvariable-nom\fR\fB}\fR.
Les noms de variable consistent en caractères alphanumériques, traits
d'union et «\ deux points\ » ; ils commencent par une lettre ou un chiffre.
La substitution se fait répétitivement jusqu'à ce qu'il n'en reste aucune à
faire\ ; le texte entier du champ après la substitution est réexaminé pour
chercher d'autres substitutions.
Quand toutes les substitutions ont été faites, chaque occurrence de la
chaîne \fB${}\fR (laquelle n'est pas une substitution autorisée) est remplacée
par un signe \fB$\fR.
On peut définir les variables en utilisant l'option commune \fB\-V\fR. On peut
aussi se servir du fichier \fBdebian/substvars\fR (ou tout autre fichier avec
l'option \fB\-T)\fR. Ce fichier est composé de lignes de la forme suivante\ :
\fInom\fR\fB=\fR\fIvaleur\fR\fP. Les espaces résiduels sur chaque ligne, les lignes
vides et les lignes qui commencent par un symbole \fB#\fR sont ignorés.
En outre, les variables standard suivantes sont disponibles\ :
.TP
.BI Arch
L'architecture pour laquelle on construit (tirée de \fBdpkg\-\-print\-architecture\fR).
.TP
.B Source\-Version
La version du paquet source (tirée du fichier changelog).
.TP
.B Installed\-Size
La taille de tous les fichiers installés du paquet. Cette valeur est copiée
dans le champ adéquat du fichier « control » ; Quand on fixe cette variable,
cela modifie la valeur de ce champ. Quand elle est indéterminée,
\fBdpkg\-gencontrol\fR use de la commande \fBdu \-k debian/tmp\fR pour trouver une
valeur par défaut.
.TP
.B Extra\-Size
L'espace disque supplémentaire utilisé pour l'installation du paquet. Quand
on fixe cette variable, on ajoute sa valeur à la valeur de la variable
\fBInstalled\-Size\fR (qu'elle soit définie explicitement ou calculée par
défaut) avant que la variable \fBInstalled\-Size\fR ne soit copiée dans le
champ du fichier «\ control\ ».
.TP
.BI F: fieldname
La valeur du champ \fIfieldname\fR affiché en sortie et qui doit être
classiquement en majuscules. Quand on fixe ces variables, cela ne prend
effet que là où elles sont effectivement développées.
.TP
.B Format
La version du format du fichier \fB.changes\fR produite par la version des
scripts construisant le source. Quand on détermine cette variable, le
contenu du champ \fBFormat\fR dans le fichier \fB.changes\fR est aussi modifié.
.TP
.BR Newline ", " Space ", " Tab
Ces variables contiennent chacune le caractère correspondant.
.TP
.BI shlibs: dependencyfield
Les variables déterminées de cette façon sont produites par
\fBdpkg\-shlibdeps\fR, voyez plus haut.
.TP
.B dpkg:UpstreamVersion
La version amont de dpkg.
.TP
.B dpkg:Version
Le numéro complèt de la version de dpkg.
.LP
Quand une variable est référencée mais n'est pas définie, cela produit un
avertissement et une valeur nulle est assumée.
.SH FICHIERS
.TP
.B debian/control
Le principal fichier d'information sur les sources\ ; il donne des
renseignements qui ne dépendent pas d'une version concernant le paquet
source et les paquets binaires qui peuvent être créés.
.TP
.B debian/changelog
Le fichier d'enregistrement des modifications\ ; on s'en sert pour connaître
les informations qui dépendent d'une version du paquet source, par exemple
l'urgence ou la distribution d'une installation sur le serveur, les
modifications faites depuis telle édition et le numéro de la version source
lui-même.
.TP
.B debian/files
La liste des fichiers créés qui seront installés sur le
serveur. \fBdpkg\-gencontrol\fR ajoute les noms présumés des fichiers des
paquets binaires à partir des fichiers «\ control\ » qu'il crée\ ; pour
ajouter d'autres fichiers on peut se servir de
\fBdpkg\-distaddfile\fR. \fBdpkg\-genchanges\fR lit dans ce fichier les données
nécessaires à la création du fichier \fB.changes\fR.
.TP
.B debian/substvars
La liste des variables de substitution et leurs valeurs.
.TP
.B debian/shlibs.local
Fichier particulier à un paquet remplaçant les informations qui concernent
les dépendances envers des bibliothèques partagées.
.TP
.B /etc/dpkg/shlibs.override
Fichier système remplaçant les informations qui concernent les dépendances
envers des bibliothèques partagées.
.TP
.B /etc/dpkg/shlibs.default
Fichier système par défaut concernant les informations de dépendances envers
des bibliothèques partagées.
.SH BOGUES
Le moment où a lieu le remplacement d'un champ par rapport à certaines
déterminations de champ affichées sur la sortie standard est plutôt
embrouillé.
On opère deux fois la substitution de variable sur les entrées d'un paquet
binaire dans le fichier \fBdebian/files\fR. Cela ne devrait pas poser de
problème puisque \fB$\fR, \fB{\fR et \fB}\fR ne sont pas permis dans les noms de
paquet et les numéros de version.
On devrait pouvoir mettre des espaces et des métacaractères du shell dans
les arguments initiaux de \fIcommande-pour-obtenir-privilèges-de-root\fR et
\fIcommande-de-signature\fR.
.SH "VOIR AUSSI"
\fBdpkg\-deb\fR(1), \fBdpkg\fR(1), \fBdselect\fR(1), \fBgpg\fR(1), \fBpgp\fR(1).
.SH AUTEUR
Ces outils et cette page de manuel ont été écrits par Ian Jackson.
.SH COPYRIGHT
Copyright (C) 1995-1996 Ian Jackson
.br
Copyright (C) 2000 Wichert Akkerman
.br
C'est un logiciel libre\ ; voyez la «\ GNU General Public Licence\ » version
2 ou supérieure pour le copyright. Il n'y a \fBpas\fR de garantie. Voyez
\fB/usr/share/doc/dpkg/copyright\fR et \fB/usr/share/common-licenses/GPL\fR pour
des précisions.
Reply to: