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 ] [
--upstream-vcs-tag= tag_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
- --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, git-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/%(versions)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.
- --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¶
Several
gbp.conf files are parsed to set defaults for the above
commandline arguments. See the [XRef to GBP.MAN.GBP.CONF] manpage for details.
SEE ALSO¶
git-buildpackage(1),
git-import-dsc(1),
git-import-dscs(1),
git-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>