NOM

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

SYNOPSIS

uscan [options] [chemin]

DESCRIPTION

Pour une utilisation basique, uscan est exécuté sans aucun paramètre à partir de la racine d'une arborescence source debianisée où on voit le répertoire debian/ ou un répertoire contenant plusieurs arborescences sources.

Sauf si --watchfile est indiqué, uscan recherche récursivement les arborescences source valides en partant du répertoire courant (voir la section "Vérification du nom du répertoire" ci-dessous pour plus de détails).

Pour chaque arborescence valide trouvée, typiquement la séquence est la suivante :

• uscan lit la première entrée dans debian/changelog pour déterminer le nom du paquet source <spkg> et la dernière version amont.
• uscan traite les lignes de veille debian/watch de haut en bas en une passe unique.

•

uscan invoque uupdate pour créer l'arborescence source debianisée : ../<spkg>-<oversion>/*

Veuillez noter les informations suivantes.

• Pour des raisons de simplicité, la méthode de compression utilisée dans les exemples est gzip avec le suffixe .gz. Les autres méthodes telles que xz, bzip2 et lzma, avec les suffixes xz, bz2 et lzma correspondants peuvent également être utilisées.
• La nouvelle version=4 permet la gestion des paquets MUT, mais ce sont des cas rares parmi les paquets Debian. Pour un paquet d'archive simple, il n'y a qu'une ligne de veille et pas de ../<spkg>_<oversion>.orig-<composante>.tar.gz .
• uscan avec l'option --verbose produit un rapport lisible de son exécution.
• uscan avec l'option --debug produit un rapport lisible de son exécution avec l'état des variables internes.
• uscan avec l'option --extra-debug produit un rapport lisible de son exécution avec l'état des variables internes et le contenu distant lors de la phase "recherche".
• uscan avec l'option --dehs produit un rapport d'état du paquet amont au format XML pour que d'autres programmes tels que Debian External Health System.
• L'objectif premier d'uscan est d'aider à déterminer si c'est bien la dernière version de l'archive amont qui est utilisée et de télécharger cette version d'archive. L'ordre des versions est déterminée par dpkg --compare-versions.
• L'option --safe d'uscan limite ses fonctionnalités à ses objectifs premiers. À la fois le repaquetage des fichiers téléchargés et la mise à jour de l'arborescence source sont sautés pour éviter l'exécution de scripts non sécurisés. Cela change aussi les options par défaut à --no-download et --skip-signature.

FORMAT DU FICHIER DE VEILLE

Le format de la version 4 actuelle de debian/watch peut être résumé comme suit :

• Les espaces et les tabulations de début sont supprimées.
• Les lignes vides sont supprimées.
• Une ligne qui débute par # (dièse) est une ligne de commentaire et elle est supprimée.
• Un \ unique (barre inverse oblique) à la fin d'une ligne est supprimé et la ligne suivante est concaténée après la suppression des espaces et des tabulations de début. La ligne concaténée est analysée comme une seule ligne. (L'existence ou l'inexistence d'une espace avant le \ unique final est signifiant.)
• La première ligne non commentée est la suivante :

•

Les lignes suivantes non commentées (lignes de veille) précisent les règles de sélection des URL d'archive amont candidates et sont dans un des trois formats suivants :

Il y a quelques chaînes spéciales qui sont remplacées par uscan pour faciliter l'écriture du fichier de veille.

@PACKAGE@

Cette chaîne est remplacée par le nom de paquet source trouvé dans la première ligne du fichier debian/changelog.

@ANY_VERSION@

Cette chaîne est remplacée par l'expression rationnelle de la version amont légale (capture).

  [-_]?[Vv]?(\d[\-+\.:\~\da-zA-Z]*)
    

@ARCHIVE_EXT@

Cette chaîne est remplacée par l'expression rationnelle de l'extension habituelle de fichier d'archive (sans capture).

 (?i)(?:\.(?:tar\.xz|tar\.bz2|tar\.gz|tar\.zstd?|zip|tgz|tbz|txz))
    

@SIGNATURE_EXT@

Cette chaîne est remplacée par l'expression rationnelle de l'extension habituelle de fichier de signature (sans capture).

  (?i)(?:\.(?:tar\.xz|tar\.bz2|tar\.gz|tar\.zstd?|zip|tgz|tbz|txz))'(?:\.(?:asc|pgp|gpg|sig|sign))'
    

@DEB_EXT@

Cette chaîne est remplacée par l'expression rationnelle de habituelle de Debian (sans capture).

  [\+~](debian|dfsg|ds|deb)(\.)?(\d+)?$
    

Certaines extensions de fichiers ne sont volontairement pas incluses dans la liste précédente pour éviter des faux positifs. Il vous est encore possible de rajouter ces motifs d'extension de fichier manuellement.

OPTIONS DE FICHIER DE VEILLE

uscan lit les options de veille spécifiées dans opts=" ... " pour personnaliser son comportement. De multiples options option1, option2, option3, ..., peuvent être configurées de cette manière : opts="option1, option2, option3, ... ". Les guillemets doubles sont nécessaires si les options contiennent des espaces.

À moins qu'elles ne soient notées par ailleurs comme persistantes, la plupart des options ne sont valables que dans la ligne de veille qui les contient.

Les options de veille disponibles sont :

component=composante

Configurer le nom de l'archive source secondaire comme <spkg>_<oversion>.orig-<composante>.tar.gz pour un paquet MUT.

ctype=component-type

Indique le type du composant (seuls "nodejs" et "perl" sont disponible actuellement). Ceci aide uscan à trouver la version courante si la version du composant est ignorée.

Lorsque ctype=nodejs est utilisé, uscan recherche une version dans "package.json", lorsque ctype=perl est utilisé, uscan recherche une version dans "META.json". Si une version est trouvée, elle est utilisée comme version courante du composant, en ignorant la version trouvée dans la chaîne de version de Debian. Ceci permet une meilleure détection des changements lorsque ignore ou checksum sont utilisés dans la version Debian.

compression=méthode

Configurer la méthode de compression quand l'archive est rempaquetée (persistant).

Les valeurs de méthode disponibles sont xz, gzip (alias gz), bzip2 (alias bz2) lzma et default. La valeur par défaut est xz. Lorsque uscan est lancé dans un répertoire source Debian et que le format est "1.0" ou n'est pas défini, la méthode par défaut devient gzip.

