Loading

NOM

       uscan - Tester/surveiller la disponibilit d'une nouvelle version amont

SYNOPSIS

       uscan [options] [chemin-vers-le-paquet-source ...]

       uscan  parcourt  les rpertoires donns (ou le rpertoire courant si aucun
       n'est indiqu) et tous leurs sous-rpertoires  la  recherche  de  paquets
       contenant  un  fichier  de  contrle  debian/watch. Les paramtres de ces
       fichiers de contrle sont ensuite analyss, et  les  sites  FTP  ou  HTTP
       amont  sont  inspects  pour  tester la prsence de nouvelles mises  jour
       (qui  sont  compares  aux  numros  de  version   amont   des   fichiers
       debian/changelog  du  mme  rpertoire). Les mises  jour les plus rcentes
       (en fonction de leur numro de version) sont rcupres et un programme est
       excut  sur  les  sources  tlcharges  si  c'est  spcifi  dans le fichier
        watch .

       Les fichiers debian/watch traditionnels  peuvent  encore  tre  utiliss,
       mais  le  format  actuel est  la fois plus simple et offre des services
       plus  souples.  L'ancien  format  n'est  pas   dcrit   ici.   Pour   la
       documentation  de  l'ancien  format,  reportez-vous  au  code source de
       uscan.

FORMAT du fichier debian/watch

       L'exemple suivant montre le type d'entre que l'on peut trouver dans  un
       fichier debian/watch. Bien sr, toutes ces entres n'apparatront pas dans
       un seul fichier. Il y a d'habitude  une  seule  ligne  pour  le  paquet
       courant.

       # numro de version du format, actuellement 3.
       # Cette ligne est obligatoire !
       version=3

       # Les lignes peuvent tre poursuivies  la ligne suivante avec un \

       # Voici le format pour un site FTP :
       # Nom-complet-du-site-avec-modle [Version [Action]]
       ftp://ftp.tex.ac.uk/tex-archive/web/c_cpp/cweb/cweb-(.*)\.tar\.gz \
         debian  uupdate

       # Voici la syntaxe pour un site FTP, avec une expression rationnelle
       # dans le nom du fichier
       ftp://ftp.worldforge.org/pub/worldforge/libs/Atlas-C++/transitional/Atlas-C\+\+-(.*)\.tar\.gz

       # Voici la syntaxe pour un site FTP avec un modle de rpertoire
       ftp://ftp.nessus.org/pub/nessus/nessus-([\d\.]+)/src/nessus-core-([\d\.]+)\.tar\.gz

       # Voici comment remplacer le paramtre PASV pour un site spcifique :
       # opts=pasv ftp://.../...

       # Il s'agit d'un format pour un site HTTP, identique  celui d'un
       # site FTP. uscan commence par tlcharger la page principale,
       # obtenue en supprimant le dernier lment de l'URL ; dans ce cas,
       # http://www.cpan.org/modules/by-module/Text/
       http://www.cpan.org/modules/by-module/Text/Text-CSV_XS-(.*)\.tar\.gz

       # Voici un autre format pour les sites HTTP,
       # qui permet de spcifier directement la page principale :
       # Page principale  Modle  [Version  [Action]]
       http://www.dataway.ch/~lukasl/amph/amph.html \
         files/amphetamine-([\d\.]*).tar.bz2

       # Cet exemple montre qu'il est possible de scanner des rpertoires, sous
       # deux formes diffrentes,  condition que le site web autorise les
       # requtes de la forme http://site/rpertoire/inter/mdiaire/
       http://tmrc.mit.edu/mirror/twisted/Twisted/(\d\.\d)/ \
         Twisted-([\d\.]*)\.tar\.bz2
       http://tmrc.mit.edu/mirror/twisted/Twisted/(\d\.\d)/Twisted-([\d\.]*)\.tar\.bz2

       # qa.debian.org fournit un redirecteur qui permet une forme plus
       # simple pour les projets hbergs sur SourceForge. Le format
       # ci-dessous sera automatiquement rcrit pour utiliser le redirecteur
       http://sf.net/audacity/audacity-src-(.+)\.tar\.gz

       # githubredir.debian.net est un redirecteur pour les projets GitHub
       # Il peut tre utilis de la faon suivante :
       http://githubredir.debian.net/github/<utilisateur>/<projet> (.*).tar.gz

       # Ceci est le format pour un site qui possde des numros de
       # version exotiques ; le groupe entre parenthses devra tre joint
       # par des points pour crer un numro de version sain
       http://www.site.com/pub/toto/toto_v(\d+)_(\d+)\.tar\.gz

       # Voici une autre manire pour des sites ayant des numros de version
       # bizarres, en effectuant une modification cette fois. (Notez que
       # plusieurs groupes seront concatns avant d'effectuer la modification,
       # et que les modifications ne seront effectues que sur le numro de
       # version de base, et pas dans les versions contenues dans les chemins.)
       opts="uversionmangle=s/^/0.0/" \
         ftp://ftp.ibiblio.org/pub/Linux/ALPHA/wine/development/Wine-(.*)\.tar\.gz

       # De manire similaire, la partie de la version amont du numro de
       # version Debian peut tre modifie :
       opts=dversionmangle=s/\.dfsg\.\d+$// \
         http://un.site.org/un/chemin/toto-(.*)\.tar\.gz

       # Le nom de fichier est dtermin en prenant le dernier composant de
       # l'URL et en retirant tout ce qui se trouve aprs un ventuel  ? .
       # Si a ne donne pas de nom de fichier utilisable, utilisez
       # filenamemangle. Par exemple,
       # <A href="http://toto.titi.org/download/?path=&amp;download=toto-0.1.1.tar.gz">
       # peut tre gr ainsi :
       # opts=filenamemangle=s/.*=(.*)/$1/ \
       #     http://toto.titi.org/download/\?path=&amp;download=toto-(.*)\.tar\.gz
       #
       # <A href="http://toto.titi.org/download/?path=&amp;download_version=0.1.1">
       # peut tre gr ainsi :
       # opts=filenamemangle=s/.*=(.*)/toto-$1\.tar\.gz/ \
       #    http://toto.titi.org/download/\?path=&amp;download_version=(.*)

       # L'option downloadurlmangle peut tre utilise pour modifier l'URL
       # du fichier  tlcharger. Ceci ne peut tre utilis qu'avec des liens
       # http://. Ceci peut tre ncessaire si le lien donn sur la page web
       # doit tre transform de manire  ce que cela fonctionne
       # automatiquement, par exemple :
       # opts=downloadurlmangle=s/prdownload/download/ \
       #   http://developer.berlios.de/project/showfiles.php?group_id=2051 \
       #   http://prdownload.berlios.de/softdevice/vdr-softdevice-(.*).tgz

       Des lignes de commentaire peuvent tre ajoutes avec un caractre  # . Les
       lignes peuvent se poursuivre  la ligne suivante en les terminant par un
       caractre backslash ( \ ).

       La  premire  ligne  (en ne prenant pas en compte les commentaires) doit
       commencer  par   version=3 .  Ceci  devrait  permettre  des  extensions
       futures, sans avoir  changer le nom du fichier.

       Les  fichiers   watch   acceptent deux syntaxes pour les sites HTTP, et
       une seule pour les sites FTP. Voici la syntaxe la plus commune  (et  la
       plus simple). Le premier champ optionnel opts=... est dcrit plus bas et
       sera ignor dans ce qui suit.

       Le premier champ donne le modle complet des URL   rechercher.  Dans  le
       cas  d'un  site  FTP,  la  liste  des fichiers du rpertoire indiqu sera
       demande et il recherchera dans cette liste des fichiers dont le nom  de
       base (ce qui suit le  /  final) correspond. Dans le cas d'un site HTTP,
       il recherche dans l'URL obtenue en enlevant tout ce qui suit le  /   de
       fin  des rfrences  href  (liens de la forme <a href=...>) vers soit une
       URL complte, un chemin absolu (l'ensemble  de  l'URL,  sans  la  partie
       http://nom.serveur/)  ou encore vers un nom de base (la partie qui suit
       le  /  final) qui correspond au modle donn.  L'ensemble,  jusqu'au   /
       final  est  considr  comme  l'URL  complte,  tant  qu'il  n'y  a pas de
       parenthse ( (  et  ) ) dans  cette  partie  de  l'URL.  S'il  y  a  des
       parenthses,  on cherchera  faire correspondre le nom du rpertoire de la
       mme faon que l'lment final de l'URL, comme dcrit ci-dessous.  (Veuillez
       noter que les caractres spciaux des expressions rationnelles, comme  +
       sont considrs littralement,  moins qu'ils se trouvent dans  une  partie
       entre  parenthses ; voyez l'exemple d'Atlas-C++ ci-dessus. De plus, les
       parenthses doivent se fermer  l'intrieur de chaque lment du chemin.)

       Le modle (la partie aprs le  /  final) est une  expression  rationnelle
       Perl (voir perlre(1) pour plus de dtails). Vous devez utiliser un modle
       suffisamment strict pour qu'il ne corresponde qu'au programme amont qui
       vous  intresse,  et  rien d'autre. Aussi, le modle sera ancr au dbut et
       la fin pour qu'il corresponde au nom complet. (Notez que dans  les  URL
       HTTP,  le champ  href  peut contenir un chemin absolu ou le nom du site
       avec le chemin, et tre toujours accept.)  Le  modle  doit  contenir  au
       moins un groupe Perl comme dcrit dans le prochain paragraphe.

       Aprs  avoir  rcupr  une liste de  fichiers  qui correspondent au modle,
       leurs numros de version sont  extraits  en  concatnant  l'ensemble  des
       groupes  de  l'expression  rationnelle Perl (dmarqus par  (...) ) et en
       les sparant par un  . . Ce numro est considr comme le numro de  version
       du  fichier.  Les  numros  de  version sont ensuite modifis si l'option
       uversionmangle, dcrite ci-dessous, a t prcise. Enfin, les versions  des
       fichiers  sont  ensuite compares pour trouver celui qui a le plus grand
       numro de version, qui est trouv en utilisant  dpkg  --compare-versions.
       Note :  si  vous avez besoin de groupes qui ne sont pas utiliss dans le
       numro de version, utilisez soit  (?:...)  soit l'option  uversionmangle
       pour nettoyer la version par la suite.

       La  version  courante (amont) peut tre indique comme le second paramtre
       dans la ligne du fichier. Si elle vaut debian ou est absente, alors  la
       version    courante    Debian   (telle   qu'elle   est   dtermine   par
       debian/changelog) est utilise pour dterminer la version amont courante.
       La   version  amont  courante  peut  aussi  tre  indique  par  l'option
       --upstream-version en ligne  de  commande,  qui  spcifie  le  numro  de
       version  amont du paquet actuellement install (c'est--dire, le numro de
       version Debian sans epoch ni version Debian). Le numro de version amont
       sera  alors  modifi  en  utilisant  l'option dversionmangle si elle est
       indique, tel que cela est dcrit plus bas. Si la version la plus  rcente
       disponible  est  plus  rcente  que la version courante, alors elle sera
       tlcharge dans le  rpertoire  parent,  sans  que  l'option  --report  ou
       --report-status  ait t utilise. Une fois que le fichier a t tlcharg, un
       lien  symbolique  vers   le   fichier   est   cr   depuis   le   paquet
       <paquet>_<version>.orig.tar.gz  si  le  fichier a un suffixe .tar.gz ou
       .tgz et  <paquet>_<version>.orig.tar.bz2 si le  fichier  a  un  suffixe
       .tar.bz2, .tbz ou .tbz2.

       Enfin,  si  un  troisime  paramtre  est  donn  dans la ligne du fichier
        watch , il est considr comme le nom d'une commande, et la commande :
           commande --upstream-version version nom_fichier
       est excute, en utilisant soit le fichier initial, soit le nom  du  lien
       symbolique.  En  rgle gnrale, cette commande est uupdate. (Notez que la
       syntaxe d'appel est lgrement diffrente de celle  des  fichiers   watch
       sans  la  ligne   version=... ,  pour  lesquels la commande excute tait
        commande fichier version .)

       L'autre syntaxe possible pour les URL HTTP est la suivante. Le  premier
       champ  correspond   la  page  d'accueil  qui  doit tre tlcharge et dans
       laquelle doivent tre recherchs  les  liens  ( href )  correspondant  au
       modle  donn  dans le second champ. (Encore une fois, ce modle sera ancr
       son dbut et
        sa fin, de faon   ce  qu'il  corresponde  au  lien  complet.  Si  vous
       chercher
        faire  correspondre  uniquement  le  nom  de base du lien, vous pouvez
       utiliser un modle comme  .*/nom-(.*)\.tar\.gz  si vous savez qu'il y  a
       une URL complte, ou encore mieux :  (?:.*/)?nom-(.*)\.tar\.gz  si l'URL
       peut tre ou ne pas tre complte. Notez l'utilisation  de   (?:...)   qui
       vite  de  crer  une rfrence.) Si un des liens de cette page est une URL
       relative, elle sera considre comme relative  l'URL de base de  la  page
       d'accueil  (c'est--dire  en retirant tout ce qui suit le  /  final), ou
       relative l'URL de base indique dans cette page avec  une  balise  <base
       href="...">.  Les  troisime et quatrime champs sont les champs du numro
       de version et de la commande, comme prcdemment.

