mk-origtargz(1) benennt den Tarball der Originalautoren um, ändert wahlweise

ÜBERSICHT

mk-origtargz [Optionen] foo-1.0.tar.gz
mk-origtargz --help

BESCHREIBUNG

mk-origtargz renames the given file to match what is expected by dpkg-buildpackage, based on the source package name and version in debian/changelog. It can convert zip to tar, optionally change the compression scheme and remove files according to Files-Excluded and Files-Excluded-component in debian/copyright. The resulting file is placed in debian/../... (In debian/copyright, the Files-Excluded and Files-Excluded-component stanzas are a part of the first paragraph and there is a blank line before the following paragraphs which contain Files and other stanzas. See uscan(1) ``COPYRIGHT FILE EXAMPLE''.)

The archive type for zip is detected by "file --dereference --brief --mime-type" command. So any zip type archives such as jar are treated in the same way. The xpi archive is detected by its extension and is handled properly using the xpi-unpack command.

Falls der Paketname über die Option --package angegeben wurde, werden keine Informationen aus debian/ gelesen und die resultierende Datei wird im aktuellen Verzeichnis abgelegt.

mk-origtargz wird üblicherweise über uscan aufgerufen. Es erhält zuerst den Tarball der Originalautoren.

OPTIONEN

Metadatenoptionen

Die folgenden Optionen erweitern oder ersetzen die aus debian/ entnommenen Informationen.
--package Paket
benutzt Paket als Namen des Debian-Quellpakets und erfordert oder verwendet daher nicht ein debian/-Verzeichnis. Diese Option kann nur zusammen mit --version benutzt werden.

Standardmäßig wird der Paketname des ersten Eintrags in debian/changelog verwendet.

-v, --version Version
benutzt Version als Version des Pakets. Dies muss der Teil einer vollständigen Debian-Version sein, der von den Originalautoren stammt, d.h. keine Debian-Revision, keine Epoche.

Standardmäßig wird der Teil der Version von den Originalautoren des ersten Eintrags in debian/changelog benutzt.

--exclude-file Glob
entfernt Dateien, die zum angegebenen Glob des Tarballs passen, als ob er in Files-Excluded aufgeführt wäre.
--copyright-file Dateiname
Remove files matching the patterns found in filename, which should have the format of a Debian copyright file (Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ to be precise). Errors parsing that file are silently ignored, exactly as is the case with debian/copyright.

Unmatched patterns will emit a warning so the user can verify whether it is correct. If there are multiple patterns which match a file, only the last one will count as being matched.

Sowohl die --exclude-file- als auch --copyright-file-Optionen ergänzen die Liste der in debian/copyright gefundenen Muster. Falls Sie diese Datei nicht auslesen wollen, müssen Sie --package verwenden.

Aktionsoptionen

Diese Optionen geben an, was genau mk-origtargz tun soll. Die Optionen --copy, --rename und --symlink schließen sich gegenseitig aus.
--symlink
liefert als Ergebnis einen symbolischen Verweis auf die Originaldatei. (Dies ist das Standardverhalten.)

If the file has to be modified (because it is a zip, or xpi file, because of --repack or Files-Excluded), this option behaves like --copy.

--copy
liefert als Ergebnis eine Kopie der Originaldatei (natürlich nur, wenn sie nicht verändert werden muss).
--rename
benennt die Originaldatei um.

If the file has to be modified (because it is a zip, or xpi file, because of --repack or Files-Excluded), this implies that the original file is deleted afterwards.

--repack
Falls die angegebene Datei nicht im gewünschten Format komprimiert vorliegt, (siehe --compression) wird sie erneut komprimiert.
-S, --repack-suffix Endung
Falls die Datei aufgrund von Files-Excluded verändert werden muss, wird Endung an die Version der Originalautoren angehängt.
-c, --component componentname
Use <componentname> as the component name for the secondary upstream tarball. Set componentname as the component name. This is used only for the secondary upstream tarball of the Debian source package. Then packagename_version.orig-componentname.tar.gz is created.
--compression [ gzip | bzip2 | lzma | xz ]
If --repack is used, or if the given file is a zip or xpi file, ensure that the resulting file is compressed using the given scheme. The default is gzip.
-C, --directory Verzeichnis
legt die resultierende Datei im angegebenen Verzeichnis ab.
--unzipopt options
Add the extra options to use with the unzip command such as -a, -aa, and -b.

AUTOR

mk-origtargz und diese Handbuchseite wurden von Joachim Breitner <[email protected]> geschrieben.