Ubuntu Manpages

origtargz

Récupérer l'archive amont d'un paquet Debian depuis divers sources, et la dépaqueter

origtargz télécharge l'archive amont (orig) d'un paquet Debian et la dépaquette facultativement dans le répertoire actuel. Le numéro de version à utiliser est déterminé par debian/changelog. L'utilisation principale d'origtargz est avec les dépôts ne contenant que le répertoire debian. Il devrait être appelé depuis le répertoire de premier niveau d'un paquet source Debian non dépaqueté.

Plusieurs emplacements de téléchargement sont essayés :

  • d'abord, un fichier existant est recherché ;
  • les répertoires donnés avec --path sont explorés ;
  • pristine-tar est essayé ;
  • apt-get source est essayé si apt-cache showsrc indique une version correspondante ;
  • enfin, uscan --download-current-version est essayé.

Lorsqu'une archive amont doit être dépaquetée, origtargz retirera tous les fichiers et répertoires du répertoire actuel sauf le répertoire debian et les répertoires du dépôt de système de contrôle de versions. Certains fichiers hors de debian/ généralement gardés dans le système de contrôle de versions même pour les dépôts ne contenant que le répertoire debian sont aussi conservés (par exemple .bzr-builddeb, .gitignore ou .hgignore). Remarquez que toutes les modifications non prises en compte (committed) seront effacées du système de correctifs utilisé (par exemple au format source « 3.0 (quilt) ») et que tous les correctifs seront retirés du paquet si aucun système n'est utilisé (pour le format source d'origine « 1.0 »).

Le comportement par défaut est de dépaqueter l'archive amont la première fois que origtargz est appelé depuis un répertoire issu d'un dépôt ne contenant que le répertoire debian.

Malgré son nom, origtargz fonctionne avec n'importe quel format de compression utilisé pour l'archive amont.

Un outil similaire pour dépaqueter les archives amont est uupdate(1). uupdate crée un nouveau répertoire de travail, dépaquette l'archive et applique les modifications Debian .diff.gz. De son côté, origtargz utilise le répertoire actuel, en gardant les métadonnées du système de gestion de versions.

Pour les dépôts de paquet Debian gardant l'intégralité des sources amont, d'autres outils devraient être utilisés pour mettre à niveau le dépôt à partir de l'archive amont. Consultez par exemple git-import-orig(1) et svn-upgrade(1). origtargz est toujours utile pour télécharger l'archive amont actuelle.

Ajouter répertoire à la liste des emplacements pour chercher une archive amont. Une fois trouvé, un lien matériel est créé si possible, un lien symbolique sinon.
Dépaqueter l'archive amont téléchargée dans le répertoire actuel, en remplaçant tout sauf le répertoire debian. Les fichiers existants sont supprimés, sauf le répertoire debian et les fichiers du système de contrôle de versions. Sont gardés : .bzr, .bzrignore, .bzr-builddeb, .git, .gitignore, .hg, .hgignore et .svn.
Ne pas dépaqueter l'archive amont.
Si le répertoire actuel ne contient qu'un répertoire debian (et éventuellement quelques fichiers .*), dépaqueter l'archive amont. C'est le comportement par défaut.
Toujours dépaqueter l'archive amont.
Identique à --unpack=no.
En utilisant apt-get source, lui passer --tar-only. L'action par défaut est de télécharger le paquet source complet, y compris les composants .dsc et .diff.gz ou .debian.tar.gz pour que debdiff puisse être utilisé pour comparer le dernier envoi au prochain. Avec --tar-only, seul le fichier .orig.tar.* est téléchargé.
Supprimer les fichiers existants comme avec --unpack. Remarquez que comme --unpack, cela supprimera les fichiers amonts même s'ils sont stockés dans un système de contrôle de versions.

debcheckout(1), git-import-orig(1), pristine-tar(1), svn-upgrade(1), uupdate(1)

origtargz et cette page de manuel ont été écrits par Christoph Berg <myon@debian.org>.

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

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

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