---
name: "darcs-buildpackage"
section: "1"
platform: "linux"
package: "darcs-buildpackage"
version: "0.5.12.2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/darcs-buildpackage"
---

# darcs-buildpackage(1)

Build Debian packages from a Darcs archive

## NAME

darcs-buildpackage - Build Debian packages from a Darcs archive

## SYNOPSIS

**darcs-buildpackage** \[ *args for* *debuild ...* \]

## DESCRIPTION

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)](/dbp-get/1.md).

- •

  Call [**debuild**(1)](/debuild/1.md) (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)](/debuild/1.md).

## ENVIRONMENT VARIABLES

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.

## EXAMPLE

```
~$ 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.

## COPYRIGHT

darcs-buildpackage, all associated scripts and programs, this manual, and all build scripts are Copyright (C) 2003 - 2005 John Goerzen.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA

## AUTHOR

**darcs-buildpackage**, its modules, documentation, executables, and all included files, except where noted, was written by John Goerzen \<jgoerzen@complete.org\> and copyright is held as stated in the COPYRIGHT section.

**darcs-buildpackage** may be downloaded from the Debian packaging system or at\
  \<URL:http://packages.debian.org/darcs-buildpackage\>.

**darcs-buildpackage** may also be downloaded using Darcs by running **darcs get --partial** **http://darcs.complete.org/darcs-buildpackage**.

## SEE ALSO

Detailed usage information, including a background and a description of how the tools fit together, can be found in the darcs-buildpackage Manual.  On Debian systems, you may find this at */usr/share/doc/darcs-buildpackage*.

**darcs-buildpackage** applications have references in that manual and the following manpages:  [**dbp-importdsc**(1)](/dbp-importdsc/1.md), [**dbp-importorig**(1)](/dbp-importorig/1.md), [**dbp-markdeb**(1)](/dbp-markdeb/1.md), [**darcs-buildpackage**(1)](/darcs-buildpackage/1.md).

Other related references include: [**darcs**(1)](/darcs/1.md), [**debuild**(1)](/debuild/1.md), [**dbp-get**(1)](/dbp-get/1.md), [**dpkg-buildpackage**(1)](/dpkg-buildpackage/1.md).