SYNOPSIS

origtargz [options] [--unpack[=no|once|yes]]

origtargz --help

DESCRIPTION

origtargz downloads the orig tarball of a Debian package, and also unpacks it into the current directory, if it just contains a debian directory. The main use for origtargz is with debian-dir-only repository checkouts, but it is useful as a general tarball download wrapper. The version number for the tarball to be downloaded is determined from debian/changelog. It should be invoked from the top level directory of an unpacked Debian source package.

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 »).

The default behavior is to unpack the orig tarball if the current directory is empty except for a debian directory and the VCS files mentioned above.

NOTES

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 gbp-import-orig(1) et svn-upgrade(1). origtargz est toujours utile pour télécharger l'archive amont actuelle.

OPTIONS

-p, --path répertoire

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.

-u, --unpack[=no|once|yes]

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, _darcs et .svn.

no

Ne pas dépaqueter l'archive amont.

once (par défaut si --unpack n'est pas utilisé)

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.

yes (par défaut si --unpack est utilisé sans argument)

Toujours dépaqueter l'archive amont.

-d, --download-only

Identique à --unpack=no.

-t, --tar-only

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

--clean

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.

AUTEUR

origtargz et cette page de manuel ont été écrits par Christoph Berg <[email protected]>.

TRADUCTION

Cyril Brulebois <[email protected]>, 2006

Thomas Huriaux <[email protected]>, 2006

David Prévot <[email protected]>, 2010-2013