OPTIONS SPCIFIQUES UN SITE

       Une ligne du fichier   watch   peut  tre  prcde  de   opts=options ,  o
       options  est  une  liste  d'options  spares  par des virgules. La chane
       options peut tre place entre  guillemets  doubles  ( " ),  ce  qui  est
       ncessaire si options contient des espaces. Les options reconnues sont :

       active et passive (ou pasv)
              Si utilis sur une ligne FTP, ceci forcera l'utilisation du  mode
              passif (PASV) ou actif pour ce site.

       uversionmangle=rgles
              Ceci permet de modifier le numro de version amont qui correspond
              une rgle ftp://... ou http://... de la faon  suivante.  Dans  un
              premier  temps,  les  rgles  sont  dcoupes en plusieurs rgles en
              utilisant  ;  comme sparateur. Puis les numros de version  amont
              sont  modifis  en  appliquant  la  rgle   la  version,  de  faon
              similaire  l'excution de la commande Perl suivante :
                  $version =~ rgle;
              pour chaque rgle. Ainsi, la rgle  s/^/0./  permet d'ajouter  0.
              au  dbut  du  numro  de  version  et   s/_/./g  pour changer les
               underscore  en point. Notez que la chane de caractres  rgle  ne
              doit  pas  contenir  de  virgule ;  ceci  ne  devrait pas tre un
              problme.

              rgle ne peut utiliser que les oprations  s ,  tr  et  y .  Quand
              l'opration   s   est utilise, seuls les drapeaux  g ,  i  et  x
              peuvent tre  utiliss  et  rgle  ne  peut  contenir  d'expression
              pouvant excuter du code (c'est--dire que les constructions de la
              forme (?{}) ou (??{}) ne sont pas prises en charge).

       dversionmangle=rgles
              Utilis pour modifier  le  numro  de  version  Debian  du  paquet
              courant install dans la mme optique que l'option uversionmangle.
              Ainsi, une  rgle  approprie  peut  tre   s/\.dfsg\.\d+$//   pour
              supprimer  le  suffixe  .dfsg.1  dans un numro de version Debian
              ou pour grer les numros de version de type  .pre6 . Ici  encore,
              la  chane  de  caractres rgles ne doit pas contenir de virgule ;
              ceci ne devrait pas tre un problme.

       versionmangle=rgles
              Il     s'agit     d'un      raccourci      syntactique      pour
              uversionmangle=rgles,dversionmangle=rgles,  appliquant  les mmes
              rgles  la fois aux numros de version Debian et amont.

       filenamemangle=rgles
              Ceci est utilis pour modifier le nom de fichier sous  lequel  le
              fichier tlcharg sera enregistr, et est parcouru de la mme manire
              qu'avec l'option uversionmangle. Les exemples d'utilisation sont
              donns dans la section ci-dessus.

       downloadurlmangle=rgles
              Ceci   est   utilis   pour  modifier  l'URL  ncessaire  pour  le
              tlchargement. L'URL est d'abord calcule en se basant sur la page
              principale  tlcharge  et sur la correspondance du motif, puis le
              numro de version est dtermin depuis cette URL. Enfin, toutes les
              rgles  donnes  par  cette  option  sont  appliques  avant que la
              tentative   de   tlchargement   soit   effectue.   Un    exemple
              d'utilisation est donn dans la section des exemples ci-dessus.

Vrification du nom du rpertoire

       Comme  plusieurs autres scripts du paquet devscripts, uscan parcourt le
       rpertoire  demand   la  recherche  de  fichiers   debian/changelog   et
       debian/watch.  Pour  se  protger  contre  certains  fichiers  gars  qui
       pourraient poser problme, il examine le nom  du  rpertoire  parent  une
       fois qu'il a trouv le fichier debian/changelog, et vrifie que le nom du
       rpertoire correspond au nom du paquet. Il ne cherchera   tlcharger  les
       nouvelles versions d'un paquet et  effectuer l'action demande que si le
       nom du rpertoire correspond au nom du paquet. La  faon  prcise  utilise
       est  contrle  par  les  deux  variables  du  fichier  de  configuration
       DEVSCRIPTS_CHECK_DIRNAME_LEVEL  et  DEVSCRIPTS_CHECK_DIRNAME_REGEX,  et
       les  options  en  ligne  de  commande associes --check-dirname-level et
       --check-dirname-regex.

       DEVSCRIPTS_CHECK_DIRNAME_LEVEL peut prendre les valeurs suivantes :

       0      Ne vrifie jamais le nom du rpertoire.

       1      Ne vrifie le nom du  rpertoire  que  s'il  a  fallu  changer  de
              rpertoire  pour trouver le fichier debian/changelog, c'est--dire
              que le rpertoire qui  contient  debian/changelog  n'est  pas  le
              rpertoire  dans  lequel  uscan a t invoqu. C'est le comportement
              par dfaut.

       2      Vrifie toujours le nom du rpertoire.

       Le nom du rpertoire est vrifi en testant si le nom du rpertoire courant
       (donn  par  pwd(1))  correspond   l'expression rationnelle donne par la
       variable DEVSCRIPTS_CHECK_DIRNAME_REGEX du fichier de configuration  ou
       par  l'option  --check-dirname-regex  regex. Il s'agit d'une expression
       rationnelle Perl (voir perlre(1)), qui sera ancre  son dbut et  sa fin.
       Si  elle  contient  un   / ,  alors  elle  doit  correspondre au chemin
       complet. Si elle contient la chane  PACKAGE , cette chane sera remplace
       par le nom du paquet source dtermin par le fichier changelog. La valeur
       par dfaut de cette expression rationnelle est  PACKAGE(-.+)? ,  ce  qui
       correspond aux rpertoires nomms PACKAGE ou PACKAGE-version.

EXEMPLE

       Ce  script  va  raliser  une  mise   jour  compltement automatique avec
       l'amont.

       #!/bin/sh -e
       # appel avec '--upstream-version' <version> <fichier>
       uupdate "$@"
       package=`dpkg-parsechangelog | sed -n 's/^Source: //p'`
       cd ../$package-$2
       debuild

       Remarquez que dupload et  dput  ne  sont  pas  appels  automatiquement,
       puisque  le  responsable  doit raliser des vrifications sur le logiciel
       avant de l'envoyer  l'archive Debian.

OPTIONS

       --report, --no-download
              Ne fournit qu'un rapport indiquant les nouvelles versions,  mais
              ne tlcharge rien.

       --report-status
              Rapporte  l'tat  de  tous  les paquets, mme ceux qui sont  jour,
              mais ne tlcharge rien du tout.

       --download
              Fournit un rapport puis tlcharge.  (C'est  le  comportement  par
              dfaut.)

       --destdir
              Chemin du rpertoire dans lequel placer les fichiers tlchargs.

       --force-download
              Tlcharger   le   fichier  amont  mme  si  le  paquet  est   jour
              (cependant, les fichiers locaux ne sont pas crass).

       --pasv Force le mode passif ( PASV ) pour les connexions FTP.

       --no-pasv
              N'utilise pas le mode passif pour les connexions FTP.

       --timeout N
              Dfini le temps d'attente  N secondes (20 secondes par dfaut).

       --symlink
              Utilise un  lien  symbolique  pour  orig.tar.gz  (respectivement
              orig.tar.bz2)  lorsque  les fichiers tlchargs ont des extensions
              .tar.gz ou .tgz (respectivement .tar.bz2, .tbz et .tbz2). (C'est
              le comportement par dfaut.)

       --rename
              Au  lieu  de  crer  des  liens symboliques, renomme les fichiers
              tlchargs avec leur nom Debian orig.tar.gz  si  leurs  extensions
              sont  .tar.gz  ou  .tgz et de manire semblable pour les fichiers
              d'extension tar.bz2.

       --repack
              Aprs avoir tlcharg une archive tar compresse avec lzma ou xz  ou
              bzip  ou  une  archive  zip, la rempaqueter dans une archive tar
              compresse avec gzip, ce qui  est  toujours  ncessaire  pour  les
              paquets source Debian. Ne rien faire si l'archive tlcharge n'est
              ni une archive tar compresse avec lzma ou  xz  ou  bzip  ni  une
              archive  zip  (c'est--dire  si elle ne finie pas par l'extension
              .tlz, tar.lzma, .txz, .tar.xz .tbz, .tbz2, .tar.bz2 ou .zip). Le
              paquet  unzip  doit  tre  install  pour rempaqueter les archives
              .zip, le paquet lzma  doit  tre  install  pour  rempaqueter  les
              archives tar compresses avec lzma et le paquet xz-utils doit tre
              install pour rempaqueter les archives tar compresses avec xz.

       --no-symlink
              Ne cre pas ces liens symboliques et ne renomme pas les fichiers.

       --dehs Utilise le format XML pour la sortie, requis par le systme DEHS.

       --no-dehs
              Utilise le format de sortie traditionnel  de  uscan.  (C'est  le
              comportement par dfaut.)

       --package paquet
              Spcifie   le  nom  du  paquet   contrler  plutt  que  d'examiner
              debian/changelog ; ceci requiert les options  --upstream-version
              (  moins  qu'une option ne soit prcise dans le fichier watch) et
              --watchfile. De plus, aucun rpertoire ne sera scann et  rien  ne
              sera  tlcharg.  Cette  option  est probablement la plus utile en
              conjonction avec le systme DEHS (et --dehs).

       --upstream-version version-amont
              Spcifie la  version  amont  courante  plutt  que  d'examiner  le
              fichier  watchfile  ou  le  journal  des  modifications  pour le
              dterminer. Ceci est ignor si un balayage de rpertoire  est  fait
              et que plus d'un fichier watchfile est trouv.

       --watchfile watchfile
              Spcifiez  le fichier watchfile plutt que de faire un balayage de
              rpertoire pour le dterminer. Si cette option  est  utilise  sans
              --package, uscan devra tre appel depuis l'arborescence du paquet
              Debian source (de sorte que debian/changelog  puisse  tre  trouv
              simplement par une recherche dans l'arborescence).

       --download-version version
              Spcifier  la  version amont souhaite, plutt que d'utiliser celle
              avec le numro de version le plus important.

       --download-current-version
              Tlcharger la version du paquet actuel

       --verbose
              Donne une sortie bavarde.

       --no-verbose
              Ne donne pas de  sortie  bavarde.  (C'est  le  comportement  par
              dfaut.)

       --debug
              Affiche  les  pages web tlcharges sur la sortie standard afin de
              dboguer votre fichier  watch .

       --check-dirname-level N
              Veuillez consulter la section ci-dessus  Vrification du  nom  du
              rpertoire  pour une explication de cette option.

       --check-dirname-regex regex
              Veuillez  consulter  la section ci-dessus  Vrification du nom du
              rpertoire  pour une explication de cette option.

       --user-agent, --useragent
              Utiliser un champ  user agent  diffrent de celui par dfaut.

       --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 Affiche un bref message d'aide.

       --version
              Afficher les informations sur la version.

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 :

       USCAN_DOWNLOAD
              Si elle est positionne  no,  les  nouveaux  fichiers  amonts  ne
              seront  pas  tlchargs,  ce  qui  quivaut   utiliser  les options
              --report ou --no-download.

       USCAN_PASV
              Si elle est positionne  yes ou  no,  cela  force  respectivement
              utiliser  ou  ne pas utiliser le mode passif pour les connexions
              FTP. Si elle est positionne  default, alors Net::FTP(3) fera  un
              choix   (bas  principalement  sur  la  variable  d'environnement
              FTP_PASSIVE).

       USCAN_TIMEOUT
              Si cette option est dfinie  un nombre N, alors dfinir  le  temps
              limite
               N secondes. C'est quivalent  l'option --timeout.

       USCAN_SYMLINK
              Si   cette   option  est  mise   no,  un  lien  symbolique  vers
              paquet_version.orig.tar.{gz|bz2}  ne  sera  pas  cr   (quivalent
              l'option  --no-symlink).  Si elle est  yes ou symlink, les liens
              symboliques seront crs. Si elle est  rename, les  fichiers  sont
              renomms (quivalent  l'option --rename).

       USCAN_DEHS_OUTPUT
              Si  cette  option  est   yes, alors la sortie sera de type DEHS,
              comme si l'option --dehs tait utilise.

       USCAN_VERBOSE
              Si elle est positionne  yes, alors la sortie sera bavarde, comme
              si l'option --verbose tait utilise.

       USCAN_USER_AGENT
              Si  elle  est  dfinie,  elle  spcifie  la  chane   utiliser pour
              annoncer le navigateur ( user agent )  la place de la valeur par
              dfaut. C'est quivalent  l'option --user-agent.

       USCAN_DESTDIR
              Si  elle  est  dfinie,  elle  dsigne le rpertoire o les fichiers
              tlchargs seront placs. C'est quivalent  l'option --destdir.

       USCAN_REPACK
              Si elle est  positionne   yes,  alors  aprs  avoir  tlcharg  une
              archive  tar  compresse  avec  bzip ou lzma ou xz ou une archive
              zip, uscan recrera une archive tar compresse  avec  gzip.  C'est
              quivalent  l'option --repack.

VALEURS DE RETOUR

       La valeur de retour indique si une nouvelle version a t trouve ; il est
       conseill de lire la sortie pour dterminer  exactement  ce  qu'il  s'est
       pass et pour voir s'il n'y a pas eu d'avertissement.

       0      Soit  les  options  --help ou --version ont t utilises, soit une
              nouvelle version amont a t trouve pour un des  fichiers   watch
              examins.

       1      Aucune  nouvelle  version  amont  n'a t trouve pour les fichiers
               watch  examins.

HISTORIQUE ET MISE NIVEAU

       Cette  section  dcrit  brivement  les  incompatibilits   inverses   des
       fonctionnalits  du  fichier  watchfile  qui  ont  t ajoutes dans chaque
       version du watchfile et la premire version du paquet devscripts qui les
       comprenait.

       Versions antrieures  2
              La  syntaxe du fichier watchfile tait trs diffrente  l'poque. Ne
              l'utilisez plus. Si vous mettez votre fichier watchfile   niveau
              depuis  une version antrieure  2, il est recommand de lire cette
              page de manuel et de recommencer  zro.

       Version 2
              devscripts version 2.6.90 :  la  premire  incarnation  du  style
              courant de watchfile.

       Version 3
              devscripts  version  2.8.12  a  introduit les choses suivantes :
              manipulation  correcte  des  expressions  rationnelles  dans  la
              partie  du  chemin,  recherche  de  motif d'un rpertoire/chemin,
              numro de  version  dans  plusieurs  parties,  numro  de  version
              modifiable. Les versions suivantes ont introduit la modification
              des liens.

              Si vous tes en train de vous mettre  niveau depuis la version 2,
              l'incompatibilit  principale  est  s'il existe plusieurs groupes
              dans la partie des motifs. Alors que seul le premier tait utilis
              dans  la  version  2, ils le seront tous dans la version 3. Pour
              viter ce comportement, modifiez les groupes non lis au numro  de
              version en (?:...) au lieu d'un groupe ordinaire (...).

VOIR AUSSI

       dpkg(1), perlre(1), uupdate(1) et devscripts.conf(5).

AUTEUR

       La   version  initiale  de  uscan  a  t  crite  par  Christoph  Lameter
       <clameter@debian.org>.  Des   amliorations   significatives,   d'autres
       modifications  et  des  corrections de bogues ont t apportes par Julian
       Gilbey <jdg@debian.org>. Le support pour  HTTP  a  t  ajout  par  Piotr
       Roszatycki  <dexter@debian.org>.  Le  programme  a  t rcrit en Perl par
       Julian Gilbey.

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.