gbp-import-orig

&dhsection;

gbp-import-orig

Import an upstream source into a git repository

          &gbp-import-orig;

          &man.common.options.synopsis;
          --upstream-version=version
          --[no-]merge
          --upstream-branch=branch_name
          --debian-branch=branch_name
          --upstream-vcs-tag=tag-format
          --[no-]sign-tags
          --keyid=gpg-keyid
          --upstream-tag=tag-format
          --filter=pattern
          --[no-]pristine-tar
          --[no-]filter-pristine-tar
          --[no-]symlink-orig
          --postimport=cmd
          --[no-]interactive
          --download

            upstream-source
            --uscan

## DESCRIPTION

&gbp-import-orig; imports `upstream-source` into the &git; repository. `upstream-source` can either be a gzip, bzip2, lzma or xz compressed tar archive, a zip archive or an already unpacked source tree. If it is already of the form `package-name_version.orig.tar.gz`, the version information is read from the tarball's filename otherwise it can be given on the command line via `--upstream-version`. If the source package name or version can't be determined &gbp-import-orig; will prompt for it unless `--no-interactive` is given.

The sources are placed on the upstream branch (default: `upstream`), tagged and merged onto the debian branch (default: `master`).

## OPTIONS

&man.common.options.description;

`--upstream-version`=`version`

`-u` `version`

- The upstream version number

`--[no-]merge`

- Merge the upstream branch to the &debian; branch after import

`--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; package is being developed on, default is `master`. After importing the new sources on the upstream branch, &gbp-import-orig; will try to merge the new version onto this branch.

`--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 it's revision history. The `tag-format` can be a pattern similar to what `--upstream-tag` supports.

`--[no-]sign-tags`

- GPG sign all created tags

`--keyid=``gpg-keyid`

- use this keyid for gpg signing tags

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

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

`--import-msg=``msg-format`

- use this format string for the commit message when importing upstream versions, default is `Imported Upstream version %(version)s`

`--filter=``pattern`

- filter out files glob-matching pattern. Can be given multiple times.

`--[no-]pristine-tar`

- generate `pristine-tar` delta file

`--[no-]filter-pristine-tar`

- if using a filter also filter the files out of the tarball passed to `pristine-tar`

`--[no-]symlink-orig`

- Whether to create and keep a symlink from the upstream tarball to a &debian; policy conformant upstream tarball name located in `../`.

  This is a good idea if not using `pristine-tar` since it avoids creating a new tarball with a different md5sum.

`--postimport=`cmd``

- run `cmd` after the import.

`--uscan`

- Use uscan to fetch new upstream version.

`--uscan`

- Download the tarball from the given HTTP URL. This needs python-request installed.

`--[no-]interactive`

- Run command interactively, i.e. ask package name and version if needed.

## EXAMPLES

Download and import a new upstream version using the informantion from `debian/watch`

          &gbp-import-orig; --uscan

After downloading an upstream tarball by hand import it

          &gbp-import-orig; ../upstream-tarball-0.1.tar.gz

&man.gbp.config-files;

## SEE ALSO

man.gbp.buildpackage, man.gbp.import.dsc, man.gbp.import.dscs, man.gbp.dch, man.gbp.conf, &man.seealso.common;

## AUTHOR

&dhusername; &dhemail;