.\" 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 "MK-ORIGTARGZ.DE 1"
.TH MK-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"
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 benennt die angegebene Datei auf Basis des Quellpaketnamens
und der Version in \fIdebian/changelog\fR so um, dass sie den Anforderungen von
\&\fBdpkg-buildpackage\fR entspricht. Es kann \fBzip\fR in \fBtar\fR umwandeln,
wahlweise das Komprimierungsverfahren ändern und Dateien entsprechend
\&\fBFiles-Excluded\fR und \fBFiles\-Excluded\-\fR\fIKomponente\fR in \fIdebian/copyright\fR
entfernen. Die daraus resultierende Datei wird in \fIdebian/../..\fR
abgelegt. (In \fIdebian/copyright\fR sind die Abschnitte \fBFiles-Excluded\fR und
\&\fBFiles\-Excluded\-\fR\fIKomponente\fR Teil des ersten Absatzes und es gibt dort
eine leere Zeile vor den folgenden Absätzen, die \fBFiles\fR oder weitere
Absätze enthalten. Siehe \fBuscan\fR(1) »COPYRIGHT \s-1FILE\s0 EXAMPLE«.)
.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 Anwender 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 \fIsignature-mode\fR" 4
.IX Item "--signature signature-mode"
Set \fIsignature-mode\fR:
.RS 4
.IP "0 for no signature" 4
.IX Item "0 for no signature"
.PD 0
.IP "1 for normal detached signature" 4
.IX Item "1 for normal detached signature"
.IP "2 for signature on decompressed" 4
.IX Item "2 for signature on decompressed"
.IP "3 for self signature" 4
.IX Item "3 for self signature"
.RE
.RS 4
.RE
.IP "\fB\-\-signature\-file\fR \fIsignature-file\fR" 4
.IX Item "--signature-file signature-file"
.PD
Use \fIsignature-file\fR as the signature file corresponding to the Debian
source package to create a \fBdpkg-source\fR (post-stretch) compatible
signature file.  (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"
Recompress even if file is compressed using the desired format and no files
were deleted.
.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 ]"
The default method is \fBxz\fR. When mk-origtargz is launched in a debian
source repository which format is \*(L"1.0\*(R" or undefined, the method switches to
\&\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.