NAME

       DhMakePerl::Command::Packaging - common routines for 'make' and 'refresh' dh-make-perl
       commands

METHODS

       main_file(file_name)
           Constructs a file name relative to the main source directory, "main_dir"

       debian_file(file_name)
           Constructs a file name relative to the debian/ sub-directory of the main source
           directory.

       explained_dependency $reason, $dependencies, @dependencies
           Adds the list of dependencies to $dependencies and shows $reason if in verbose mode.

           Used to both bump a dependency and tell the user why.

           $dependencies is an instance of Debian::Dependencies class, and @dependencies is a
           list of Debian::Dependency instances or strings.

           The message printed looks like "$reason needs @dependencies".

       configure_cpan
           Configure CPAN module. It is safe to call this method more than once, it will do
           nothing if CPAN is already configured.

       discover_dependencies
           Just a wrapper around $self->control->discover_dependencies which provides the right
           parameters to it.

           Returns a list of missing modules.

       discover_utility_deps
           Determines whether a certain version of debhelper(1) or quilt(1) is needed by the
           build process.

           The following special cases are detected:

           Module::AutoInstall
               If Module::AutoInstall is discovered in "" in inc, debhelper dependency is raised
               to 7.2.13.

           Module::Build::Tiny
               if Module::Build::Tiny is present in the build-dependencies, debhelper dependency
               is raised to 9.20130630.

           dh --with=quilt
               "dh --with=quilt" needs debhelper 7.0.8 and quilt 0.46-7.

           dh --with=bash-completion
               "dh --with=bash-completion" needs debhelper 7.0.8 and bash-completion 1:1.0-3.

           dh --with=perl_dbi
               "dh --with=perl_dbi" needs debhelper 7.0.8 and libdbi-perl 1.612.

           dh --buildsystem=buildsystem
               "dh --buildsystem=buildsystem" needs debhelper 7.3.7.

           quilt.make
               If /usr/share/quilt/quilt.make is included in debian/rules, a build-dependency on
               "quilt" is added.

           debhelper override targets
               Targets named "override_dh_..." are supported by debhelper since 7.0.50

           Makefile.PL created by Module::Build::Compat
               Building such packages requires debhelper 7.0.17 (see
               <http://bugs.debian.org/496157>) =back

           Module::Build
               The proper build-dependency in this case is

                   perl

               The on perl without a version is set as Lenny has already 5.10 which includes
               first Module::Build.

       makefile_pl_is_MBC
           Checks if Makefile.PL is a compatibility wrapper around Build.PL provided by
           Module::Build::Compat.

       backup_file(file_name)
           Creates a backup copy of the specified file by adding ".bak" to its name. If the
           backup already exists, it is overwritten.

           Does nothing unless the "backups" option is set.

       unquote(string)
           Runs its argument through Text::Balanced's "extract_quotelike" method and returns the
           extracted content with quotes removed. Dies if "extract_quotelike" can't find quoted
           string.

COPYRIGHT & LICENSE

       Copyright (C) 2000, 2001 Paolo Molaro <lupus@debian.org>
       Copyright (C) 2002, 2003, 2008 Ivan Kohler <ivan-debian@420.am>
       Copyright (C) 2003, 2004 Marc 'HE' Brockschmidt <he@debian.org>
       Copyright (C) 2005-2007 Gunnar Wolf <gwolf@debian.org>
       Copyright (C) 2006 Frank Lichtenheld <djpig@debian.org>
       Copyright (C) 2007-2013 Gregor Herrmann <gregoa@debian.org>
       Copyright (C) 2007,2008,2009,2010,2012,2013 Damyan Ivanov <dmn@debian.org>
       Copyright (C) 2008, Roberto C. Sanchez <roberto@connexer.com>
       Copyright (C) 2009-2011, Salvatore Bonaccorso <carnil@debian.org>
       Copyright (C) 2011, Nicholas Bamber <nicholas@periapt.co.uk>

       This program is free software; you can redistribute it and/or modify it under the terms of
       the GNU General Public License version 2 as published by the Free Software Foundation.

       This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
       without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
       See the GNU General Public License for more details.

       You should have received a copy of the GNU General Public License along with this program;
       if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
       Boston, MA 02110-1301 USA.