A typical, simple workflow consists of the following steps:
Initially import a Debian™ package via gbp import-dsc. This
imports the Debian™ Package on the
and the upstream sources on the
Develop, test, commit changes. During this time, you can
always build the package with gbp buildpackage. In case you have
uncommitted changes in your source tree, you can use the
Optionally you can create the Debian™ changelog entries
using gbp dch and create snapshot releases for testing using its
Once satisfied, you can build the final package with
--git-tag. This additionally
creates a tag within Git™ so you can switch back to that version later
at any time. The format of the tags can be specified; tags can
be GPG™ signed.
When a new upstream version is released and upstream
isn't using Git™, you can import the new version via gbp import-orig
upstream-branch. gbp import-orig will
by default try to merge the new upstream version onto the
debian-branch (you can skip the merge with
--no-merge). After resolving any potential conflicts,
go back to the second step.
These steps will be explained in more details in the following sections.