&dhemail;
&dhfirstname; &dhsurname;
gbp-import-ref &dhsection; gbp-import-ref Update upstream sources when using &git; only &gbp-import-ref; &man.common.options.synopsis; version [auto|merge|replace] branch_name tag_format [BRANCH|VERSION|commit-id] branch_name gpg-keyid DESCRIPTION &gbp-import-ref; merges upstream git commits onto your &debian-branch; You can either specify a branch to merge, give an upstream version or specify the commit id directly. If no tag exists for the imported commit it will be automatically created. OPTIONS &man.common.options.description; =version version The upstream version to merge. The upstream tag to use will be determined via the . [auto|merge|replace] How to fold the upstream commits onto the &debian; packaging branch. merge does a &git; merge leaving you on your own in case of merge conflict resolution. replace mode on the other hand makes the head of the &debian; packaging branch identical to the newly imported tree but preserves the content of the debian/ directory while keeping the current head as well as the newly imported tree as parents of the generated commit. This is similar to a merge strategy while preserving debian/. The default is auto which uses replace for 3.0 (quilt) packages and merge otherwise. =branch_name The branch in the &git; repository the upstream sources are on. Default is upstream. tag-format Use this tag format when looking up upstream tags, default is upstream/%(version)s. [BRANCH|VERSION|commit-id] What to merge into the &debian-branch;. BRANCH (the default) merges from the upstream branch. VERSION looks for a tag determined from the given upstream version number via the option. Other values are interpreted as git commit id to merge from. =branch_name The branch in the &git; repository the &debian; package is being developed on, default is master. GPG sign all created tags. gpg-keyid Use this for gpg signing tags. msg-format Use this format string for the commit message when importing upstream versions, default is New upstream version %(version)s. Run cmd after the import. The hook gets the following environment variables passed: GBP_BRANCH The name of the Debian packaging branch GBP_TAG The name of the just created upstream tag GBP_UPSTREAM_VERSION The just imported upstream version GBP_DEBIAN_VERSION The Debian version of the package with a Debian revision of '-1' Rollback changes in case of an error. EXAMPLES Merge commits from the &upstream-branch; into the &debian-branch; creating a tag for the version 0.0~git20180524: &gbp-import-ref; --upstream-tree=BRANCH -u0.0~git20180524 Merge commits from the the tag corresponding to version 1.0: &gbp-import-ref; --upstream-tree=VERSION -u1.0 Merge commits given by a SHA1 creating a tag for the version 0.0~git20180524 &gbp-import-ref; --upstream-tree=c4398912c -u0.0~git20180524 &man.gbp.config-files; SEE ALSO , , , , , uscan 1 , &man.seealso.common; AUTHOR &dhusername; &dhemail;