]> git.donarmstrong.com Git - debhelper.git/blob - dh_auto_configure
Merge branch 'master' into buildsystems
[debhelper.git] / dh_auto_configure
1 #!/usr/bin/perl -w
2
3 =head1 NAME
4
5 dh_auto_configure - automatically configure a package prior to building
6
7 =cut
8
9 use strict;
10 use Debian::Debhelper::Dh_Buildsystems;
11
12 =head1 SYNOPSIS
13
14 B<dh_auto_configure> [S<I<build system options>>] [S<I<debhelper options>>] [S<B<--> I<params>>]
15
16 =head1 DESCRIPTION
17
18 dh_auto_configure is a debhelper program that tries to automatically
19 configure a package prior to building. It does so by running the
20 appropriate command for the build system it detects the package uses.
21 For example, it looks for and runs a ./configure script, Makefile.PL,
22 Build.PL, or cmake. A standard set of parameters is determined and passed
23 to the program that is run. Some build systems, such as make, do not
24 need a configure step; for these dh_auto_configure will exit without
25 doing anything.
26
27 This is intended to work for about 90% of packages. If it doesn't work,
28 you're encouraged to skip using dh_auto_configure at all, and just run
29 ./configure or its equivalent manually.
30
31 =head1 OPTIONS
32
33 See L<debhelper(7)/BUILD SYSTEM OPTIONS> for a list of common build
34 system selection and control options.
35
36 =over 4
37
38 =item B<--> I<params>
39
40 Pass "params" to the program that is run, after the standard
41 parameters that dh_auto_configure passes. This can be used to supplement
42 or override those parameters. For example:
43
44   dh_auto_configure -- --with-foo --enable-bar
45
46 =back
47
48 =cut
49
50 buildsystems_init();
51 buildsystems_do();
52
53 =head1 SEE ALSO
54
55 L<debhelper(7)>
56
57 This program is a part of debhelper.
58
59 =head1 AUTHOR
60
61 Joey Hess <joeyh@debian.org>
62
63 =cut