module::install::trustmetayml(3pm) [debian man page]

Module::Install::TrustMetaYml(3pm)			User Contributed Perl Documentation			Module::Install::TrustMetaYml(3pm)

NAME

       Module::Install::TrustMetaYml - trusts META.yml list of dependencies

SYNOPSIS

       In Makefile.PL:

	       trust_meta_yml;

DESCRIPTION

       CPAN doesn't trust "META.yml"'s list of dependencies for a module. Instead it expects "Makefile.PL" run on the computer the package is
       being installed upon to generate its own list of dependencies (called "MYMETA.yml" or "MYMETA.json").

       This module is a Module::Install plugin that generates "MYMETA.yml" by simply passing through the dependencies from "META.yml".

       It does nothing when run from the module author's development copy.

       The module defines two functions which are aliases for each other:

       "trust_meta_yml"
       "trust_meta_yaml"

BUGS

       Please report any bugs to http://rt.cpan.org/Dist/Display.html?Queue=Module-Install-TrustMetaYml
       <http://rt.cpan.org/Dist/Display.html?Queue=Module-Install-TrustMetaYml>.

SEE ALSO

       Module::Install, Module::Package::RDF.

AUTHOR

       Toby Inkster <tobyink@cpan.org>.

CREDITS

       Thanks to Chris Williams (BINGOS), Ingy dA~Xt Net (INGY) and Florian Ragwitz (FLORA) for explaining the role of "MYMETA.json", and helping
       me figure out why mine weren't working.

COPYRIGHT AND LICENCE

       This software is copyright (c) 2011 by Toby Inkster.

       This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

DISCLAIMER OF WARRANTIES

       THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
       MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

perl v5.14.2							    2011-10-05					Module::Install::TrustMetaYml(3pm)

Module::Install::Admin(3)				User Contributed Perl Documentation				 Module::Install::Admin(3)

NAME

       Module::Install::Admin - Author-side manager for Module::Install

SYNOPSIS

       In a Module::Install extension module:

	   sub extension_method {
	       my $self = shift;
	       $self->admin->some_method(@args);
	   }

       As an one-liner:

	   % perl "-MModule::Install::Admin" -e'&some_method(@args);'

       The two snippets above are really shorthands for

	   $some_obj->some_method(@args)

       where $some_obj is the singleton object of a class under the "Module::Install::Admin::*" namespace that provides the method "some_method".
       See "METHODS" for a list of built-in methods.

DESCRIPTION

       This module implements the internal mechanism for initializing, including and managing extensions, and should only be of interest to
       extension developers; it is never included under a distribution's inc/ directory, nor are any of the Module::Install::Admin::* extensions.

       For normal usage of Module::Install, please see Module::Install and "COOKBOOK / EXAMPLES" in Module::Install instead.

   Bootstrapping
       When someone runs a Makefile.PL that has "use inc::Module::Install", and there is no inc/ in the current directory, Module::Install will
       load this module bootstrap itself, through the steps below:

       o   First, Module/Install.pm is POD-stripped and copied from @INC to inc/.  This should only happen on the author's side, never on the end-
	   user side.

       o   Reload inc/Module/Install.pm if the current file is somewhere else.	This ensures that the included version of inc/Module/Install.pm is
	   always preferred over the installed version.

       o   Look at inc/Module/Install/*.pm and load all of them.

       o   Set up a "main::AUTOLOAD" function to delegate missing function calls to "Module::Install::Admin::load" -- again, this should only
	   happen at the author's side.

       o   Provide a "Module::Install::purge_self" function for removing included files under inc/.

METHODS

SEE ALSO

       Module::Install

AUTHORS

       Audrey Tang <autrijus@autrijus.org>

COPYRIGHT

       Copyright 2003, 2004 by Audrey Tang <autrijus@autrijus.org>.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

       See <http://www.perl.com/perl/misc/Artistic.html>

perl v5.16.3							    2012-03-01						 Module::Install::Admin(3)