.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" 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.DE 1"
.TH ORIGTARGZ.DE 1 "2018-12-05" "Debian-Hilfswerkzeuge" " "
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "BEZEICHNUNG"
.IX Header "BEZEICHNUNG"
origtargz \- ruft den Original-Tarball eines Debian-Pakets aus verschiedenen
Quellen ab und entpackt ihn.
.SH "ÜBERSICHT"
.IX Header "ÜBERSICHT"
.IP "\fBorigtargz\fR [\fI\s-1OPTIONEN\s0\fR] [\fB\-\-unpack\fR[=\fBno\fR|\fBonce\fR|\fByes\fR]]" 4
.IX Item "origtargz [OPTIONEN] [--unpack[=no|once|yes]]"
.PD 0
.IP "\fBorigtargz\fR \fB\-\-help\fR" 4
.IX Item "origtargz --help"
.PD
.SH "BESCHREIBUNG"
.IX Header "BESCHREIBUNG"
\&\fBorigtargz\fR lädt den Original-Tarball eines Debian-Pakets herunter und
entpackt ihn außerdem in das aktuelle Verzeichnis, falls es nur ein
\&\fIdebian\fR\-Verzeichnis enthält. \fBorigtargz\fR wird hauptsächlich beim
Auschecken von reinen Debian-Verzeichnissen benutzt, aber es ist auch als
allgemeiner Wrapper zum Herunterladen von Tarbällen nützlich. Die
Versionsnummer des Tarballs, der heruntergeladen werden soll, wird von
\&\fIdebian/changelog\fR festgelegt. Es sollte von der obersten Verzeichnisebene
eines entpackten Debian-Quellpakets aufgerufen werden.
.PP
Es werden verschiedene Speicherorte zum Herunterladen ausprobiert:
.IP "\(bu" 4
Zuerst wird nach einer existierenden Datei gesucht.
.IP "\(bu" 4
Es werden mit \fB\-\-path\fR angegebene Verzeichnisse durchsucht.
.IP "\(bu" 4
\&\fBpristine-tar\fR wird probiert.
.IP "\(bu" 4
Wenn \fBapt-cache showsrc\fR eine passende Version meldet, wird \fBapt-get
source\fR probiert.
.IP "\(bu" 4
Finally, \fBuscan \-\-download \-\-download\-current\-version\fR is tried.
.PP
When asked to unpack the orig tarball, \fBorigtargz\fR will remove all files
and directories from the current directory, except the debian directory, and
the \s-1VCS\s0 repository directories. \fINote that this will drop all non-committed
changes\fR for the patch system in use (e.g. source format \*(L"3.0 (quilt)\*(R"), and
will even remove all patches from the package when no patch system is in use
(the original \*(L"1.0\*(R" source format). Some \s-1VCS\s0 control files outside
\&\fIdebian/\fR preserved (\fI.bzr\-builddeb\fR, \fI.bzr\-ignore\fR, \fI.gitignore\fR,
\&\fI.hgignore\fR), if stored in \s-1VCS.\s0
.PP
Standardverhalten ist es, den Original-Tarball zu entpacken, falls das
derzeitige Verzeichnis mit Ausnahme des \fIdebian\fR\-Verzeichnisses und der
oben erwähnten VCS-Dateien leer ist.
.SH "ANMERKUNGEN"
.IX Header "ANMERKUNGEN"
Obwohl \fBorigtargz\fR »targz« heißt, funktioniert es mit jedem für den Tarball
benutzten Komprimierungsverfahren.
.PP
Ein ähnliches Werkzeug zum Entpacken von Tarbällen ist
\&\fBuupdate\fR(1). \fBuupdate\fR erstellt ein neues Arbeitsverzeichnis, entpackt
den Tarball und wendet die Debian\-\fI.diff.gz\fR\-Änderungen an. Demgegenüber
benutzt \fBorigtargz\fR das aktuelle Verzeichnis und behält die VCS-Metadaten
bei.
.PP
Für Debian-Paketdepots, die die ganze Ursprungsquelle beibehalten, sollten
andere Werkzeuge benutzt werden, um ein Upgrade des Depots von dem neuen
Tarball durchzuführen. Siehe zum Beispiel \fBgbp-import-orig\fR(1) und
\&\fBsvn-upgrade\fR(1). \fBorigtargz\fR ist immer noch zum Herunterladen des
aktuellen Tarballs nützlich.
.SH "OPTIONEN"
.IX Header "OPTIONEN"
.IP "\fB\-p\fR, \fB\-\-path\fR \fIVerzeichnis\fR" 4
.IX Item "-p, --path Verzeichnis"
fügt \fIVerzeichnis\fR der Liste von Orten hinzu, an denen nach einem
existierenden Tarball gesucht wird. Wenn er gefunden wird, wird nach
Möglichkeit ein harter, andernfalls ein symbolischer Verweis erzeugt.
.IP "\fB\-u\fR, \fB\-\-unpack\fR[=\fBno\fR|\fBonce\fR|\fByes\fR]" 4
.IX Item "-u, --unpack[=no|once|yes]"
entpackt den heruntergeladenen Original-Tarball in das aktuelle Verzeichnis
und ersetzt alles außer dem Debian-Verzeichnis. Existierende Dateien werden
entfernt, mit Ausnahme der \fIdebian/\fR und VCS-Dateien. Aufbewahrt werden:
\&\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 und \fI.svn\fR.
.RS 4
.IP "\fBno\fR" 4
.IX Item "no"
entpackt nicht den Original-Tarball.
.IP "\fBonce\fR (Vorgabe, wenn nicht \fB\-\-unpack\fR benutzt wird)" 4
.IX Item "once (Vorgabe, wenn nicht --unpack benutzt wird)"
Falls das aktuelle Verzeichnis nur ein \fIdebian\fR\-Verzeichnis (und
möglicherweise ein paar Dateien, deren Name mit Punkt beginnt) enthält, wird
der Original-Tarball entpackt. Dies ist das Standardverhalten.
.IP "\fByes\fR (Vorgabe für \fB\-\-unpack\fR ohne Argument)" 4
.IX Item "yes (Vorgabe für --unpack ohne Argument)"
entpackt immer den Original-Tarball.
.RE
.RS 4
.RE
.IP "\fB\-d\fR, \fB\-\-download\-only\fR" 4
.IX Item "-d, --download-only"
Alias für \fB\-\-unpack=no\fR
.IP "\fB\-t\fR, \fB\-\-tar\-only\fR" 4
.IX Item "-t, --tar-only"
Wenn \fBapt-get source\fR benutzt wird, wird \fB\-\-tar\-only\fR daran
übergeben. Standardmäßig wird die vollständige Quelle einschließlich der
\&\fI.dsc\fR\- und \fI.diff.gz\fR\- oder \fI.debian.tar.gz\fR\-Bestandteile
heruntergeladen. Daher kann \fBdebdiff\fR verwendet werden, um den Unterschied
zwischen dem letzten Upload und dem nächsten zu ermitteln. Mit \fB\-\-tar\-only\fR
wird nur die \fI.orig.tar.*\fR\-Datei heruntergeladen.
.IP "\fB\-\-clean\fR" 4
.IX Item "--clean"
entfernt existierende Dateien wie bei \fB\-\-unpack\fR. Beachten Sie, dass dies
wie \fB\-\-unpack\fR die Ursprungsdateien auch dann entfernt, wenn sie im \s-1VCS\s0
gespeichert sind.
.SH "SIEHE AUCH"
.IX Header "SIEHE AUCH"
\&\fBdebcheckout\fR(1), \fBgbp-import-orig\fR(1), \fBpristine-tar\fR(1),
\&\fBsvn-upgrade\fR(1), \fBuupdate\fR(1)
.SH "AUTOR"
.IX Header "AUTOR"
\&\fBorigtargz\fR und diese Handbuchseite wurden von Christoph Berg
<\fImyon@debian.org\fR> geschrieben.