1Module::Install::Admin(U3s)er Contributed Perl DocumentatMioodnule::Install::Admin(3)
2
3
4

NAME

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

SYNOPSIS

9       In a Module::Install extension module:
10
11           sub extension_method {
12               my $self = shift;
13               $self->admin->some_method(@args);
14           }
15
16       As an one-liner:
17
18           % perl "-MModule::Install::Admin" -e'&some_method(@args);'
19
20       The two snippets above are really shorthands for
21
22           $some_obj->some_method(@args)
23
24       where $some_obj is the singleton object of a class under the "Mod‐
25       ule::Install::Admin::*" namespace that provides the method
26       "some_method".  See "METHODS" for a list of built-in methods.
27

DESCRIPTION

29       This module implements the internal mechanism for initializing, includ‐
30       ing and managing extensions, and should only be of interest to exten‐
31       sion developers; it is never included under a distribution's inc/
32       directory, nor are any of the Module::Install::Admin::* extensions.
33
34       For normal usage of Module::Install, please see Module::Install and
35       Module::Install-Cookbook instead.
36
37       Bootstrapping
38
39       When someone runs a Makefile.PL that has "use inc::Module::Install",
40       and there is no inc/ in the current directory, Module::Install will
41       load this module bootstrap itself, through the steps below:
42
43       ·   First, Module/Install.pm is POD-stripped and copied from @INC to
44           inc/.  This should only happen on the author's side, never on the
45           end-user side.
46
47       ·   Reload inc/Module/Install.pm if the current file is somewhere else.
48           This ensures that the included version of inc/Module/Install.pm is
49           always preferred over the installed version.
50
51       ·   Look at inc/Module/Install/*.pm and load all of them.
52
53       ·   Set up a "main::AUTOLOAD" function to delegate missing function
54           calls to "Module::Install::Admin::load" -- again, this should only
55           happen at the author's side.
56
57       ·   Provide a "Module::Install::purge_self" function for removing
58           included files under inc/.
59

METHODS

SEE ALSO
62       Module::Install
63

AUTHORS
65       Audrey Tang <autrijus@autrijus.org>
66

68       Copyright 2003, 2004 by Audrey Tang <autrijus@autrijus.org>.
69
70       This program is free software; you can redistribute it and/or modify it
71       under the same terms as Perl itself.
72
73       See <http://www.perl.com/perl/misc/Artistic.html>
74
75
76
77perl v5.8.8                       2007-03-05         Module::Install::Admin(3)



        

    


            
        

        

            Impressum