.\" -*- 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 "DhMakePerl::Command::Packaging 3pm" .TH DhMakePerl::Command::Packaging 3pm 2024-03-14 "perl v5.38.2" "User Contributed Perl Documentation" .\" 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 DhMakePerl::Command::Packaging \- common routines for 'make' and 'refresh' dh\-make\-perl commands .SH METHODS .IX Header "METHODS" .IP main_file(file_name) 4 .IX Item "main_file(file_name)" Constructs a file name relative to the main source directory, "main_dir" .IP debian_file(file_name) 4 .IX Item "debian_file(file_name)" Constructs a file name relative to the debian/ sub-directory of the main source directory. .ie n .IP "explained_dependency \fR\fI$reason\fR\fI\fR, \fI\fR\fI$dependencies\fR\fI\fR, \fI\fR\fI@dependencies\fR\fI\fR" 4 .el .IP "explained_dependency \fR\f(CI$reason\fR\fI\fR, \fI\fR\f(CI$dependencies\fR\fI\fR, \fI\fR\f(CI@dependencies\fR\fI\fR" 4 .IX Item "explained_dependency $reason, $dependencies, @dependencies" Adds the list of dependencies to \fR\f(CI$dependencies\fR\fI\fR and shows \fI\fR\f(CI$reason\fR\fI\fR if in verbose mode. .Sp Used to both bump a dependency and tell the user why. .Sp \&\fR\f(CI$dependencies\fR\fI\fR is an instance of Debian::Dependencies class, and \&\fI\fR\f(CI@dependencies\fR\fI\fR is a list of Debian::Dependency instances or strings. .Sp The message printed looks like \f(CW\*(C`$reason needs @dependencies\*(C'\fR. .IP configure_cpan 4 .IX Item "configure_cpan" Configure CPAN module. It is safe to call this method more than once, it will do nothing if CPAN is already configured. .IP discover_dependencies 4 .IX Item "discover_dependencies" Just a wrapper around \f(CW$self\fR\->control\->discover_dependencies which provides the right parameters to it. .Sp Returns a list of missing modules. .IP discover_utility_deps 4 .IX Item "discover_utility_deps" Determines whether certain versions of \fBdebhelper\fR\|(1) and other packages are needed by the build process. .Sp The following special cases are detected: .RS 4 .IP Module::Build::Tiny 4 .IX Item "Module::Build::Tiny" if Module::Build::Tiny is present in the build-dependencies, debhelper dependency is raised to 9.20140227~ in case it was lower before. .IP "dh \-\-with=quilt" 4 .IX Item "dh --with=quilt" \&\f(CW\*(C`dh \-\-with=quilt\*(C'\fR needs quilt. .IP quilt.make 4 .IX Item "quilt.make" If \fI/usr/share/quilt/quilt.make\fR is included in \fIdebian/rules\fR, a build-dependency on \f(CW\*(C`quilt\*(C'\fR is added. .IP "dh \-\-with=perl_dbi" 4 .IX Item "dh --with=perl_dbi" A build dependency on \f(CW\*(C`libdbi\-perl\*(C'\fR is added. .IP "dh \-\-with=perl_openssl" 4 .IX Item "dh --with=perl_openssl" A build dependency on \f(CW\*(C`perl\-openssl\-defaults\*(C'\fR is added. .RE .RS 4 .RE .IP makefile_pl_is_MBC 4 .IX Item "makefile_pl_is_MBC" Checks if \fIMakefile.PL\fR is a compatibility wrapper around Build.PL provided by Module::Build::Compat. .IP backup_file(file_name) 4 .IX Item "backup_file(file_name)" Creates a backup copy of the specified file by adding \f(CW\*(C`.bak\*(C'\fR to its name. If the backup already exists, it is overwritten. .Sp Does nothing unless the \f(CW\*(C`backups\*(C'\fR option is set. .IP unquote(\fIstring\fR) 4 .IX Item "unquote(string)" Runs its argument through Text::Balanced's \f(CW\*(C`extract_quotelike\*(C'\fR method and returns the extracted content with quotes removed. Dies if \f(CW\*(C`extract_quotelike\*(C'\fR can't find quoted string. .IP create_upstream_metadata 4 .IX Item "create_upstream_metadata" Populates \fIdebian/upstream/metadata\fR with information from \fIMETA\fR, using Debian::Upstream::Metadata::Perl. .IP cme_fix_dpkg_control 4 .IX Item "cme_fix_dpkg_control" The equivalent of letting \fBcme\fR\|(1) reformat and fix \fIdebian/control\fR. .SH "COPYRIGHT & LICENSE" .IX Header "COPYRIGHT & LICENSE" .IP "Copyright (C) 2000, 2001 Paolo Molaro " 4 .IX Item "Copyright (C) 2000, 2001 Paolo Molaro " .PD 0 .IP "Copyright (C) 2002, 2003, 2008 Ivan Kohler " 4 .IX Item "Copyright (C) 2002, 2003, 2008 Ivan Kohler " .IP "Copyright (C) 2003, 2004 Marc 'HE' Brockschmidt " 4 .IX Item "Copyright (C) 2003, 2004 Marc 'HE' Brockschmidt " .IP "Copyright (C) 2005\-2007 Gunnar Wolf " 4 .IX Item "Copyright (C) 2005-2007 Gunnar Wolf " .IP "Copyright (C) 2006 Frank Lichtenheld " 4 .IX Item "Copyright (C) 2006 Frank Lichtenheld " .IP "Copyright (C) 2007\-2023, gregor herrmann " 4 .IX Item "Copyright (C) 2007-2023, gregor herrmann " .IP "Copyright (C) 2007\-2013 Damyan Ivanov " 4 .IX Item "Copyright (C) 2007-2013 Damyan Ivanov " .IP "Copyright (C) 2008, Roberto C. Sanchez " 4 .IX Item "Copyright (C) 2008, Roberto C. Sanchez " .IP "Copyright (C) 2009\-2011, Salvatore Bonaccorso " 4 .IX Item "Copyright (C) 2009-2011, Salvatore Bonaccorso " .IP "Copyright (C) 2011, Nicholas Bamber " 4 .IX Item "Copyright (C) 2011, Nicholas Bamber " .IP "Copyright (c) 2016, Nick Morrott " 4 .IX Item "Copyright (c) 2016, Nick Morrott " .IP "Copyright (c) 2017, David Miguel Susano Pinto " 4 .IX Item "Copyright (c) 2017, David Miguel Susano Pinto " .PD .PP 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. .PP 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. .PP 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.