DARCS-BUILDPACKAGE(1)
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/darcsbuildpackage.
darcs-buildpackage applications have references in that manual and the following manpages: dbp-importdsc(1), dbp-importorig(1), dbpmarkdeb(1), darcs-buildpackage(1).
- Other related references include: darcs(1), debuild(1), dbp-get(1),
dpkg-buildpackage(1).