X-Git-Url: https://git.donarmstrong.com/?p=debhelper.git;a=blobdiff_plain;f=dh_auto_configure;h=e1ca7af25b41a1cfcfea733672663e81457ef43a;hp=34d6298a9689fabac816bcc0ef0293e349dabdd1;hb=18a0da8092ea9f3dc48bca92b36f592af25a608d;hpb=7bbc9917c046d06f7d7e8d7cad10b9e3b27a8ec9

diff --git a/dh_auto_configure b/dh_auto_configure
index 34d6298..e1ca7af 100755
--- a/dh_auto_configure
+++ b/dh_auto_configure
@@ -11,29 +11,34 @@ use Debian::Debhelper::Dh_Buildsystems;
 
 =head1 SYNOPSIS
 
-B<dh_auto_configure> [S<I<debhelper options>>] [S<B<--> I<params>>]
+B<dh_auto_configure> [S<I<build system options>>] [S<I<debhelper options>>] [S<B<--> I<params>>]
 
 =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.
+B<dh_auto_configure> is a debhelper program that tries to automatically
+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 F<./configure> script, F<Makefile.PL>,
+F<Build.PL>, or F<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 B<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
-./configure or its equivalent manually.
+you're encouraged to skip using B<dh_auto_configure> at all, and just run
+F<./configure> or its equivalent manually.
 
 =head1 OPTIONS
 
+See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build
+system selection and control options.
+
 =over 4
 
 =item B<--> I<params>
 
-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:
+Pass I<params> to the program that is run, after the parameters that
+B<dh_auto_configure> usually passes. For example:
 
   dh_auto_configure -- --with-foo --enable-bar