cjfields/bioperl6/lib/Configure
bioperl6 src
NAME
Makefile.pm - common code for Makefile builder and runner
SYNOPSIS
perl6 Configure.p6
Where F<Configure.p6> generally has only these lines:
# Configure.p6 - installer - see documentation in ../Configure.pm
BEGIN { @*INC.push( '..' ); } use Configure;
DESCRIPTION
A Perl module often needs a Makefile to specify how to build, test and
install it. A Makefile must make sense to the Unix make utility.
Makefiles must often be adjusted slightly to alter the context in which
they will work. There are various tools to make Makefiles and this
Configure.p6 and Configure.pm combination run purely in Perl 6.
Configure.p6 resides in the top level directory of the module.
For easier maintenance, Configure.p6 usually contains only the lines
shown in L<doc:#SYNOPSIS> above, namely a comment and one line of code
to pass execution to F<Configure.pm>. It is recommended that any custom
actions required to prepare the module be written in Makefile.in.
Configure.pm reads Makefile.in from the module top level directory,
replaces certain variables marked like <THIS>, and writes the updated
text to Makefile in the same directory. Finally it runs the standard
'make' utility, which builds the first target defined in Makefile.
AUTHOR
Martin Berends (mberends on CPAN github #perl6 and @autoexec.demon.nl).