Veuillez noter que le rempaquetage des archives amont par mk-origtargz ne se produit que si une des conditions suivantes est satisfaite :

repack

Forcer le rempaquetage de l'archive amont avec la méthode de compression.

repacksuffix=suffixe

Ajouter un suffixe à la version du paquet Debian amont seulement lorsque l'archive source est rempaquetée. Cette règle peut être utilisée seulement pour un unique paquet d'archive amont.

mode=mode

Configurer le mode de téléchargement de l'archive.

pretty=règle

Configurer la chaîne de version amont à un format arbitraire comme un argument optionnel de opts quand le motif_correspondant est HEAD ou heads/branch pour le mode git. Pour connaître la syntaxe exacte, voir la page de manuel de git-log avec tformat. Le format par défaut est pretty=0.0~git%cd.%h. Aucune règle uversionmangle n'est applicable dans ce cas.

When pretty=describe is used, the upstream version string is the output of the "git describe --tags | sed s/-/./g" command instead. For example, if the commit is the 5-th after the last tag v2.17.12 and its short hash is ged992511, then the string is v2.17.12.5.ged992511 . For this case, it is good idea to add uversionmangle=s/^/0.0~/ or uversionmangle=s/^v// to make the upstream version string compatible with Debian. Please note that in order for pretty=describe to function well, upstream need to avoid tagging with random alphabetic tags.

L'option pretty=describe contraint à configurer gitmode=full pour créer automatiquement un clone local complet du dépôt.

date=règle

Configurer la chaîne de date utilisée par l'option pretty à un format arbitraire comme un paramètre optionnel de opts quand le motif_correspondant est HEAD ou heads/branch pour le mode git. Pour connaître la syntaxe exacte, voir la page de manuel strftime. Le format par défaut est date=%Y%m%d.

gitexport=mode

Indique le mode d'opération des exports d'archive git. La valeur par défaut est gitexport=default. Mettre ceci à gitexport=all pour inclure tous les fichiers dans l'archive .orig.tar, en ignorant tous les attributs git export-ignore définis par l'amont.

Cette option n'est valide qu'en mode "git".

gitmode=mode

Configurer le mode de l'opération git clone. La valeur par défaut est gitmode=shallow. Pour certains serveurs git simples ("dumb"), il peut être nécessaire de configurer soi-même la valeur gitmode=full pour imposer une opération de clonage complète.

Si le répertoire courant est un dépôt git et si le dépôt recherché est listé dans les sources amont ("remote"), alors uscan l'utilisera au lieu de dupliquer le dépôt dans un répertoire temporaire.

pgpmode=mode

Configurer le mode de vérification de signature PGP/GPG.

searchmode=mode

Configurer le mode de recherche.

decompress

Décompresser l'archive compressée avant la vérification de la signature PGP/GPG.

bare

Désactiver tout le code "special code" spécifique au site telles que les utilisations de redirecteur d'URL et les altérations de contenu de page. (Persistant)

user-agent=chaîne_user-agent

Configurer la chaîne user-agent utilisée pour contacter le serveur HTTP(S) comme chaîne_user-agent. (Persistant)

L'option user-agent devrait être précisée par elle-même dans la ligne de veille sans URL, pour permettre l'utilisation de point-virgules et de virgules.

pasv, passive

Utiliser le mode passif ("PASV") pour les connexions FTP.

Si le mode PASV (passif) est requis à cause de l'environnement réseau côté client, configurer uscan pour qu'il utilise le mode PASV avec les "OPTIONS DE LIGNE DE COMMANDE" ou plutôt avec les "VARIABLES DE CONFIGURATION DE DEVSCRIPT".

active, nopasv

Ne pas utiliser le mode PASV (passif) pour les connexions FTP.

unzipopt [options]

Ajouter les options supplémentaires à utiliser avec la commande unzip telles que -a, -aa et -b lors de l'exécution par mk-origtargz.

dversionmangle=règles

Normaliser la dernière chaîne de version amont trouvée dans debian/changelog pour la comparer avec la version de l'archive amont disponible. Le retrait de suffixes spécifiques à Debian tels que s/\+dfsg\d*$// est habituellement réalisé à ce moment là.

Il est également possible d'utiliser dversionmangle=auto, ce qui est exactement la même chose que dversionmangle=s/@DEB_EXT@//

dirversionmangle=règles

Normaliser la chaîne du chemin du répertoire correspondant à l'expression rationnelle dans un ensemble de parenthèses de http://URL comme chaîns d'index de version triable. Cela est utilisé seulement comme l'index triable de chemin de répertoire.

Une substitution telle que s/PRE/~pre/; s/RC/~rc/ peut aider.

pagemangle=règles

