.\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\"
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng .
.TH "GBP-IMPORT-DSC" "1" "07 February 2017" "" "git-buildpackage Manual"
.SH NAME
gbp-import-dsc \- Import Debian packages into a Git repository
.SH SYNOPSIS
\fBgbp\~import-dsc\fR [ \fB--version\fR ] [ \fB--help\fR ] [ \fB--verbose\fR ] [ \fB--color=\fI[auto|on|off]\fB\fR ] [ \fB--color-scheme=\fICOLOR_SCHEME\fB\fR ] [ \fB--allow-same-versions\fR ] [ \fB--author-date-is-committer-date\fR ] [ \fB--author-is-committer\fR ] [ \fB--debian-branch=\fIbranch_name\fB\fR ] [ \fB--debian-tag=\fItag-format\fB\fR ] [ \fB--filter=\fIpattern\fB\fR ] [ \fB--keyid=\fIgpg-keyid\fB\fR ] [ \fB--[no-]create-missing-branches\fR ] [ \fB--[no-]pristine-tar\fR ] [ \fB--[no-]sign-tags\fR ] [ \fB--skip-debian-tag\fR ] [ \fB--upstream-branch=\fIbranch_name\fB\fR ] [ \fB--upstream-tag=\fItag-format\fB\fR ] [ \fB--repo-user=[GIT|DEBIAN]\fR ] [ \fB--repo-email=[GIT|DEBIAN]\fR ] \fB\fIdebian-source.dsc\fB\fR [ \fB\fItarget\fB\fR ]
\fBgbp\~import-dsc\fR [ \fBoptions\fR ] [ \fB--[no-]allow-unauthenticated\fR ] \fB\fIURL\fB\fR [ \fB\fItarget\fB\fR ]
.SH "DESCRIPTION"
.PP
\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 \fI/etc/apt/sources.list\fR).
.SH "OPTIONS"
.TP
\fB--version\fR
Print version of the program, i.e. version of the git-buildpackage
suite
.TP
\fB-v\fR
.TP
\fB--verbose\fR
Verbose execution
.TP
\fB-h\fR
.TP
\fB--help\fR
Print help and exit
.TP
\fB--color=\fI[auto|on|off]\fB \fR
Whether to use colored output.
.TP
\fB--color-scheme=\fICOLOR_SCHEME\fB \fR
Colors to use in output (when color is enabled). The format for
COLOR_SCHEME is
\&':::\&'.
Numerical values and color names are accepted, empty fields imply
the default color. For example,
\fB--git-color-scheme=\fR\&'cyan:34::' would
show debug messages in cyan, info messages in blue and other messages
in default (i.e. warning and error messages in red).
.TP
\fB--upstream-branch=\fIbranch_name\fB \fR
The branch in the Git repository the upstream sources are put
onto. Default is \fIupstream\fR\&.
.TP
\fB--debian-branch=\fIbranch_name\fB \fR
The branch in the Git repository the debian sources are put
onto. Default is \fImaster\fR\&.
.TP
\fB--[no-]sign-tags \fR
GPG sign all created tags
.TP
\fB--keyid=\fIgpg-keyid\fB \fR
use this keyid for gpg signing tags
.TP
\fB--debian-tag=\fItag-format\fB \fR
use this tag format when tagging Debian versions,
default is \fIdebian/%(version)s\fR
.TP
\fB--upstream-tag=\fItag-format\fB \fR
use this tag format when tagging upstream versions,
default is \fIupstream/%(version)s\fR
.TP
\fB--skip-debian-tag \fR
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
\fB--filter=\fIpattern\fB \fR
filter out files glob-matching pattern. Can be given multiple times.
.TP
\fB--pristine-tar \fR
generate pristine-tar delta file
.TP
\fB--allow-unauthenticated \fR
Whether to skip signature verification on
downloads. Passed on verbatim to dget and apt-get
respectively. Use with care.
.TP
\fB--allow-same-version \fR
Allow one to import a package with the same debian version.
.TP
\fB--author-is-committer \fR
When importing the Debian patch, use the author identity as
committer identity.
.TP
\fB--author-date-is-committer-date \fR
When importing the Debian patch, use the author date as
committer date.
.sp
.RS
.B "Warning:"
Git will subtly misbehave if the committer date of a commit is not
later than or equal to all its parents.
.RE
.TP
\fB--[no-]create-missing-branches \fR
Create missing upstream and debian branch if missing.
.TP
\fB--repo-user=[GIT|DEBIAN]\fR
When set to \fBDEBIAN\fR
use the \fBDEBUSER\fR environment variable to set the
user.name Git configuration otherwise use Git\&'s
defaults. Only affects newly created repos.
.TP
\fB--repo-email=[GIT|DEBIAN]\fR
When set to \fBDEBIAN\fR
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"
.PP
Several \fIgbp.conf\fR files are parsed
to set defaults for the above command-line arguments. See the
\fBgbp.conf\fR(5)> manpage for details.
.SH "EXAMPLES"
.PP
Download and import a source package from a URL:
.nf
\fBgbp\~import-dsc\fR http://http.debian.net/debian/pool/main/h/hello/hello_2.10-1.dsc
.fi
.PP
Download and import a source package via \fBapt-get
source\fR from unstable:
.nf
\fBgbp\~import-dsc\fR apt://hello/sid
.fi
.PP
Import a source package in the local file system:
.nf
\fBgbp\~import-dsc\fR \&../hello_2.10-1.dsc
.fi
.SH "SEE ALSO"
.PP
\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),
\fIThe Git-Buildpackage Manual\fR
.SH "AUTHOR"
.PP
Guido Guenther