dh_perl.1

   1 .TH DH_PERL 1 "22 June 1999" "Debhelper Commands" "Debhelper Commands"
   2 .SH NAME
   3 dh_perl \- calculates perl scripts & modules dependencies
   4 .SH SYNOPSIS
   5 .B dh_perl
   6 .I "[debhelper options] [-k] [-d] [library dirs ...]"
   7 .SH "DESCRIPTION"
   8 dh_perl is a debhelper program that is responsible for generating
   9 the perl:Depends substitutions and adding them to substvars files.
  10 .P
  11 The program will look for the location of installed modules and will
  12 use this information to generate a dependency (at the present time
  13 it can only be perl5, perl5-thread, perl-5.X or perl-5.X-thread).
  14 The dependancy will be substituted into your package's control file
  15 wherever you place the token "${perl:Depends}".
  16 .P
  17 It will also look at #! lines of perl scripts in order to be able
  18 to calculate a dependency for perl scripts and not only perl modules.
  19 .P
  20 In addition it will automatically remove .packlist file and will
  21 remove the directory in which it was if it's empty. You can
  22 switch off this option by passing -k.
  23 .SH OPTIONS
  24 .TP
  25 .TP
  26 .B debhelper options
  27 See
  28 .BR debhelper (1)
  29 for a list of options common to all debhelper commands.
  30 .TP
  31 .B -k
  32 Keep .packlist files.
  33 .TP
  34 .B -d
  35 In some specific cases you may want to depend on a -base package
  36 (ie perl-5.6-base or perl5-base). If so, you can pass
  37 the -d option to make
  38 .BR dh_perl
  39 generate a dependency on the correct base package. This is only necessary
  40 for some modules that are included in the base system.
  41 .TP
  42 .B library dirs
  43 If your package installs perl modules in non-standard
  44 directories, you can make
  45 .BR dh_perl
  46 check those directories by passing their names on the command line.
  47 .BR dh_perl
  48 will only check usr/lib/perl5 by default.
  49 .SH ENVIRONMENT
  50 See
  51 .BR debhelper (1)
  52 for a list of environment variables that affect all debhelper commands.
  53 .SH "SEE ALSO"
  54 .TP
  55 .BR debhelper (1)
  56 .SH "CONFORMS TO"
  57 .P
  58 Debian policy, version 3.0.1
  59 .P
  60 Perl policy, version 1.0
  61 .SH AUTHOR
  62 Raphaël Hertzog <hertzog@debian.org>