GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MODULE::INSTALL::ADMIN (3)

.ds Aq ’

NAME

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

CONTENTS

SYNOPSIS

In a <B>Module::InstallB> 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 <B>Module::Install::Admin::*B> extensions.

For normal usage of <B>Module::InstallB>, 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, <B>Module::InstallB> 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>

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 MODULE::INSTALL::ADMIN (3) 2015-05-02

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.