NAME

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

SYNOPSIS

In aModule::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 theModule::Install::Admin::* namespace that provides the methodsome_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 isnever included under a distribution'sinc/ directory, nor are any of theModule::Install::Admin::* extensions.

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

Bootstrapping

When someone runs aMakefile.PL that hasuse inc::Module::Install, and there is noinc/ in the current directory,Module::Install will load this module bootstrap itself, through the steps below:

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

• Reloadinc/Module/Install.pm if the current file is somewhere else. This ensures that the included version ofinc/Module/Install.pm is always preferred over the installed version.

• Look atinc/Module/Install/*.pm and load all of them.

• Set up amain::AUTOLOAD function to delegate missing function calls toModule::Install::Admin::load -- again, this should only happen at the author's side.

• Provide aModule::Install::purge_self function for removing included files underinc/.

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.

Seehttp://www.perl.com/perl/misc/Artistic.html