.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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 "dpt-missing-upload 1"
.TH dpt-missing-upload 1 2024-03-04 "pkg-perl-tools 0.78" "Debian Perl packaging Tools"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
dpt\-missing\-upload \- incorporate package uploads not done from Git
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBdpt missing-upload\fR [\fB\-i\fR] \fIBASETAG\fR \fINEWVERSION\fR
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBdpt missing-upload\fR incorporates uploads of a package which are not yet in
the Git repo, e.g. NMUs.
.PP
To be run in the root directory of the source package's Git repo, and with
the target branch checked out.
.SH OPTIONS
.IX Header "OPTIONS"
Options must come before parameters.
.IP \fB\-i\fR 4
.IX Item "-i"
Run interactively, e.g. call \f(CW\*(C`git merge\*(C'\fR with \fI\-\-no\-commit\fR, so the commit
can be amended. Useful if the imported upload adds/removes files.
.Sp
Interactive mode is also enabled if a \fI.gitignore\fR file is found.
.SH PARAMETERS
.IX Header "PARAMETERS"
.IP BASETAG 4
.IX Item "BASETAG"
The Git tag representing the package version before the one to be imported. Required.
.IP NEWVERSION 4
.IX Item "NEWVERSION"
The package version to be downloaded and imported. Required.
.SH NOTES
.IX Header "NOTES"
.IP \(bu 4
To make merging Debian tags as painless as possible, \fBdpkg\-mergechangelogs\fR\|(1) is helpful.
.IP \(bu 4
For downloading the source package, \f(CW\*(C`deb\-src\*(C'\fR entries are required in the \fIsources.list\fR.
.SH "COPYRIGHT & LICENSE"
.IX Header "COPYRIGHT & LICENSE"
Copyright: 2020\-2024, gregor herrmann <gregoa@debian.org>
.PP
License: Artistic | GPL\-1+