.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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
.\" ========================================================================
.\"
.IX Title "DH_AUTO_INSTALL 1"
.TH DH_AUTO_INSTALL 1 2024-03-27 13.15.3 Debhelper
.\" 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_auto_install \- automatically runs make install or similar
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBdh_auto_install\fR [\fIbuild\ system\ options\fR] [\fIdebhelper\ options\fR] [\fB\-\-\fR\ \fIparams\fR]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBdh_auto_install\fR is a debhelper program that tries to automatically install
built files. It does so by running the appropriate command for the build
system it detects the package uses. For example, if there's a \fIMakefile\fR and
it contains a \fBinstall\fR target, then this is done by running \fBmake\fR (or \fBMAKE\fR,
if the environment variable is set). If there is a \fIsetup.py\fR or \fIBuild.PL\fR,
it is used. Note that the Ant build system does not support installation,
so \fBdh_auto_install\fR will not install files built using Ant.
.PP
In compat 15 or later, \fBdh_auto_install\fR will use \fIdebian/tmp\fR as the default
\&\fB\-\-destdir\fR and should be moved from there to the appropriate package build
directory using \fBdh_install\fR\|(1) or similar tools. Though if the \fBsingle-binary\fR
addon for \fBdh\fR\|(1) is activated, then it will pass an explicit
\&\fB\-\-destdir=debian/\fR\f(BIpackage\fR\fB/\fR to \fBdh_auto_install\fR.
.PP
For earlier compat levels then unless \fB\-\-destdir\fR option is
specified, the files are installed into debian/\fIpackage\fR/ if there is only one
binary package. In the multiple binary package case, the files are instead
installed into \fIdebian/tmp/\fR, and should be moved from there to the
appropriate package build directory using \fBdh_install\fR\|(1) or similar tools.
.PP
\&\fBDESTDIR\fR is used to tell make where to install the files. 
If the Makefile was generated by MakeMaker from a \fIMakefile.PL\fR, it will
automatically set \fBPREFIX=/usr\fR too, since such Makefiles need that.
.PP
This is intended to work for about 90% of packages. If it doesn't work, or
tries to use the wrong install target, you're encouraged to skip using
\&\fBdh_auto_install\fR at all, and just run make install manually.
.SH OPTIONS
.IX Header "OPTIONS"
See "\fBBUILD SYSTEM OPTIONS\fR" in \fBdebhelper\fR\|(7) for a list of common build
system selection and control options.
.IP \fB\-\-destdir=\fR\fIdirectory\fR 4
.IX Item "--destdir=directory"
Install files into the specified \fIdirectory\fR. If this option is not specified,
destination directory is determined automatically as described in the
"\fBDESCRIPTION\fR" section.
.IP "\fB\-\-\fR \fIparams\fR" 4
.IX Item "-- params"
Pass \fIparams\fR to the program that is run, after the parameters that
\&\fBdh_auto_install\fR usually passes.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBdebhelper\fR\|(7)
.PP
This program is a part of debhelper.
.SH AUTHOR
.IX Header "AUTHOR"
Joey Hess <joeyh@debian.org>