.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)
.\"
.\" 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
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "DH_AUTO_TEST 1"
.TH DH_AUTO_TEST 1 "2017-01-25" "10.2.5" "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_test \- automatically runs a package's test suites
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBdh_auto_test\fR [\fIbuild system options\fR] [\fIdebhelper options\fR] [\fB\-\-\fR \fIparams\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBdh_auto_test\fR is a debhelper program that tries to automatically run a
package's test suite. It does so by running the appropriate command for the
build system it detects the package uses. For example, if there's a
Makefile and it contains a \fBtest\fR or \fBcheck\fR target, then this is done by
running \fBmake\fR (or \fB\s-1MAKE\s0\fR, if the environment variable is set). If the test
suite fails, the command will exit nonzero. If there's no test suite, it
will exit zero without doing anything.
.PP
This is intended to work for about 90% of packages with a test suite. If it
doesn't work, you're encouraged to skip using \fBdh_auto_test\fR at all, and
just run the test suite manually.
.SH "OPTIONS"
.IX Header "OPTIONS"
See "\fB\s-1BUILD SYSTEM OPTIONS\s0\fR" in \fIdebhelper\fR\|(7) for a list of common build
system selection and control options.
.IP "\fB\-\-\fR \fIparams\fR" 4
.IX Item "-- params"
Pass \fIparams\fR to the program that is run, after the parameters that
\&\fBdh_auto_test\fR usually passes.
.SH "NOTES"
.IX Header "NOTES"
If the \fB\s-1DEB_BUILD_OPTIONS\s0\fR environment variable contains \fBnocheck\fR, no
tests will be performed.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIdebhelper\fR\|(7)
.PP
This program is a part of debhelper.
.SH "AUTHOR"
.IX Header "AUTHOR"
Joey Hess <joeyh@debian.org>