Normaliser la chaîne de page web téléchargée. (À n'utiliser qu'en cas de nécessité absolue. En général, l'étiquette g est requise pour ces règles.)

Cela est pratique si vous souhaitez accéder à Amazon AWS ou à des dépôts Subversion dans lesquels <a href="..."> n'est pas utilisé.

uversionmangle=règles

Normaliser les chaînes de version amont candidate extraites des références href dans le code source de la page web. Cela est utilisé comme l'index de tri de version lors de la sélection de la dernière version amont.

Une substitution telle que s/PRE/~pre/; s/RC/~rc/ peut aider.

versionmangle=règles

Il s'agit d'un raccourci syntactique pour uversionmangle=règles,dversionmangle=règles

hrefdecode=percent-encoding

Convertir la chaîne des références href de l'archive amont sélectionnée de lachaîne hexadécimale encodée en pourcent vers la chaîne de l'URL normale décodée pour les sites web embrouillés. Seulement percent-encoding estdisponible et il est décodé avec la commande s/%([A-Fa-f\d]{2})/chr hex $1/eg.

downloadurlmangle=règles

Convertir la chaîne des références href de l'archive amont sélectionnée dans l'URL accessible des sites web embrouillés. L'exécution intervient après hrefdecode.

filenamemangle=règles

Générer le nom de fichier de l'archive amont à partir de la chaîne des références href sélectionnée si motif_correspondant peut extraire l'<uversion> de la dernière version amont à partir de la chaîne des références href sélectionnée. Autrement, générer le nom de fichier de l'archive amont à partir de la chaîne de l'URL complète et configurer l'<uversion> manquant à partir du nom de fichier de l'archive amont généré.

Sans cette option, le nom de fichier de l'archive amont par défaut est généré en prenant la dernière composante de l'URL et en retirant tout ce qui est après un "?" ou un "#".

pgpsigurlmangle=règles

Générer la chaîne d'URL du fichier de signature amont candidat à partir de l'URL de l'archive amont.

oversionmangle=règles

Générer la chaîne de version <oversion> de l'archive source <spkg><spkg>_<oversion>.orig.tar.gz à partir de <uversion>. Cela devrait être utilisé pour ajouter un suffixe tel que +dfsg à un paquet MUT.

Ici, les règles de manipulation appliquent les règles à la chaîne pertinente. De multiples règles peuvent être précisées dans une chaîne de règle de manipulation en créant une chaîne concaténée de chaque règle de manipulation séparée par des ; (point-virgule).

Les règles de manipulation ne peuvent pas comporter de ; (point-virgule), , (virgule) ni de " (guillemet double).

Chaque règle de manipulation se comporte comme si une commande Perl "$string =~ règle" était exécutée. Il y a quelques particularités notables.

•

Une règle peut seulement utiliser les opérations s, tr et y.

EXEMPLE D'EXÉCUTION

uscan lit la première entrée dans debian/changelog pour déterminer le nom du paquet source et la dernière version amont.

Par exemple, si la première entrée de debian/changelog est :

•

titi (3:2.03+dfsg-4) unstable; urgency=low

alors, le nom du paquet source est titi et la version la plus récente du paquet Debian est 3:2.03+dfsg-4.

La dernière version amont est normalisée à 2.03+dfsg en retirant l'epoch et la révision Debian.

Si la règle dversionmangle existe, la dernière version amont est normalisée plus profondément en lui appliquant cette règle. Par exemple, si la dernière version amont est 2.03+dfsg indiquant que l'archive source a été rempaquetée, le suffixe +dfsg est retiré par la substitution de chaîne s/\+dfsg\d*$// pour produire la dernière version amont 2.03 (traitée avec dversionmangle) et est comparée aux versions d'archive amont candidates comme 2.03, 2.04, ..., qui se trouvent sur le site distant. Donc, configurer la règle ainsi :

•

opts="dversionmangle=s/\+dfsg\d*$//"

uscan télécharge une page web à partir de l'adresse http://URL spécifiée dans debian/watch.

• Si la partie nom du répertoire de l'URL n'a pas de parenthèse, ( et ), il est pris tel quel.
• Si la partie nom du répertoire de l'URL a des parenthèses ( et ), alors uscan cherche de façon récursive tous les répertoires possibles pour trouver une page avec la nouvelle version. Si la règle dirversionmangle existe, l'index de tri généré est utilisé pour trouver la version la plus récente. Si une version particulière est spécifiée pour le téléchargement, la chaîne de version correspondante a la priorité sur la version la plus récente.

Par exemple, cette adresse http://URL peut être spécifiée ainsi :

•

http://www.example.org/@ANY_VERSION@/

Veuillez noter le / final dans l'adresse ci-dessus pour faire de @ANY_VERSION@ le répertoire.

Si la règle pagemangle existe, la totalité de la page web téléchargée, considérée comme une chaîne, est normalisée en y appliquant la règle. C'est un outil très puissant qui doit être utilisé avec prudence. Si d'autres règles de manipulation peuvent être utilisées pour répondre à vos objectifs, n'utilisez pas cette règle.

Des références href, définies dans l'étiquette <a href=" ... ">, sont recherchées dans la page web téléchargée pour localiser les références de l'archive amont candidate. Ces références de l'archive amont candidate sont sélectionnées par le motif d'expression rationnelle Perl motif-correspondant, tel que DL-(?:[\d\.]+?)/toto-(.+)\.tar\.gz pour réduire le nombre de candidates. Ce motif de sélection doit être borné au début et à la fin. Par exemple, les références candidates peuvent être :

• DL-2.02/toto-2.02.tar.gz
• DL-2.03/toto-2.03.tar.gz
• DL-2.04/toto-2.04.tar.gz

Ici, la chaîne de sélection (.+) dans motif-correspondant est considérée comme la version amont candidate. S'il y a plusieurs chaînes correspondantes de motifs de capture dans motif-correspondant, elles sont toutes concaténées avec un point (.) pour former la version amont candidate. Il convient de s'assurer d'utiliser des expressions rationnelles non capturantes telles que (?:[\d\.]+?) à la place pour la partie correspondant à du texte variable sans rapport avec la version.

Les versions amont candidates sont alors :

• 2.02
• 2.03
• 2.04

Le nom de fichier de l'archive téléchargée est simplement fixé comme le nom de fichier dans l'URL distante de la référence href sélectionnée.

Si la règle <uversionmangle> existe, les versions amont candidates sont normalisées en leur appliquant cette règle. (Cette règle peut être utilisée si le schéma de la version amont ne permet pas un tri qui identifie correctement la version la plus récente.)

La référence href de l'archive amont correspondant à la version amont candidate la plus récente (traitée par uversionmangle), plus récente que la dernière version amont (traitée par dversionmangle) est sélectionnée.

Si plusieurs références href d'archive amont correspondant à une version unique existent avec différentes extensions, c'est la plus forte compression qui est choisie. (Ordre de priorité : tar.xz > tar.lzma > tar.bz2 > tar.gz.)

Si la référence href de l'archive amont sélectionnée est une URL relative, elle est convertie en URL absolue avec l'URL de base de la page web. Si l'étiquette <base href=" ... "> existe sur la page web, la référence href de l'archive amont est convertie en URL absolue en utilisant plutôt l'URL de base spécifiée dans l'étiquette de base.

Si la règle downloadurlmangle existe, la référence href de l'archive amont sélectionnée est normalisée en lui appliquant cette règle. (Cela est utile sur certains sites avec des URL de téléchargement embrouillées.)

Si la règle filenamemangle existe, le nom de fichier d'archive téléchargé est généré en appliquant cette règle à la référence href sélectionnée si le motif-correspondant peut extraire la dernière version amont <uversion> à partir de la chaîne de la référence href sélectionnée. Autrement, le nom de fichier d'archive amont est généré à partir de sa chaîne d'URL complète et règle le <uversion> manquant à partir du nom de fichier d'archive amont généré.

En absence de règle filenamemangle, le nom de fichier d'archive amont par défaut est généré en prenant la dernière composante de l'URL et en retirant tout ce qu'il y a après un "?" ou un "#".

uscan télécharge l'archive amont sélectionnée dans le répertoire parent ../. Par exemple, le fichier téléchargé peut être :

•

../toto-2.04.tar.gz

De façon générique, nous appellerons par la suite cette version 2.04 téléchargée dans l'exemple ci-dessus sous le nom de <uversion>.

Si la règle pgpsigurlmangle existe, l'URL du fichier de signature amont est générée en appliquant cette règle à la référence href de l'archive amont sélectionnée (traitée par downloadurlmangle) et on tente de télécharger le fichier de signature à partir de cette URL.

Si la règle pgpsigurlmangle n'existe pas, uscan prévient l'utilisateur si le fichier de signature amont correspondant est disponible à partir de la même URL, en ajoutant à son nom de fichier les cinq suffixes courants asc, gpg, pgp, sig et sign. (On peut éviter cet avertissement avec le réglage pgpmode=none.)

Si le fichier de signature est téléchargé, l'authenticité de l'archive amont téléchargée est vérifiée par rapport au fichier de signature téléchargé en utilisant le trousseau blindé debian/upstream/signing-key.asc. (Voir "EXEMPLES DE FICHIER DE TROUSSEAU"). Si la signature n’est pas valable, ou si la clef ne fait pas partie du trousseau, uscan signalera une erreur.

Si la règle oversionmangle existe, la version d'archive source oversion est générée à partir de la version amont téléchargée uversion en appliquant cette règle. Elle est utile pour ajouter un suffixe tel que +dfsg à la version de tous les paquets source du paquet MUT pour lequel le mécanisme de suffixe de rempaquetage ne fonctionne pas.

uscan invoque mk-origtargz pour créer l'archive source nommée correctement pour le paquet source avec .orig. (ou .orig-<component>. pour les archives secondaires) dans son nom de fichier.

cas A : empaquetage de l'archive amont telle quelle

mk-origtargz crée un lien symbolique ../titi_<oversion>.orig.tar.gz avec l'archive locale amont téléchargée. Ici, << titi >> est le nom du paquet source trouvé dans debian/changelog. Le lien symbolique généré peut être :

cas B : empaquetage de l'archive amont après le retrait des fichiers non-DFSG

mk-origtargz vérifie le motif générique ("glob") des noms de fichiers du paragraphe Files-Excluded dans la première section de debian/copyright, retire les fichiers correspondants pour créer une archive amont rempaquetée. Normalement, l'archive amont rempaquetée est renommée en ../bar_<oversion><suffixe>.orig.tar.gz avec suffixe, utilisant l'option repacksuffix pour le seul paquet amont. Ici, <oversion> est mis à jour en <oversion><suffixe>.

Le retrait des fichiers est requis si les fichiers ne sont pas compatibles avec DFSG. Dans ce cas, +dfsg est utilisé comme suffixe.

Alors, les options sont plutôt ainsi combinées opts="dversionmangle=s/\+dfsg\d*$// , repacksuffix=+dfsg".

Par exemple, l'archive amont rempaquetée peut être :

uscan invoque normalement "uupdate --find --upstream-version oversion" pour le fichier de veille version=4.

Veuillez noter que l'option --find est ici utilisée dans la mesure où mk-origtargz a déjà été invoquée pour construire le fichier *.orig.tar.gz. uscan choisit bar à partir de debian/changelog.

Il crée la nouvelle arborescence source amont sous le répertoire ../bar-<oversion> et l'adapte à Debian en exploitant le contenu du dernier paquet.

EXEMPLES DE FICHIER DE VEILLE

Lors de l'écriture du fichier de veille, vous devriez vous servir de la dernière page d’annonce web de la source amont. Vous ne devriez pas, si possible, essayer de deviner la structure de l'archive amont. Voici des fichiers debian/watch typiques.

Veuillez noter que l'exécution de uscan avec -v ou -vv révèlece qui se passe précisément en interne.

L'existence ou l'absence d'une espace avant le \ ("back slash") final est significatif.

Certaines chaînes de configuration plus courtes non documentées sont utilisées dans les EXEMPLES ci-dessous pour faciliter votre saisie. Elles sont intentionnelles. uscan est écrit pour accepter de tellesabréviations de bon sens, mais il ne faut pas exagérer.

  version=4
  http://example.com/~user/release/@PACKAGE@.html \
      files/@PACKAGE@@ANY_VERSION@@ARCHIVE_EXT@

  version=4

  version=4
  opts="pgpsigurlmangle=s%$%.asc%" http://example.com/release/@PACKAGE@.html \
      files/@PACKAGE@@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  opts="pgpsigurlmangle=s%@ARCHIVE_EXT@$%.asc%,decompress" \
      http://example.com/release/@PACKAGE@.html \
      files/@PACKAGE@@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  opts="pgpmode=next" http://example.com/release/@PACKAGE@.html \
      files/(?:\d+)/@PACKAGE@@ANY_VERSION@@ARCHIVE_EXT@ debian
  opts="pgpmode=previous" http://example.com/release/@PACKAGE@.html \
      files/(?:\d+)/@PACKAGE@@ANY_VERSION@@SIGNATURE_EXT@ previous

  version=4
  opts="pgpmode=next" http://example.com/DL/ \
      files/(?:\d+)/@PACKAGE@@ANY_VERSION@@ARCHIVE_EXT@ debian
  opts="pgpmode=previous" http://example.com/DL/ \
      files/(?:\d+)/@PACKAGE@@ANY_VERSION@@SIGNATURE_EXT@ \
      previous

  version=4
  opts="pgpsigurlmangle=s%$%.sig%" \
      http://example.com/release/foo.html \
      files/foo-@ANY_VERSION@@ARCHIVE_EXT@ debian
  opts="pgpsigurlmangle=s%$%.sig%, component=bar" \
      http://example.com/release/foo.html \
      files/foobar-@ANY_VERSION@@ARCHIVE_EXT@ same
  opts="pgpsigurlmangle=s%$%.sig%, component=baz" \
      http://example.com/release/foo.html \
      files/foobaz-@ANY_VERSION@@ARCHIVE_EXT@ same

  version=4
  opts="pgpsigurlmangle=s%$%.sig%, dirversionmangle=s/-PRE/~pre/;s/-RC/~rc/" \
      http://tmrc.mit.edu/mirror/twisted/Twisted/@ANY_VERSION@/ \
      Twisted-@ANY_VERSION@@ARCHIVE_EXT@

  http://tmrc.mit.edu/mirror/twisted/Twisted/

  version=4
  opts="pgpsigurlmangle=s%$%.sig%" \
      http://www.cpan.org/modules/by-module/Text/ \
      Text-CSV_XS-@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  opts="pgpsigurlmangle=s%$%.sig%" \
      http://www.cpan.org/modules/by-module/Text/Text-CSV_XS-@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  opts="pgpsigurlmangle=s%$%.sig%" \
      http://www.cpan.org/modules/by-module/Text/\
      Text-CSV_XS-@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  http://www.site.com/pub/foobar/foobar_v(\d+)_(\d+)@ARCHIVE_EXT@

  version=4
  opts="dversionmangle=s/\+dfsg\d*$//,repacksuffix=+dfsg" \
  http://some.site.org/some/path/foobar-@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  opts=filenamemangle=s/.*=(.*)/$1/ \
  http://foo.bar.org/dl/\?path=&dl=foo-@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  opts=filenamemangle=s/.*=(.*)/foo-$1\.tar\.gz/ \
  http://foo.bar.org/dl/\?path=&dl_version=@ANY_VERSION@

  version=4
  opts=filenamemangle=s&.*/dl/(.*)/foo\.tar\.gz&foo-$1\.tar\.gz& \
  http://foo.bar.org/dl/@ANY_VERSION@/ foo.tar.gz

  version=4
  opts=downloadurlmangle=s/prdownload/download/ \
  http://developer.berlios.de/project/showfiles.php?group_id=2051 \
  http://prdownload.berlios.de/softdevice/vdr-softdevice-@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  opts=oversionmangle=s/(.*)/$1+dfsg/ \
  http://example.com/~user/release/foo.html \
  files/foo-@ANY_VERSION@@ARCHIVE_EXT@ debian
  opts="component=bar" \
  http://example.com/~user/release/foo.html \
  files/bar-@ANY_VERSION@@ARCHIVE_EXT@ same

  version=4
  opts=pagemangle="s/<a\s+bogus=/<a href=/g" \
  http://example.com/release/foo.html \
  files/@PACKAGE@@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  opts="pagemangle=s%<Key>([^<]*)</Key>%<Key><a href="$1">$1</a></Key>%g" \
  http://example.com/release/foo.html \
  (?:.*)/@PACKAGE@@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  ftp://ftp.tex.ac.uk/tex-archive/web/c_cpp/cweb/cweb-@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  ftp://ftp.worldforge.org/pub/worldforge/libs/\
  Atlas-C++/transitional/Atlas-C\+\+-@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  opts="uversionmangle=s/^/0.0./" \
  ftp://ftp.ibiblio.org/pub/Linux/ALPHA/wine/\
  development/Wine-@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  https://sf.net/<project>/ <tar-name>-@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  https://sf.net/audacity/ audacity-minsrc-@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  opts="uversionmangle=s/-pre/~pre/, \
    filenamemangle=s%(?:.*)audacity-minsrc-(.+)\.tar\.xz/download%\
                         audacity-$1.tar.xz%" \
    http://sourceforge.net/projects/audacity/files/audacity/@ANY_VERSION@/ \
    (?:.*)audacity-minsrc-@ANY_VERSION@@ARCHIVE_EXT@/download

  version=4
  opts="searchmode=plain" \
      https://api.github.com/repos/<user>/<project>/releases?per_page=100 \
      https://github.com/<user>/<project>/releases/download/[^/]+/@PACKAGE@-@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  opts="filenamemangle=s%.*/@ANY_VERSION@%@PACKAGE@-$1.tar.gz%,searchmode=plain" \
      https://api.github.com/repos/<user>/<project>/releases?per_page=100 \
      https://api.github.com/repos/<user>/<project>/tarball/@ANY_VERSION@

  version=4
  opts="filenamemangle=s%.*/@ANY_VERSION@%@PACKAGE@-$1.tar.gz%,searchmode=plain" \
      https://api.github.com/repos/<user>/<project>/tags?per_page=100 \
      https://api.github.com/repos/<user>/<project>/tarball/refs/tags/@ANY_VERSION@

  version=4
  https://pypi.python.org/packages/source/<initial>/<project>/ \
      <tar-name>-@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  https://pypi.python.org/packages/source/c/cfn-sphere/ \
      cfn-sphere-@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  opts="pgpmode=none" \
      https://pypi.python.org/pypi/cfn-sphere/ \
      https://pypi.python.org/packages/.*/.*/.*/\
      cfn-sphere-@ANY_VERSION@@ARCHIVE_EXT@#.*

  version=4
  opts="searchmode=plain" \
   https://registry.npmjs.org/aes-js \
   https://registry.npmjs.org/aes-js/-/aes-js-@ANY_VERSION@@ARCHIVE_EXT@

  version=4
  opts="searchmode=plain,pgpmode=none" \
    https://registry.npmjs.org/mongodb \
    https://registry.npmjs.org/mongodb/-/mongodb-@ANY_VERSION@@ARCHIVE_EXT@ group
  opts="searchmode=plain,pgpmode=none,component=bson" \
    https://registry.npmjs.org/bson \
    https://registry.npmjs.org/bson/-/bson-@ANY_VERSION@@ARCHIVE_EXT@ group
  opts="searchmode=plain,pgpmode=none,component=mongodb-core" \
    https://registry.npmjs.org/mongodb-core \
    https://registry.npmjs.org/mongodb-core/-/mongodb-core-@ANY_VERSION@@ARCHIVE_EXT@ group
  opts="searchmode=plain,pgpmode=none,component=requireoptional" \
    https://registry.npmjs.org/require_optional \
    https://registry.npmjs.org/require_optional/-/require_optional-@ANY_VERSION@@ARCHIVE_EXT@ group

  version=4
  opts="searchmode=plain,pgpmode=none" \
    https://registry.npmjs.org/mongodb \
    https://registry.npmjs.org/mongodb/-/mongodb-@ANY_VERSION@@ARCHIVE_EXT@ group
  opts="searchmode=plain,pgpmode=none,component=bson" \
    https://registry.npmjs.org/bson \
    https://registry.npmjs.org/bson/-/bson-@ANY_VERSION@@ARCHIVE_EXT@ checksum
  opts="searchmode=plain,pgpmode=none,component=mongodb-core" \
    https://registry.npmjs.org/mongodb-core \
    https://registry.npmjs.org/mongodb-core/-/mongodb-core-@ANY_VERSION@@ARCHIVE_EXT@ checksum
  opts="searchmode=plain,pgpmode=none,component=requireoptional" \
    https://registry.npmjs.org/require_optional \
    https://registry.npmjs.org/require_optional/-/require_optional-@ANY_VERSION@@ARCHIVE_EXT@ checksum

  Main: 2.0.6
  Comp1:         1 .     2 .     4
  Comp2:         2 .     0 .     1
  Comp3:        10 .     0
  ================================
  Result  : 1+2+10 . 2+0+0 .   4+1
  Checksum:     13 .     2 .     5
  ================================
  Final Version:   2.0.6+~cs13.2.5

  2.0.6+~1.2.4+~2.0.1+~10.0

  version=4
  opts="mode=git, gitmode=full, pgpmode=none" \
  http://git.ao2.it/tweeper.git \
  refs/tags/v@ANY_VERSION@

  version=4
  opts="mode=git, pgpmode=none" \
  https://github.com/Debian/dh-make-golang \
  HEAD

  version=4
  opts="mode=svn, pgpmode=none" \
  svn://svn.code.sf.net/p/jmol/code/tags/ \
  @ANY_VERSION@\/

  version=4
  opts="mode=svn, pgpmode=none" \
  svn://svn.code.sf.net/p/jmol/code/trunk/ \
  HEAD

EXEMPLES DE FICHIER DE COPYRIGHT

Voici un exemple de fichier debian/copyright qui déclenche le rempaquetage automatique de l'archive amont en <spkg>_<oversion>.orig.tar.gz (dans debian/copyright, les alinéas Files-Excluded et Files-Excluded-component font partie du premier paragraphe et il existe un ligne vide avant les paragraphes suivants qui contiennent Files et d'autres alinéas.) :

  Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
  Files-Excluded: exclude-this
   exclude-dir
   */exclude-dir
   .*
   */js/jquery.js
   Files: *
   Copyright: ...
   ...

