summaryrefslogtreecommitdiff
path: root/dh_auto_build
blob: 77b55eef84d5ee48d1249018e4ff402f7c2c1056 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
#!/usr/bin/perl -w

=head1 NAME

dh_auto_build - automatically builds a package

=cut

use strict;
use Debian::Debhelper::Dh_Buildsystems;

=head1 SYNOPSIS

B<dh_auto_build> [S<I<build system options>>] [S<I<debhelper options>>] [S<B<--> I<params>>]

=head1 DESCRIPTION

B<dh_auto_build> is a debhelper program that tries to automatically build a
package. It does so by running the appropriate command for the build system
it detects the package uses. For example, if a F<Makefile> is found, this is
done by running B<make> (or B<MAKE>, if the environment variable is set). If
there's a F<setup.py>, or F<Build.PL>, it is run to build the package.

This is intended to work for about 90% of packages. If it doesn't work,
you're encouraged to skip using B<dh_auto_build> at all, and just run the
build process manually.

In order to override standard build flags, export appropriate environment
variables as documented in the L<dpkg-buildflags(1)> manual page. They will be
preferred over directly exported their counterparts (CFLAGS, CXXFLAGS, LDFLAGS
etc.).

=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 I<params> to the program that is run. These can be used to supplement
or override any standard parameters that B<dh_auto_build> passes.

=back

=cut

buildsystems_init();
buildsystems_do();

=head1 SEE ALSO

L<debhelper(7)>

This program is a part of debhelper.

=head1 AUTHOR

Joey Hess <joeyh@debian.org>

=cut