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.