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).
- 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 <[email protected]> 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.