ModPerl::MM man page on OpenServer

Man page or keyword search:  
man Server   5388 pages
apropos Keyword Search (all sections)
Output format
OpenServer logo
[printable version]

mod_perl-2.0.3::docs::User:Contributemod_perl-2.0.3::docs::api::ModPerl::MM(3)

NAME
       ModPerl::MM -- A "subclass" of ExtUtils::MakeMaker for mod_perl 2.0

Synopsis
	 use ModPerl::MM;

	 # ModPerl::MM takes care of doing all the dirty job of overriding
	 ModPerl::MM::WriteMakefile(...);

	 # if there is a need to extend the default methods
	 sub MY::constants {
	     my $self = shift;
	     $self->ModPerl::MM::MY::constants;
	     # do something else;
	 }

	 # or prevent overriding completely
	 sub MY::constants { shift->MM::constants(@_); }";

	 # override the default value of WriteMakefile's attribute
	 my $extra_inc = "/foo/include";
	 ModPerl::MM::WriteMakefile(
	     ...
	     INC => $extra_inc,
	     ...
	 );

	 # extend the default value of WriteMakefile's attribute
	 my $extra_inc = "/foo/include";
	 ModPerl::MM::WriteMakefile(
	     ...
	     INC => join " ", $extra_inc, ModPerl::MM::get_def_opt('INC'),
	     ...
	 );

Description
       "ModPerl::MM" is a "subclass" of "ExtUtils::MakeMaker" for mod_perl
       2.0, to a degree of sub-classability of "ExtUtils::MakeMaker".

       When "ModPerl::MM::WriteMakefile()" is used instead of "ExtUtils::Make-
       Maker::WriteMakefile()", "ModPerl::MM" overrides several "ExtU-
       tils::MakeMaker" methods behind the scenes and supplies default
       "WriteMakefile()" arguments adjusted for mod_perl 2.0 build. It's writ-
       ten in such a way so that normally 3rd party module developers for
       mod_perl 2.0, don't need to mess with Makefile.PL at all.

"MY::" Default Methods
       "ModPerl::MM" overrides method foo as long as Makefile.PL hasn't
       already specified a method MY::foo. If the latter happens, "Mod-
       Perl::MM" will DWIM and do nothing.

       In case the functionality of "ModPerl::MM" methods needs to be
       extended, rather than completely overriden, the "ModPerl::MM" methods
       can be called internally. For example if you need to modify constants
       in addition to the modifications applied by "ModPerl::MM::MY::con-
       stants", call the "ModPerl::MM::MY::constants" method (notice that it
       resides in the package "ModPerl::MM::MY" and not "ModPerl::MM"), then
       do your extra manipulations on constants:

	 # if there is a need to extend the methods
	 sub MY::constants {
	     my $self = shift;
	     $self->ModPerl::MM::MY::constants;
	     # do something else;
	 }

       In certain cases a developers may want to prevent from "ModPerl::MM" to
       override certain methods. In that case an explicit override in Make-
       file.PL will do the job. For example if you don't want the "con-
       stants()" method to be overriden by "ModPerl::MM", add to your Make-
       file.PL:

	 sub MY::constants { shift->MM::constants(@_); }";

       "ModPerl::MM" overrides the following methods:

       "ModPerl::MM::MY::post_initialize"

       This method is deprecated.

"WriteMakefile()" Default Arguments
       "ModPerl::MM::WriteMakefile" supplies default arguments such as "INC"
       and "TYPEMAPS" unless they weren't passed to "ModPerl::MM::WriteMake-
       file" from Makefile.PL.

       If the default values aren't satisfying these should be overriden in
       Makefile.PL. For example to supply an empty INC, explicitly set the
       argument in Makefile.PL.

	 ModPerl::MM::WriteMakefile(
	     ...
	     INC => '',
	     ...
	 );

       If instead of fully overriding the default arguments, you want to
       extend or modify them, they can be retrieved using the "Mod-
       Perl::MM::get_def_opt()" function. The following example appends an
       extra value to the default "INC" attribute:

	 my $extra_inc = "/foo/include";
	 ModPerl::MM::WriteMakefile(
	     ...
	     INC => join " ", $extra_inc, ModPerl::MM::get_def_opt('INC'),
	     ...
	 );

       "ModPerl::MM" supplies default values for the following "Mod-
       Perl::MM::WriteMakefile" attributes:

       "CCFLAGS"

       "LIBS"

       "INC"

       "OPTIMIZE"

       "LDDLFLAGS"

       "TYPEMAPS"

       "dynamic_lib"

       "OTHERLDFLAGS"

	 dynamic_lib => { OTHERLDFLAGS => ... }

       "macro"

       "MOD_INSTALL"

	 macro => { MOD_INSTALL => ... }

       makes sure that Apache-Test/ is added to @INC.

Public API
       The following functions are a part of the public API. They are
       described elsewhere in this document.

       "WriteMakefile()"

	 ModPerl::MM::WriteMakefile(...);

       "get_def_opt()"

	 my $def_val = ModPerl::MM::get_def_opt($key);

perl v5.8.8			  200mod_perl-2.0.3::docs::api::ModPerl::MM(3)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server OpenServer

List of man pages available for OpenServer

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net