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.