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:
o Verify that it is being executed from the proper location.
o 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).
o 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 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-importorig(1), dbp-
markdeb(1), darcs-buildpackage(1).
Other related references include: darcs(1), debuild(1), dbp-get(1),
dpkg-buildpackage(1).