Voici un autre exemple de fichier debian/copyright qui déclenche le rempaquetage automatique d'archives amont multiples en <spkg>_<oversion>.orig.tar.gz et <spkg>_<oversion>.orig-bar.tar.gz:

  Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
  Files-Excluded: exclude-this
   exclude-dir
   */exclude-dir
   .*
   */js/jquery.js
  Files-Excluded-bar: exclude-this
   exclude-dir
   */exclude-dir
   .*
   */js/jquery.js
   Files: *
   Copyright: ...
   ...

Voir mk-origtargz(1).

EXEMPLES DE FICHIER DE TROUSSEAU

Supposons que la "clef de test d'uscan (non secrète) <none@debian.org>" amont signe son paquet avec une clef secrète OpenPGP et publie la clef publique OpenPGP correspondante. Cette clef publique OpenPGP peut être identifiée de trois façons différentes avec sa forme hexadécimale.

• L'empreinte sous la forme des 20 octets de données calculés à partir de la clef publique OpenPGP. Par exemple "CF21 8F0E 7EAB F584 B7E2 0402 C77E 2D68 7254 3FAF
• L'identificateur long " long keyid") sous la forme des 8 derniers octets de données de l'empreinte. Par exemple, "C77E2D6872543FAF"
• L'identificateur court ("short keyid") sous la forme des 4 derniers octets de données de l'empreinte. Par exemple, "72543FAF"

