]> 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 - configure and prepare package sources for 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<debhelper options>>] [S<I<dh_auto options>>] [S<B<--> I<params>>]
15
16 =head1 DESCRIPTION
17
18 dh_auto_configure is a debhelper program that is responsible for the
19 I<configure> step of the L<dh_auto(7)> building process. Since I<configure> is
20 the first step, typically it is the point when build configuration options
21 are set, system settings are detected and various build system specific
22 temporary files are pre-generated in the build directory. Some simpler build
23 systems do not need this step. In such a case, dh_auto_configure silently
24 succeeds without doing anything.
25
26 dh_auto_configure usually pre-configures the source build system with a set of
27 standard options which most Debian packages need to set anyway. Custom options
28 can be passed as I<params>. If dh_auto_configure does not meet your needs or
29 does not work, it is safe to skip/override it entirely and just run a configure
30 script or its equivalent manually.
31
32 #DH_AUTO SHARED OPTIONS#
33
34 =head1 OPTIONS
35
36 =over 4
37
38 =item B<--> I<params>
39
40 Pass I<params> to the command 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 =head1 SUPPORTED BUILD SYSTEMS
49
50 #SUPPORTED BUILD SYSTEMS INTRO#
51 #SUPPORTED BUILD SYSTEMS LIST#
52
53 =cut
54
55 buildsystems_init();
56 buildsystems_do();
57
58 =head1 SEE ALSO
59
60 L<dh_auto(7)>
61
62 L<debhelper(7)>
63
64 This program is a part of debhelper and its dh_auto package source building
65 suite.
66
67 =head1 AUTHORS
68
69  Joey Hess <joeyh@debian.org>
70  Modestas Vainius <modestas@vainius.eu>
71
72 =cut