trusty (1) git-import-orig.1.gz

NAME

       git-import-orig, gbp-import-orig - Import an upstream source into a git repository

SYNOPSIS

       gbp   import-orig   [  --verbose  ]  [  --upstream-version=version  ]  [  --[no-]merge  ]  [  --upstream-
       branch=branch_name ] [ --debian-branch=branch_name ] [ --upstream-vcs-tag=tag_name ] [ --[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  ]
       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

       --upstream-version=version

       -uversion
              The upstream version number

       --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_name
              Add tag_name 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.

       --verbose

       -v     verbose execution

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

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

CONFIGURATION FILES

       Several gbp.conf files are  parsed  to  set  defaults  for  the  above  commandline  arguments.  See  the
       gbp.conf(5) manpage for details.

SEE ALSO

       gbp-buildpackage(1),  gbp-import-dsc(1), gbp-import-dscs(1), gbp-dch(1), gbp.conf(5), debuild(1), git(1),
       pristine-tar(1),   The   Git-Buildpackage   Manual    <URL:file:///usr/share/doc/git-buildpackage/manual-
       html/index.html>

AUTHOR

       Guido Guenther <agx@sigxcpu.org>

                                                15 February 2014                              GBP-IMPORT-ORIG(1)