X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_auto_configure;h=6b6b58f34ba7b2fce5b39342ceb114316da2c4ff;hb=4433049e1c444db9536be2141431d98b0ea438e4;hp=e846e99901fe80e17a15255649fc8bead0c67ac5;hpb=776abbb23a899ebba954774c8b3740706a21f72b;p=debhelper.git diff --git a/dh_auto_configure b/dh_auto_configure index e846e99..6b6b58f 100755 --- a/dh_auto_configure +++ b/dh_auto_configure @@ -11,15 +11,18 @@ use Debian::Debhelper::Dh_Buildsystems; =head1 SYNOPSIS -B [S>] [S I>] +B [S>] [S>] [S I>] =head1 DESCRIPTION dh_auto_configure is a debhelper program that tries to automatically -configure a package prior to building. It looks for and runs a ./configure -script, Makefile.PL, Build.PL, or cmake. A standard set of parameters is -determined and passed to the program that is run. If no program to run is -found, dh_auto_configure will exit without doing anything. +configure a package prior to building. It does so by running the +appropriate command for the build system it detects the package uses. +For example, it looks for and runs a ./configure script, Makefile.PL, +Build.PL, or cmake. A standard set of parameters is determined and passed +to the program that is run. Some build systems, such as make, do not +need a configure step; for these dh_auto_configure will exit without +doing anything. This is intended to work for about 90% of packages. If it doesn't work, you're encouraged to skip using dh_auto_configure at all, and just run @@ -27,19 +30,25 @@ you're encouraged to skip using dh_auto_configure at all, and just run =head1 OPTIONS +See L for a list of common build +system selection and control options. + =over 4 =item B<--> I -Pass "params" to the program that is run. These can be used to supplement -or override the standard parameters that dh_auto_configure passes. +Pass "params" to the program that is run, after the standard +parameters that dh_auto_configure passes. This can be used to supplement +or override those parameters. For example: + + dh_auto_configure -- --with-foo --enable-bar =back =cut -my $manager = new Debian::Debhelper::Dh_Buildsystems; -$manager->run_dh_auto_tool(); +buildsystems_init(); +buildsystems_do(); =head1 SEE ALSO