Version: 0.9.36

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™ packages from a Git repository
gbp-clone — Clone a repository from remote
gbp-config — Query configuration values
gbp-create-remote-repo — Create remote repositories
gbp-dch — Generate the Debian™ changelog from git commit messages
gbp-export-orig — Export upstream tarballs from a Git repository
gbp-import-dsc — Import Debian™ packages into a Git repository
gbp-import-dscs — Import multiple versions of a Debian source packages into a Git repository
gbp-import-orig — Import an upstream source into a git repository
gbp-import-ref — Update upstream sources when using Git only
gbp-pq — Manage quilt patches on patch queue branches in git
gbp-pristine-tar — Manage pristine-tar commits in a git repository
gbp-pull — Safely update a repository from remote
gbp-push — Push Debian™ packaging changes to a Git remote
gbp-tag — Tag a Debian™ packages 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