DEBAUX-BUILD(1p)					User Contributed Perl Documentation					  DEBAUX-BUILD(1p)

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>.

perl v5.8.8							    2007-07-15							  DEBAUX-BUILD(1p)