'\" -*- coding: UTF-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH gbp-import-dsc 1 "15 December 2023" "" "git-buildpackage Manual"
.SH NAME
gbp-import-dsc \- Import Debian packages into a Git repository
.SH SYNOPSIS
'nh
.fi
.ad l
\*(T<\fBgbp\ import\-dsc\fR\*(T> \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\*(T<\fB\-\-version\fR\*(T>] [\*(T<\fB\-\-help\fR\*(T>] [\*(T<\fB\-\-verbose\fR\*(T>] [\*(T<\fB\-\-color=\fR\*(T>[auto|on|off]] [\*(T<\fB\-\-color\-scheme=\fR\*(T> \fICOLOR_SCHEME\fR] [\*(T<\fB\-\-allow\-same\-versions\fR\*(T>] [\*(T<\fB\-\-author\-date\-is\-committer\-date\fR\*(T>] [\*(T<\fB\-\-author\-is\-committer\fR\*(T>] [\*(T<\fB\-\-debian\-branch=\fR\*(T> \fIbranch_name\fR] [\*(T<\fB\-\-debian\-tag=\fR\*(T> \fItag-format\fR] [\*(T<\fB\-\-filter=\fR\*(T> \fIpattern\fR]\&... [\*(T<\fB\-\-keyid=\fR\*(T> \fIgpg-keyid\fR] [\*(T<\fB\-\-[no\-]create\-missing\-branches\fR\*(T>] [\*(T<\fB\-\-[no\-]pristine\-tar\fR\*(T>] [\*(T<\fB\-\-[no\-]sign\-tags\fR\*(T>] [\*(T<\fB\-\-skip\-debian\-tag\fR\*(T>] [\*(T<\fB\-\-upstream\-branch=\fR\*(T> \fIbranch_name\fR] [\*(T<\fB\-\-upstream\-tag=\fR\*(T> \fItag-format\fR] [\*(T<\fB\-\-upstream\-vcs\-tag=\fR\*(T> \fItag-format\fR] [\*(T<\fB\-\-repo\-user=\fR\*(T> \*(T<\fB[GIT|DEBIAN]\fR\*(T>] [\*(T<\fB\-\-repo\-email=\fR\*(T> \*(T<\fB[GIT|DEBIAN]\fR\*(T>] \fIdebian-source.dsc\fR [\fItarget\fR]
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\*(T<\fBgbp\ import\-dsc\fR\*(T> \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\*(T<\fBoptions\fR\*(T>] [\*(T<\fB\-\-[no\-]allow\-unauthenticated\fR\*(T>] \fIURL\fR [\fItarget\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBgbp\ import-dsc\fR imports a Debian source package into a Git repository,
notes the package version in the commit logs, and commits the change. All
information, including package name, version, Debian modifications and upstream
source, is automatically detected from the source package. After
import the repository can be used with the other \fBgbp\fR tools.
.PP
If the command is run from within an existing Git repository, it will import
into it; if not, a new repository named as the Debian source package is
created. You can override the location of the new repository by specifying
the optional \fItarget\fR argument.
.PP
When given a \fIURL\fR \fBgbp\ import-dsc\fR
will download the source package prior to importing it. dget
is used for all schemes except for the special
scheme \fIapt:///\fR which uses apt-get
(and therefore needs \fIdeb-src\fR
entries in your \*(T<\fI/etc/apt/sources.list\fR\*(T>).
The later can be abbreviated by using the pseudo URL
\fIapt:\fR.
.SH OPTIONS
.TP 
\*(T<\fB\-\-version\fR\*(T>
Print version of the program, i.e. version of the git-buildpackage
suite
.TP 
\*(T<\fB\-v\fR\*(T>, \*(T<\fB\-\-verbose\fR\*(T>
Verbose execution
.TP 
\*(T<\fB\-h\fR\*(T>, \*(T<\fB\-\-help\fR\*(T>
Print help and exit
.TP 
\*(T<\fB\-\-color=\fR\*(T>[auto|on|off] 
Whether to use colored output.
.TP 
\*(T<\fB\-\-color\-scheme=\fR\*(T>\fICOLOR_SCHEME\fR 
Colors to use in output (when color is enabled). The format for
COLOR_SCHEME is
\&'<debug>:<info>:<warning>:<error>'.
Numerical values and color names are accepted, empty fields imply
the default color. For example,
\*(T<\fB\-\-git\-color\-scheme=\fR\*(T>\*(T<'cyan:34::'\*(T> would
show debug messages in cyan, info messages in blue and other messages
in default (i.e. warning and error messages in red).
.TP 
\*(T<\fB\-\-upstream\-branch\fR\*(T>=\fIbranch_name\fR 
The branch in the Git repository the upstream sources are put
onto. Default is \fIupstream\fR.
.TP 
\*(T<\fB\-\-debian\-branch\fR\*(T>=\fIbranch_name\fR 
The branch in the Git repository the debian sources are put
onto. Default is \fImaster\fR.
.TP 
\*(T<\fB\-\-[no\-]sign\-tags\fR\*(T> 
GPG sign all created tags
.TP 
\*(T<\fB\-\-keyid=\fR\*(T>\fIgpg-keyid\fR 
Use this keyid for gpg signing tags.
.TP 
\*(T<\fB\-\-debian\-tag=\fR\*(T>\fItag-format\fR 
Use this tag format when tagging Debian versions,
default is \fIdebian/%(version)s\fR.
.TP 
\*(T<\fB\-\-upstream\-tag=\fR\*(T>\fItag-format\fR 
Use this tag format when tagging upstream versions,
default is \fIupstream/%(version)s\fR.
.TP 
\*(T<\fB\-\-upstream\-vcs\-tag\fR\*(T>=\fItag-format\fR 
Add \fItag-format\fR as additional parent to the
commit of the upstream tarball. Useful when upstream uses git and you
want to link to its revision history. The
\fItag-format\fR can be a pattern similar to
what \*(T<\fB\-\-upstream\-tag\fR\*(T> supports.

The default is to not add upstream tags as additional
parents since this requires additional setup to have the upstream
sources in the same repository.
.TP 
\*(T<\fB\-\-skip\-debian\-tag\fR\*(T> 
Don't create Debian tag after importing the Debian patch. This can be
useful if you already created a package but want to further work on
it after importing it into git.
.TP 
\*(T<\fB\-\-filter=\fR\*(T>\fIpattern\fR 
Filter out files glob-matching
\fIpattern\fR from
upstream tarballs and the debian tarball of 3.0(quilt)
packages. Note that the \fI.diff.gz\fR of 1.0
source format packages is currently not filtered.

This option can be given multiple times.
.TP 
\*(T<\fB\-\-pristine\-tar\fR\*(T> 
Generate pristine-tar delta file.
.TP 
\*(T<\fB\-\-allow\-unauthenticated\fR\*(T> 
Whether to skip signature verification on
downloads. Passed on verbatim to dget and apt-get
respectively. Use with care.
.TP 
\*(T<\fB\-\-allow\-same\-version\fR\*(T> 
Allow one to import a package with the same debian version.
.TP 
\*(T<\fB\-\-author\-is\-committer\fR\*(T> 
When importing the Debian patch, use the author identity as
committer identity.
.TP 
\*(T<\fB\-\-author\-date\-is\-committer\-date\fR\*(T> 
When importing the Debian patch, use the author date as
committer date.
.RS 
\fBWarning\fR

Git will subtly misbehave if the committer date of a commit is not
later than or equal to all its parents.
.RE
.TP 
\*(T<\fB\-\-[no\-]create\-missing\-branches\fR\*(T> 
Create upstream and debian branch if missing.
.TP 
\*(T<\fB\-\-repo\-user=\fR\*(T>\*(T<\fB[GIT|DEBIAN]\fR\*(T>
When set to \*(T<\fBDEBIAN\fR\*(T>
use the \fBDEBUSER\fR environment variable to set the
user.name Git configuration otherwise use Git's
defaults. Only affects newly created repos.
.TP 
\*(T<\fB\-\-repo\-email=\fR\*(T>\*(T<\fB[GIT|DEBIAN]\fR\*(T>
When set to \*(T<\fBDEBIAN\fR\*(T>
use the \fBDEBEMAIL\fR environment variable to set the
user.email Git configuration otherwise use Git's
defaults. Only affects newly created repos.
.SH "CONFIGURATION FILES"
Several \*(T<\fIgbp.conf\fR\*(T> files are parsed 
to set defaults for the above command-line arguments. See the
\fBgbp.conf\fR(5) manpage for details.
.SH EXAMPLES
Download and import a source package from a URL:
.PP
.nf
\*(T<
      \fBgbp\ import\-dsc\fR http://http.debian.net/debian/pool/main/h/hello/hello_2.10\-1.dsc
    \*(T>
.fi
.PP
Download and import a source package via \fBapt-get
source\fR from unstable:
.PP
.nf
\*(T<
      \fBgbp\ import\-dsc\fR apt:hello/sid
    \*(T>
.fi
.PP
Import a source package in the local file system:
.PP
.nf
\*(T<
      \fBgbp\ import\-dsc\fR ../hello_2.10\-1.dsc
    \*(T>
.fi
.SH "SEE ALSO"
\fBgbp-import-dscs\fR(1),
\fBgbp-buildpackage\fR(1),
\fBgbp-import-orig\fR(1),
\fBgbp-dch\fR(1),
\fBapt-get\fR(1),
\fBsources.list\fR(5),
\fBdget\fR(1),
\fBgbp.conf\fR(5),
\fBdebuild\fR(1),
\fBgit\fR(1),
\fBpristine-tar\fR(1),
.URL file:///usr/share/doc/git-buildpackage/manual-html/index.html "       The Git-Buildpackage Manual"
.SH AUTHOR
Guido G\(:unther <\*(T<agx@sigxcpu.org\*(T>>