]> git.donarmstrong.com Git - debhelper.git/blob - dh_auto_configure
Revert "Always respect DEB_${flag}_{APPEND,SET} envvars."
[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 B<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 F<./configure> script, F<Makefile.PL>,
22 F<Build.PL>, or F<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 B<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 B<dh_auto_configure> at all, and just run
29 F<./configure> or its equivalent manually.
30
31 =head1 OPTIONS
32
33 See L<debhelper(7)/B<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 I<params> to the program that is run, after the standard
41 parameters that B<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