NAME

       debaux-build - Debian package building script

SYNOPSIS

       debaux-build [OPTIONS] DEBDIR [BUILDDIR SOURCEDIR]

       debaux-build --cpan Net::Google

VERSION

       0.1.10

DESCRIPTION

       debaux-build is a helper script for building Debian packages.  Besides options it takes up
       to three parameters: DEBDIR, BUILDDIR, SOURCEDIR. DEBDIR is a required parameter.

       If DEBDIR doesn't exist, debaux-build tries to download the package with apt-get source.

       debaux-build applies all patches found in the DEBDIR subdirectory patches.

       If no source tarball exist and the DEBDIR subdirectory sources exist, all files in this
       directory get packed and used as source tarball.

OPTIONS

       "--apt"
           Forces apt-get source mode.

       "--archive"
           Specifies file name of source archive.

       "--build-options"
           Options passed to "dpkg-buildpackage".

       "--cpan"
           Download Perl module from CPAN and create necessary Debian packaging files. You need
           to have the dh-make Debian package installed in order to utilize this option.

       "--empty"
           Empty package (no source code archive). Intended to use for task packages.

       "--epoch"
           Specifies epoch for CPAN builds.

           "--extra-sources"
               Specifies a directory below DEBDIR which is copied to the build directory.

           "-i, --install, --install=PACKAGE"
               Install build package.

           "-l, --lintian"
               Run lintian on the source file and the generated packages.

           "--make-archive"
               Intended to use for native Debian packages. Specify the commands to build the
               archive here.

           "--release"
               The generated packages are targeted for official Debian packages.

           "--rpm, --alien"
               Convert generated packages into RPM packages by using "alien".

           "-s, --sign"
               Sign source package and changelog.

           "--skip-patches"
               Don't apply patches from the patches directory and sources.diff file.

               "--source-tree"
                   Instructs "debaux-build" to use the specified directory instead of an archive
                   file.

               "--stop-before-build"
                   Stop script before calling "dpkg-buildpackage".

CONFIGURATION FILE

       "debaux-build" looks for the configuration file ".debauxrc" in the home directory and in
       the current directory and recognizes the following directives:

       "debauxdir" PACKAGE
           Used as "DEBDIR" for package if it is an existing directory.  Considered before the
           <debiandir> directive.

       "debiandir"
           If the directory "DEBDIR" on the commandline doesn't exist, "debaux-build" appends
           "DEBDIR" to the specified directory and tries again.

       "sourcedir"
           Directory with the source archives. Can be overridden by the commandline parameter
           "SOURCEDIR".

       "source-tree" PACKAGE
           Directory with the source code for PACKAGE.

SEE ALSO

       dpkg(8), dpkg-source(1), apt-get(8)

AUTHOR

       Stefan Hornburg (Racke) <racke@linuxia.de>.

LICENSE

       debaux-build comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome
       to redistribute and modify it under the terms of the GNU General Public License.

COPYRIGHT

       Copyright 2000,2001,2002,2003,2004,2005,2006,2007 Stefan Hornburg (Racke)
       <racke@linuxia.de>.

POD ERRORS

       Hey! The above document had some coding errors, which are explained below:

       Around line 1377:
           You forgot a '=back' before '=head1'

           You forgot a '=back' before '=head1'