Version: 0.9.37

Guido Günther


Introduction
Repository Layout and Terminology
Workflow
Importing Sources
Importing already existing Debian™ packages
Importing a new upstream version
Recovering from errors
Converting an existing Git repository
Upstream sources on a branch
Upstream sources not on a branch
Starting a Debian™ package from scratch
When upstream uses Git
No upstream tarballs
Upstream tarballs and linked upstream history
Upstream tarballs and separate upstream history
Branch layout
Building Packages from the Git Repository
Using a separate build dir
Invoking external programs
Running lintian
Pushing into a remote repository
Running postexport hook
Running preexport hook
Working with Patches
Basic Workflow
Importing a new upstream version
Adding your first patch
Team maintenance
Releases and Snapshots
Maintaining debian/changelog
Creating debian/changelog just before the release
Incrementally filling debian/changelog
Creating snapshots with increasing version numbers
Customizing snapshot numbers
Tuning commit messages
Configuration Files
Overriding Parsing Order
Special Use Cases
Handling non-DFSG clean upstream sources
Importing NMUs
Building with Cowbuilder
Working on random packages
Sloppy tarball creation
Integrating with pk4
A. Command Reference
gbp — Maintain Debian™ packages in Git
gbp-buildpackage — Build Debian™ source and binary packages from a Git repository
gbp-clone — Clone a Git repository from a remote and set up the necessary branch tracking
gbp-config — Query configuration values
gbp-create-remote-repo — Create a remote Git repository
gbp-dch — Generate the debian/changelog from Git commit history
gbp-export-orig — Recreate upstream tarballs from a Git repository
gbp-import-dsc — Import a Debian™ source package into a Git repository
gbp-import-dscs — Import several versions of a Debian™ source package into a Git repository, sorted by version number
gbp-import-orig — Import an upstream source from tarball, or git tag and tarball, into a git repository
gbp-import-ref — Update upstream sources in a git only workflow
gbp-pq — Manage debian/patches in Git without any need for GNU Quilt
gbp-pristine-tar — Manage pristine-tar commits in a git repository
gbp-pull — Update a Git repository from a remote, aware of necessary packaging branch tracking
gbp-push — Push to a remote Git repository, aware of necessary packaging branch tracking
gbp-tag — Tag a Debian™ release in a Git repository
gbp.conf — Gbp configuration file
gbp-buildpackage-rpm — Build RPM packages from a Git repository
gbp-import-srpm — Import source RPM packages into a Git repository
gbp-pq-rpm — Manage patches and development branches in Git
gbp-rpm-ch — Generate the RPM changelog from git commit messages
B. Copyright