.\" -*- nroff -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH DEBDIFF 1 "Utilitaires Debian" DEBIAN .SH NOM debdiff \- Comparer la liste des fichiers de deux paquets Debian .SH SYNOPSIS \fBdebdiff\fP [\fIoptions\fP] .br \fBdebdiff\fP [\fIoptions\fP] ... \fIdeb1 deb2\fP .br \fBdebdiff\fP [\fIoptions\fP] ... \fIchanges1 changes2\fP .br \fBdebdiff\fP [\fIoptions\fP] ... \fB\-\-from\fP \fIdeb1a deb1b ... \fP\fB\-\-to\fP \fIdeb2a deb2b ...\fP .br \fBdebdiff\fP [\fIoptions\fP] ... \fIdsc1 dsc2\fP .SH DESCRIPTION \fBdebdiff\fP prend en argument le nom de deux paquets Debian (fichiers \fI.deb\fP ou \fI.udeb\fP) et compare leur contenu (en comparant uniquement les fichiers principaux, sans les scripts de maintenance). Il affiche quels fichiers ont été ajoutés ou retirés entre deux paquets. Il est de ce fait utile pour pointer les fichiers perdus par inadvertance entre deux versions d'un paquet. Il vérifie également les permissions et propriétaires des fichiers et compare le fichier control des deux paquets à l'aide du programme \fBwdiff\fP. Pour une comparaison plus précise de deux paquets Debian, l’outil \fBdiffoscope\fP peut être utilisé. .PP Si aucun paramètre n'est donné, \fBdebdiff\fP essaie de comparer le contenu du répertoire source actuel avec la dernière version du paquet. .PP \fBdebdiff\fP peut aussi gérer les changements entre des groupes de fichiers \&\fI.deb\fP de deux façons. La première consiste à indiquer deux fichiers \&\fI.changes\fP. Dans ce cas, les fichiers \fI.deb\fP listés dans les fichiers \&\fI.changes\fP seront comparés, en considérant ensemble le contenu de tous les fichiers \fI.deb\fP. Il est supposé que les fichiers \fI.deb\fP se trouvent dans le même répertoire que le fichier \fI.changes\fP. La deuxième façon consiste à indiquer la liste de fichiers \fI.deb\fP avec la syntaxe \fB\-\-from\fP ... (depuis) et \fB\-\-to\fP ... (vers). On peut ainsi vérifier que, lorsqu'un paquet est découpé en paquets plus petits, rien n'est perdu au passage. .PP \fBdebdiff\fP examine les fichiers de configuration de \fBdevscripts\fP comme décrit ci\-dessous. Les options en ligne de commande permettent de remplacer les paramètres des fichiers de configuration. .PP Si deux paquets source (fichiers \fI.dsc\fP) sont fournis à \fBdebdiff\fP, il comparera le contenu des paquets source. Si les paquets source ne diffèrent que par leur numéro de version Debian (c'est\-à\-dire que les fichiers \&\fI.orig.tar.gz\fP sont identiques dans les deux fichiers \fI.dsc\fP), alors \fBinterdiff\fP(1) sera utilisé pour comparer les deux fichiers de rustine si ce programme est disponible sur le système, sinon, \fBdiff\fP sera utilisé sur les deux arborescences des sources. .SH OPTIONS .TP \fB\-\-dirs\fP, \fB\-d\fP Le mode opératoire par défaut est d'ignorer les noms de répertoire qui apparaissent dans la liste de fichiers\ ; mais avec cette option, ils seront pris en compte. .TP \fB\-\-nodirs\fP Ignorer les répertoires dont le nom apparaît dans la liste de fichiers. C'est le comportement par défaut. Cette option permet de remplacer un paramètre d'un fichier de configuration. .TP \fB\-\-move\fP \fIDEPUIS VERS\fP, \fB\-m\fP \fIDEPUIS VERS\fP Il arrive parfois que différents fichiers ou répertoires soient déplacés entre deux versions. On peut régler le problème en utilisant cette option. Les deux arguments représentent les emplacements du répertoire ou du fichier dans le premier et dans le second paquet. Quand les listes de fichiers sont comparées, tous les fichiers de la première liste dont le nom commence par le premier argument sont traités comme s'ils commençaient par le second argument. Vous pouvez donner un nombre arbitraire d'arguments \fB\-\-move\fP\ : ils sont interprétés dans l'ordre d'apparition. Cela affecte seulement les paquets binaires, pas les paquets source. .TP \fB\-\-move\-regex\fP \fIDEPUIS VERS\fP Identique à \fB\-\-move\fP, mais \fIDEPUIS\fP est traité comme une expression rationnelle et la commande de substitution \fBperl\fP \fIs/^DEPUIS/VERS/\fP est appliquée aux fichiers. En particulier, VERS peut avoir des références arrières telles que $1. .TP \fB\-\-nocontrol\fP \fBdebdiff\fP compare normalement les deux fichiers control respectifs avec \fBwdiff\fP(1). Cette option permet de désactiver cette fonctionnalité. .TP \fB\-\-control\fP Comparer les fichiers \fIcontrol\fP respectifs, ce qui est le comportement par défaut. Cette option permet de remplacer un paramètre d'un fichier de configuration. .TP \fB\-\-controlfiles\fP \fIFICHIER\fP[\fB,\fP\fIFICHIER\fP ...] Indiquer quels fichiers de contrôle comparer. Par défaut, il s'agit juste de \fIcontrol\fP, mais peut inclure \fIpostinst\fP, \fIconfig\fP, etc. Les fichiers ne seront comparés que s'ils sont présents dans les deux fichiers \fI.deb\fP. La valeur spéciale \fIALL\fP compare tous les fichiers de contrôle présents dans les deux paquets, à l'exception de md5sums. Cette option peut être utilisée pour remplacer les paramètres du fichier de configuration. .TP \fB\-\-wdiff\-source\-control\fP Lors du traitement des paquets source, comparer les fichiers de contrôle avec \fBwdiff\fP. C'est équivalent à l'option \fB\-\-control\fP pour les paquets binaires. .TP \fB\-\-no\-wdiff\-source\-control\fP Ne pas comparer les fichiers de contrôle des paquets source en utilisant \fBwdiff\fP. C'est le comportement par défaut. .TP \fB\-\-wp\fP, \fB\-\-wl\fP, \fB\-\-wt\fP Passe respectivement les options \fB\-p\fP, \fB\-l\fP ou \fB\-t\fP à \fBwdiff\fP (cela affiche le \fBwdiff\fP complet, plutôt que juste les lignes modifiées). .TP \fB\-\-show\-moved\fP Si plusieurs fichiers \fI.deb\fP sont fournis sur la ligne de commande, que la syntaxe utilisée soit des fichiers \fI.changes\fP soit la syntaxe \fB\-\-from\fP/\fB\-\-to\fP, alors cette option affichera également les fichiers (s'il y en a) qui ont été déplacés entre deux paquets. Les noms des paquets sont simplement déterminés par les noms des fichiers \fI.deb\fP. .TP \fB\-\-noshow\-moved\fP Le comportement par défaut\ ; cette option permet de remplacer les paramètres d'un fichier de configuration. .TP \fB\-\-renamed\fP \fIDEPUIS VERS\fP Si l'option \fB\-\-show\-moved\fP est utilisée et qu'un paquet a été renommé au cours du processus, cette commande indique à \fBdebdiff\fP de traiter le paquet de la première liste appelé \fIDEPUIS\fP comme s'il s'appelait \fIVERS\fP. Cette option peut être utilisée plusieurs fois. .TP \fB\-\-exclude\fP \fIMOTIF\fP Exclut les fichiers correspondant au \fIMOTIF\fP. Une utilisation multiple de cette option est possible. .TP \fB\-\-diffstat\fP Inclure le résultat de \fBdiffstat\fP avant de produire le différentiel. .TP \fB\-\-no\-diffstat\fP Le comportement par défaut\ ; cette option permet de remplacer les paramètres d'un fichier de configuration. .TP \fB\-\-auto\-ver\-sort\fP Lors de la comparaison de paquets source, comparer dans l'ordre des versions. .TP \fB\-\-no\-auto\-ver\-sort\fP Comparer les paquets source dans l'ordre où ils ont été fournis sur la ligne de commande, même si cela force la comparaison entre un paquet avec une version supérieure et un paquet avec une version inférieure. C'est le comportement par défaut. .TP \fB\-\-unpack\-tarballs\fP Lors de la comparaison des paquets source, ouvrir également les archives tar trouvées dans la racine des sources pour comparer leurs contenus en même temps que les autres fichiers. Il s'agit du comportement par défaut. .TP \fB\-\-no\-unpack\-tarballs\fP Ne pas ouvrir les archives tar se trouvant dans les paquets source. .TP \fB\-\-no\-conf\fP, \fB\-\-noconf\fP Ne lire aucun fichier de configuration. L'option ne peut être utilisée qu'en première position de la ligne de commande. .TP \fB\-\-debs\-dir\fP \fIrépertoire\fP Chercher les fichiers \fI.dsc\fP dans le \fIrépertoire\fP au lieu du répertoire parent du répertoire source. Cela doit être soit un chemin absolu, soit un chemin relatif à la racine du répertoire source. .TP \fB\-\-help\fP, \fB\-h\fP Afficher un résumé des options. .TP \fB\-\-version\fP, \fB\-v\fP Affiche la version et le copyright. .TP \fB\-\-quiet\fP, \fB\-q\fP Rester silencieux si aucune différence n'est trouvée. .TP \fB\-\-ignore\-space\fP, \fB\-w\fP Ignorer les blancs dans les diffs. .SH "VARIABLES DE CONFIGURATION" Les deux fichiers de configuration \fI/etc/devscripts.conf\fP et \fI~/.devscripts\fP sont évalués dans cet ordre par un interpréteur de commandes («\ shell\ ») pour placer les variables de configuration. Des options de ligne de commande peuvent être utilisées pour neutraliser les paramètres des fichiers de configuration. Les paramètres des variables d'environnement sont ignorés à cette fin. Si la première option donnée en ligne de commande est \fB\-\-noconf\fP, alors ces fichiers ne sont pas évalués. Les variables actuellement identifiées sont\ : .TP \fBDEBDIFF_DIRS\fP Lui attribuer la valeur \fIyes\fP équivaut à utiliser l'option \fB\-\-dirs\fP. .TP \fBDEBDIFF_CONTROL\fP Lui attribuer la valeur \fIno\fP équivaut à utiliser l'option \fB\-\-nocontrol\fP. La valeur par défaut est \fIyes\fP. .TP \fBDEBDIFF_CONTROLFILES\fP Définit les fichiers control à comparer, correspondant à l'option en ligne de commande \fB\-\-controlfiles\fP. La valeur par défaut est \fIcontrol\fP. .TP \fBDEBDIFF_SHOW_MOVED\fP Lui attribuer la valeur \fIyes\fP équivaut à utiliser l'option \fB\-\-show\-moved\fP. .TP \fBDEBDIFF_WDIFF_OPT\fP Cette option est passée à \fBwdiff\fP\ ; les valeurs possibles sont \fB\-p\fP, \fB\-l\fP ou \fB\-t\fP. .TP \fBDEBDIFF_SHOW_DIFFSTAT\fP Lui attribuer la valeur \fIyes\fP équivaut à utiliser l'option \fB\-\-diffstat\fP de la ligne de commande. .TP \fBDEBDIFF_WDIFF_SOURCE_CONTROL\fP Lui attribuer la valeur \fIyes\fP équivaut à utiliser l'option \fB\-\-wdiff\-source\-control\fP de la ligne de commande. .TP \fBDEBDIFF_AUTO_VER_SORT\fP Lui attribuer la valeur \fIyes\fP équivaut à utiliser l'option \fB\-\-auto\-ver\-sort\fP de la ligne de commande. .TP \fBDEBDIFF_UNPACK_TARBALLS\fP Lui attribuer la valeur \fIno\fP équivaut à utiliser l'option \fB\-\-no\-unpack\-tarballs\fP de la ligne de commande. .TP \fBDEBRELEASE_DEBS_DIR\fP Indiquer le répertoire dans lequel chercher les fichiers \fI.dsc\fP, et est soit un chemin absolu ou un chemin relatif à la racine du répertoire racine. Cela correspond à l'option en ligne de commande \fB\-\-debs\-dir\fP. Cette directive peut être utilisée par exemple si vous utilisez systématiquement \fBpbuilder\fP ou \fBsvn\-buildpackage\fP pour construire vos paquets. Remarquez que cela concerne également \fBdebrelease\fP(1), ce qui explique le nom étrange de l'option. .SH "VALEURS DE RETOUR" Normalement, la valeur de retour est 0 si aucune différence n'a été trouvée et 1 en cas de différence. Dans le cas d'une erreur fatale, la valeur de retour sera 255. .SH "VOIR AUSSI" \fBdebdiff\-apply\fP(1), \fBdiffstat\fP(1), \fBdpkg\-deb\fP(1), \fBinterdiff\fP(1), \fBwdiff\fP(1), \fBdevscripts.conf\fP(5), \fBdiffoscope\fP(1) .SH AUTEUR \fBdebdiff\fP a été initialement écrit sous forme de script shell par Yann Dirson et a été réécrit en Perl avec beaucoup plus de fonctionnalités par Julian Gilbey . C'est un logiciel libre qui peut être redistribué suivant les termes de la licence publique générale GNU, version\ 2. .SH TRADUCTION Ce document est une traduction, maintenue à l'aide de l'outil po4a <\fIhttps://po4a.alioth.debian.org/\fR> 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 à .nh <\fIdebian\-l10n\-french@lists.debian.org\fR> .hy 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 «\ \fB\-L\ C\fR\ » à la commande \fBman\fR.