debclean - Nettoyer une arborescence de code source
debclean [
options]
debclean parcourt l'arborescence des répertoires en
commençant par l'arborescence du répertoire d'où il a
été appelé, et exécute
debuild -- clean pour chaque répertoire source
Debian rencontré. Ces répertoires sont reconnus parce qu'ils
contiennent un fichier
debian/changelog pour le paquet dont le nom
correspond au nom du répertoire. La correspondance des noms est
décrite plus bas.
Si
debclean est invoqué à partir d'un répertoire qui
est déjà un paquet source Debian, il ne descendra pas dans ses
sous-répertoires.
En outre, si l'option
--cleandebs est donnée, alors dans chaque
répertoire contenant une arborescence source Debian, tous les fichiers
nommés *.deb, *.changes et *.build sont supprimés. Les fichiers
.dsc, .diff.gz et (.orig).tar.gz ne sont pas touchés afin que la
version puisse être reconstruite si nécessaire et les fichiers
.upload sont laissés pour que
debchange fonctionne correctement.
L'option
--nocleandebs empêche ce comportement de nettoyage
supplémentaire et l'option
--cleandebs le force. Par
défaut, le nettoyage n'est pas réalisé.
debclean utilise
debuild(1) pour nettoyer l'arborescence des
sources.
Comme certains autres scripts du paquet
devscripts,
debclean
parcourt une arborescence de répertoires pour trouver des fichiers
debian/changelog. Pour éviter les problèmes posés
par les fichiers égarés, il examine le nom du répertoire
parent une fois qu'il a trouvé le fichier
debian/changelog, et
vérifie que le nom du répertoire correspond au nom du paquet. La
façon précise utilisée est contrôlée par
les deux variables du fichier de configuration
DEVSCRIPTS_CHECK_DIRNAME_LEVEL et
DEVSCRIPTS_CHECK_DIRNAME_REGEX, et les options en ligne de commande
associées
--check-dirname-level et
--check-dirname-regex.
DEVSCRIPTS_CHECK_DIRNAME_LEVEL peut prendre les valeurs
suivantes :
- 0
- Ne jamais vérifier le nom du répertoire.
- 1
- Ne vérifier le nom du répertoire que s'il a
fallu changer de répertoire pour trouver le fichier
debian/changelog. C'est le comportement par défaut.
- 2
- Toujours vérifier le nom du répertoire.
Le nom du répertoire est vérifié en testant si le nom du
répertoire actuel (donné par
pwd(1)) correspond à
l'expression rationnelle donnée par la variable
DEVSCRIPTS_CHECK_DIRNAME_REGEX du fichier de configuration ou par
l'option
--check-dirname-regex expression_rationnelle. Il s'agit
d'une expression rationnelle Perl (voir
perlre(1)), qui sera
ancrée à son début et à sa fin. Si elle contient
un "/", alors elle doit correspondre au chemin complet, sinon elle
doit correspondre au nom de répertoire complet. Si elle contient la
chaîne "PACKAGE", cette chaîne sera remplacée
par le nom du paquet source déterminé par le journal de
modifications. La valeur par défaut de cette expression rationnelle est
"PACKAGE(-.+)?", ce qui correspond aux répertoires
nommés PACKAGE ou PACKAGE-version.
- --cleandebs
- Enlever également tous les fichiers .deb, .changes
et .build du répertoire parent.
- --nocleandebs
- Ne pas supprimer les fichiers .deb, .changes et .build du
répertoire parent. C'est le comportement par défaut.
-
--check-dirname-level N
- Veuillez consulter la section Vérification du nom
du répertoire ci-dessus pour une explication de cette
option.
-
--check-dirname-regex regex
- Veuillez consulter la section Vérification du nom
du répertoire ci-dessus pour une explication de cette
option.
-
--no-conf, --noconf
- Ne lire aucun fichier de configuration. L'option ne peut
être utilisée qu'en première position de la ligne de
commande.
- -d
- Ne pas exécuter dpkg-checkbuilddeps pour
vérifier les dépendances de construction du paquet
("build dependencies").
- --help
- Afficher un message d'aide et quitter avec
succès.
- --version
- Afficher la version et le copyright, puis quitter avec
succès.
Les deux fichiers de configuration
/etc/devscripts.conf et
~/.devscripts sont évalués dans cet ordre pour
régler les variables de configuration. Des options de ligne de commande
peuvent être utilisées pour écraser les paramètres
des fichiers de configuration. Les variables d'environnement sont
ignorées à cette fin. Les variables actuellement
identifiées sont :
- DEBCLEAN_CLEANDEBS
- Lui attribuer la valeur yes équivaut à
utiliser l'option --cleandebs.
-
DEVSCRIPTS_CHECK_DIRNAME_LEVEL,
DEVSCRIPTS_CHECK_DIRNAME_REGEX
- Veuillez consulter la section Vérification du nom
du répertoire ci-dessus pour une explication de ces variables.
Remarquez 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).
debuild(1),
devscripts.conf(5)
Christoph Lameter <
[email protected]> ; modifications par Julian
Gilbey <
[email protected]>.
Ce document est une traduction, maintenue à l'aide de l'outil po4a <
https://po4a.org/> par l'équipe de traduction francophone du
projet Debian.
Nicolas François, Guillaume Delacour, Cyril Brulebois, Thomas Huriaux et
David Prévot ont réalisé cette traduction.
L'équipe de traduction a fait le maximum pour réaliser une
adaptation française de qualité. Veuillez signaler toute erreur
de traduction en écrivant à <
[email protected]> ou par un rapport de bogue sur
le paquet devscripts.
La version anglaise la plus à jour de ce document est toujours
consultable en ajoutant l'option «
-L C » à la commande
man.