NAME

Uttu::MakeMaker - create a framework or function set Makefile

SYNOPSIS

  use Uttu::MakeMaker;

  WriteMakefile( ATTRIBUTE => VALUE [, ...] );

which is really

  MM->new(\%att)->flush;

with a few default parameters set.

DESCRIPTION

Uttu::MakeMaker redirects ExtUtils::MakeMaker to install frameworks and function sets under the Uttu framework or function set directories. This may be overridden by specifying the PREFIX and LIB arguments on the commandline:

  perl Makefile.PL PREFIX=/some/path LIB=/some/path/to/lib

Note that the defaults are based on $Uttu::Config::PREFIX:

  PREFIX="${Uttu::Config::PREFIX}/functionsets/$framework";
  LIB="${PREFIX}/lib";

or (for frameworks):

  PREFIX="${Uttu::Config::PREFIX}/framework/$framework";
  LIB="${PREFIX}/lib";

If PREFIX or LIB are specified on the command line, they will not have /functionsets/$framework or /framework/$framework appended.

Configuration

Uttu::MakeMaker recognizes all the arguments for ExtUtils::MakeMaker. In addition, it uses the following arguments to modify default ExtUtils::MakeMaker behavior.

FRAMEWORK => $framework

This defines the framework being installed. This should only be set if installing a framework.

This defaults to the last component of the NAME parameter or the last component of the calling package if the calling package is in the form "Uttu::Framework::$framework" (with only two sets of "::").

PREREQ_FRAMEWORK => [ $framework => $version ]

This defines the framework required to use the function set being installed. This should only be set if the Makefile.PL is for a function set.

This adds Uttu::Framework::$framework to the PREREQ_PM configuration argument with the given version.

PREREQ_FCTN => { $function_set => $version }

This is a hash of function sets mapped to versions. This has meaning only if PREREQ_FRAMEWORK is defined. This should only be set if the Makefile.PL is for a function set.

This adds Uttu::Framework::$framework::$function_set to the PREREQ_PM configuration argument with the given version. Do not include Uttu::Framework::$framework in the keys.

FCTNDIRS => [ directory list ]

This is a list of directories in which function sets are located. The subdirectories of these directories are the names of the function sets. Anything below those subdirectories are considered files for installation.

For example, if FCTNDIRS = [ sets ]>, then sets/Auth/* would denote all the documents (e.g., HTML::Mason components) for the Auth function set that are available for export to the web.

The default value for FCTNDIRS is . and sets.

BUGS (a.k.a. TODO LIST)

URI Map Installation

Installation of URI-to-filename maps is not yet supported.

Testing

Testing during the build/installation process is not yet supported.

SEE ALSO

ExtUtils::MakeMaker.

AUTHOR

James Smith <jgsmith@cpan.org>

COPYRIGHT

Copyright (C) 2002 Texas A&M University. All Rights Reserved.

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