.\" -*- 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_PERL 1"
.TH DH_PERL 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_perl \- calculates Perl dependencies and cleans up after MakeMaker
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBdh_perl\fR [\fIdebhelper\ options\fR] [\fB\-d\fR] [\fIlibrary\ dirs\fR\ ...]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBdh_perl\fR is a debhelper program that is responsible for generating
the \fB${perl:Depends}\fR substitutions and adding them to substvars files.
.PP
The program will look at Perl scripts and modules in your package,
and will use this information to generate a dependency on \fBperl\fR or
\&\fBperlapi\fR. The dependency will be substituted into your package's \fIcontrol\fR
file wherever you place the token \fB${perl:Depends}\fR.
.PP
\&\fBdh_perl\fR also cleans up empty directories that MakeMaker can generate when
installing Perl modules.
.SH OPTIONS
.IX Header "OPTIONS"
.IP \fB\-d\fR 4
.IX Item "-d"
In some specific cases you may want to depend on \fBperl-base\fR rather than the
full \fBperl\fR package. If so, you can pass the \-d option to make \fBdh_perl\fR generate
a dependency on the correct base package. This is only necessary for some
packages that are included in the base system.
.Sp
Note that this flag may cause no dependency on \fBperl-base\fR to be generated at
all. \fBperl-base\fR is Essential, so its dependency can be left out, unless a
versioned dependency is needed.
.IP \fB\-V\fR 4
.IX Item "-V"
By default, scripts and architecture independent modules don't depend
on any specific version of \fBperl\fR. The \fB\-V\fR option causes the current
version of the \fBperl\fR (or \fBperl-base\fR with \fB\-d\fR) package to be specified.
.IP "\fIlibrary dirs\fR" 4
.IX Item "library dirs"
If your package installs Perl modules in non-standard
directories, you can make \fBdh_perl\fR check those directories by passing their
names on the command line. It will only check the \fIvendorlib\fR and \fIvendorarch\fR
directories by default.
.SH "CONFORMS TO"
.IX Header "CONFORMS TO"
Debian policy, version 3.8.3
.PP
Perl policy, version 1.20
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBdebhelper\fR\|(7)
.PP
This program is a part of debhelper.
.SH AUTHOR
.IX Header "AUTHOR"
Brendan O'Dea <bod@debian.org>