DEBIAN-BUILDER(1)					User Contributed Perl Documentation					 DEBIAN-BUILDER(1)

NAME

       debian-builder - Rebuild a Debian package from its source code.

SYNOPSIS

	 debian-builder [options]

	 Help Options:
	  --debug    Show useful debugging information.
	  --help     Show this scripts help information.
	  --manual   Read this scripts manual.
	  --version  Show the version number and exit.
	  --verbose  Show verbose output.

	 Building options:

	  --sign	 Force package signing, disabled by default.
	  --debuild foo  Pass arguments 'foo' onto debuild when building
	  --suffix  foo  Give the built package versions the suffix 'foo'.

OPTIONS

       --debug Show the commands this script executes as an aid to debugging.
       --help Show the brief help information.
       --verbose Show verbose information useful to debugging.

DESCRIPTION

	 debian-builder is a simple script which is designed to facilitate the
	rebuilding of a Debian GNU/Linux package from its source code.	It will
	correctly handle the installation of any required build-dependencies,
	and remove them once building is complete.

AUTHOR

	Steve
	--
	http://www.steve.org.uk/

	$Id: debian-builder,v 1.14 2006/06/04 18:24:04 steve Exp $

LICENSE

       Copyright (c) 2005 by Steve Kemp.  All rights reserved.

       This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.  The LICENSE file contains the
       full text of the license.

       buildPackage

	  Do all the work of building the given package.

	  Return '>0' on success, '0' on failure of any kind.  (The result is the
	number of binary files moved into the results directory.)

       parseCommandLineArguments

	 Parse any command line arguments, and set the appropriate values
	in the global CONFIG hash.

       getSourcePackageName

	 Return the name of the source package required to build package 'foo'

       getPackageSource

	 Download the source of the package to the specified directory
	and return the name of the unpacked directory.

       updateChangeLog

	 If the Debian changelog file doesn't already refer to the specified
	version then add it.

       saveDebianPackage

	 Move the build Debian package, associated .diff.gz file, .changes file,
	etc.  From the build directory into the binary directory.

	 Return the number of files moved into the binary directory.

       tidySystem

	 Uninstall all the build dependency packages we installed.

	 We do this by finding the list of all packages which are currently
	installed and removing those that were not present when we started.

       getInstalledPackages

	 Return a hash of all the currently installed packages.

       installBuildDependencies

	 Install the build-dependencies required to build the given package.

       removePackages

	 Remove the given array of packages from the system.

       END

	 Desperately try to reset the host system to the same starting point
	as it initially had.

	 This should be taken care of in situations where the script doesn't
	abort on an error condition.

perl v5.8.8							    2008-03-13							 DEBIAN-BUILDER(1)