Man Linux: Main Page and Category List

NAME

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

SYNOPSIS

       git-import-orig  [  --verbose  ] [ --upstream-version=version ] [ --no-
       merge ] [ --upstream-branch=branch_name ] [ --debian-branch=branch_name
       ]  [  --[no-]sign-tags  ]  [  --keyid=gpg-keyid ] [ --upstream-tag=tag-
       format ] [ --filter=pattern ] [ --[no-]pristine-tar ] [  --[no-]filter-
       pristine-tar ] [ --postimport=cmd ] [ --uscan ] upstream-source

DESCRIPTION

       git-import-orig   imports  upstream-source  into  the  Git  repository.
       upstream-source can either be a gzip or bzip2 compressed tar 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.

       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

       --no-merge
              Don't merge the upstream version to the development branch

       --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, git-import-orig will try  to  merge  the
              new version onto this branch.

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

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

       --pristine-tar
              generate pristine-tar delta file

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

       --postimport=cmd
              run cmd after the import.

       --uscan
              Use uscan to fetch new upstream version.

CONFIGURATION FILES

       Four configuration files are parsed  to  set  defaults  for  the  above
       commandline arguments:

       /etc/git-buildpackage/gbp.conf
              system wide configuraton

       ~/.gbp.conf
              per user configuration

       .gbp.conf
              per branch configuration, can be published with the repository

       debian/gbp.conf
              per branch configuration, can be published with the repository

       .git/gbp.conf
              per repository configuration

       See /etc/git-buildpackage/gbp.conf for an example.

SEE ALSO

       git-buildpackage(1), git-import-dsc(1), git-import-dscs(1), git-dch(1),
       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>

                               05 September 2010