=head1 SYNOPSIS
Functions for dealing with the actual compiling/installation of spells
and walking through casts 'pass 4' pipeline. If BUILD_API is '1'
=head1 DESCRIPTION
Contains functions for the build api version 1
which has the following steps:
PRE_BUILD -> BUILD -> POST_BUILD -> POST_INSTALL -> TRIGGERS
=head1 COPYRIGHT
Copyright (C) 2004 The Source Mage Team
This runs through the phase 4 pipeline of building and installing a spell for BUILD_API 1.
This phase of casting involves unpacking the source into the source directories. If a PRE_BUILD file exists in SCRIPT_DIRECTORY and is executable it is run in preference to the default_pre_build.
Starts up the compile logs, turns on the various environment settings that need to be on, eventually gets around to running BUILD or default_build, then does other things it shouldn't do.
Checks for a POST_BUILD file in SCRIPT_DIRECTORY, and if it is executable, runs it. This file is run after BUILD and before POST_INSTALL. Its purpose is to bookend BUILD and shutoff installwatch.
Checks for a POST_INSTALL file in SCRIPT_DIRECTORY, and if it is executable, runs it. This file is used for extra files that need to be installed, but not tracked by installwatch.
API
Creates the source directory and unpacks the source package into it. Used if no PRE_BUILD script is found for a spell.
API
Used if no BUILD script is found for a spell Default build is:
./configure --build=$BUILD ## --prefix=/usr ## --sysconfdir=/etc ## --localstatedir=/var ## $OPTS && make && prepare_install && make install
API
Installs configuration files and documentation. Stops installwatch. Used if no POST_BUILD script is found for a spell.