1DH_AUTORECONF(1)      User Contributed Perl Documentation     DH_AUTORECONF(1)
2
3
4

NAME

6       dh_autoreconf - Call autoreconf -f -i and keep track of the changed
7       files.
8

SYNOPSIS

10       dh_autoreconf [debhelper options] [-Xitem] [--mode=mode]
11       [program -- params]
12

DESCRIPTION

14       dh_autoreconf is responsible for calling autoreconf and creating the
15       files debian/autoreconf.before and debian/autoreconf.after which
16       contain checksums of all files before/after the build. It is
17       complemented by dh_autoreconf_clean which creates a list of all changed
18       and added files and removes them.
19
20       Please note that dh_autoreconf can only be run once. Thus, if you need
21       to run multiple commands, use a script or similar. An example is given
22       in dh-autoreconf(7).
23

FILES

25       debian/autoreconf
26           This file can contain a list of directories. If present,
27           dh_autoreconf will only scan the given directories for changes. If
28           no special command is given to dh_autoreconf, it will also forward
29           the directory list to autoreconf which causes it to be run only on
30           those sub directories.
31

OPTIONS

33       -Xitem --exclude=item
34           Exclude files that contain "item" anywhere in their filename from
35           being checked for changes. This means that those files won't be
36           deleted by "dh_autoreconf_clean" even if there are changes. You may
37           use this option multiple times to build up a list of things to
38           exclude.
39
40           Starting with version 3, the directories of common version control
41           systems such as cvs, git, hg, svn, and bzr are excluded
42           automatically.
43
44       --mode=mode
45           Change the way in which modifications to files are detected. The
46           default mode is md5 for using MD5 checksums, but there is also
47           timesize for using the time of the last modification and the file
48           size.
49
50       --as-needed
51           Enable support for -Wl,--as-needed in all ltmain.sh files identical
52           to the one of the libtool package. This only works in the MD5 mode
53           (the default one). The changes are reverted in dh_autoreconf_clean.
54           You should not prevent LIBTOOLIZE from running with this, as it
55           only works correctly with libtoolize running.
56
57       -Ddir --sourcedirectory=dir
58           Run everything in the source directory. Supported only in debhelper
59           compat level 10 for backwards compatibility.
60
61       program -- params
62           Run the program given by program with the arguments given by params
63           instead of autoreconf -f -i. If you need to run multiple commands,
64           put them in a script and pass the script instead (or add a target
65           to debian/rules).
66

ENVIRONMENT

68       For each tool executed by autoreconf(1), one can export a variable with
69       the uppercase name of the tool to the specific program which shall be
70       run, including true to prevent the tool in question from being run. The
71       following example shows the beginning of a debian/rules for a package
72       where automake 1.11 shall be run instead of the default automake
73       version and libtoolize shall not be run:
74
75           #!/usr/bin/make -f
76           export AUTOMAKE = automake-1.11
77           export LIBTOOLIZE = true
78

SEE ALSO

80       debhelper(7), dh_autoreconf_clean(1), dh-autoreconf(7)
81

AUTHOR

83       Julian Andres Klode <jak@debian.org>
84
85
86
87perl v5.38.0                      2023-07-19                  DH_AUTORECONF(1)
Impressum