D.6. How to build a package with git-buildpackage

Please refer to the git-builpackage documentation for more complete information. Here is just a quick guide.

All options, except those starting on --git, are passed to dpkg-buildpackage. Hence, basic usage should be something like this (from the root of the repository): git-buildpackage -rfakeroot -uc -us. The package will be built in place, and the result will be put in the parent directory.

git-buildpackage will complain when your repository is not clean. You may use the option --git-ignore-new to override this behaviour.

If your package is ready for upload you may use the --git-tag option for the final build. This will create a tag in your local repository. Provided you have commited all your changes to the Git repository, this will after a successful build of the package create a tag for the current version.

Tip

Tags created by git-import-orig and git-buildpackage are not automatically pushed, you have to push them explicitly with the following command: git push --tags. Be careful if you use local tags!

You can add the --dry-run option to git push to see what will be done.

To build with pbuilder (or cowbuilder), use the following:

  git-buildpackage \
    --git-builder="pdebuild --debbuildopts '-I.git -i\.git -uc -us'" \
    --git-cleaner="fakeroot debian/rules clean"