ÜBERSICHT
- origtargz [OPTIONEN] [--unpack[=no|once|yes]]
- origtargz --help
BESCHREIBUNG
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.Es werden verschiedene Speicherorte zum Herunterladen ausprobiert:
- Zuerst wird nach einer existierenden Datei gesucht.
- Es werden mit --path angegebene Verzeichnisse durchsucht.
- pristine-tar wird probiert.
- Wenn apt-cache showsrc eine passende Version meldet, wird apt-get source probiert.
- Am Ende wird --download-current-version versucht.
Wenn origtargz den Original-Tarball entpacken soll, wird es alle Dateien und Verzeichnisse außer dem Debian-Verzeichnis und den VCS-Depotverzeichnissen aus dem aktuellen Verzeichnis entfernen. Einige Dateien außerhalb von debian/, die oft im VCS gespeichert werden, auch für Depots aus reinen Debian-Verzeichnissen, werden ebenso aufbewahrt (.bzr-builddeb, .gitignore, .hgignore). Beachten Sie, dass dadurch alle nicht übergebenen Änderungen für das benutzte Patch-System (z.B. Quellformat »3.0 (quilt)«) verworfen werden. Wenn kein Patch-System benutzt wird (das Originalquellformat »1.0«), werden sogar alle Patches des Pakets entfernt .
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.
ANMERKUNGEN
Obwohl origtargz »targz« heißt, funktioniert es mit jedem für den Tarball benutzten Komprimierungsverfahren.Ein ähnliches Werkzeug zum Entpacken von Tarballs ist uupdate(1). uupdate erstellt ein neues Arbeitsverzeichnis, entpackt den Tarball und wendet die Debian-.diff.gz-Änderungen an. Demgegenüber benutzt origtargz das aktuelle Verzeichnis und behält die VCS-Metadaten bei.
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 gbp-import-orig(1) und svn-upgrade(1). origtargz ist immer noch zum Herunterladen des aktuellen Tarballs nützlich.
OPTIONEN
- -p, --path Verzeichnis
- fügt Verzeichnis 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.
- -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 debian/ und VCS-Dateien. Aufbewahrt werden:
.bzr, .bzrignore, .bzr-builddeb, .git, .gitignore, .hg,
.hgignore, _darcs und .svn.
-
- no
- entpackt nicht den Original-Tarball.
- once (Vorgabe, wenn nicht --unpack benutzt wird)
- Falls das aktuelle Verzeichnis nur ein debian-Verzeichnis (und möglicherweise ein paar Dateien, deren Name mit Punkt beginnt) enthält, wird der Original-Tarball entpackt. Dies ist das Standardverhalten.
- yes (Vorgabe für --unpack ohne Argument)
- entpackt immer den Original-Tarball.
-
- -d, --download-only
- Alias für --unpack=no
- -t, --tar-only
- Wenn apt-get source benutzt wird, wird --tar-only daran übergeben. Standardmäßig wird die vollständige Quelle einschließlich der .dsc- und .diff.gz- oder .debian.tar.gz-Bestandteile heruntergeladen. Daher kann debdiff verwendet werden, um den Unterschied zwischen dem letzten Upload und dem nächsten zu ermitteln. Mit --tar-only wird nur die .orig.tar.*-Datei heruntergeladen.
- --clean
- entfernt existierende Dateien wie bei --unpack. Beachten Sie, dass dies wie --unpack die Ursprungsdateien auch dann entfernt, wenn sie im VCS gespeichert sind.