.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" 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 "MK-ORIGTARGZ.DE 1"
.TH MK-ORIGTARGZ.DE 1 "2021-08-18" "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"
mk-origtargz \- benennt den Tarball der Originalautoren um, ändert wahlweise
die Komprimierung und entfernt unerwünschte Dateien.
.SH "ÜBERSICHT"
.IX Header "ÜBERSICHT"
.IP "\fBmk-origtargz\fR [\fIOptionen\fR] \fIfoo\-1.0.tar.gz\fR" 4
.IX Item "mk-origtargz [Optionen] foo-1.0.tar.gz"
.PD 0
.IP "\fBmk-origtargz\fR \fB\-\-help\fR" 4
.IX Item "mk-origtargz --help"
.PD
.SH "BESCHREIBUNG"
.IX Header "BESCHREIBUNG"
\&\fBmk-origtargz\fR renames the given file to match what is expected by
\&\fBdpkg-buildpackage\fR, based on the source package name and version in
\&\fIdebian/changelog\fR. It can convert \fBzip\fR to \fBtar\fR, optionally change the
compression scheme and remove files according to \fBFiles-Excluded\fR and
\&\fBFiles\-Excluded\-\fR\fIcomponent\fR in \fIdebian/copyright\fR. The resulting file is
placed in \fIdebian/../..\fR. (In \fIdebian/copyright\fR, the \fBFiles-Excluded\fR
and \fBFiles\-Excluded\-\fR\fIcomponent\fR stanzas are a part of the first paragraph
and there is a blank line before the following paragraphs which contain
\&\fBFiles\fR and other stanzas. The \fBFiles-Included\fR stanza may be used to
ignore parts of subdirectories specified by the \fBFiles-Excluded\fR stanza See
\&\fBuscan\fR(1) \*(L"\s-1COPYRIGHT FILE EXAMPLE\*(R".\s0)
.PP
Der Archivtyp für \fBzip\fR wird mit dem Befehl »\fBfile \-\-dereference \-\-brief
\&\-\-mime\-type\fR ermittelt. Daher werden alle Archve vom Typ \fBzip\fR, wie etwa
\&\fBjar\fR, auf die gleiche Weise behandelt. Das \fBxpi\fR\-Archiv wird anhand
seiner Erweiterung bestimmt und ordnungsgemäß mittels des Befehls
\&\fBxpi-unpack\fR gehandhabt.
.PP
Falls der Paketname über die Option \fB\-\-package\fR angegeben wurde, werden
keine Informationen aus \fIdebian/\fR gelesen und die resultierende Datei wird
im aktuellen Verzeichnis abgelegt.
.PP
\&\fBmk-origtargz\fR wird üblicherweise über \fBuscan\fR aufgerufen. Es erhält
zuerst den Tarball der Originalautoren.
.SH "OPTIONEN"
.IX Header "OPTIONEN"
.SS "Metadatenoptionen"
.IX Subsection "Metadatenoptionen"
Die folgenden Optionen erweitern oder ersetzen die aus \fIdebian/\fR
entnommenen Informationen.
.IP "\fB\-\-package\fR \fIPaket\fR" 4
.IX Item "--package Paket"
benutzt \fIPaket\fR als Namen des Debian-Quellpakets und erfordert oder
verwendet daher nicht ein \fIdebian/\fR\-Verzeichnis. Diese Option kann nur
zusammen mit \fB\-\-version\fR benutzt werden.
.Sp
Standardmäßig wird der Paketname des ersten Eintrags in \fIdebian/changelog\fR
verwendet.
.IP "\fB\-v\fR, \fB\-\-version\fR \fIVersion\fR" 4
.IX Item "-v, --version Version"
benutzt \fIVersion\fR 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.
.Sp
Standardmäßig wird der Teil der Version von den Originalautoren des ersten
Eintrags in \fIdebian/changelog\fR benutzt.
.IP "\fB\-\-exclude\-file\fR \fIGlob\fR" 4
.IX Item "--exclude-file Glob"
entfernt Dateien, die zum angegebenen \fIGlob\fR des Tarballs passen, als ob er
in \fBFiles-Excluded\fR aufgeführt wäre.
.IP "\fB\-\-copyright\-file\fR \fIDateiname\fR" 4
.IX Item "--copyright-file Dateiname"
entfernt Dateien, die den in \fIDateiname\fR gefunden Mustern
entsprechen. Diese sollten im Format einer Debian\-\fICopyright\fR\-Datei
(genaugenommen \fBFormat:
https://www.debian.org/doc/packaging\-manuals/copyright\-format/1.0/\fR)
vorliegen. Fehler beim Auswerten dieser Datei werden stillschweigend
ignoriert, genau wie dies bei \fIdebian/copyright\fR der Fall ist.
.Sp
Ungleiche Muster werden eine Warnung ausgeben, so dass der Benutzer prüfen
kann, ob es korrekt ist. Falls es mehrere zu einer Datei passende Muster
gibt, zählt nur das letzte als passend.
.Sp
Sowohl die \fB\-\-exclude\-file\fR\- als auch \fB\-\-copyright\-file\fR\-Optionen ergänzen
die Liste der in \fIdebian/copyright\fR gefundenen Muster. Falls Sie diese
Datei nicht auslesen wollen, müssen Sie \fB\-\-package\fR verwenden.
.IP "\fB\-\-signature\fR \fISignaturmodus\fR" 4
.IX Item "--signature Signaturmodus"
\&\fISignaturmodus\fR setzen:
.RS 4
.IP "0 für keine Signatur" 4
.IX Item "0 für keine Signatur"
.PD 0
.IP "1 für normale freistehende Signatur" 4
.IX Item "1 für normale freistehende Signatur"
.IP "2 für Signatur von Dekompriniertem" 4
.IX Item "2 für Signatur von Dekompriniertem"
.IP "3 für Selbstsignatur" 4
.IX Item "3 für Selbstsignatur"
.RE
.RS 4
.RE
.IP "\fB\-\-signature\-file\fR \fISignaturdatei\fR" 4
.IX Item "--signature-file Signaturdatei"
.PD
verwendet \fISignaturdatei\fR als zum Debian-Quellpaket gehörige Signaturdatei,
um eine \fBdpkg-source\fR (post\-stretch)\-kompatible Signaturdatei zu
erzeugen. (optional).
.SS "Aktionsoptionen"
.IX Subsection "Aktionsoptionen"
Diese Optionen geben an, was genau \fBmk-origtargz\fR tun soll. Die Optionen
\&\fB\-\-copy\fR, \fB\-\-rename\fR und \fB\-\-symlink\fR schließen sich gegenseitig aus.
.IP "\fB\-\-symlink\fR" 4
.IX Item "--symlink"
liefert als Ergebnis einen symbolischen Verweis auf die Originaldatei. (Dies
ist das Standardverhalten.)
.Sp
Falls die Datei verändert werden muss (da es aufgrund von \fB\-\-repack\fR oder
\&\fBFiles-Excluded\fR eine \fBZip\fR\- oder \fBXpi\fR\-Datei ist), verhält sich diese
Option wie \fB\-\-copy\fR.
.IP "\fB\-\-copy\fR" 4
.IX Item "--copy"
liefert als Ergebnis eine Kopie der Originaldatei (natürlich nur, wenn sie
nicht verändert werden muss).
.IP "\fB\-\-rename\fR" 4
.IX Item "--rename"
benennt die Originaldatei um.
.Sp
Falls die Datei verändert werden muss (da es aufgrund von \fB\-\-repack\fR oder
\&\fBFiles-Excluded\fR eine \fBZip\fR\- oder \fBXpi\fR\-Datei ist), impliziert dies, dass
die Originaldatei hinterher gelöscht wird.
.IP "\fB\-\-repack\fR" 4
.IX Item "--repack"
Falls die angegebene Datei nicht im gewünschten Format komprimiert vorliegt,
(siehe \fB\-\-compression\fR) wird sie erneut komprimiert.
.IP "\fB\-S\fR, \fB\-\-repack\-suffix\fR \fIEndung\fR" 4
.IX Item "-S, --repack-suffix Endung"
Falls die Datei aufgrund von \fBFiles-Excluded\fR verändert werden muss, wird
\&\fIEndung\fR an die Version der Originalautoren angehängt.
.IP "\fB\-\-force\-repack\fR" 4
.IX Item "--force-repack"
komprimiert die Datei sogar dann neu, wenn sie im gewünschten Format
komprimiert vorliegt und keine Dateien gelöscht wurden.
.IP "\fB\-c\fR, \fB\-\-component\fR \fIKomponentenname\fR" 4
.IX Item "-c, --component Komponentenname"
verwendet \fIKomponentenname\fR als Komponentenname für den untergeordneten
Tarball der Ursprungsautoren. Dies wird nur für den untergeordneten Tarball
der Ursprungsautoren eines Debian-Quellpakets benutzt. Dann wird
\&\fIPaketname_Version.orig\-Komponentenname.tar.gz\fR erstellt.
.IP "\fB\-\-compression\fR [ \fBgzip\fR | \fBbzip2\fR | \fBlzma\fR | \fBxz\fR | \fBdefault\fR ]" 4
.IX Item "--compression [ gzip | bzip2 | lzma | xz | default ]"
Die Standardmethode ist \fBxz\fR. Wenn mk-origtargz in einem Debian-Quelldepot,
dessen Format »1.0« oder nicht definiert ist, gestartet wird, wechselt die
Methode zu \fBgzip\fR.
.IP "\fB\-C\fR, \fB\-\-directory\fR \fIVerzeichnis\fR" 4
.IX Item "-C, --directory Verzeichnis"
legt die resultierende Datei im angegebenen Verzeichnis ab.
.IP "\fB\-\-unzipopt\fR [\fIOptionen\fR]" 4
.IX Item "--unzipopt [Optionen]"
fügt die zusätzlichen Optionen, wie \fB\-a\fR, \fB\-aa\fR und \fB\-b\fR, hinzu, die mit
dem Befehl \fBunzip\fR benutzt werden.
.SH "SIEHE AUCH"
.IX Header "SIEHE AUCH"
\&\fBuscan\fR(1), \fBuupdate\fR(1)
.SH "AUTOR"
.IX Header "AUTOR"
\&\fBmk-origtargz\fR und diese Handbuchseite wurden von Joachim Breitner
<\fInomeata@debian.org\fR> geschrieben.