Provided by: devscripts_2.10.61ubuntu5_i386 bug

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

DESCRIPTION

       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é 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 wdiff.

       Si aucun paramètre n’est donné, debdiff essaie de comparer  le  contenu
       du répertoire source courant avec la dernière version du paquet.

       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  .deb listés dans les fichiers
       .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.

       debdiff  examine  les  fichiers  de  configuration  de devscripts comme
       décrit ci-dessous. Les options  en  ligne  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.

OPTIONS

       --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 pris en compte.

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

       --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  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   --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
              debdiff compare normalement les deux fichiers control respectifs
              avec  wdiff(1).  Cette  option  permet   de   désactiver   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.

       --controlfiles FICHIER,FICHIER,...
              Spécifie  quels  fichiers  de  contrôle comparer. Par défaut, il
              s’agit juste de control, mais  peut  inclure  postinst,  config,
              etc.  Les  fichiers  ne  seront comparés que s’ils sont présents
              dans les deux fichiers .deb. La valeur spéciale ALL 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.

       --wdiff-source-control
              Lors  du  traitement des paquets source, comparer les fichier de
              contrôle avec wdiff. C’est équivalent à l’option --control  pour
              les paquets binaires.

       --no-wdiff-source-control
              Ne  pas  comparer les fichiers de contrôle des paquets source en
              utilisant wdfiff. C’est le comportement par défaut.

       --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  fournis  sur  la  ligne  de
              commande,  que  la  syntaxe  utilisée soit des fichiers .changes
              soit  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é  au cours du 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.

       --exclude MOTIF
              Exclut les fichiers  correspondant  au  MOTIF.  Une  utilisation
              multiple de cette option est possible.

       --diffstat
              Inclure le résultat de diffstat avant de générer le diff.

       --no-diffstat
              Le  comportement  par  défaut ; cette option permet de remplacer
              les paramètres 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, 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.

       --unpack-tarballs
              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.

       --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
              utilisée qu’en première position de la ligne de commande.

       --help, -h
              Afficher un résumé des options.

       --version, -v
              Affiche la version et le copyright.

       --quiet, -q
              Reste silencieux si aucune différence n’est trouvée.

       --ignore-space, -w
              Ignorer les blancs dans les diffs.

VARIABLES DE CONFIGURATION

       Les    deux   fichiers   de   configuration   /etc/devscripts.conf   et
       ~/.devscripts 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 --noconf, alors ces fichiers ne
       sont pas évalués. Les variables actuellement identifiées sont :

       DEBDIFF_DIRS
              Si elle est positionnée à  yes,  équivaut  à  utiliser  l’option
              --dirs.

       DEBDIFF_CONTROL
              Si  elle  est  positionnée  à  no,  équivaut à utiliser l’option
              --nocontrol. La valeur par défaut est yes.

       DEBDIFF_CONTROLFILES
              Définit  les  fichiers  control  à  comparer,  correspondant   à
              l’option  en  ligne  de  commande  --controlfiles. La valeur par
              défaut est control.

       DEBDIFF_SHOW_MOVED
              Si elle est positionnée à  yes,  équivaut  à  utiliser  l’option
              --show-moved.

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

       DEBDIFF_SHOW_DIFFSTAT
              Si elle est positionnée à  yes,  équivaut  à  utiliser  l’option
              --diffstat de la ligne de commande.

       DEBDIFF_WDIFF_SOURCE_CONTROL
              Si  elle  est  positionnée  à  yes, équivaut à utiliser l’option
              --wdiff-source-control de la ligne de commande.

       DEBDIFF_AUTO_VER_SORT
              Si elle est positionnée à  yes,  équivaut  à  utiliser  l’option
              --auto-ver-sort de la ligne de commande.

       DEBDIFF_UNPACK_TARBALLS
              Si  elle  est  positionnée  à  no, alors c’est comme si l’option
              --no-unpack-tarballs était utilisée.

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.

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

TRADUCTION

       Ce   document  est  une  traduction,  réalisée  par  Nicolas  François,
       Guillaume Delacour, Cyril Brulebois et Thomas Huriaux.

       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.