NOM
debclean - Nettoyer une arborescence de code source
SYNOPSIS
debclean [options]
debclean parcourt l'arborescence des rpertoires en commenant par
l'arborescence du rpertoire d'o il a t appel, et excute debian/rules
clean pour chaque rpertoire source Debian rencontr. Ces rpertoires sont
reconnus parce qu'ils contiennent un fichier debian/changelog pour le
paquet dont le nom correspond au nom du rpertoire. La correspondance
des noms est dcrite plus bas.
En outre, si l'option --cleandebs est donne, alors dans chaque
rpertoire contenant une arborescence source Debian, tous les fichiers
nomms *.deb, *.changes et *.build sont supprims. Les fichiers .dsc,
.diff.gz et (.orig).tar.gz ne sont pas touchs afin que la version
puisse tre reconstruite si ncessaire et les fichiers .upload sont
laisss pour que debchange fonctionne correctement. L'option
--nocleandebs empche ce comportement de nettoyage supplmentaire et
l'option --cleandebs le force. Par dfaut, le nettoyage n'est pas ralis.
debclean utilise debuild(1) pour nettoyer l'arborescence des sources.
Vrification du nom du rpertoire
Comme certains autres scripts du paquet devscripts, debclean parcourt
une arborescence de rpertoires pour trouver des fichiers
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
--cleandebs
Enlve galement tous les fichiers .deb, .changes et .build du
rpertoire parent.
--nocleandebs
Ne retire pas les fichiers .deb, .changes et .build du rpertoire
parent. C'est le comportement par dfaut.
--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.
-d N'excute pas dpkg-checkbuilddeps pour vrifier les dpendances de
construction du paquet ( build dependencies ).
--help 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 :
DEBCLEAN_CLEANDEBS
Si elle est positionne yes , alors c'est comme si l'option
--cleandebs tait utilise.
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
debuild(1) et devscripts.conf(5).
AUTEUR
Christoph Lameter <clameter@debian.org> ; modifications par Julian
Gilbey <jdg@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.