gbp-import-dsc

&dhsection;

gbp-import-dsc

Import a &debian; source package into a &git; repository

          &gbp-import-dsc;
          &man.common.options.synopsis;
          --allow-same-versions
          --author-date-is-committer-date
          --author-is-committer
          --debian-branch=branch_name
          --debian-tag=tag-format
          --filter=pattern
          --keyid=gpg-keyid
          --[no-]create-missing-branches
          --[no-]pristine-tar
          --[no-]sign-tags
          --skip-debian-tag
          --upstream-branch=branch_name
          --upstream-tag=tag-format
          --upstream-vcs-tag=tag-format
          --repo-user=[GIT|DEBIAN]
          --repo-email=[GIT|DEBIAN]
          debian-source.dsc
          target

          &gbp-import-dsc;
          options
          --[no-]allow-unauthenticated

            URL

          target

## DESCRIPTION

&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;

`--upstream-branch`=`branch_name`

- The branch in the &git; repository the upstream sources are put onto. Default is `upstream`.

`--debian-branch`=`branch_name`

- The branch in the &git; repository the debian sources are put onto. Default is `master`.

`--[no-]sign-tags`

- GPG sign all created tags

`--keyid=``gpg-keyid`

- Use this keyid for gpg signing tags.

`--debian-tag=``tag-format`

- Use this tag format when tagging &debian; versions, default is `debian/%(version)s`.

`--upstream-tag=``tag-format`

- Use this tag format when tagging upstream versions, default is `upstream/%(version)s`.

`--upstream-vcs-tag`=`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 `--upstream-tag` 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.

`--skip-debian-tag`

- 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.

`--filter=``pattern`

- Filter out files glob-matching ``pattern`` 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.

`--pristine-tar`

- Generate pristine-tar delta file.

`--allow-unauthenticated`

- Whether to skip signature verification on downloads. Passed on verbatim to &dget; and &apt-get; respectively. Use with care.

`--allow-same-version`

- Allow one to import a package with the same debian version.

`--author-is-committer`

- When importing the &debian; patch, use the author identity as committer identity.

`--author-date-is-committer-date`

- 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.

`--[no-]create-missing-branches`

- Create upstream and debian branch if missing.

`--repo-user=``[GIT|DEBIAN]`

- When set to `DEBIAN` use the `DEBFULLNAME` environment variable to set the user.name &git; configuration otherwise use &git;'s defaults. Only affects newly created repos.

`--repo-email=``[GIT|DEBIAN]`

- When set to `DEBIAN` 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

Ensure that the local git repository has the latest version of the package available in Debian unstable by downloading and attempting to import the source package via `apt-get source`:

          &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

man.gbp.import.dscs, man.gbp.buildpackage, man.gbp.import.orig, man.gbp.dch,

apt-get

1 ,

sources.list

5 ,

dget

1 , man.gbp.conf, &man.seealso.common;

## AUTHOR

&dhusername; &dhemail;