darcs-buildpackage1

Usage

Overview

The darcs-buildpackage command is used to build Debian source and .deb packages from a checked-out version of a Debian source tree. Please refer to the darcs-buildpackage manual for instructions on how to check out such a tree.

darcs-buildpackage will, in order:

•

Verify that it is being executed from the proper location.

•

Check to see if a proper orig.tar.gz exists. If not, it will check out the proper upstream directory from the darcs-buildpackage repository (if necessary) and build the orig.tar.gz. The orig.tar.gz will not contain Darcs meta-data.

If the upstream repository is not available locally, it will consult mirrors in the same manner as dbp-get(1).

•

Call debuild(1) (or the application specified in DBP_BUILDER) with arguments instructing it to ignore Darcs meta-data in the diff.gz, passing along all arguments given to darcs-buildpackage.

Options

All options passed to darcs-buildpackage are sent directly to debuild(1).

Environment

If the DBP_BUILDER environment variable is set, it will be taken as the name of a command to use to build the Debian packages. It will be passed no arguments save those passed to darcs-buildpackage itself.

If DBP_BUILDER is not set, the default is to use debuild -i_darcs -I_darcs, which will build a package and ensure that that _darcs directory is not included in the generated Debian source package. If you set DBP_BUILDER, you should probably ensure that similar exclusions are passed to your preferred building tool.

Examples

~$ cd ~/tree/debian
FIXME: show example

Files

The following specific files are used by this application:

~/.darcs-buildpackage

Specifies the location of the canonical Debian and upstream repositories.

Environment

This application uses no environment variables directly, but other programs it calls may do so.