NOM
debrelease - Encapsulation d'appels dupload ou dput
SYNOPSIS
debrelease [options_debrelease] [options_dupload/dput]
debrelease est un simple script d'encapsulation ( wrapper ) d'appels
dupload ou dput. Il est appel depuis l'arborescence des sources d'un
paquet, et dtermine la version actuelle d'un paquet. Il recherche
ensuite un fichier .changes correspondant (qui liste les fichiers
ncessaires l'envoi l'archive Debian) dans le rpertoire parent de
l'arborescence du code source, et appelle ensuite dupload ou dput avec
le fichier .changes en paramtre de faon raliser l'envoi ( upload ).
Vous pouvez fournir des options debrelease. l'exception de celles qui
sont listes ci-dessous, elles sont passes inchanges dupload ou dput.
Les fichiers de configuration de devscripts sont galement lus par
debrelease, comme indiqu ci-dessous.
Vrification du nom du rpertoire
Comme certains autres scripts du paquet devscripts, debrelease parcourt
une arborescence de rpertoires jusqu' ce qu'il trouve un fichier
debian/changelog. Pour viter les problmes poss par les fichiers gars,
il examine le nom du rpertoire parent une fois qu'il a trouv le fichier
debian/changelog, et vrifie que le nom du rpertoire correspond au nom
du paquet. La faon prcise utilise est contrle par les deux variables du
fichier de configuration DEVSCRIPTS_CHECK_DIRNAME_LEVEL et
DEVSCRIPTS_CHECK_DIRNAME_REGEX, et les options en ligne de commande
associes --check-dirname-level et --check-dirname-regex.
DEVSCRIPTS_CHECK_DIRNAME_LEVEL peut prendre les valeurs suivantes :
0 Ne vrifie jamais le nom du rpertoire.
1 Ne vrifie le nom du rpertoire que s'il a fallu changer de
rpertoire pour trouver le fichier debian/changelog. C'est le
comportement par dfaut.
2 Vrifie toujours le nom du rpertoire.
Le nom du rpertoire est vrifi en testant si le nom du rpertoire courant
(donn par pwd(1)) correspond l'expression rationnelle donne par la
variable DEVSCRIPTS_CHECK_DIRNAME_REGEX du fichier de configuration ou
par l'option --check-dirname-regex regex. Il s'agit d'une expression
rationnelle Perl (voir perlre(1)), qui sera ancre son dbut et sa fin.
Si elle contient un / , alors elle doit correspondre au chemin
complet. Si elle contient la chane PACKAGE , cette chane sera remplace
par le nom du paquet source dtermin par le fichier changelog. La valeur
par dfaut de cette expression rationnelle est PACKAGE(-.+)? , ce qui
correspond aux rpertoires nomms PACKAGE ou PACKAGE-version.
OPTIONS
--dupload, --dput
Permet de spcifier le programme utilis pour l'envoi l'archive
Debian. Par dfaut, dupload est utilis.
-S Si cette option est utilise ou si le fichier par dfaut .changes
n'est pas trouv mais qu'un fichier .changes pour les sources
uniquement est prsent, alors ce dernier fichier .changes est
tlcharg vers le serveur
la place de celui spcifique une architecture.
-aarchitecture-debian, -ttype-de-systme-GNU
Veuillez consulter dpkg-architecture(1) pour une description de
ces options. Ces options affectent la recherche du fichier
.changes. Elles consistent imiter le comportement de
dpkg-buildpackage lors de la dtermination du nom du fichier
.changes. Si une option -t est donne, elle est considre comme
une option dfinissant l'hte pour dupload et marque donc la fin
des options spcifiques debrelease.
--multi
Mode des fichiers changes multiarchitecture : ceci signifie que
debrelease doit utiliser le fichier le plus rcent respectant le
modle paquet_version_*+*.changes, autorisant ainsi les fichiers
changes gnrs par dpkg-cross.
--debs-dir RP
Cherche les fichiers .changes et .deb dans le rpertoire RP au
lieu du rpertoire parent du rpertoire source. Cela doit tre soit
un chemin absolu, soit un chemin relatif la racine du rpertoire
source.
--check-dirname-level N
Veuillez consulter la section ci-dessus Vrification du nom du
rpertoire pour une explication de cette option.
--check-dirname-regex regex
Veuillez consulter la section ci-dessus Vrification du nom du
rpertoire pour une explication de cette option.
--no-conf, --noconf
Ne lit aucun fichier de configuration. L'option ne peut tre
utilise qu'en premire position de la ligne de commande.
--help, -h
Affiche un message d'aide et quitte avec succs.
--version
Affiche la version et le copyright, puis quitte avec succs.
VARIABLES DE CONFIGURATION
Les deux fichiers de configuration /etc/devscripts.conf et
~/.devscripts sont valus dans cet ordre pour rgler les variables de
configuration. Des options de ligne de commande peuvent tre utilises
pour neutraliser les paramtres des fichiers de configuration. Les
variables d'environnement sont ignores cette fin. Les variables
actuellement identifies sont :
DEBRELEASE_UPLOADER
Les valeurs valables actuellement sont dupload et dput. Cette
variable permet de spcifier quel sera le programme utilis pour
raliser l'envoi au serveur. Elle correspond l'utilisation des
options --dupload ou --dput.
DEBRELEASE_DEBS_DIR
Spcifie le rpertoire dans lequel chercher les fichiers .changes
et .deb, il est soit un chemin absolu soit un chemin relatif la
racine du rpertoire racine. Ceci correspond l'option en ligne
de commande --debs-dir. Cette directive peut tre utilise par
exemple si vous utilisez systmatiquement pbuilder ou
svn-buildpackage pour construire vos paquets. Notez que cela
concerne galement debc(1) and debi(1).
DEVSCRIPTS_CHECK_DIRNAME_LEVEL, DEVSCRIPTS_CHECK_DIRNAME_REGEX
Veuillez consulter la section Vrification du nom du rpertoire
ci-dessus pour une explication de ces variables. Notez que ce
sont des variables de configuration pour tous les outils du
paquet devscripts ; elles impacteront tous les scripts qui les
utilisent, comme indiqu dans leurs pages de manuel respectives
et dans devscripts.conf(5).
VOIR AUSSI
dupload(1), dput(1) et devscripts.conf(5).
AUTEUR
Julian Gilbey <jdg@debian.org>, bas sur le script initial release de
Christoph Lameter <clameter@debian.org>.
TRADUCTION
Ce document est une traduction, ralise par Nicolas Franois, Guillaume
Delacour, Cyril Brulebois et Thomas Huriaux.
L'quipe de traduction a fait le maximum pour raliser une adaptation
franaise de qualit.
La version anglaise la plus jour de ce document est toujours
consultable en ajoutant l'option -L C la commande man.
N'hsitez pas signaler l'auteur ou la liste de traduction
<debian-l10-french@lists.debian.org>, selon le cas, toute erreur dans
cette page de manuel.