man-pages/man1/dh_autoreconf.1.html
2021-03-31 01:06:50 +01:00

155 lines
4.8 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 (1)<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 - Call autoreconf -f -i and keep track of the changed files.
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>dh_autoreconf</B> [<I>debhelper&nbsp;options</I>] [<B>-X</B><I>item</I>] [<B>--mode=</B><I>mode</I>]
[<I>program</I>&nbsp;<B>--</B>&nbsp;<I>params</I>]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
dh_autoreconf is responsible for calling autoreconf and creating the files
debian/autoreconf.before and debian/autoreconf.after which contain checksums
of all files before/after the build. It is complemented by dh_autoreconf_clean
which creates a list of all changed and added files and removes them.
<P>
Please note that dh_autoreconf can only be run once. Thus, if you need to
run multiple commands, use a script or similar. An example is given in
<I><A HREF="/cgi-bin/man/man2html?7+dh-autoreconf">dh-autoreconf</A></I>(7).
<A NAME="lbAE">&nbsp;</A>
<H2>FILES</H2>
<DL COMPACT>
<DT id="1">debian/autoreconf<DD>
This file can contain a list of directories. If present, dh_autoreconf will
only scan the given directories for changes. If no special command is given
to dh_autoreconf, it will also forward the directory list to autoreconf
which causes it to be run only on those sub directories.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="2"><B>-X</B><I>item</I> <B>--exclude=</B><I>item</I><DD>
Exclude files that contain ``item'' anywhere in their filename from being
checked for changes. This means that those files won't be deleted by
<TT>&quot;dh_autoreconf_clean&quot;</TT> even if there are changes. You may use this option
multiple times to build up a list of things to exclude.
<P>
Starting with version 3, the directories of common version control systems
such as cvs, git, hg, svn, and bzr are excluded automatically.
<DT id="3"><B>--mode=</B><I>mode</I><DD>
Change the way in which modifications to files are detected. The default mode
is <I>md5</I> for using <FONT SIZE="-1">MD5</FONT> checksums, but there is also <I>timesize</I> for using
the time of the last modification and the file size.
<DT id="4"><B>--as-needed</B><DD>
Enable support for -Wl,--as-needed in all ltmain.sh files identical to
the one of the libtool package. This only works in the <FONT SIZE="-1">MD5</FONT> mode (the
default one). The changes are reverted in dh_autoreconf_clean. You should
not prevent <FONT SIZE="-1">LIBTOOLIZE</FONT> from running with this, as it only works correctly
with libtoolize running.
<DT id="5"><B>-D</B><I>dir</I> <B>--sourcedirectory</B>=<I>dir</I><DD>
Run everything in the source directory. Supported only in debhelper compat
level 10 for backwards compatibility.
<DT id="6"><I>program</I> <B>--</B> <I>params</I><DD>
Run the program given by <I>program</I> with the arguments given by <I>params</I>
instead of autoreconf -f -i. If you need to run multiple commands, put them in
a script and pass the script instead (or add a target to debian/rules).
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>ENVIRONMENT</H2>
For each tool executed by <I><A HREF="/cgi-bin/man/man2html?1+autoreconf">autoreconf</A></I>(1), one can export a variable with
the uppercase name of the tool to the specific program which shall be run,
including <B>true</B> to prevent the tool in question from being run. The following
example shows the beginning of a debian/rules for a package where automake
1.11 shall be run instead of the default automake version and libtoolize
shall not be run:
<P>
<PRE>
#!/usr/bin/make -f
export AUTOMAKE = automake-1.11
export LIBTOOLIZE = true
</PRE>
<A NAME="lbAH">&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_autoreconf_clean">dh_autoreconf_clean</A></I>(1), <I><A HREF="/cgi-bin/man/man2html?7+dh-autoreconf">dh-autoreconf</A></I>(7)
<A NAME="lbAI">&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="7"><A HREF="#lbAB">NAME</A><DD>
<DT id="8"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="9"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="10"><A HREF="#lbAE">FILES</A><DD>
<DT id="11"><A HREF="#lbAF">OPTIONS</A><DD>
<DT id="12"><A HREF="#lbAG">ENVIRONMENT</A><DD>
<DT id="13"><A HREF="#lbAH">SEE ALSO</A><DD>
<DT id="14"><A HREF="#lbAI">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:05:10 GMT, March 31, 2021
</BODY>
</HTML>