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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
=head1 NAME
dh-autoreconf - debhelper add-on to run autoreconf during build
=head1 DESCRIPTION
The dh-autoreconf package provides a sequence addon for debhelper 7 which
can be used in the following way:
#!/usr/bin/make -f
%:
dh $@ --with autoreconf
This will call dh_autoreconf prior to dh_auto_configure and will call
dh_autoreconf_clean before dh_clean.
For more information on how to control the autoreconf process or how to
other possible options, read the L<dh_autoreconf(1)> and
L<dh_autoreconf_clean(1)> manual pages.
=head1 CDBS INTEGRATION
This package also provides F</usr/share/cdbs/1/rules/autoreconf.mk> for
packages using B<CDBS>. The variable C<DEB_DH_AUTORECONF_ARGS> can be used
to pass extra arguments to dh_autoreconf, and the variable
C<DEB_DH_AUTORECONF_CLEAN_ARGS> to pass arguments to dh_autoreconf_clean. See
their manual pages for information on available arguments.
=head1 TIPS AND EXAMPLES
=head2 PATCHING LTMAIN.SH FOR AS-NEEDED LINKER FLAGS
You can add support for -Wl,--as-needed to ltmain.sh (at least for those
ltmain.sh scripts changed during autoreconf) by passing the argument
B<--as-needed> to dh_autoreconf, as demonstrated in the following example:
#!/usr/bin/make -f
%:
dh $@ --with autoreconf
override_dh_autoreconf:
dh_autoreconf --as-needed
and for CDBS, by adding it to the correct variable such as:
DEB_DH_AUTORECONF_ARGS = --as-needed
For more information about this feature, see L<dh_autoreconf(1)>
=head2 RUNNING MULTIPLE COMMANDS WITH DH_AUTORECONF
Please note that you may run dh_autoreconf only once. If you need to run
multiple commands, you can put the commands into a script or your debian/rules
file and then pass the name of your script to dh_autoreconf. For example, if
your script is called debian/autogen.sh, you can put the following into your
debian/rules if you use dh:
override_dh_autoreconf:
dh_autoreconf debian/autogen.sh
Or, if you use CDBS:
DEB_DH_AUTORECONF_ARGS += debian/autogen.sh
=head1 CAVEATS
dh_autoreconf is a superset of the autotools-dev debhelper addons, so
you do not need --with=autotools_dev if you use --with=autoreconf. In
fact, in most cases they should not be used together, as it may lead to
unpredictable behaviour.
From time to time, there might be a short breakage for those using
automatic ltmain.sh patching, when the patch now longer applies to
the ltmain.sh.
You can only run dh_autoreconf once. Future versions may be able to
be run multiple times, but this requires slightly more planning.
=head1 SEE ALSO
L<debhelper(7)>, L<dh(1)>, L<dh_autoreconf(1)>, L<dh_autoreconf_clean(1)>
=head1 AUTHOR
Julian Andres Klode <jak@debian.org>
|