.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "ORIGTARGZ.FR 1"
.TH ORIGTARGZ.FR 1 "2023-12-12" "Utilitaires Debian" " "
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NOM"
.IX Header "NOM"
origtargz \- Récupérer l'archive amont d'un paquet Debian depuis divers sources, et la dépaqueter
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.IP "\fBorigtargz\fR [\fIoptions\fR] [\fB\-\-unpack\fR[=\fBno\fR|\fBonce\fR|\fByes\fR]]" 4
.IX Item "origtargz [options] [--unpack[=no|once|yes]]"
.PD 0
.IP "\fBorigtargz\fR \fB\-\-help\fR" 4
.IX Item "origtargz --help"
.PD
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBorigtargz\fR télécharge l'archive amont (orig) d'un paquet Debian et la dépaquette aussi dans le répertoire actuel s'il contient seulement un répertoire \fIdebian\fR. L'utilisation principale d'\fBorigtargz\fR est avec les dépôts ne contenant que le répertoire \fIdebian\fR, mais il est aussi utile comme enveloppe générale de téléchargement d'archive. Le numéro de version de l'archive à télécharger est déterminé par \fIdebian/changelog\fR. Il devrait être appelé depuis le répertoire de premier niveau d'un paquet source Debian non dépaqueté.
.PP
Plusieurs emplacements de téléchargement sont essayés :
.IP "\(bu" 4
D'abord, un fichier existant est recherché.
.IP "\(bu" 4
Les répertoires donnés avec \fB\-\-path\fR sont explorés .
.IP "\(bu" 4
\&\fBpristine-tar\fR est essayé .
.IP "\(bu" 4
\&\fBpristine-tar\fR est essayé.
.IP "\(bu" 4
\&\fBapt-get source\fR est essayé si \fBapt-cache showsrc\fR indique une version correspondante.
.IP "\(bu" 4
Enfin, \fBuscan \-\-download \-\-download\-current\-version\fR est essayé.
.PP
Lorsqu'une archive amont doit être dépaquetée, \fBorigtargz\fR retirera tous les fichiers et répertoires du répertoire actuel sauf le répertoire \fIdebian\fR et les répertoires du dépôt de système de contrôle de versions. \fIRemarquez que toutes les modifications non prises en compte (committed) seront effacées\fR du système de correctifs utilisé (par exemple au format source \*(L"3.0 (quilt)\*(R") et que tous les correctifs seront retirés du paquet si aucun système n'est utilisé (pour le format source d'origine \*(L"1.0\*(R"). Certains fichiers du système de contrôle de versions, hors de \fIdebian/\fR, sont conservés (\fI.bzr\-builddeb\fR, \fI.bzr\-ignore\fR, \fI.gitignore\fR ou \fI.hgignore\fR) s'ils sont gardés dans le système de contrôle de versions.
.PP
Le comportement par défaut est de dépaqueter l'archive amont si le répertoire courant est vide sauf le répertoire \fIdebian\fR et les fichiers du système de contrôle de versions mentionnés plus haut.
.SH "NOTES"
.IX Header "NOTES"
Malgré son nom, \fBorigtargz\fR fonctionne avec n'importe quel format de compression utilisé pour l'archive amont.
.PP
Un outil similaire pour dépaqueter les archives amont est \fBuupdate\fR(1). \fBuupdate\fR crée un nouveau répertoire de travail, dépaquette l'archive et applique les modifications Debian \fI.diff.gz\fR. De son côté, \fBorigtargz\fR utilise le répertoire actuel, en gardant les métadonnées du système de gestion de versions.
.PP
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 \fBgbp-import-orig\fR(1) et \fBsvn-upgrade\fR(1). \fBorigtargz\fR est toujours utile pour télécharger l'archive amont actuelle.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-p\fR, \fB\-\-path\fR \fIrépertoire\fR" 4
.IX Item "-p, --path répertoire"
Ajouter \fIrépertoire\fR à la liste des emplacements pour chercher une archive amont. Une fois trouvé, un lien matériel est créé si possible, un lien symbolique sinon.
.IP "\fB\-u\fR, \fB\-\-unpack\fR[=\fBno\fR|\fBonce\fR|\fByes\fR]" 4
.IX Item "-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 \fIdebian\fR. Les fichiers existants sont supprimés, sauf le répertoire \fIdebian\fR et les fichiers du système de contrôle de versions. Sont gardés : \fI.bzr\fR, \fI.bzrignore\fR, \fI.bzr\-builddeb\fR, \fI.git\fR, \fI.gitignore\fR, \fI.hg\fR, \fI.hgignore\fR, \fI_darcs\fR et \fI.svn\fR.
.RS 4
.IP "\fBno\fR" 4
.IX Item "no"
Ne pas dépaqueter l'archive amont.
.IP "\fBonce\fR (par défaut si \fB\-\-unpack\fR n'est pas utilisé)" 4
.IX Item "once (par défaut si --unpack n'est pas utilisé)"
Si le répertoire actuel ne contient qu'un répertoire \fIdebian\fR (et éventuellement quelques fichiers \fI.*\fR), dépaqueter l'archive amont. C'est le comportement par défaut.
.IP "\fByes\fR (par défaut si \fB\-\-unpack\fR est utilisé sans paramètre)" 4
.IX Item "yes (par défaut si --unpack est utilisé sans paramètre)"
Toujours dépaqueter l'archive amont.
.RE
.RS 4
.RE
.IP "\fB\-d\fR, \fB\-\-download\-only\fR" 4
.IX Item "-d, --download-only"
Identique à \fB\-\-unpack=no\fR.
.IP "\fB\-t\fR, \fB\-\-tar\-only\fR" 4
.IX Item "-t, --tar-only"
En utilisant \fBapt-get source\fR, lui passer \fB\-\-tar\-only\fR. L'action par défaut est de télécharger le paquet source complet, y compris les composants \fI.dsc\fR et \fI.diff.gz\fR ou \fI.debian.tar.gz\fR pour que \fBdebdiff\fR puisse être utilisé pour comparer le dernier envoi au prochain. Avec \fB\-\-tar\-only\fR, seul le fichier \fI.orig.tar.*\fR est téléchargé.
.IP "\fB\-\-clean\fR" 4
.IX Item "--clean"
Supprimer les fichiers existants comme avec \fB\-\-unpack\fR. Remarquez que comme \fB\-\-unpack\fR, cela supprimera les fichiers amonts même s'ils sont stockés dans un système de contrôle de versions.
.SH "VOIR AUSSI"
.IX Header "VOIR AUSSI"
\&\fBdebcheckout\fR(1), \fBgbp-import-orig\fR(1), \fBpristine-tar\fR(1), \fBsvn-upgrade\fR(1), \fBuupdate\fR(1)
.SH "AUTEUR"
.IX Header "AUTEUR"
\&\fBorigtargz\fR et cette page de manuel ont été écrits par Christoph Berg <\fImyon@debian.org\fR>.
.SH "TRADUCTION"
.IX Header "TRADUCTION"
Cyril Brulebois <\fIcyril.brulebois@enst\-bretagne.fr\fR>, 2006
.PP
Thomas Huriaux <\fIthomas.huriaux@gmail.com\fR>, 2006
.PP
David Prévot <\fIdavid@tilapin.org\fR>, 2010\-2013
.PP
Xavier Guimard <\fIyadd@debian.org\fR>, 2018\-2021