]> git.donarmstrong.com Git - debhelper.git/blob - dh_auto_build
Always respect DEB_${flag}_{APPEND,SET} envvars.
[debhelper.git] / dh_auto_build
1 #!/usr/bin/perl -w
2
3 =head1 NAME
4
5 dh_auto_build - automatically builds a package
6
7 =cut
8
9 use strict;
10 use Debian::Debhelper::Dh_Buildsystems;
11
12 =head1 SYNOPSIS
13
14 B<dh_auto_build> [S<I<build system options>>] [S<I<debhelper options>>] [S<B<--> I<params>>]
15
16 =head1 DESCRIPTION
17
18 B<dh_auto_build> is a debhelper program that tries to automatically build a
19 package. It does so by running the appropriate command for the build system
20 it detects the package uses. For example, if a F<Makefile> is found, this is
21 done by running B<make> (or B<MAKE>, if the environment variable is set). If
22 there's a F<setup.py>, or F<Build.PL>, it is run to build the package.
23
24 This is intended to work for about 90% of packages. If it doesn't work,
25 you're encouraged to skip using B<dh_auto_build> at all, and just run the
26 build process manually.
27
28 In order to override standard build flags, export appropriate environment
29 variables as documented in the L<dpkg-buildflags(1)> manual page. They will be
30 preferred over directly exported their counterparts (CFLAGS, CXXFLAGS, LDFLAGS
31 etc.).
32
33 =head1 OPTIONS
34
35 See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build
36 system selection and control options.
37
38 =over 4
39
40 =item B<--> I<params>
41
42 Pass I<params> to the program that is run. These can be used to supplement
43 or override any standard parameters that B<dh_auto_build> passes.
44
45 =back
46
47 =cut
48
49 buildsystems_init();
50 buildsystems_do();
51
52 =head1 SEE ALSO
53
54 L<debhelper(7)>
55
56 This program is a part of debhelper.
57
58 =head1 AUTHOR
59
60 Joey Hess <joeyh@debian.org>
61
62 =cut