Compte tenu de l'existence des attaques par collisions sur les identificateurs courts, il est recommandé d'utiliser l'identificateur long pour recevoir des clefs à partir des serveurs de clefs publiques. Vous devez vérifier la clef OpenPGP téléchargée en utilisant la valeur de son empreinte complète dont vous savez qu'elle est sûre.

Le fichier de trousseau blindé debian/upstream/signing-key.asc peut être créé en utilisant la commande gpg (ou gpg2) comme suit.

  $ gpg --recv-keys "C77E2D6872543FAF"
  ...
  $ gpg --finger "C77E2D6872543FAF"
  pub   4096R/72543FAF 2015-09-02
        Key fingerprint = CF21 8F0E 7EAB F584 B7E2  0402 C77E 2D68 7254 3FAF
  uid                  uscan test key (no secret) <none@debian.org>
  sub   4096R/52C6ED39 2015-09-02
  $ cd chemin/vers/<upkg>-<uversion>
  $ mkdir -p debian/upstream
  $ gpg --export --export-options export-minimal --armor \
        'CF21 8F0E 7EAB F584 B7E2  0402 C77E 2D68 7254 3FAF' \
        >debian/upstream/signing-key.asc

Les fichiers de trousseau binaires, debian/upstream/signing-key.pgp et debian/upstream-signing-key.pgp, sont encore gérés, mais ils sont obsolètes.

