man-pages/man7/dh-autoreconf.7.html
2021-03-31 01:06:50 +01:00

186 lines
4.9 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of DH-AUTORECONF</TITLE>
</HEAD><BODY>
<H1>DH-AUTORECONF</H1>
Section: dh-autoreconf (7)<BR>Updated: 2018-05-19<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
dh-autoreconf - debhelper add-on to run autoreconf during build
<A NAME="lbAC">&nbsp;</A>
<H2>DESCRIPTION</H2>
The dh-autoreconf package provides a sequence addon for debhelper 7 and is
enabled by default since compatibility level 10. For earlier compatibility
levels it can be enabled in the following way:
<P>
<PRE>
#!/usr/bin/make -f
%:
dh $@ --with autoreconf
</PRE>
<P>
This will call dh_autoreconf prior to dh_auto_configure and will call
dh_autoreconf_clean before dh_clean.
<P>
For more information on how to control the autoreconf process or how to
other possible options, read the <I><A HREF="/cgi-bin/man/man2html?1+dh_autoreconf">dh_autoreconf</A></I>(1) and
<I><A HREF="/cgi-bin/man/man2html?1+dh_autoreconf_clean">dh_autoreconf_clean</A></I>(1) manual pages.
<A NAME="lbAD">&nbsp;</A>
<H2>CDBS INTEGRATION</H2>
This package also provides <I>/usr/share/cdbs/1/rules/autoreconf.mk</I> for
packages using <B></B><FONT SIZE="-1"><B>CDBS</B></FONT><B></B>. The variable <TT>&quot;DEB_DH_AUTORECONF_ARGS&quot;</TT> can be used
to pass extra arguments to dh_autoreconf, and the variable
<TT>&quot;DEB_DH_AUTORECONF_CLEAN_ARGS&quot;</TT> to pass arguments to dh_autoreconf_clean. See
their manual pages for information on available arguments.
<A NAME="lbAE">&nbsp;</A>
<H2>TIPS AND EXAMPLES</H2>
<A NAME="lbAF">&nbsp;</A>
<H3><FONT SIZE="-1">PATCHING LTMAIN.SH FOR</FONT> AS-NEEDED <FONT SIZE="-1">LINKER FLAGS</FONT></H3>
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</B> to dh_autoreconf, as demonstrated in the following example:
<P>
<PRE>
override_dh_autoreconf:
dh_autoreconf --as-needed
</PRE>
<P>
and for <FONT SIZE="-1">CDBS,</FONT> by adding it to the correct variable such as:
<P>
<PRE>
DEB_DH_AUTORECONF_ARGS = --as-needed
</PRE>
<P>
For more information about this feature, see <I><A HREF="/cgi-bin/man/man2html?1+dh_autoreconf">dh_autoreconf</A></I>(1)
<A NAME="lbAG">&nbsp;</A>
<H3><FONT SIZE="-1">RUNNING MULTIPLE COMMANDS WITH DH_AUTORECONF</FONT></H3>
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:
<P>
<PRE>
override_dh_autoreconf:
dh_autoreconf debian/autogen.sh
</PRE>
<P>
Or, if you use <FONT SIZE="-1">CDBS:</FONT>
<P>
<PRE>
DEB_DH_AUTORECONF_ARGS += debian/autogen.sh
</PRE>
<A NAME="lbAH">&nbsp;</A>
<H2>CAVEATS</H2>
dh_autoreconf is mostly a superset of the dh_update_autotools_config debhelper
command included in debhelper since version 9.20160115. When using the dh
sequencer, dh_update_autotools_config is run before dh_autoreconf and updates
the config.guess and config.sub files. This is required in cases where
autoreconf does not update config.guess and config.sub itself.
<P>
From time to time, there might be a short breakage for those using
automatic ltmain.sh patching, when the patch no longer applies to
the ltmain.sh.
<P>
You can only run dh_autoreconf once. Future versions may be able to
be run multiple times, but this requires slightly more planning.
<A NAME="lbAI">&nbsp;</A>
<H2>SEE ALSO</H2>
<I><A HREF="/cgi-bin/man/man2html?7+debhelper">debhelper</A></I>(7), <I><A HREF="/cgi-bin/man/man2html?1+dh">dh</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+dh_autoreconf">dh_autoreconf</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?1+dh_autoreconf_clean">dh_autoreconf_clean</A></I>(1)
<A NAME="lbAJ">&nbsp;</A>
<H2>AUTHOR</H2>
Julian Andres Klode &lt;<A HREF="mailto:jak@debian.org">jak@debian.org</A>&gt;
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="1"><A HREF="#lbAB">NAME</A><DD>
<DT id="2"><A HREF="#lbAC">DESCRIPTION</A><DD>
<DT id="3"><A HREF="#lbAD">CDBS INTEGRATION</A><DD>
<DT id="4"><A HREF="#lbAE">TIPS AND EXAMPLES</A><DD>
<DL>
<DT id="5"><A HREF="#lbAF"><FONT SIZE="-1">PATCHING LTMAIN.SH FOR</FONT> AS-NEEDED <FONT SIZE="-1">LINKER FLAGS</FONT></A><DD>
<DT id="6"><A HREF="#lbAG"><FONT SIZE="-1">RUNNING MULTIPLE COMMANDS WITH DH_AUTORECONF</FONT></A><DD>
</DL>
<DT id="7"><A HREF="#lbAH">CAVEATS</A><DD>
<DT id="8"><A HREF="#lbAI">SEE ALSO</A><DD>
<DT id="9"><A HREF="#lbAJ">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:08 GMT, March 31, 2021
</BODY>
</HTML>