Building Debian Packages with git-buildpackage
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