Si un groupe de développeurs signe le paquet, il faut la liste des empreintes de chacun d'entre eux dans le paramètre pour gpg --export ... afin que le trousseau contienne toutes leurs clefs OpenPGP.

Parfois, on se demande qui a créé le fichier de signature. Il est possible d'obtenir l’identificateur de la clef publique utilisé pour créer le fichier de signature séparé toto-2.0.tar.gz.asc en exécutant gpg ainsi :

  $ gpg -vv toto-2.0.tar.gz.asc
  gpg: armor: BEGIN PGP SIGNATURE
  gpg: armor header: Version: GnuPG v1
  :signature packet: algo 1, keyid C77E2D6872543FAF
        version 4, created 1445177469, md5len 0, sigclass 0x00
        digest algo 2, begin of digest 7a c7
        hashed subpkt 2 len 4 (sig created 2015-10-18)
        subpkt 16 len 8 (issuer key ID C77E2D6872543FAF)
        data: [4091 bits]
  gpg: assuming signed data in `toto-2.0.tar.gz'
  gpg: Signature made Sun 18 Oct 2015 11:11:09 PM JST using RSA key ID 72543FAF
  ...

OPTIONS DE LIGNE DE COMMANDE

Pour un usage basique d'uscan, la configuration de ces options n'est pas nécessaire.

--conffile, --conf-file

Ajoute ou remplace les fichiers de configuration par défaut ("/etc/devscripts.conf" and "~/.devscripts"). L'option ne peut être utilisée qu'en première position de la ligne de commande.

--no-conf, --noconf

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

--no-verbose

Ne pas rapporter d'informations verbeuses. (Par défaut).

--verbose, -v

Rapporter des informations verbeuses.

--debug, -vv

Rapporter des informations verbeuses et les valeurs de certains états internes.

--extra-debug, -vvv

Rapporter des informations verbeuses y compris les pages web téléchargées traitées sur la sortie d'erreur standard pour débogage.

--dehs

Envoyer la sortie de style DEHS (type XML) sur la sortie standard, tout en envoyant toutes les autres sorties de uscan sur la sortie d'erreur standard.

--no-dehs

Utiliser seulement le format de sortie traditionnel de uscan. (Par défaut)

--download, -d

Télécharger la nouvelle version amont. (Par défaut)

--force-download, -dd

Télécharger la nouvelle version amont même si elle est à jour (peut ne pas écraser les fichiers locaux).

--overwrite-download, -ddd

Télécharger le fichier amont même si le paquet est à jour (peut écraser les fichiers locaux).

--no-download, --nodownload

Ne pas télécharger ni rapporter d'information.

Des archives précédemment téléchargées peuvent être utilisées.

Passage du comportement par défaut à --skip-signature.

--signature

Télécharger la signature. (Par défaut)

--no-signature

Ne pas télécharger la signature, mais vérifier si elle a déjà été téléchargée.

-skip-signature

Ne pas s'occuper de télécharger ni de vérifier la signature.

--safe, --report

Éviter l'exécution de scripts non sécurisés en sautant à la fois le rempaquetage du paquet téléchargé et la mise à jour de l'arborescence de la nouvelle source.

Passage du comportement par défaut à --no-download et --skip-signature.

Quand l'objectif de l'exécution de uscan est de recueillir l'état du paquet amont sous un environnement conscient de la sécurité, veuillez vous assurer d'utiliser cette option.

--report-status

Équivaut à utiliser l'option --verbose --safe.

--download-version version

Indiquer la version à laquelle la version amont doit correspondre pour être prise en compte, plutôt qu'utiliser celle avec le numéro de version le plus important. (fonctionnalité optimale)

--download-debversion version

Préciser la version du paquet Debian dont il faut télécharger la version amont correspondante. Les règles dversionmangle et uversionmangle sont prises en compte. (fonctionnalité optimale)

--download-current-version

Télécharger la version actuelle du paquet. (fonctionnalité optimale)

--check-dirname-level N

Veuillez consulter la section "Vérification du nom du répertoire" ci-dessus pour une explication de cette option.

--check-dirname-regex regex

Veuillez consulter la section "Vérification du nom du répertoire" ci-dessus pour une explication de cette option.

--destdir chemin Normalement, uscan change son répertoire courant interne pour le répertoire source du paquet où le répertoire debian/ est situé. Ensuite, le répertoire de destination de l'archive téléchargée et des autres fichiers est défini sur le répertoire parent ../ à partir de ce répertoire courant interne.

Le répertoire de destination par défaut peut être remplacé en définissant l'option --destdir vers un chemin particulier. Si ce chemin est un chemin relatif, le répertoire de destination est déterminé relativement au répertoire courant interne d'exécution d'uscan. Si ce chemin est un chemin absolu, le répertoire de destination est fixé à cheminindépendamment du répertoire courant interne d'exécution d'uscan.

Ce qui précède est vrai non seulement pour l'exécution unique d'uscan dans une arborescence de sources unique, mais aussi pour l'exécution par uscan d'une recherche avancée dans des sous-répertoires contenant plusieurs arborescences de sources.

Une exception existe quand les options --watchfile et --package sont utilisées ensemble. Dans ce cas, le répertoire courant interne d'exécution d'uscan et le répertoire de destination par défaut sont définis au répertoire courant . où uscan est lancé. Le répertoire de destination par défaut peut être remplacé en définissant aussi l'option --destdir.

--package paquet

Indiquer le nom du paquet à contrôler plutôt qu'examiner debian/changelog ; cela nécessite les options --upstream-version (à moins qu'une option ne soit précisée dans le fichier watch) et --watchfile. De plus, aucun répertoire ne sera scanné et rien ne sera téléchargé. Cette option configure automatiquement --no-download et --skip-signature ; elle est probablement la plus utile en conjonction avec le système DEHS (et --dehs).

--upstream-version version-amont

Indiquer la version amont actuelle plutôt qu'examiner le fichier debian/watch ou le journal des modifications de Debian pour le déterminer. C'est ignoré si un balayage de répertoire est fait et que plus d'un fichier debian/watch est trouvé.

--watchfile watchfile

Indiquer le fichier watch plutôt que faire un balayage de répertoire pour le déterminer. Si cette option est utilisée 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).

Une exception existe quand les options --watchfile et --package sont utilisées ensemble. uscan peut être appelé à partir de n'importe quel répertoire et le répertoire courant interne d'exécution d'uscan et le répertoire de destination par défaut sont définis au répertoire courant . où uscan est lancé.

Vous trouverez plus d'informations dans l'explication de --destdir.

--bare

Désactiver tout le code "special code" spécifique au site pour réaliser les redirections d'URL et les altérations de contenu de page.

--http-header

Ajoute l'en-tête spécifié dans les requêtes HTTP correspondant à l'url. Cette option peut être multivaluée, les valeurs doivent être de la forme "baseUrl@NomEnTête=valeur". Exemple :

  uscan --http-header https://example.org@My-Token=azertyuiop
    

Sécurité :

--no-exclusion

Ne pas exclure automatiquement les fichiers mentionnés dans le champ Files-Excluded de debian/copyright.

--pasv

Forcer le mode passif ("PASV") pour les connexions FTP.

--no-pasv

Ne pas utiliser le mode passif (PASV) pour les connexions FTP.

--no-symlink

Ne pas renommer ni rempaqueter l'archive amont.

--timeout N

Définir le temps d'attente à N secondes (20 secondes par défaut).

--user-agent, --useragent

Utiliser un champ "user agent" différent de celui par défaut.

--help

Afficher un bref message d'aide.

--version

Afficher les informations sur la version.

uscan accepte aussi les options suivantes et les passe à mk-origtargz :

--symlink

Faire des fichiers résultants orig.tar.gz (avec l'extension appropriée) des liens symboliques vers les fichiers téléchargés (c'est le comportement par défaut).

--copy

Au lieu de créer des liens symboliques comme décrit précédemment, copier les fichiers téléchargés.

--rename

Au lieu de créer des liens symboliques comme décrit précédemment, renommer les fichiers téléchargés.

--repack

Après avoir téléchargé une archive lzma tar, xz tar, bzip tar, gz tar, zip, jar, xpi, zstd, le rempaqueter à la compression spécifiée (voir --compression).

The unzip package must be installed in order to repack zip, jar, and xpi archives, the xz-utils package must be installed to repack lzma or xz tar archives, and zstd must be installed to repack zstd archives.

--compression [ gzip | bzip2 | lzma | xz ]

Au cas où les sources amont sont rempaquetés (soit parce que l’option --repack est donnée, soit parce que debian/copyright contient le champ Files-Excluded), la méthode de compression peut être contrôlée avec le paramètre comp. La méthode par défaut est gzip pour les archives normales, et xz pour les archives générées directement à partir du dépôt git.

--copyright-file fichier_de_copyright

Exclure les fichiers mentionnés dans le champ Files-Excluded du fichier_de_copyright donné. C’est utile lors de l’utilisation d’uscan en dehors d’un répertoire de paquet source.

VARIABLES DE CONFIGURATION DE DEVSCRIPT

Pour une utilisation de base d'uscan, la configuration de ces variables n'est pas nécessaire.

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 :

USCAN_DOWNLOAD

Télécharger ou rapporter l'information seulement:

USCAN_SAFE

Si elle est définie à yes, alors uscan évite l'exécution de scripts non sécurisés en sautant à la fois le rempaquetage du paquet téléchargé et la mise à jour de l'arborescence de la nouvelle source ; c'est l'équivalent des options --safe ; cela définit aussi les options par défaut à --no-download et --skip-signature.

USCAN_PASV

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

USCAN_TIMEOUT

Si cette option est définie à un nombre N, alors définir 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|lzma|xz} ne sera pas créé (équivalent à l'option --no-symlink). Si elle est à yes ou symlink, les liens symboliques seront créés. Si elle est à rename, les fichiers sont renommés (é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 utilisée.

USCAN_VERBOSE

Si elle est définie à yes, alors la sortie sera verbeuse, comme si l'option --verbose était utilisée.

USCAN_USER_AGENT

Si elle est définie, elle spécifie la chaîne à utiliser pour annoncer le navigateur ("user agent") à la place de la valeur par défaut. C'est équivalent à l'option --user-agent.

USCAN_DESTDIR

Si elle est définie, elle désigne le répertoire où les fichiers téléchargés seront placés. C'est équivalent à l'option --destdir.

USCAN_REPACK

Si elle est définie à yes, alors après avoir téléchargé une archive tar compressée avec bzip, lzma, xz ou zstd ou une archive ZIP, uscan recréera une archive compressée du type défini (voir --compression). C'est équivalent à l'option --repack.

USCAN_EXCLUSION

Si elle est définie à no, les fichiers mentionnés dans le champ Files-Excluded de debian/copyright seront ignorés et aucune exclusion de fichiers ne sera tentée. C'est équivalent à l'option --no-exclusion.

USCAN_HTTP_HEADER

Si définie, l'en-tête spécifié sera utilisé pour toutes les URLs correspondantes. C'est équivalent à l'option --http-header.

VALEURS DE RETOUR

La valeur de retour indique si une nouvelle version a été trouvée ; il est conseillé de lire la sortie pour déterminer 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é utilisées, soit une nouvelle version amont a été trouvée pour un des fichiers watch examinés.

1

Aucune nouvelle version amont n'a été trouvée pour les fichiers watch examinés.

FONCTIONNALITÉS AVANCÉES

uscan possède beaucoup d'autres fonctionnalités qui sont sautées dans la section ci-dessus, pour être plus simple. Regardons leurs points marquants.

uscan peut être exécuté avec chemin comme paramètre pour passer le répertoire de départ de recherche du répertoire courant à chemin.

Si vous ne savez pas exactement ce qui se passe dans les coulisses, veuillez activer l'option --verbose. Si ce n'est pas suffisant, activez l'option --debug pour voir toutes les actions internes.

Voir "OPTIONS DE LIGNE DE COMMANDE" et "VARIABLES DE CONFIGURATION DE DEVSCRIPT" pour d'autres variantes.

HISTORIQUE ET MISE À NIVEAU

Cette section décrit brièvement les incompatibilités inverses des fonctionnalités du fichier watch qui ont été ajoutées dans chaque version du fichier watch et la première version du paquet devscripts qui les comprenait.

Versions antérieures à 2

La syntaxe du fichier watch était très différente à l'époque. Ne l'utilisez plus. Si vous mettez votre fichier watch à niveau depuis une version antérieure à 2, il est recommandé de lire cette page de manuel et de recommencer à zéro.

Version 2

devscripts version 2.6.90 : la première incarnation du style actuel de fichier watch. Cette version est également dépréciée et sera rejetée dès la publication de Debian 11.

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 répertoire/chemin, numéro de version dans plusieurs parties, numéro 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 lorsqu'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 liés au numéro de version en (?: ... ) au lieu d'un groupe ordinaire ( ... ).

Version 4

devscripts version 2.15.10 : la première incarnation des fichiers watch prenant en charge les archives amont multiples.

La syntaxe du fichier de veille est assouplie pour permettre plus d'espaces de lisibilité.

Si vous avez un script personnalisé à la place de uupdate, vous pouvez aussi rencontrer des problèmes lors de la mise à jour à partir de la version 3.

VOIR AUSSI

dpkg(1), mk-origtargz(1), perlre(1), uupdate(1), devscripts.conf(5)

AUTEUR

La version initiale de uscan a été écrite par Christoph Lameter <clameter@debian.org>. Des améliorations significatives, d'autres modifications et des corrections de bogues ont été apportées par Julian Gilbey <jdg@debian.org>. La prise en charge d'HTTP a été ajouté par Piotr Roszatycki <dexter@debian.org>. Le programme a été réécrit en Perl par Julian Gilbey. Xavier Guimard l'a convertit en Perl orienté-objet en utilisant Moo.

TRADUCTION

Cyril Brulebois <cyril.brulebois@enst-bretagne.fr>, 2006

Thomas Huriaux <thomas.huriaux@gmail.com>, 2006

David Prévot <david@tilapin.org>, 2010-2013

Xavier Guimard <yadd@debian.org>, 2018-2021