debdiff - compare la liste des fichiers de deux paquets Debian

debdiff [options] ... deb1 deb2

debdiff [options] ... changes1 changes2

debdiff [options] ... --from deb1a deb1b ... --to deb2a deb2b ...

debdiff [options] ... dsc1 dsc2

debdiff prend en argument le nom de deux paquets Debian (fichiers .deb) et compare leur contenu (en comparant uniquement les fichiers du paquet principal, 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 compare également le fichier control des deux paquets à l'aide du programme wdiff.

debdiff peut aussi gérer les changements entre des groupes de fichiers .deb de deux façons. La première consiste à spécifier deux fichiers .changes. Dans ce cas, les fichiers .debs listés dans le fichier .changes seront comparés, en considérant ensemble le contenu de tous les fichiers .deb. Il est supposé que les fichiers .deb se trouvent dans le même répertoire que le fichier .changes. La deuxième façon consiste à lister les fichiers .deb avec la syntaxe --from ... (depuis) et --to ... (vers). On peut ainsi vérifier que, lorsqu'un paquet est découpé en paquets plus petits, rien n'est perdu au passage. Dans ces deux cas, les fichiers control sont comparés seulement s'il y a un seul .deb impliqué de chaque côté de la comparaison.

debdiff examine les fichiers de configuration de devscripts comme décrit ci-dessous. Les options en lignes de commande permettent de remplacer les paramètres des fichiers de configuration.

Si deux paquets source (fichiers .dsc) sont fournis à debdiff, 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 .orig.tar.gz sont identiques dans les deux fichiers .dsc), alors interdiff(1) sera utilisé pour comparer les deux fichiers de rustine si ce programme est disponible sur le système, sinon, diff sera utilisé sur les deux arborescences des sources.

--dirs, -d

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 également considérés.

--nodirs

Ignore 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.

--move DEPUIS VERS, -m DEPUIS VERS

Il arrive parfois que différents fichiers ou répertoires soient déplacés entre deux versions. On peut gérer 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 commencaient par le second argument. Vous pouvez donner un nombre arbitraire d'arguments --move : ils sont interprétés dans l'ordre d'apparition.

--move-regex DEPUIS VERS

Identique à --move, mais DEPUIS est traité comme une expression rationnelle et la commande de substitution perl s/^DEPUIS/VERS/ est appliquée aux fichiers. En particulier, VERS peut avoir des références arrières telles que $1.

--nocontrol

Si debdiff est appelé avec deux noms de fichier .deb alors il compare les fichiers control respectifs avec wdiff(1). Cette option permet de supprimer cette fonctionnalité.

--control

Compare les fichiers control respectifs, ce qui est le comportement par défaut. Cette option permet de remplacer un paramètre d'un fichier de configuration.

--wp, --wl, --wt

Passe respectivement les options -p, -l ou -t à wdiff. (Ceci affiche le wdiff complet, plutôt que juste les lignes modifiées).

--show-moved

Si plusieurs fichiers .deb sont spécifiés sur la ligne de commande, que la syntaxe utilisée soit des fichiers .changes ou la syntaxe --from/--to, 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 .deb.

--noshow-moved

Le comportement par défaut ; cette option permet de remplacer les paramètres d'un fichier de configuration.

--renamed DEPUIS VERS

Si l'option --show-moved est utilisée et qu'un paquet a été renommé dans le processus, cette commande indique à debdiff de traiter le paquet de la première liste appelé DEPUIS comme s'il s'appelait VERS. Cette option peut être utilisée plusieurs fois.

--no-conf, --noconf

Ne lit aucun fichier de configuration. L'option ne peut être utilisée qu'en première position de la ligne de commande.

--help, -h

Affiche un résumé des options.

--version, -v

Affiche la version et le copyright.

Les deux fichiers de configuration /etc/devscripts.conf et ~/.devscripts sont évalués dans cet ordre par un interpréteur de commande (« 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 --noconf, alors ces fichiers ne sont pas évalués. Les variables actuellement identifiées sont :

DEBDIFF_DIRS

Si elle est positionnée à yes, c'est comme si l'option --dirs était utilisée.

DEBDIFF_CONTROL

Si elle est positionnée à no, c'est comme si l'option --nocontrol était utilisée. La valeur par défaut est yes

DEBDIFF_SHOW_MOVED

Si elle est positionnée à yes, c'est comme si l'option --show-moved était utilisée.

DEBDIFF_WDIFF_OPT

Cette option est passée à wdiff ; les valeurs possibles sont -p, -l ou -t.

La valeur de retour normale est 0. Dans le cas d'une erreur fatale, la valeur de retour n'est pas nulle.

dpkg-deb(1), wdiff(1), interdiff(1) et devscripts.conf(5).

debdiff a été originellement écrit sous forme de script shell par Yann Dirson <dirson@debian.org> et a été ré-écrit en Perl avec beaucoup plus de fonctionnalités par Julian Gilbey <jdg@debian.org>. C'est un logiciel libre qui peut être redistribué suivant les termes de la licence publique générale GNU, version 2.

Ce document est une traduction, réalisée par Nicolas FRANÇOIS le 21 janvier 2005.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité.

La version anglaise la plus à jour de ce document est toujours consultable en ajoutant l'option « -L C » à la commande man.

N'hésitez 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.