NOM
debdiff - Comparer la liste des fichiers de deux paquets Debian
SYNOPSIS
debdiff [options]
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
ou .udeb) et compare leur contenu (en comparant uniquement les fichiers
principaux, sans les scripts de maintenance). Il affiche quels fichiers
ont t ajouts ou retirs entre deux paquets. Il est de ce fait utile pour
pointer les fichiers perdus par inadvertance entre deux versions d'un
paquet. Il vrifie galement les permissions et propritaires des fichiers
et compare le fichier control des deux paquets l'aide du programme
wdiff.
Si aucun paramtre n'est donn, debdiff essaie de comparer le contenu du
rpertoire source courant avec la dernire version du paquet.
debdiff peut aussi grer les changements entre des groupes de fichiers
.deb de deux faons. La premire consiste spcifier deux fichiers
.changes. Dans ce cas, les fichiers .deb lists dans les fichiers
.changes seront compars, en considrant ensemble le contenu de tous les
fichiers .deb. Il est suppos que les fichiers .deb se trouvent dans le
mme rpertoire que le fichier .changes. La deuxime faon consiste lister
les fichiers .deb avec la syntaxe --from ... (depuis) et --to ...
(vers). On peut ainsi vrifier que, lorsqu'un paquet est dcoup en
paquets plus petits, rien n'est perdu au passage.
debdiff examine les fichiers de configuration de devscripts comme dcrit
ci-dessous. Les options en ligne de commande permettent de remplacer
les paramtres 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
diffrent que par leur numro 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 systme, sinon, diff sera
utilis sur les deux arborescences des sources.
OPTIONS
--dirs, -d
Le mode opratoire par dfaut est d'ignorer les noms de rpertoire
qui apparaissent dans la liste de fichiers ; mais avec cette
option, ils seront pris en compte.
--nodirs
Ignorer les rpertoires dont le nom apparat dans la liste de
fichiers. C'est le comportement par dfaut. Cette option permet
de remplacer un paramtre d'un fichier de configuration.
--move DEPUIS VERS, -m DEPUIS VERS
Il arrive parfois que diffrents fichiers ou rpertoires soient
dplacs entre deux versions. On peut rgler le problme en
utilisant cette option. Les deux arguments reprsentent les
emplacements du rpertoire ou du fichier dans le premier et dans
le second paquet. Quand les listes de fichiers sont compares,
tous les fichiers de la premire liste dont le nom commence par
le premier argument sont traits comme s'ils commenaient par le
second argument. Vous pouvez donner un nombre arbitraire
d'arguments --move : ils sont interprts 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 applique aux fichiers. En particulier, VERS peut avoir des
rfrences arrires telles que $1.
--nocontrol
debdiff compare normalement les deux fichiers control respectifs
avec wdiff(1). Cette option permet de dsactiver cette
fonctionnalit.
--control
Compare les fichiers control respectifs, ce qui est le
comportement par dfaut. Cette option permet de remplacer un
paramtre d'un fichier de configuration.
--controlfiles FICHIER,FICHIER,...
Spcifie quels fichiers de contrle comparer. Par dfaut, il s'agit
juste de control, mais peut inclure postinst, config, etc. Les
fichiers ne seront compars que s'ils sont prsents dans les deux
fichiers .deb. La valeur spciale ALL compare tous les fichiers
de contrle prsents dans les deux paquets, l'exception de
md5sums. Cette option peut tre utilise pour remplacer les
paramtres du fichier de configuration.
--wdiff-source-control
Lors du traitement des paquets source, comparer les fichier de
contrle avec wdiff. C'est quivalent l'option --control pour les
paquets binaires.
--no-wdiff-source-control
Ne pas comparer les fichiers de contrle des paquets source en
utilisant wdfiff. C'est le comportement par dfaut.
--wp, --wl, --wt
Passe respectivement les options -p, -l ou -t wdiff. (Ceci
affiche le wdiff complet, plutt que juste les lignes modifies.)
--show-moved
Si plusieurs fichiers .deb sont fournis sur la ligne de
commande, que la syntaxe utilise soit des fichiers .changes soit
la syntaxe --from/--to, alors cette option affichera galement
les fichiers (s'il y en a) qui ont t dplacs entre deux paquets.
Les noms des paquets sont simplement dtermins par les noms des
fichiers .deb.
--noshow-moved
Le comportement par dfaut ; cette option permet de remplacer les
paramtres d'un fichier de configuration.
--renamed DEPUIS VERS
Si l'option --show-moved est utilise et qu'un paquet a t renomm
au cours du processus, cette commande indique debdiff de
traiter le paquet de la premire liste appel DEPUIS comme s'il
s'appelait VERS. Cette option peut tre utilise plusieurs fois.
--exclude MOTIF
Exclut les fichiers correspondant au MOTIF. Une utilisation
multiple de cette option est possible.
--diffstat
Inclure le rsultat de diffstat avant de gnrer le diff.
--no-diffstat
Le comportement par dfaut ; cette option permet de remplacer les
paramtres d'un fichier de configuration.
--auto-ver-sort
Lors de la comparaison de paquets source, comparer dans l'ordre
des versions.
--no-auto-ver-sort
Comparer les paquets source dans l'ordre o ils ont t fournis sur
la ligne de commande, mme si cela force la comparaison entre un
paquet avec une version suprieure et un paquet avec une version
infrieure. C'est le comportement par dfaut.
--unpack-tarballs
Lors de la comparaison des paquets source, ouvrir galement les
archives tar trouves dans la racine des sources pour comparer
leurs contenus en mme temps que les autres fichiers. Il s'agit
du comportement par dfaut.
--no-unpack-tarballs
Ne pas ouvrir les archives tar se trouvant dans les paquets
source.
--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
Afficher un rsum des options.
--version, -v
Affiche la version et le copyright.
--quiet, -q
Reste silencieux si aucune diffrence n'est trouve.
--ignore-space, -w
Ignorer les blancs dans les diffs.
VARIABLES DE CONFIGURATION
Les deux fichiers de configuration /etc/devscripts.conf et
~/.devscripts sont valus dans cet ordre par un interprteur de commandes
( shell ) pour placer les variables de configuration. Des options de
ligne de commande peuvent tre utilises pour neutraliser les paramtres
des fichiers de configuration. Les paramtres des variables
d'environnement sont ignors cette fin. Si la premire option donne en
ligne de commande est --noconf, alors ces fichiers ne sont pas valus.
Les variables actuellement identifies sont :
DEBDIFF_DIRS
Si elle est positionne yes, quivaut utiliser l'option --dirs.
DEBDIFF_CONTROL
Si elle est positionne no, quivaut utiliser l'option
--nocontrol. La valeur par dfaut est yes.
DEBDIFF_CONTROLFILES
Dfinit les fichiers control comparer, correspondant l'option
en ligne de commande --controlfiles. La valeur par dfaut est
control.
DEBDIFF_SHOW_MOVED
Si elle est positionne yes, quivaut utiliser l'option
--show-moved.
DEBDIFF_WDIFF_OPT
Cette option est passe wdiff ; les valeurs possibles sont -p,
-l ou -t.
DEBDIFF_SHOW_DIFFSTAT
Si elle est positionne yes, quivaut utiliser l'option
--diffstat de la ligne de commande.
DEBDIFF_WDIFF_SOURCE_CONTROL
Si elle est positionne yes, quivaut utiliser l'option
--wdiff-source-control de la ligne de commande.
DEBDIFF_AUTO_VER_SORT
Si elle est positionne yes, quivaut utiliser l'option
--auto-ver-sort de la ligne de commande.
DEBDIFF_UNPACK_TARBALLS
Si elle est positionne no, alors c'est comme si l'option
--no-unpack-tarballs tait utilise.
VALEURS DE RETOUR
Normalement, la valeur de retour est 0 si aucune diffrence n'a t trouve
et 1 en cas de diffrence. Dans le cas d'une erreur fatale, la valeur de
retour sera 255.
VOIR AUSSI
dpkg-deb(1), wdiff(1), interdiff(1), diffstat(1) et devscripts.conf(5).
AUTEUR
debdiff a t initialement crit sous forme de script shell par Yann
Dirson <dirson@debian.org> et a t rcrit en Perl avec beaucoup plus de
fonctionnalits par Julian Gilbey <jdg@debian.org>. C'est un logiciel
libre qui peut tre redistribu suivant les termes de la licence publique
gnrale GNU, version 2.
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.