&dhemail;
&dhfirstname;
&dhsurname;
gbp-import-dsc
&dhsection;
gbp-import-dscImport &debian; packages into a &git; repository
&gbp-import-dsc;
&man.common.options.synopsis;
branch_nametag-formatpatterngpg-keyidbranch_nametag-formattag-formatdebian-source.dsctarget
&gbp-import-dsc;
URLtargetDESCRIPTION
&gbp-import-dsc; 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 &gbp; tools.
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 target argument.
When given a URL &gbp-import-dsc;
will download the source package prior to importing it. &dget;
is used for all schemes except for the special
scheme apt:/// which uses &apt-get;
(and therefore needs deb-src
entries in your /etc/apt/sources.list).
The later can be abbreviated by using the pseudo URL
apt:.
OPTIONS
&man.common.options.description;
=branch_name
The branch in the &git; repository the upstream sources are put
onto. Default is upstream.
=branch_name
The branch in the &git; repository the debian sources are put
onto. Default is master.
GPG sign all created tags
gpg-keyid
Use this keyid for gpg signing tags.
tag-format
Use this tag format when tagging &debian; versions,
default is debian/%(version)s.
tag-format
Use this tag format when tagging upstream versions,
default is upstream/%(version)s.
=tag-format
Add tag-format 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
tag-format can be a pattern similar to
what supports.
The default is to not add upsteam tags as additional
parents since this requires additional setup to have the upstream
sources in the same repository.
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.
pattern
Filter out files glob-matching
from
upstream tarballs and the debian tarball of 3.0(quilt)
packages. Note that the .diff.gz of 1.0
source format packages is currently not filtered.
This option can be given multiple times.
Generate pristine-tar delta file.
Whether to skip signature verification on
downloads. Passed on verbatim to &dget; and &apt-get;
respectively. Use with care.
Allow one to import a package with the same debian version.
When importing the &debian; patch, use the author identity as
committer identity.
When importing the &debian; patch, use the author date as
committer date.
&git; will subtly misbehave if the committer date of a commit is not
later than or equal to all its parents.
Create upstream and debian branch if missing.
When set to
use the DEBUSER environment variable to set the
user.name &git; configuration otherwise use &git;'s
defaults. Only affects newly created repos.
When set to
use the DEBEMAIL environment variable to set the
user.email &git; configuration otherwise use &git;'s
defaults. Only affects newly created repos.
&man.gbp.config-files;
EXAMPLES
Download and import a source package from a URL:
&gbp-import-dsc; http://http.debian.net/debian/pool/main/h/hello/hello_2.10-1.dsc
Download and import a source package via apt-get
source from unstable:
&gbp-import-dsc; apt:hello/sid
Import a source package in the local file system:
&gbp-import-dsc; ../hello_2.10-1.dsc
SEE ALSO,
,
,
,
apt-get1,
sources.list5,
dget1,
,
&man.seealso.common;
AUTHOR
&dhusername; &dhemail;