Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

debian::control::fromcpan(3pm) [debian man page]

Debian::Control::FromCPAN(3pm)				User Contributed Perl Documentation			    Debian::Control::FromCPAN(3pm)

NAME

       Debian::Control::FromCPAN - fill debian/control from unpacked CPAN distribution

SYNOPSIS

	   my $c = Debian::Control::FromCPAN->new();
	   $c->discover_dependencies( { ... } );
	   $c->prune_perl_deps;

	   Debian::Control::FromCPAN inherits from L<Debian::Control>.

METHODS

       discover_dependencies( [ { options hash } ] )
	   Discovers module dependencies and fills the dependency fields in debian/control accordingly.

	   Options:

	   apt_contents
	       An instance of Debian::AptContents to be used when locating to which package a required module belongs.

	   dir The directory where the cpan distribution was unpacked.

	   intrusive
	       A flag indicating permission to use Module::Depends::Intrusive for discovering dependencies in case Module::Depends fails. Sinse
	       this requires loading all Perl modules in the distribution (and running their BEGIN blocks (and the BEGIN blocks of their
	       dependencies, recursively), it is recommended to use this only when dealing with trusted sources.

	   require_deps
	       If true, causes the method to die if some a package for some dependency cannot be found. Otherwise only a warning is issued.

	   verbose
	   wnpp_query
	       An instance of Debian::WNPP::Query to be used when checking for WNPP bugs of depeended upon packages.

	   Returns a list of module names for which no suitable Debian packages were found.

       find_debs_for_modules dep hash[, APT contents[, verbose ]]
	   Scans the given hash of dependencies ( module => version ) and returns matching Debian package dependency specification (as an instance
	   of Debian::Dependencies class) and a list of missing modules. Installed packages are searched first, then the APT contents, then the
	   perl core.

       prune_simple_perl_dep
	   Input:

	   dependency object
	       shall be a simple dependency (no alternatives)

	   (optional) build dependency flag
	       true value indicates the dependency is a build-time one

	   The following checks are made

	   dependencies on "perl-modules"
	       These are replaced with "perl" as per Perl policy.

	   dependencies on "perl-base" and build-dependencies on "perl" or "perl-base"
	       These are removed, unless they specify a version greater than the one available in "oldstable" or the dependency relation is not
	       ">=" or ">>".

	   Return value:

	   undef
	       if the dependency is redundant.

	   pruned dependency
	       otherwise. "perl-modules" replaced with "perl".

       prune_perl_dep
	   Similar to "prune_simple_perl_dep", but supports alternative dependencies.  If any of the alternatives is redundant, the whole
	   dependency is considered redundant.

       prune_perl_deps
	   Remove redundant (build-)dependencies on perl, perl-modules and perl-base.

COPYRIGHT &; LICENSE
       Copyright (C) 2009, 2010 Damyan Ivanov dmn@debian.org

       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.

perl v5.14.2							    2012-01-15					    Debian::Control::FromCPAN(3pm)

Check Out this Related Man Page

DhMakePerl::Utils(3pm)					User Contributed Perl Documentation				    DhMakePerl::Utils(3pm)

NAME

       DhMakePerl::Utils - helper routined for dh-make-perl and alike

SYNOPSIS

	   use DhMakePerl::Utils qw(is_core_module);

	   my $v = is_core_module('Test::More', '1.002');
	   my $v = nice_perl_ver('5.010001');

FUNCTIONS

       None of he following functions is exported by default.

       find_cpan_module
	   Returns CPAN::Module object that corresponds to the supplied argument. Returns undef if no module is found by CPAN.

	   If the CPAN module needs to be configured in some way, that should be done before calling this function.

       find_cpan_distribution
	   Returns CPAN::Distribution object that corresponds to the supplied argument.  Returns undef if no distribution is found by CPAN.

	   If the CPAN module needs to be configured in some way, that should be done before calling this function.

       is_core_module module, version
	   Returns the version of the "perl" package containing the given module (at least version version).

	   Returns "undef" if module is not a core module.

       nice_perl_ver version_string
	   Reformats perl version to match Debian's perl package versions.

	   For example 5.010 (and 5.01) is converted to 5.10.

       core_module_perls module[, min-version]
	   Returns a list of Perl versions that have module. If min-version is given, the list contains only Perl versions containing module at
	   least version min-version.

       find_core_perl_dependency( $module[, $version] )
	   return a dependency on perl containing the required module version. If the module is not available in any perl released by Debian,
	   return undef.

       split_version_relation string
	   Splits the string, typicaly found in dependency fields' values in CPAN META into relation and version. If no relation is found in the
	   string, ">=" is assumed.

	   Returns a list of relation and version. The relation is suitable for using in debian package dependency version requirements.

	   For example

	   split_version_relation('0.45') returns ( '>=', '0.45' )
	   split_version_relation('< 0.56') returns ( '<<', '0.56' )

COPYRIGHT &; LICENSE
       Copyright (C) 2008, 2009, 2010 Damyan Ivanov <dmn@debian.org>

       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.

perl v5.14.2							    2012-01-15						    DhMakePerl::Utils(3pm)
Man Page