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

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.

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::$frameset to the PREREQ_PM configuration argument with the given version.

FCTN => { function_set => install_location }

This is a list of function sets and the directories to which they will be installed. This overrides FCTNDIRS and FCTN_DIR.

FCTN_DIR => $install_subdir

This is the directory under the prefix which holds the function set documents. This corresponds to the global_function_set_base configuration variable.

Function set documents are installed into $PREFIX/$FCTN_DIR/$set_name/.

The default is set.

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 sets.

BUGS (a.k.a. TODO LIST)

Function Set support

Uttu::MakeMaker does not yet have complete support for function sets. Please do not expect it to work. The configuration items for function sets are subject to change.

URI Map Installation

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

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.