.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "DH_AUTORECONF 1" .TH DH_AUTORECONF 1 "2021-02-04" "dh-autoreconf v20" "dh-autoreconf" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" dh_autoreconf \- Call autoreconf \-f \-i and keep track of the changed files. .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBdh_autoreconf\fR [\fIdebhelper\ options\fR] [\fB\-X\fR\fIitem\fR] [\fB\-\-mode=\fR\fImode\fR] [\fIprogram\fR\ \fB\-\-\fR\ \fIparams\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" 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. .PP 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 \&\fBdh\-autoreconf\fR\|(7). .SH "FILES" .IX Header "FILES" .IP "debian/autoreconf" 4 .IX Item "debian/autoreconf" 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. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-X\fR\fIitem\fR \fB\-\-exclude=\fR\fIitem\fR" 4 .IX Item "-Xitem --exclude=item" Exclude files that contain \*(L"item\*(R" anywhere in their filename from being checked for changes. This means that those files won't be deleted by \&\f(CW\*(C`dh_autoreconf_clean\*(C'\fR even if there are changes. You may use this option multiple times to build up a list of things to exclude. .Sp Starting with version 3, the directories of common version control systems such as cvs, git, hg, svn, and bzr are excluded automatically. .IP "\fB\-\-mode=\fR\fImode\fR" 4 .IX Item "--mode=mode" Change the way in which modifications to files are detected. The default mode is \fImd5\fR for using \s-1MD5\s0 checksums, but there is also \fItimesize\fR for using the time of the last modification and the file size. .IP "\fB\-\-as\-needed\fR" 4 .IX Item "--as-needed" Enable support for \-Wl,\-\-as\-needed in all ltmain.sh files identical to the one of the libtool package. This only works in the \s-1MD5\s0 mode (the default one). The changes are reverted in dh_autoreconf_clean. You should not prevent \s-1LIBTOOLIZE\s0 from running with this, as it only works correctly with libtoolize running. .IP "\fB\-D\fR\fIdir\fR \fB\-\-sourcedirectory\fR=\fIdir\fR" 4 .IX Item "-Ddir --sourcedirectory=dir" Run everything in the source directory. Supported only in debhelper compat level 10 for backwards compatibility. .IP "\fIprogram\fR \fB\-\-\fR \fIparams\fR" 4 .IX Item "program -- params" Run the program given by \fIprogram\fR with the arguments given by \fIparams\fR 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). .SH "ENVIRONMENT" .IX Header "ENVIRONMENT" For each tool executed by \fBautoreconf\fR\|(1), one can export a variable with the uppercase name of the tool to the specific program which shall be run, including \fBtrue\fR 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: .PP .Vb 3 \& #!/usr/bin/make \-f \& export AUTOMAKE = automake\-1.11 \& export LIBTOOLIZE = true .Ve .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBdebhelper\fR\|(7), \fBdh_autoreconf_clean\fR\|(1), \fBdh\-autoreconf\fR\|(7) .SH "AUTHOR" .IX Header "AUTHOR" Julian Andres Klode